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