【发布时间】：2021-07-12 23:43:36
【问题描述】：
我正在运行带有 GitHub Desktop 的 Windows 10。我安装了 Jekyll 并尝试创建一个测试博客。
我从以下位置的说明开始：
- 我在 GitHub Desktop 中创建了存储库，并立即将其发布到 Github.com。
- 当我使用 GitHub Desktop 以“在 bash 中打开”时，如上面链接中所述，我被发送到：
E:\codingPractice\DocSourceBlog\DocSourceBlog> - 按照上面链接中的建议，我输入：
E:\codingPractice\DocSourceBlog\DocSourceBlog>mkdir docs
E:\codingPractice\DocSourceBlog\DocSourceBlog>cd docs
E:\codingPractice\DocSourceBlog\DocSourceBlog\docs>git checkout --orphan gh-pages
- 我输入
$ jekyll new .，我得到了
New jekyll site installed in E:/codingPractice/DocSourceBlog/DocSourceBlog/docs.
-
我编辑 gemfile，注释掉“gem jekyll”并将下一行更改为
gem "github-pages", "~> 214", group: :jekyll_plugins通过将当前版本号替换为上述链接的样板。 -
我运行
bundle update和bundle exec jekyll serve和 localhost:4000 显示预期的站点，包括一个示例博客文章，可以通过单击“欢迎 Jekyll！”访问该文章。该示例博客文章的开头是：
你会在你的 _posts 目录中找到这篇文章。继续编辑它并重新构建站点以查看您的更改。您可以通过多种不同方式重建网站，
-
我使用 GitHub Desktop 将更改的文件提交到分支，并将分支发布到 GitHub。
-
我参考以下说明：
-
我去 github.com/longarchivist/DocSourceBlog/settings/pages 并将源设置为“gh-pages”和“docs”
-
我转到https://longarchivist.github.io/DocSourceBlog/ 并看到其中的一些内容，但博客文章似乎没有按预期显示在“欢迎来到 Jekyll！”我点击链接进入
https://longarchivist.github.io/jekyll/update/2021/04/18/welcome-to-jekyll.html
但那有 404 页面。
-
我检查了 github web 界面以确保“_posts”目录在那里。
-
我注意到“Welcome to Jekyll!”的地址。链接是：
http://localhost:4000/jekyll/update/2021/04/18/welcome-to-jekyll.html
我可以推测，当我尝试 bundle exec jekyll serve 时，ruby 以某种方式破坏了正确的 Jekyll 配置，但如果这足以破坏系统，那么文档似乎具有严重的误导性。
- 我尝试编辑配置文件。 “baseurl”变量现在是“/docs”，链接地址是
https://longarchivist.github.io/docs/jekyll/update/2021/04/18/welcome-to-jekyll.html
但是，所需的示例博客文章仍未显示。而是
https://longarchivist.github.io/docs/jekyll/update/2021/04/18/welcome-to-jekyll.html
仍然是 404 页面。
所以本地主机问题并不是问题的关键。
我们将不胜感激任何建设性的批评。
【问题讨论】：