Crude-docs NPM

crude-docs

一个简单的文档生成器. 通过一些简单的配置和命令, 便可以进行文档写作和生成你的今天文档网站.

crude-docs 是一个合法的 npm 包. 在工作之初, 大多时候你不需要手动安装 crude-docs;

我发布了另外一个工具: crude-docs-init :sunny::sunny:. 你可以用它来生成你的 crude-docs 项目:

使用 yarn:

# 在全局安装 crude-docs-init
yarn global add crude-docs-init
# 使用 crude-docs-init 生成项目
# my-doc 是你项目的名字, 你可以自己命名
crude-docs-init my-doc

或使用 npm:

# 在全局安装 crude-docs-init
npm i -g crude-docs-init
# 使用 crude-docs-init 生成项目
# my-doc 是你项目的名字, 你可以自己命名
crude-docs-init my-doc

一旦你使用了 crude-docs-init 初始化了一个项目, 便会帮你自动安装 crude-docs, 并且我已经为你进行了一些模板配置, 你可以直接在上面进行修改和继续工作.

如果你还没有安装crude-docs-init , 你应该先安装 crude-docs-init, 并生成一个 crude-docs 项目.

...待更新:frowning::frowning:

如果你在全局安装了 crude-docs, 那么你可以直接在 CMD 使用 crude 命令.

如果只在项目里安装了 crude-docs, 那么你应该在 npm scripts 里使用 crude 命令.

crude -h: 查看可用的命令

crude start: 开始在你的 markdown 上编写内容, 并在浏览器查看结果.

crude build: 生成你的静态网站, 文件会输出在项目的 dist/ 文件夹下.

crude preview: 生成你的今天网站, 并打开浏览器预览. 如果觉得没问题, 可直接使用 dist/ 下的文件部署.

...待更新:frowning::frowning:

在编写 markdown 的时候, 需要使用预定义的格式, 以便解析元数据.

...待更新:frowning::frowning: