9 Star 31 Fork 7

小弟调调 / rdoc

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

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)

空文件

简介

RDoc 是一个文档生成工具,用于生成文档网站或简单的博客网站,简单到你只需写 Markdown 文件就可以帮助你生成网站,同时可以方便的集成到你的项目工程中。 展开 收起
JavaScript
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/jaywcjlove/rdoc.git
git@gitee.com:jaywcjlove/rdoc.git
jaywcjlove
rdoc
rdoc
master

搜索帮助