@m-fe/docsify-x

docsify-tools

Quickly document your (typescript or otherwise) projects!

• docsify-init provides a client-side Docsify based markdown documentation site with full text search
• generate-ts-doc generates markdown documentation from api-extractor api.json files
• docsify-auto-sidebar automatically populates the sidebar from the resulting docs tree

本项目是对 docsify-tools 的定制化升级，包括支持 .index 文件默认排序、默认隐藏 examples 目录等。

docsify-init

Usage:

docsify-init [-r repoDir] [-d docsDir]

npm run ts src/docsify-sync-to-hugo.ts --src /Users/zhangzixiong/Desktop/Docs/Business/Industry-Series --target /Users/zhangzixiong/Desktop/Workspace/Github/ngte/seo-markdown-blog-site/hugo/content/books

Initializes docsify in the specified repo and docs sub-directory. By default, the repo is the current directory and the subdirectory is "docs".

You can use docsify-init -r . -d . to initialize in a pure-documentation repo.

docsify-auto-sidebar

Usage:

docsify-auto-sidebar -d docs

Generates a new _sidebar.md for docsify. You can prefix directories with a number and a dash to control the ordering, the number and dash will not appear in the sidebar text. For example:

1-Guides
2-API

will result with "Guides" and "API" items in the sidebar. Other dashes will be replaced with spaces

generate-ts-doc

Like api-documenter, but it doesn't generate separate files for methods or properties. Create. the .api.json files in a directory (e.g. in docs/2-API) and then run it:

generate-ts-doc markdown -i docs/2-API -o docs/2-API

Notes

Don't forget to setup your repo so that github generates a documentation site