手把手教你GitBook使用(四)

简介: 详细的记录了一步步搭建自己的电子文档笔记

3.4 查看帮助


1.png3.5 发布

可以使用 Github Pages 服务将我们写的 gitbook 发布到互联网上,前提是你已经了解了 Git、Github 及 Github Pages 的使用。

3.5.1 发布到 Github Pages


1. 将静态网站直接发布到 Github Pages

可以将编写好的 .md 文件通过 Gitbook 处理成静态网站,然后发布到Github Pages 上。


这个参考这个:[https://www.yuque.com/docs/share/9afacf4e-005e-4c5e-8373-a81af2940a68?# 《利用 GitHub 从零开始搭建一个博客》](https://www.yuque.com/docs/share/9afacf4e-005e-4c5e-8373-a81af2940a68?# 《利用 GitHub 从零开始搭建一个博客》)


3.5.2 使用项目的 Pages 服务

除了上面的直接发布静态文件到 Github Pages 的方法以外,还可以使用一个单独的项目的 Github Pages 功能。


1. 创建仓库与分支

登陆到 Github,创建一个新的仓库,名称我们就命名为 book ,这样我就得到一个 book 仓库。(创建的时候小白推荐选上 README.md 初始化)

克隆仓库到本地: git clone git@github.com:/USER_NAME/book.git

创建一个新分支: git checkout -b gh-pages,注意,分支名必须为 gh-pages 。

将分支 push 到仓库: git push -u origin gh-pages。

切换到主分支:git checkout main。

经过这一步处理,我们已经创建了 gh-pages 分支了,有了这个分支,Github会自动为你分配一个网址。


http://USERNAME.github.io/book


同步静态网站代码到分支:


下面我们就可以将 build 好的静态网站代码同步到 gh-pages 分支中去了。


把 build 成功的文件复制到 book 本地的 book 文件夹中。


1.切换 git 分支

2.png

我的实际操作:

3.png

接下来,输入下面的一系列命令:

4.png

然后,等十来分钟后,你就可以访问到你的在线图书了。以后,只要你每次修改之后,将生成静态网站 Copy 到 book 目录,然后运行上面三条命令一下就 OK 了。

目录
相关文章
|
8月前
|
机器学习/深度学习 人工智能 自然语言处理
DeepRant:一款专为国际游戏玩家设计的翻译工具,一键翻译聊天对话,无需切出游戏
专为游戏玩家设计的多语言快捷翻译工具,支持多种翻译模式和主流语言,基于Tauri和React开发。
481 12
DeepRant:一款专为国际游戏玩家设计的翻译工具,一键翻译聊天对话,无需切出游戏
|
JavaScript
文档工具GitBook使用指南
这篇博客提供了GitBook的安装和使用指南,包括如何在本地安装Node.js和GitBook、初始化GitBook项目、生成HTML和电子书格式(PDF、mobi)的文档,以及推荐的相关阅读资源。
534 8
文档工具GitBook使用指南
|
12月前
|
存储 安全 云计算
云计算核心概念与关键技术简介
本文介绍了云计算的基本概念、技术基础、服务模式(IaaS、PaaS、SaaS)及其关键技术,如虚拟化、容器技术、云存储和多租户管理等。云计算通过按需付费、灵活扩展、高可用性等特点,显著降低了企业的IT成本,加速了业务创新,推动了各行各业的智能化转型。
3181 0
|
Java
掌握Java 17的利器:Switch语句升级,模式匹配闪耀登场
掌握Java 17的利器:Switch语句升级,模式匹配闪耀登场
239 0
|
Shell Linux Windows
忘掉Iterm2,试试这款跨平台终端工具
Mac用户最多的用的就是Iterm2了,windows之前因为丑陋的终端也开发了新的终端工具,很神奇的是,很长一段时间里,都没有一款真正好用的能跨平台的终端工具,直到我发现了hyper。无论Windows、Mac、Debian、Fedora还是其他Linux系统,hyper都能支持。
1113 0
忘掉Iterm2,试试这款跨平台终端工具
|
监控 数据挖掘
探索ERP系统的质量管理模块
探索ERP系统的质量管理模块
435 9
|
数据挖掘 数据处理 API
使用TransBigData组件实现个人手机定位功能
使用TransBigData组件实现个人手机定位功能
269 0
|
域名解析 IDE Java
在 Maven 项目中运行 JUnit 5 测试用例
本文为大家演示了如何如何编写JUnit 5测试用例以及在Maven项目中运行JUnit 5测试用例的过程。
3135 0
在 Maven 项目中运行 JUnit 5 测试用例
layui上传组件连续上传同一个文件upload组件无反应
layui上传组件连续上传同一个文件upload组件无反应
620 0
|
存储 缓存 NoSQL
社交网络场景下大规模图存储实践——Facebook TAO
社交网络场景下大规模图存储实践——Facebook TAO
392 0
社交网络场景下大规模图存储实践——Facebook TAO