如何在不本地安装 Jekyll 的情况下向 github 页面添加新帖子答案

【问题标题】：How to add new posts to github pages without installing Jekyll locally如何在不本地安装 Jekyll 的情况下向 github 页面添加新帖子
【发布时间】：2015-06-10 04:51:22
【问题描述】：

我在 github 上为使用 automatic generator 的项目创建了博客，现在我想添加新帖子。我添加了 _posts 文件夹并放入名为 2015-04-05-post-name.md 的文件。然后我将所有更改推送到 github 上的 repo。新页面可用，但其样式未设置为 index.html。

我做错了什么？我想要实现的是能够添加用 Markdown 编写的新帖子，但无需在我的电脑上安装 jekyll。所有新帖子都应该根据博客的整体风格。

文件内容如下：

---
layout: post
title: Test Title
---

# First Post Header

Some text goes here.

【问题讨论】：

“我做错了什么？”如果没有看到代码，很难回答这个问题……也许你忘记了 YAML Front Matter？还是其中的一部分，例如layout？请在您的问题中添加至少部分示例。
@Chris 我在问题中添加了一个示例
该帖子内容看起来很合理。它是如何渲染的，您希望它如何渲染？可以直接链接到网站吗？

标签： github jekyll github-pages

【解决方案1】：

自动生成器不适用于 Jekyll，它适用于普通的独立 html 页面。你应该从这里开始：barryclark/jekyll-now [github]

如果您想要一个工具来更轻松地发布到您的 Jekyll 博客/网站，那么可以使用 Prose.io。根据他们的网站：

这是一个基于 Web 的界面，用于管理 GitHub 上的内容。用它来创建、编辑和删除文件，并将更改直接保存到 GitHub

此外，如果您的帖子的样式与您的 index.html 不同，那么这可能意味着您的布局有问题。

【讨论】：

【解决方案2】：

提供的主题（至少我尝试过的两个，Minimal 和 Slate）没有单独的“帖子”布局，只有一个“默认”布局。因为您已经指定了layout: post（按照 Jekyll 文档的说明），所以 Jekyll 正试图找到一个并放弃。 完全删除布局线，它将正确地退回到默认样式。您不必创建或编辑布局。

【讨论】：

【解决方案3】：

注意starting Dec. 2016, you can work with markdown page only（那时不需要yaml）

现在所有 Markdown 文件都由 GitHub Pages 呈现，您无需将 YAML 前端内容（文件顶部的元数据由 ---s 分隔）添加到每个文件。

如果您没有 index.md（或 index.html），我们将使用您的 README 文件作为网站的索引，这与您浏览 GitHub 上的存储库时没有什么不同。

如果给定文件没有指定布局，我们将根据其上下文分配一个。例如，如果页面布局不存在，页面将自动获取页面布局或默认布局。

如果您的页面没有明确的标题，并且文件以 H1、H2 或 H3 开头，我们将使用该标题作为页面标题，该标题显示在浏览器选项卡等位置。

【讨论】：

【解决方案4】：

如果您希望 Jekyll 在 Github Pages 上生成您的网站，您需要添加布局，可能还需要添加 _config.yml 文件。

查看Jekyll site template here 并阅读Jekyll documentation。

【讨论】：

那么我不明白automatic generator 功能的用途，因为应用它后，您不能只向生成的站点添加新内容。事实证明，您需要手动添加 Jekyll 所需的文件夹和文件。那么自动生成器就完全没用了。让我感到困惑的是，在 gitgub pages 文档中没有关于如何在网站创建后更进一步的示例。