the flydoc is an documentation generator that uses a simple folder structure and Markdown files to create custom documentation. it is writed by python that can be compiled on windows and linux, and we pack a exe file to help use easily.
-
the templates are writed by bootstrap, the users can modify it easily.
-
support the style of github markdown.
-
support the more beautiful table mark.
-
support custom the config file. of course, it can work normally with no config file.
-
support the code syntax highlighting.
-
supports unlimited hierarchical directory.
by default, the flydoc will find the /docs
folder to build the markdown file. if you don't want to use the default folder, that can transfer an parameter to specify the document folder. normally, the folder structure is like that:
docs
1.examplemarkdown.md
2.markdown2-.md
subfolder
1.markdownfile.md
2.file2-.md
3.file3.md
config.json
flydoc.exe
if you don't use flydoc.exe, and use python main.py [inputfolder] [outputfolder]
command to complie. the folder structure is like that:
common
themes
docs
1.examplemarkdown.md
2.markdown2-.md
subfolder
1.markdownfile.md
2.file2-.md
3.file3.md
__init__.py
config.json
main.py
-
use the flydoc.exe
download the flydoc.exe from github.
execute the flydoc.exe with some command
-
use the sources.
download the sources from github.
install the dependence.
pip install simplejson codecs shutil markdown Jinja2
-
use the flydoc.exe
flydoc.exe [inputfolder] [outputfolder]
-
use the sources.
python main.py [inputfolder] [outputfolder]
{
"title": "",
"author": "",
"description": "",
"headers": [
{"name": "the header nav title", "url": "the url"}
],
//the host or root of the navigation's url
"rooturl": "",
"theme": "default",
/*
by default, the tool will insert the catalog automatically. you can change the method.
Another method that removes catalog is adding the `-` on the tail of the filename. for example:
1.examplemd-.md
*/
"catalog": true,
// support regex
"ignore": {
"files": [],
"folders": []
}
}
the idea is inspired by these projects: