gitbook入门指南

曾经用过gitbook搭建blog

[toc]

Gitbook

说明

本项目是由typora+picGo+AliyunOSS+Gitbook+github pages构建起来的。

安装

安装gitbook

1
npm install gitbook -g

安装完成后使用时会出现某个函数错误问题,原因是gitbook依赖的包未更更新,STFW即可

使用

cd到欲创建gitbook的目录

1
gitbook init

完成后,编写readme.md文件以及summary.md文件。其中,本项目现在的summary.md如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Summary

- [Introduction](README.md)
- [System](system/README.md)
- [Stack](system/stack.md)
- [Format String](system/format_string.md)
- [Heap](system/heap.md)
- [ELF](system/ELF.md)
- [unsorted_bin](system/system_常用操作.md)

- [AI](ai/README.md)
- [pandas](ai/pandas.md)
- [pytorch](ai/pytorch.md)
- [unsorted_bin](ai/thing.md)

- [unsorted_notes](unsortedbin/README.md)
- [Frequent operations](unsortedbin/常用操作.md)
- [docker](unsortedbin/docker使用.md)
- [vim](unsortedbin/vim.md)
- [gitbook](unsortedbin/gitbook.md)

之后,进行每一次修改需要重新build。可以添加两个参数来分别指定md存放的目录以及gitbook生成的目录。

1
2
gitbook build # 默认
gitbook build . /docs # 将gitbook输出到docs目录而不是默认的/_books目录

若欲本地部署,则:

1
gitbook serve

由于本项目使用github pages,因此:

1
2
3
git add .
git commit -m ""
git push origin main

gitbook入门指南
http://example.com/2023/08/18/工具使用/gitbook/
作者
Ltfall
发布于
2023年8月18日
许可协议