Skip to content

Commit e67f343

Browse files
committed
Add missing questions
1 parent 9ab64d7 commit e67f343

File tree

4 files changed

+54
-2
lines changed

4 files changed

+54
-2
lines changed

SUMMARY.md

+2
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@
3232
* [What is an Access Key?](books/what-is-an-access-key.md)
3333
* [How can I disable/delete an Access Key?](books/how-can-i-disable-access-key.md)
3434
* [Can I use a custom domain for my book?](books/can-i-use-custom-domain.md)
35+
* [How can I use Git to update my book?](books/how-can-i-use-git.md)
3536

3637
### Content & Customization
3738

@@ -40,6 +41,7 @@
4041
* [How can I change the theme?](content/how-can-i-change-theme.md)
4142
* [How can I integrate dynamic content (such as video)?](content/how-can-i-include-dynamic.md)
4243
* [How can I enable a plugin?](content/how-can-i-add-plugin.md)
44+
* [Why are my updates failing to build?](content/why-are-my-updates-failing.md)
4345

4446
### GitHub Integration
4547

books/how-can-i-use-git.md

+47
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
When your book is created on **gitbook.com**, you need to push some content to it. To do so, you can use the online editor or the command line.
2+
3+
If you want to update your book from the command line, you can use [GIT](http://git-scm.com) to push your content:
4+
5+
### GIT Url
6+
7+
Each book is associated with a Git HTTPS url. The ssh protocol is not yet supported on the GitBook's git server.
8+
9+
The format for the git url is:
10+
11+
```
12+
https://git.gitbook.com/{{UserName}}/{{Book}}.git
13+
```
14+
15+
### Authentication
16+
17+
The git server is using your basic GitBook login to authenticate you. When prompted enter your GitBook username and your password (you can also use your API token).
18+
19+
### Saving your credentials
20+
21+
To avoid having to enter your password on each new push, you can add your GitBook credentials to your `~/.netrc` file. Create or append to an existing `~/.netrc` file something like below:
22+
23+
```
24+
machine git.gitbook.com
25+
login USERNAME-or-EMAIL
26+
password API-TOKEN-or-PASSWORD
27+
```
28+
29+
We recommend using your **API TOKEN** for security reasons, you can find it [in your settings under "API"](https://www.gitbook.com/settings#api)
30+
31+
### Create a new repository on the command line
32+
33+
```
34+
touch README.md SUMMARY.md
35+
git init
36+
git add README.md SUMMARY.md
37+
git commit -m "first commit"
38+
git remote add gitbook https://git.gitbook.com/{{UserName}}/{{Book}}.git
39+
git push -u -f gitbook master
40+
```
41+
42+
### Push an existing repository
43+
44+
```
45+
git remote add gitbook https://git.gitbook.com/{{UserName}}/{{Book}}.git
46+
git push -u -f gitbook master
47+
```

content/why-are-my-updates-failing.md

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
Content could fail to updates for multiple reasons: invalid configuration, unstable 3rd party plugins, etc.
2+
3+
Feel free to post an issue on [GitHub](https://github.com/GitbookIO/gitbook/issues) or [Contact us](https://www.gitbook.com/contact). Provide us with as much essential information as possible (url of your failed update, etc).

orgs/what-is-an-organization.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
related:
3-
- what-is-difference.md
4-
- how-can-i-create.md
3+
- orgs/what-is-difference.md
4+
- orgs/how-can-i-create.md
55

66
---
77

0 commit comments

Comments
 (0)