GitBook入门(用github做出第一本书)——超详细配图说明

我最近接触到gitbook,发现它支持markdown和git,刚好把我之前在github上的笔记可以生成一本书,于是我就开始着手捣鼓gitbook,一下午的时间就弄的差不多了,说明这个东西还是挺容易的,可以看看我的书:
《LeetBook(LeetCode详解)》

比较建议直接在github上部署你的框架,然后再导入gitbook。

创建一个新的仓库

创建过程不需要我细讲了把,如果不知道,看看github入门

创建一个新文件,名为SUMMARY.md,里面填入:

# Summary
* [前言](README.md)

创建一本书

首先进入gitbook的官网:https://www.gitbook.com/

点红色部分,用github登录

登录之后,点+NewBook

点到github,点击Link to your Github

授权完毕然后再点到这个页面

选择你需要导入的仓库,我们用刚才创建的testbook,然后标题可以自己取,下面的地址只能填英文,然后点创建

这个页面目前是在同步,等同步完毕后,就可以看到自己的书了。

可以点击read

可以发现里面就1页,就是我们刚才SUMMARY.md写的内容

增加内容

我们退回上一步,点edit

可以看到如下界面

我们点开

可以同步显示编辑后的效果

现在我们就可以完成我们的书的录入了,在目录区点击右键,可以新建一个内容页

然后点击一下,会提示创建一个文件

然后你会发现在github上也多了一个文件,这就关联起来了。

我们再看SUMMARY里面多了一个“第一页”

我们双击一下,发现就是markdown的超链接,原来这就是gitbook的内容组织方式,通过超连接把内容和github上文件关联起来。

我们修改一下名字,然后把他缩进一个tab,保存看看有什么变化

可以发现目录结构变了,然后名字也变了

通过修改SUMMARY.md你可以轻松的组织你的书

书的框架

一般来说,你的书得有一个README.md和一个SUMMARY.md。
其中SUMMARY.md是最重要的,它代表了整个书的框架,也是我们主要需要修改的地方。

当你考虑好要写一本书,你可以先粗略的想好大概要分几部分,对这几部分弄一个文件夹。然后把对应的markdown文件放进去。

然后push到github上,然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook关联

关于地址的获取有个小诀窍,就是点击文件,邮件,有个重命名,这里可以看到文件的完整地址,复制就好。

最后,可以在自己的书的主页点击read看看效果

  • 28
    点赞
  • 101
    收藏
    觉得还不错? 一键收藏
  • 13
    评论
### 回答1: 好的,下面是具体的步骤: 1. 在公司的电脑上安装 Git,可以到官网下载安装包进行安装。 2. 在公司的 GitHub 账号中创建一个 SSH Key,用于身份验证。可以按照 GitHub 的指南进行操作。 3. 在公司的电脑上设置 Git 的全局配置,包括用户名和邮箱等。可以在 Git Bash 中输入以下两行命令: ``` git config --global user.name "Your Name" git config --global user.email "youremail@example.com" ``` 4. 在 GitHub 上找到需要拉取的项目,复制项目的 SSH 或 HTTPS 地址。 5. 打开 Git Bash,进入要存放项目的文件夹,使用 `git clone` 命令将项目克隆到本地,如下所示: ``` cd /path/to/folder git clone git@github.com:username/repository.git ``` 或者 ``` cd /path/to/folder git clone https://github.com/username/repository.git ``` 如果是第一次使用 Git,可能需要输入 GitHub 的用户名和密码。 6. 如果项目中有依赖库需要安装,可以使用项目中提供的依赖管理工具进行安装,比如 Maven、Gradle 等。具体的安装方法可以参考项目的 README 文件。 到此为止,你就已经成功将 GitHub 上的项目拉取到了公司的电脑上。 ### 回答2: 第一次去公司拉取GitHub项目,需要进行以下步骤: 1. 确保你已经安装了Git工具:在本地计算机上安装Git,可以从Git官网(https://git-scm.com/downloads)下载适合你操作系统的版本并进行安装。 2. 创建GitHub账号:如果没有GitHub账号,就需要在GitHub官网(https://github.com)进行注册创建一个账号。 3. 获取项目URL:进入公司的GitHub项目页面,找到"Clone or download"按钮并点击,复制项目的URL(以HTTPS形式)。 4. 打开Git Bash(或其他终端工具):在本地计算机上找到Git Bash(或其他终端工具)并打开。 5. 设置Git全局配置:首次使用Git,需要进行全局配置,输入以下命令并回车: ``` git config --global user.name "Your Name" git config --global user.email "yourname@example.com" ``` 将"Your Name"替换为你的GitHub用户名,"yourname@example.com"替换为你的GitHub邮箱地址。 6. 克隆项目:在Git Bash终端中输入以下命令并回车,将公司的GitHub项目克隆到本地: ``` git clone 项目的URL ``` 将"项目的URL"替换为第3步中复制的项目URL。 7. 导航到项目文件夹:使用CD命令在Git Bash中导航到克隆下来的项目文件夹中: ``` cd 项目文件夹路径 ``` 将"项目文件夹路径"替换为实际克隆下来的项目文件夹路径。 8. 拉取最新代码:在Git Bash中输入以下命令并回车,拉取最新的代码: ``` git pull origin 分支名 ``` 将"分支名"替换为你想要拉取代码的分支。 现在你已经成功地将公司的GitHub项目克隆到本地,并拉取了最新代码。你可以进行下一步的开发工作,或者使用其他Git命令进行代码管理。 ### 回答3: 第一次去公司拉取GitHub项目的步骤如下: 1. 安装Git:首先确保在你的机器上已经安装了Git工具。你可以在Git官方网站上下载合适的版本并完成安装。 2. 注册GitHub账号:如果你还没有GitHub账号,访问GitHub官方网站并注册一个。 3. 配置Git:在你的本地Git工具中,打开终端或命令行窗口,并配置全局用户信息。通过以下命令设置你的用户名和邮箱地址: ``` $ git config --global user.name "Your Name" $ git config --global user.email "youremail@example.com" ``` 4. 克隆项目:在公司的GitHub项目页面中,找到要克隆的项目,点击右上角的“Clone or download”按钮,并复制其中的项目URL。 5. 在本地目录中克隆项目:在终端或命令行窗口中,使用以下命令在你的本地目录中克隆项目: ``` $ git clone <项目URL> ``` 将`<项目URL>`替换为实际的项目URL。 6. 进入项目目录:使用以下命令进入克隆下来的项目目录: ``` $ cd <项目目录> ``` 将`<项目目录>`替换为实际项目克隆下来的目录。 7. 查看分支:使用以下命令查看项目的分支: ``` $ git branch ``` 你会看到所有可用的分支列表。 8. 切换分支:使用以下命令切换到你想要的分支: ``` $ git checkout <分支名> ``` 将`<分支名>`替换为你想要切换到的分支名。 9. 拉取最新代码:使用以下命令从远程仓库拉取最新的代码: ``` $ git pull ``` 现在你已经成功地拉取了公司GitHub项目,并可以开始开发或者进行其他操作了。如果你需要进行更改或提交代码,可以在完成相应步骤后使用Git的相关命令来实现。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 13
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值