您的位置:首页 > 其它

gitbook使用手册

2015-11-30 09:46 405 查看
现在写文档,记笔记,已经全面转到markdown了,相信很多小伙伴也一样,markdown的好处不用多说,单单两条,足以独步天下,编写简单(如果你是程序员的话就更觉得得心应手了),看起来漂亮(我说的是将它生成html后)

本文针对使用gitbook将markdown文档生成html做简单说明

安装

首先安装nodejs

windows下载安装即可

linux下,下载后,解压,配置环境变量即可

$>wget https://nodejs.org/dist/v0.12.7/node-v0.12.7-linux-x64.tar.gz $>tar -xvf *.tar.gz
$>vi /etc/profile
export NODE_HOME=/opt/node-v0.12.7-linux-x64
export PATH=$NODE_HOME/bin:$PATH

$>source /etc/profile


安装gitbook

npm install -g gitbook-cli


编辑

使用MarkdownPad编辑即可

生成html

dos进入文档源文件目录的上一级目录,该手册所在目录为source目录,然后输入:

gitbook serve ./source
运行完毕后会生成:_book目录,


发布 ##

将上述_book目录中的内容拷贝至237的/opt/document/references/目录下即可

乱码问题

如果上述_book文件夹下有中文文件,可能会在centos上出现乱码情况,可以使用下面命令进行转码:

/usr/bin/convmv -f gbk -t utf-8 -r --notest /opt/document/references


如果convmv命令不存在,使用下面命令安装:

yum -y install convmv


也可一去我的个人站点 查看

或者,欢迎关注俺的微信订阅号,每天一篇小笔记,每天提高一点点:

公众好:enilu123

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: