EasyDoc, Easy to generate Documents. :seedling: EasyDoc,简单、快速生成文档的工具。
EasyDoc, Easy
to generate Documents
.
EasyDoc pronunciation [ˈiziˈdɑk] sound file
link to download software (Compressed package need to extract the software file.)
Only one software file, do not install, not to rely on others, support to Microsoft system computer, Apple system computer, Linux system computer.
How to update the software: Please download the new software file overwrite the old software file.
EasyDoc is developed by Go language, open source software, you can use the source code to compile. In fact, you do not have to do that, we have compiled and optimized software for download.
Ensure that easydoc software file can executable!
software file in the current directory:
Windows system $ easydoc -version
Unix-like system (such as Mac, Linux. Note that in front of ./ ) $ ./easydoc -version
You can put easydoc software file in the global environment directory(recommended use this), Using anywhere $ easydoc -version
.
Do not forget to a small horizontal line in front of!
-init
Init the document structure
-build
Build the document
-server
Start web server(used[or not] with the port -port
and the path -path
, the default port is 80 -port 80
, the default path is dist directory-path ./dist
)
-emptydist
Empty dist directory
-help
Help about EasyDoc
-version
Print the version number of EasyDoc
Static documents which Generated by EasyDoc are placed in the dist
directory, use or copy this directory directly as a site directory.
Use -init
command automatically generate
├── dist //release directory
├── config
│ └── config.toml //Configuration file, using toml syntax
├── src //Writing directory: store .md source files(required, support to store in this directory and its subdirectories)
│ ├── index.md //Home(not required, but recommended)
│ ├── NO-asset-folder.txt //To avoid conflicts, prompt src directory with caution asset and static subdirectory
│ └── NO-static-folder.txt
├── static //Static file directory, this directory will be completely copied to the release directory(Flexibility to use it for file layout)
└── theme //Template directory (support multiple sets of templates)
└── default //This default template
├── css
│ └── style.css //Css file in template(No,use the software's default)
├── js
│ └── app.js //Js file in the template(No,use the software's default)
├── doc.tpl //Document template(No,use the software's default)
└── menu.tpl //Menu template(The menu is generated in order, Explanations below.)
├── easydoc.exe //software file(Recommended put it on the global environment directory
Source files written using Markdown syntax.
Writing is in the src directory, multi-level subdirectory support (hint: src directory caution asset and static subdirectories).scanFile = [
["Link title", "base on src directory, src beginning of character, .md file path(support external link)"],
["Home", "src/index.md"],
["XXX page", "src/sub/XXX.md"],
]
GitHub: https://github.com/wuyumin/easydoc Welcome star it
Suggest or help us to improve: submit an issue to us or pull request to us.
Welcome to provide "Who Use EasyDoc".