Help us understand the problem. What is going on with this article?

Githubのmasterにgitbookを上げる流れ

経緯

  • Githubを使ってドキュメント管理がしたかった。
    • リポジトリ内にてドキュメントのバージョン管理を行う
    • GitHubPagesでその内容が見れるようにしたい
    • gitbookがいい感じなのでそれを使いたい。
  • ブランチを切って、そこにドキュメントを上げることで、GithubPagesにリポジトリ単位でURL指定をすると、見ることができる。
    (例) https://sample.github.io/sampleRepository

    • ブランチを切ってあげなければならない、上げるコマンドが若干複雑(怠惰)
    • Githubにてコードと同じリポジトリ内で、ブランチを切らずにバージョン管理ができないものか。。。

手順

そもそも今は、わざわざbranch切らなくても、masterやmaster/branch選択できるようになった模様。(参考を参照。)
⇒ じゃあそれ使ってみよう!

1. githubにてリポジトリを作成する

=> Githubに新規リポジトリを追加を参照

2. gitbookを作成する

1. リポジトリに移動する

C:>chdir sampleProject

2. "docs"フォルダを作る(これがgitbookをデプロイするフォルダになる)

C:\sampleProject>mkdir docs

3. docsフォルダに移動する

C:\sampleProject>chdir docs

4. gitbookを管理するフォルダを作る

C:\sampleProject\docs>mkdir gitbookFolder

5. gitbookを管理するフォルダに移動する

C:\sampleProject\docs>chdir gitbookFolder

6. gitbookを初期化する

C:\sampleProject\docs\gitbookFolder>gitbook init

7. gitbookをいろいろいじった後、ビルドする(HTMLに変換する)

C:\sampleProject\docs\gitbookFolder>gitbook build

8. _bookフォルダに展開されたHTML、静的ファイルをdocsフォルダ(親フォルダ)にコピーする

C:\sampleProject\docs\gitbookFolder>xcopy _book ..\ /s/e/i

結果こうなる。

C:\sampleProject\docs\gitbookFolder>tree C:\sampleProject /f
C:.
│  index.html
└─docs
    │  index.html
    │  search_index.json
    ├─gitbook
    │  ├─fonts
    │  │  └─fontawesome
    │  ├─gitbook-plugin-fontsettings
    │  ├─gitbook-plugin-highlight
    │  ├─gitbook-plugin-lunr
    │  ├─gitbook-plugin-search
    │  ├─gitbook-plugin-sharing
    │  └─images
    └─gitbookFolder
        │  README.md
        │  SUMMARY.md
        └─_book
            │  index.html
            │  search_index.json
            └─gitbook
                ├─fonts
                │  └─fontawesome
                ├─gitbook-plugin-fontsettings
                ├─gitbook-plugin-highlight
                ├─gitbook-plugin-lunr
                ├─gitbook-plugin-search
                ├─gitbook-plugin-sharing
                └─images

この状態でgitコミット

C:\sampleProject\docs\gitbookFolder>chdir C:\sampleProject
C:\sampleProject>git add *
C:\sampleProject>git commit -m "make gitbook"
C:\sampleProject>git push origin master

3. github側の設定でgitbookの読み取り先を変更する

1. githubでgitbookの読み取り先を設定する
movie.gif

2. 開いてみる。(https://ユーザー名.github.io/リポジトリ名)
スクリーンショット (49).png

4. その後

その後は、7.以降を繰り返せばOK.
※ もっといいフォルダの切り方はあるかもしれないです。その辺は各自の工夫に任せます。(自分的にはこの構成が好きです)

参考

MewW6m
3年目SEです。 Web系を主軸に様々なことに挑戦してます。 メインはQrunchを使ってます。 Qittaには需要のある記事のみ書きます。 よろしくお願いします。
https://meww6m.qrunch.io/
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした