首页 文章

使用GitHub页面时了解Jekyll和gh-pages分支

提问于
浏览
2

我正在使用Jekyll和GitHub页面(特别是项目页面) . 我创建了2个分支:

  • master

  • gh-pages

documentation解释说网站内容存储在 gh-pages 分支中,该内容将由Jekyll呈现 . 输出将在诸如username.github.io/project-name之类的URL中提供 .

如果我在本地 master 分支中运行 jekyll new mysite ,则会在该分支中创建_config.yml,_posts,_sites等 . 此时,如果我运行 jekyll serve ,我可以在localhost:4000看到一个基本站点(这很棒) .

My question:

考虑到我目前在我的 master 分支中的内容似乎正在起作用, gh-pages 分支的目的是什么?究竟应该包含在a) master 分支和b) gh-pages 分支中?

提前致谢 .

2 回答

  • 4

    阅读Github pages documentation

    如果您想推送代码并让Github生成您的网站:

    您只需要对代码进行版本控制,而不是生成的页面版本 . 因此,只需要一个分支 .

    • 对于用户/组织Github页面( github.com/username/username.github.io ),您在 master 中发布代码 .

    • 对于项目页面( github.com/username/projectRepository ),您在 gh-pages 中发布代码 . 在这里,您不需要 master 分支 .

    如果您需要在本地生成您的站点,只在Github上发送生成的页面:

    您需要对代码和生成的页面进行版本控制 . 因此,需要两个分支机构 .

    • User/organisation repository:基本代码进入 code (或任何你命名的)分支,生成的页面进入 master .

    • Project repository:基本代码进入 master (或任何你命名的)分支,生成的页面进入 gh-pages .

  • 0

    如github gh-pages中所述:

    滚动香草,或为您的项目生成一个站点以快速入门 .

    gh-pages 只是一个github特定分支,允许您将其用作您的网站 .

    这意味着如果您在此页面中有 index.html ,则可以直接在浏览器中查看它 .

    你这个链接格式: username.github.io/project_name

    更多信息可以在这里找到:https://pages.github.com/

相关问题