Typera+Node.js+Git搭建托管于远端的写作平台(GitBook)(上)

简介: Typera+Node.js+Git搭建托管于远端的写作平台(GitBook)(上)

0x00 文章内容


  1. 环境准备
  2. GitBook闪亮登场

一直在寻找一个比较良好的MarkDown写作平台,几乎把市面上所有的产品都试过了,但还是决定这样解决,原因如下:

Typera是一个非常不错的MarkDown编辑器,但是复制到它上面的图片只能存放在本地,无法同步到云端,如果需要将你的MarkDown文本复制到其他平台,则需要将图片一一复制一遍,过程非常繁琐。

想要一个随时随地都可以远程开发的环境

主要的问题就是:真的有点复杂!


0x01 环境准备


1. Typera

a. 下载与安装(=> 链接跳转

b. 配置,因为要配置到Git,所以准备将图片配置成保存在assets文件夹,这样比较方便以后利用

image.png


2. Node.js

a. 请参考文章:

3. Git

a. Git的安装与配置(Mac版本)=> 链接跳转


0x02 GitBook闪亮登场


1. 安装GitBook

a. 全局安装GitBook(可以去看一下目录里有没有下载到东西)

npm install -g gitbook-cli

image.png


解释:Node.js默认安装了npm(node包管理工具),此处不用单独安装npm,执行以下命令安装GitBook。


2. 初始化GitBook

a. 新建一个文件夹,作为一本笔记本的主目录,之后将会有一篇又一篇的文章,此处我的文件夹为:test-book

mkdir test-book


image.png


b. 接着初始化GitBook,进入test-book文件夹,执行:

gitbook init


image.png


遇到问题:此时可能会遇到问题,一直卡在这里。

需要注意的点

  1. 注意cmd命令行要使用“管理员身份打开”,提升其管理员权限。


image.png


查资料说版本问题,于是我卸载了默认的3.2.3的版本:

gitbook uninstall 3.2.3

如果提示不需要卸载,则不管。

下载一个3.0.0版本:

gitbook fetch 3.0.0


image.png


等了几分钟之后,就提示安装完成了,此时再重新初始化就可以了:

gitbook init


image.png


解释:完成后,test-book文件夹下会多了两个文件 =>

README.md:书籍的介绍可写在此文件中

SUMMARY.md:书籍的目录结构可写在此文件中


image.png


3. 生产GitBook目录结构

a. 编辑SUMMARY.md文件,此时就可以使用Typora了,将内容修改为:


# 目录
* [前言](README.md)
* [第一章 全栈工程师之路](全栈工程师之路/README.md)
  * [第1节 前端](全栈工程师之路/前端.md)
  * [第2节 后端](全栈工程师之路/后端.md)
  * [第3节 运维](全栈工程师之路/运维.md)
  * [第4节 UI设计](全栈工程师之路/UI设计.md)
* [第二章 大数据](大数据/README.md)
* [第三章 云计算](云计算/README.md)
* [第四章 人工智能](人工智能/README.md)


b. 接着生成目录结构,在test-book文件夹中再次执行命令:

gitbook init

image.png



相关文章
|
1月前
|
存储 JavaScript 前端开发
基于 JavaScript/VuePress 搭建的远程工作平台:YuanCheng.works
为了提高团队的协作效率和信息共享能力,许多公司开始探索基于现代技术的远程工作平台。本文将介绍如何利用 JavaScript 和 VuePress 搭建一个高效的远程工作平台,助力团队在灵活的工作环境中实现卓越的协作。
115 56
|
3月前
|
Java Shell 开发工具
git集成IDEA,托管项目实现版本管理
git集成IDEA,托管项目实现版本管理
46 0
|
4月前
|
C++ Windows
HTML+JavaScript构建C++类代码一键转换MASM32代码平台
HTML+JavaScript构建C++类代码一键转换MASM32代码平台
|
5月前
|
JavaScript 前端开发 API
【独家揭秘】如何从零开始,用Vue.js打造你的专属电商平台?
【8月更文挑战第30天】本教程将指导你使用Vue.js及其生态,包括Element UI,从零开始构建一个具备首页、商品列表、详情页、购物车及登录注册功能的基础电商平台前端。通过实践,你不仅将学会构建完整的Web应用,还将掌握Vue.js的高级特性和多种实用插件的使用方法,逐步提升应用的功能并优化用户体验。
114 0
|
5月前
|
存储 Linux Shell
使用Git LFS托管大文件
使用Git LFS托管大文件
|
5月前
|
JavaScript 前端开发 数据安全/隐私保护
空气质量在线监测平台JS逆向:请求响应数据加密
空气质量在线监测平台JS逆向:请求响应数据加密
71 0
|
6月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的宠物交易平台附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的宠物交易平台附带文章源码部署视频讲解等
90 4
|
6月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的家政平台附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的家政平台附带文章源码部署视频讲解等
81 3
|
6月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的华为数码商城交易平台附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的华为数码商城交易平台附带文章源码部署视频讲解等
48 2
|
6月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的家装一体化平台附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的家装一体化平台附带文章源码部署视频讲解等
47 2