GitBook

越来越多的人想写个人博客或者打算做自媒体,笔者也是一样. 最近在学习如何写博客,分享下创作经历,避免走弯路. 首先在于定位,不同的定位决定了不同的平台.由于笔者分享的大多是技术类博客,所以主战场是各大主流的技术类博客论坛,当然还搭建了自己的官网. 考虑到前期仅仅是分享技术博客,无需购买专门的服务器,因此寻求免费的解决方案. 笔者采用的是 github 搭建个人项目官网,优点是不花一分钱,就能 免费 开启 https 服务,缺点是国内访问速度慢. 下面分为两部分介绍博客的创作平台,一部分是 个人官网 ,另一部分是 第三方平台 . 个人官网 首先注册 github 账号(例如:用户名 snowdreams1006 ),然后新建特定规则的项目(例如:项目名 snowdreams1006.github.io ),最后在项目下创建首页 index.html .现在访问 https://用户名.github.io/ ( https://snowdreams1006.github.io/ )即可. 个人官网的基本流程和特点如下: 利用 gitbook 技术将 markdown 源码文件输出为 html 静态网页. 将项目按照 特定规则 上传到 github 网站公开托管,生成免费网站. 源代码更新后再生成输出文件,然后一起上传到 github ,个人官网自动更新. 项目源码

https://www.gitbook.com/ 我一直用这个平台进行写作。目前有两本电子书可以供大家阅读，分别如下 Office 365 开发入门指南 https://www.gitbook.com/book/chenxizhang/office365devguide 优化网站设计的35条原则和实践 https://www.gitbook.com/book/chenxizhang/speedwebsite/details 它的最大特点就是，可以跟Github天然集成，从名字上面也可以看出这一点。 另外，它还支持直接导出电子书，并且在线版本还提供了与读者互动的功能。 你可以用Markdown这种精简的标记语言进行编写，你也可以通过它提供的Gitbook Editor（提供了更加简单的Markdown编写体验），离线地编辑文档。 我更喜欢直接用Visual Studio Code来编写，搭配markdown paste这个插件，可以实现图片的粘贴，简直太酷了。 最后，如果你想将书籍托管在你自己的网站，则可以利用gitbook的客户端工具来生成网页，甚至直接启动一个网络服务器。 通过npm install –g gitbook-cli 来安装 通过gitbook init来初始化一本书，会自动建立一个readme.md和summary.md文件 Summary文件是必须的

简介 一个神奇的文档网站生成器。 简单而轻便（〜18kB压缩） 没有静态构建的HTML文件 多个主题 快速开始 建议 docsify-cli 全局安装，这有助于本地初始化和预览网站。 npm i docsify-cli -g 初始化 如果在根目录中编写文档 docsify init ./ 写作内容 在之后init完成后，你可以看到在文件列表 ./ 根目录。 index.html 作为入口文件 README.md 作为主页 .nojekyll 防止GitHub页面忽略以下划线开头的文件 您可以轻松更新文档 ./README.md ，当然您可以添加更多页面。 侧边栏 为了有侧边栏，那么你可以创建你自己的 _sidebar.md ： 首先，你需要设置 loadSidebar 为true。详细信息可在配置段落中找到。 <!-- index.html --> <script> window.$docsify = { loadSidebar: true } </script> <script src="//unpkg.com/docsify/lib/docsify.min.js"></script> 创建 _sidebar.md ： <!-- docs/_sidebar.md --> - [Home](/) - [Guide](guide.md) 其他详细配置情参考 官方文档 配置index

gitBook 是一个基于 node.js 的命令行工具,使用 github/git 和 markdown/asciiDoc 构建精美的电子书. gitbook 支持输出静态网页和电子书等多种格式,其中默认输出静态网页格式. gitbook 不仅支持本地构建电子书,而且可以托管在 gitbook 官网上,并享受在线发布和托管图书的便利,完整的文档请参考 gitbook 新版文档(需FQ) 或 gitbook 旧版文档(不需FQ) 适用场景 不仅适用于 软件说明文档 的发布更新,同样适用于 文本文档 的连载更新. 既适合具有一定编程经验的 软件开发从业者 ,也适用于 不满足传统书写 方式的文学创作者. 简而言之, gitbook 可以 条理清晰 地整理出零碎知识,打造专属你自己的 电子书 ,漂亮的主题,丰富的插件让你的知识变得从此与众不同! git + markdown = gitbook ,其中 git 可以管理书籍内容的变更,并将其托管到云端实现团队协作,而 markdown 简洁的语法特点,使得我们不必关心布局排版问题,专注创作,重拾写作乐趣! 如果你还不了解 git 和 markdown 相关知识,赶紧去学习 markdown 快速入门 和 git 入门教程 吧! 先睹为快 gitbook 教程 gitbook 官网 gitbook 文档 参考文档 gitbook 官网(新)

前言：之前我一直使用的是wordpress搭建的博客，由于是在某云搞活动时买的最低配置服务器，而wordpress又需要安装很多组件，网站变得越来越慢。最近发现了Hugo 是 Go 编写的静态网站生成器，速度很快，依赖于 Markdown 文件， 非常适合博客，索性就把之前的全部干掉了。 看了一些帖子，大部分是在本地编辑好，然后转化为html文件扔到Github，然后通过 Github Page的方式访问，我也测了下感觉访问Github还是太慢了，并且最近GIthub也不稳定，所以我就直接在我Linux服务器上部署了，使用个人域名访问还是挺快的。我的博客 本问部署方式是使用Nginx作为Web服务器，代理Hugo和Gitbook的静态网页，通过个人域名访问。 一、部署hugo 在Github上下载Hugo的Release包上传到Linux服务器 $ yum -y install git golang $ mkdir -p /app/hugo_0.74.3 $ tar xf hugo_0.74.3_Linux-64bit.tar.gz -C /app/hugo_0.74.3 $ cp /app/hugo_0.74.3/hugo /usr/local/bin/ $ hugo version Hugo Static Site Generator v0.74.3-DA0437B4

第二题参考博客 https://labuladong.gitbook.io/algo/gao-pin-mian-shi-xi-lie/yi-hang-dai-ma-jie-jue-de-zhi-li-ti 来源： oschina 链接： https://my.oschina.net/u/4411125/blog/4686077

GitBook 是一个基于 Node.js 的命令行工具，可使用 Github /Git 和 Markdown 来制作精美的电子书。 一、官网下载nodejs直接安装 传送门 ，安装完成后如下： 可以看到npm也安装了，此时可以在cmd控制台进行验证（win+r）,输入cmd进入控制台： C:\pc>node - v v8. 11.1 C:\pc>npm - v 5.6. 0 二、安装gitbook 在cmd控制台输入如下命令进行安装： C:\Users\wwwli>npm install gitbook-cli -g C:\Users\wwwli\AppData\Roaming\npm\gitbook -> C:\Users\wwwli\AppData\Roaming\npm\node_modules\gitbook-cli\bin\gitbook.js+ gitbook-cli@2.3.2 added 578 packages from 672 contributors in 251.912s 查看安装的版本： C:\Users\wwwli>gitbook -V CLI version: 2.3.2 GitBook version: 3.2.3 三、安装gitbook editor windows版 官网地址： gitbook editor for windows 备用下载链接