• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

rdoc: RDoc 是一个文档生成工具,用于生成文档网站或简单的博客网站,简单到你只需写 ...

原作者: [db:作者] 来自: 网络 收藏 邀请

rdoc

Join the chat at https://gitter.im/j-rdoc/Lobby jaywcjlove/sb

基于React的快速静态网站生成器,你只需要写 Markdown 文档即可。访问 react-doc.github.io网站获取更多信息。

这个文档网站就是一个 demo 实例。

开始

rdoc 使用非常简单,只需将其它作为模块安装并运行即可创建您的网站。

让我们开始吧!

安装

安装 rdoc 到你系统的全局,您需要在本地开发计算机上使用 Node >= 8。 您可以使用 n 轻松切换不同项目之间的 Node 版本。

npm install rdoc -g# /usr/local/bin/rdoc -> /usr/local/lib/node_modules/rdoc/.bin/rdoc.js# /usr/local/bin/rdoc-cli -> /usr/local/lib/node_modules/rdoc/.bin/rdoc.js

增加了 rdoc-cli 命令来解决 Mac 集成 rdoc 命令冲突。

  1. 初始化项目
rdoc init my-project  # Init project# 或者rdoc-cli init my-project 
  1. 运行网站
cd my-project && npm install # 进入目录安装依赖npm start # 启动服务。
  1. 编译输出静态HTML资源。
npm run build
  1. package.json 中配置部署 URL
{  "scripts": {    "deploy": "rdoc --publish <your repo url>"    ...  },  ...}
  1. 部署到 Github gh-pages 分支。
npm run deploy

命令帮助

Usage: rdoc [options]Fast static site generator for React.Options:  -i, init [path]        创建一个空的网站或重新初始化一个现有网站。  -d, --doc <path>       生成指定其他文档。  -o, --output <path>    将编译的文件写入磁盘目录。(默认:.rdoc-dist)  -p, --port [number]    端口。(默认: 5858)  --host [host]      主机. (默认: 0.0.0.0)  -b, --branch <branch>  <分支>您要推送的分支的名称。(默认:gh-pages)  --publish [url]        将生成的代码,push到指定仓库,已经分支。  --build                创建编译的生产版本。  --clean                删除.cache文件夹。  -h, --help             输出使用帮助文档。Examples:  $ rdoc init  $ rdoc init doc-example  $ rdoc -d doc/mm  $ rdoc -d tutorial,doc  $ rdoc -d tutorial,doc --clean --build  $ rdoc -p 2323  -d doc --clean  $ rdoc --host 0.0.0.0 -d doc --clean  $ rdoc --publish https://<your-git-repo>.git --branch master

开发

获取代码,进入目录,运行自动重载构建,:

$ git clone https://github.com/jaywcjlove/rdoc.git$ cd rdoc     # 进入目录$ npm install # or yarn install

要开发,请运行自重载构建:

# 运行应用程序# 每次代码更改时,自动重新启动应用程序。# 在开发过程中很有用。$ npm run start

打开浏览器并访问 http://localhost:5858

Folders

.├── README.md├── .rdoc-dist├── package.json├── src│   ├── build.js│   ├── commands│   ├── conf│   ├── publish.js│   ├── server.js│   ├── utils│   └── web├── templates│   └── default # 记录静态文件。└── theme    └── default

License

The MIT License (MIT)


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
热门话题
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap