Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
27
Help us understand the problem. What is going on with this article?
@kwappa

GitHub PagesのUser Pagesでドキュメントルートを変更するにはmasterを殺す

More than 3 years have passed since last update.

TL;DR

GitHub PagesのUser Pages(#{username}.github.ioとかになるやつ)はリポジトリ直下がドキュメントルートになる。

サブディレクトリ(/docsとか)をドキュメントルートにするには…

  • masterから別のブランチ(例:source)を作ってリモートにpushしておく
    • git push origin source
  • リポジトリのSettings->Branches->Default Branchessourceに変更する Branches.png
  • masterブランチをリモートから削除する
    • git push -f --delete origin master
  • ドキュメントルートにしたいディレクトリ(例 : /docs)をsubtreeとしてmasterという名前でpushする
    • git subtree push --prefix docs/ origin master

これでhttp(s)://#{username}.github.ioにアクセスすると/docs/index.htmlが表示される。

参考資料

GitHub PagesにはUser & Organization PagesとProject Pagesの2種類がある。Project Pagesはgh-pagesというブランチか/docs以下をドキュメントルートにする「Source」という設定ができたのだが、User & Organization Pagesではmasterのルート直下しか選べない。

「Source」が設定できるようになる前はgh-pagesというブランチを用意するしかなかったのだが、これもルート直下がドキュメントルートになってしまう。master/docsをsubtreeとしてpushする、というテクニックが以前から使われていたので、それをmasterとして使ってみたというわけ。

27
Help us understand the problem. What is going on with this article?
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
kwappa
Ruby programmer

Comments

No comments
Sign up for free and join this conversation.
Sign Up
If you already have a Qiita account Login
27
Help us understand the problem. What is going on with this article?