Document the ability to supply a custom docs path

This commit is contained in:
Paul Stanton 2013-08-22 23:26:07 +02:00
parent 6b041596fb
commit fd86353ab3
2 changed files with 28 additions and 2 deletions

View File

@ -31,10 +31,12 @@ Download this repository as a zip, and unpack. Copy the files to a web server th
## Folders
The generator will look for folders in the `/docs` folder. Add your folders inside the `/docs` folder. This project contains some example folders and files to get you started.
By default, the generator will look for folders in the `/docs` folder. Add your folders inside the `/docs` folder. This project contains some example folders and files to get you started.
You can nest folders any number of levels to get the exact structure you want. The folder structure will be converted to the nested navigation.
If you'd prefer to keep your docs somewhere else (like outside of the daux.io root directory) you can specify your docs path in the `config.json` file.
## Files
The generator will look for Markdown `*.md` files inside the `/docs` folder and any of the subfolders within /docs.
@ -82,6 +84,17 @@ Change the title bar in the docs
}
```
###Docs Path:
If you'd prefer to keep your docs outside of the Daux.io directory, you can provide the filepath.
Note: Your `config.json` file will need to remain in `/daux.io/docs`.
```json
{
"docs_path": "../../my_docs"
}
```
###Themes:
We have 4 built-in Bootstrap themes. To use one of the themes, just set the `theme` option to one of the following:

View File

@ -31,10 +31,12 @@ Download this repository as a zip, and unpack. Copy the files to a web server th
## Folders
The generator will look for folders in the `/docs` folder. Add your folders inside the `/docs` folder. This project contains some example folders and files to get you started.
By default, the generator will look for folders in the `/docs` folder. Add your folders inside the `/docs` folder. This project contains some example folders and files to get you started.
You can nest folders any number of levels to get the exact structure you want. The folder structure will be converted to the nested navigation.
If you'd prefer to keep your docs somewhere else (like outside of the daux.io root directory) you can specify your docs path in the `config.json` file.
## Files
The generator will look for Markdown `*.md` files inside the `/docs` folder and any of the subfolders within /docs.
@ -82,6 +84,17 @@ Change the title bar in the docs
}
```
###Docs Path:
If you'd prefer to keep your docs outside of the Daux.io directory, you can provide the filepath.
Note: Your `config.json` file will need to remain in `/daux.io/docs`.
```json
{
"docs_path": "../../my_docs"
}
```
###Themes:
We have 4 built-in Bootstrap themes. To use one of the themes, just set the `theme` option to one of the following: