11 September 2015

现在写文档,记笔记,已经全面转到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 




Fork me on GitHub