RDoc帮助你生成静态网站，你只须要写Markdown

时间 2019-11-17

标签 rdoc 帮助生成静态网站只须 markdown 栏目网站开发繁體版

原文原文链接

RDoc 是一个文档生成工具，用于生成文档网站或简单的博客网站。简单到你只需写 Markdown 文件就能够帮助你生成网站。同时能够方便的集成到你的项目工程中。react

下图官方网站，是 rdoc 生成的：git

基于React的快速静态站点生成器，只需编写Markdown文件便可。访问react-doc.github.io网站获取更多信息。github

快速开始

在您的系统上全局安装rdoc。须要在本地开发机器上具备Node> = 8。您可使用 n 来轻松切换不一样项目之间的Node版本。npm

全局安装

npm install rdoc -g
复制代码

初始化网站

rdoc init my-project  # Init project
复制代码

运行网站

cd my-project && npm start # Into the directory, start the service.


## Compiled successfully!

## You can now view doc-example in the browser.

## Local: http://localhost:5858/
## On Your Network: http://192.168.188.109:5858/

## Note that the development build is not optimized.
## To create a production build, use npm run build.
复制代码

编译生成HTML

npm run build
复制代码

修改部署配置

在 package.json 中配置部署URLjson

{
  "scripts": {
    "deploy": "rdoc --publish <您的GitHub仓库地址>"
    ...
  },
  ...
}
复制代码

例如：bash

{
  "scripts": {
    "deploy": "rdoc --publish https://github.com/react-doc/react-doc.github.io.git --branch master"
    ...
  },
  ...
}
复制代码

上面 deploy 实例，将当前工程生成的静态 push 到 https://github.com/react-doc/react-doc.github.io.git 仓库的 master 分支中。工具

--branch master 参数指定分支，默认没有这个参数，推向指定网站的 gh-pages 分支。

部署网站

npm run deploy
复制代码

恭喜你，你已经生成了一个网站。😆网站