gitbook使用手册

来源:互联网 发布:常州瑞声科技 知乎 编辑:程序博客网 时间:2024/04/26 11:57

现在写文档,记笔记,已经全面转到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/profileexport NODE_HOME=/opt/node-v0.12.7-linux-x64export 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
这里写图片描述

0 0
原创粉丝点击