Typora+Gitbook写作

Typora是一款Markdown文本编辑器,跨平台并且免费。而且很好用。

Gitbook可以将md文件转成html文件,读者可以很方便的通过浏览器进行浏览。

由于Gitbook是基于node的,所以先来下载node,推荐版本为6.14.1,为了兼容gitbook 2.6.7版本。因为gitbook高版本生成的html必须要先开启一个服务(如apache,nginx等)将html部署到服务上,然后才能正常浏览。否则会提示跨域错误。推荐gitbook版本为2.6.7。

image-20191228164759455

为了解决node版本问题,这里不推荐直接安装node环境(如果以后只用一个版本的话),如果是linux环境,则没有这个困扰,可以通过安装n版本管理工具解决版本切换的问题。而window与n不兼容,则需要安装另一个版本管理工具->nvm,这个工具必须先安装,然后通过nvm安装不同的node版本。

关于n版本管理工具使用可自行百度,这里主要介绍window

nvm -> node的版本管理工具

先安装nvm,nvm也有window和linux版本,注意下载window版本的,

https://github.com/coreybutler/nvm-windows

下载完成并安装,通过nvm下载node,如果下载速度太慢,请切换镜像源

进入到nvm安装目录,比如我的D:\Users\dagger\AppData\Roaming\nvm,修改settings.txt文件,添加

node_mirror: https://npm.taobao.org/mirrors/node/
npm_mirror: https://npm.taobao.org/mirrors/npm/

重新打开控制台安装想要的node版本。

安装成功之后通过nvm ls可查看所有已安装的node版本,其中前缀有号标注的是当前版本。通过nvm use 版本号*即可切换到想要的node版本了。

nvm use 6.14.1

gitbook使用

安装gitbook-cli

npm i -g gitbook-cli

初始化目录并安装gitbook,指定安装的版本为2.6.7

gitbook init --gitbook=2.6.7

初始化成功后,会发现当前目录下多了两个文件README.mdSUMMARY.md

README.md是介绍内容,也就是一本书的介绍,在第一页,一打开就能看到

SUMMARY.md是书的目录,可以自定义书的目录结构

查看已安装gitbook的版本

gitbook ls

构建图书,在当前目录生成_book目录,里面的index.html就是书的入口

gitbook build
或者指定gitbook的版本号
gitbook build --gitbook=2.6.7

开启gitbook本地服务,如果不指定端口,默认是4000端口,通过localhost:4000即可访问

gitbook serve

目录编辑

编辑目录,我们希望html页面左侧能生成目录信息,通过点击来完成对右侧内容的跳转

修改SUMMARY.md

如果想要修改目录上Introduction文字,通过修改指向README.md的链接就行了。如下

* [介绍](README.md)

目录示例

* [介绍](README.md)
* 标题一
  * [1.1](1.1.md)
  * [1.2](1.2.md)
* 标题二
  * [2.1](2.1.md)
  * [2.2](2.2.md)

[]中是显示的文字信息,()中是链接。后面再跟上#,#后面的内容就是锚点,可以跳转到页面上某一个位子,不过我测试的时候有一些bug,比如,同一个页面有两个锚点,但是只能跳转一次。

也可以用/来分隔目录,如果有多级目录的话可以通过[文件1](a/b/1.md)这样来指定

typora显示结果,其实就是无序列表

image-20191228172341144

参考:https://blog.csdn.net/jss19940414/article/details/86577645

posted @ 2019-12-28 17:52  dagger9527  阅读(911)  评论(0编辑  收藏  举报