使用 github, gitbook, markdown 写博客/写书

Github 是基于开源代码管理工具 Git 的一个代码托管平台。Gitbook 是一个命令行工具，可以把你的 Markdown 文件汇集成电子书，并提供PDF等多种格式输出。你可以把Gitbook 生成的HTML发布出来，就形成了一个简单的静态网站。Gitbook还有一个同名的平台（gitbook.io），可以发布和销售电子书。Gitbook 其实跟 Git/Github 没啥关系，但可以通过绑定Github 的项目而达到 push Github 时同时更新到 gitbook.io 的效果。

首先我们需要有个域名，比如之前随手买的一个 fxnotes.net，我们在域名提供商比如 godaddy 上面设置下 DNS 解析服务器，比如设置为国内的 dnspod：f1g1ns1.dnspod.net f1g1ns2.dnspod.net 。

有了域名我们还需要个ip（主机存储空间），如果购买国内云服务器提供商的主机，我们需要做域名备案，很是麻烦（或者买个vps）。对此可以把域名解析到 xxx.github.io（xxx 为 Github 用户名），当然目录就只能存一些静态 HTML 文件了。

现在我们到了 dnspod 控制台，如下图配置，将 www cname 到 xxx.github.io，且设置两条 A 记录到 Github 提供的 ip 上：

此时我们通过浏览器访问 fxnotes.net 会直接访问到 github.io 对应的某台服务器上面去，但Github 还不存在对应的项目，故建立一个 xxx.github.io 的 repo，在 repo 下建一个文件名为 cname 的文件，写上 fxnotes.net，并随便建一个 index.html 写几个字，访问一下，是不是看到了那几个字？

进一步地，如果我们将搭建一个博客站点，可以使用 jelly or hexo 等博客模版，然后将写好的 markdown 格式文件 push 到 xxx.github.io 某目录

下，这样就可以访问静态博客页面了。

如果我们想写开源书籍呢？也是类似的，只不过不用搭建博客模版，但需要借助下 gitbook 工具。

比如我们在 github 上建一个 repo WebSecurityLearning，里面分目录，且按 gitbook 的要求写一个 SUMMARY.md，包含了书目即章节结构，大致格

式如下：

SUMMARY.md

This is the summary of my book
* Overview* [overview](Overview/overview.md)
* XSS* [xss](XSS/xss.md)
* SQLI* [sqli](SQLI/SQLI.md)

接着用 gitbook 生成书籍，需要安装下 gitbook（使用 npm 安装需要先安装 nodejs）。

$ npm install gitbook -g

$ npm install gitbook-cli -g

把 repo clone 到本地，gitbook build WebSecurityLearning，会发现目录下多了个 _book 目录，里面就是编译好的书，可以将

_book 改名为 websec，然后将整个目录 push 到 xxx.github.io 目录下，直接访问 fxnotes.net/websec，其中 Introduction 编译自 README.md，而目

录当然是来自 SUMMARY.md 了，如下所示：

这样我们就能在本地写 markdown 文件，然后 push 到 github 做版本维护，用 gitbook 编译目录，替换站点目录，更新书籍，

还算是比较方便的。无论写博客还是写文章，如果需要引用图片，需要外链，推荐用七牛云存储来上传本地图片做外链。

注：本文不涉及详细流程、设置和命令，只为大家提供个思路索引，具体动手做一遍就清晰了。

使用 github, gitbook, markdown 写博客/写书相关推荐

如何使用Markdown写博客
使用 Markdown + MathJax 在博客里插入数学公式 https://blog.csdn.net/kamidox/article/details/48380239 如何使用Markdown ...
无需上网，离线也能用Markdown写博客
无需上网,离线也能用Markdown写博客这里就讲一下如何使用一款名为"MarkdownPad"的Markdown编辑器离线写博客.有关下载安装的细节请参考Markdown编 ...
如何使用CSDN中的Markdown写博客——纯小白篇
这篇博客用来学习如何使用CSDN中的Markdown写博客在写这篇博客前,我找了很多教程,摸索了很长时间才会用这东西写博客,现在写一个教程方便像我一样的纯小白学习如何用这个Makedown写博客. ...
markdown写博客工具
最近选择使用markdown写博客,markdown应类似于简化版的html,写东西比较方便,简单罗列一下使用到的工具: 1. markdown编辑器使用cmd markdown,有对应的客户端,有 ...
csdn markdown写博客技巧
markdown写博客技巧二.markdown常用的html代码: 1. 字体颜色大小,背景颜色 2. 空格 3. 标号.(tab)缩进一.高级Markdown技巧学习网站: 二.markdown ...
如何优雅的使用markdown写博客--微博图床使用说明
一: 我的理想我一直有一个理想, 写博客就舒心的去写, 然后能够在知乎, 简书, csdn, 科学网上任意复制, 这是多么快意的人生. Markdown的出现, 满足了我90%的需求, 一个痛点就是 ...
用markdown写博客，看这篇就够了
文章目录开篇[^标题] 工具正文结尾备注开篇1 点这里可以看到本文的"源代码".用markd写东西,特别是写博客好处有很多,比如一旦熟悉常用的语法后,可以很方便的控制格式 ...
html编辑器知乎,科学网—如何优雅的使用markdown写博客--微博图床使用说明 - 邓飞的博文...
一: 我的理想我一直有一个理想, 写博客就舒心的去写, 然后能够在知乎, 简书, csdn, 科学网上任意复制, 这是多么快意的人生. Markdown的出现, 满足了我90%的需求, 一个痛点就是 ...
博客园cnblog用Markdown写博客的过程如何图片居中、添加缩进
刚开始写博客,对Markdown语法不熟悉,HTML也快全忘了.记录一下. 一.博客园插入图片(复制之后直接粘贴,而非上传的方式) 正常是这么显示的![](图片链接),这种形式没有办法进行图片居中或 ...

使用 github, gitbook, markdown 写博客/写书

使用 github, gitbook, markdown 写博客/写书相关推荐

最新文章

热门文章