【问题标题】:Is it possible to add Open Graph metadata to a GitHub Pages site without using Jekyll locally?是否可以在不本地使用 Jekyll 的情况下将 Open Graph 元数据添加到 GitHub Pages 站点?
【发布时间】:2018-01-03 14:37:54
【问题描述】:

我在 GitHub 存储库中有一个简单的 index.md 页面,我正在通过 GitHub Pages“Minimal”主题发布它。我在本地使用 Jekyll;我依靠 Pages 将 Markdown 呈现为 HTML。我想在头部添加一些 Open Graph 元数据,以改进页面的 SEO 和共享实用程序。

查看 Minimal 主题的 code,似乎无法向 <head> 添加任何内容。我是否遗漏了什么,或者 GitHub 主题是否以这种方式受到限制?安装 Jekyll 只是为了创建一个页面似乎有点矫枉过正,所以我试图避免这种情况。

【问题讨论】:

    标签: github jekyll github-pages


    【解决方案1】:

    是的,有可能,只需 copy theme files 到根目录下的 jekyll 实例并根据需要编辑它们,Jekyll 将在查找主题文件之前使用这些文件。

    或者您可以使用jekyll-seo-tag 插件,它会根据您的页面描述、标题等自动为您添加 OpenGraph 元数据,并由 github-pages gem 使用。

    【讨论】:

    • 明确地说,我根本没有在本地运行 Jekyll。我已将 /docs/index.md 文件添加到 GitHub 上的存储库中,然后依靠 Pages 呈现 Markdown 并将其作为 HTML 提供。我尝试在 _config.yml 文件中添加描述和徽标,但我没有看到它们出现在渲染页面的头部。
    • 描述应该在index.md中,然后在config.yml中指定使用jekyll-seo-tag
    • 啊,谢谢。我一直在搜索“github pages open graph metatdata”并且没有找到任何东西。没想到要搜索SEO。还阅读了如何在此页面上自定义 CSS,但对 HTML 部分的阅读还不够:help.github.com/articles/…
    【解决方案2】:

    感谢上面 marcanuy 的 answer,我能够将 Open Graph 元数据添加到页面中。以下是我遵循的步骤:

    1. /docs/_layouts 的 repo 中创建一个新目录。
    2. Minimal theme下载default.html文件的原始HTML,基于these instructions
    3. 将该default.html 文件复制到/docs/_layouts
    4. 将此添加到/docs 中的_config.yml 文件中,以使 Jekyll SEO 标签能够在 GitHub 页面上运行,基于 these instructions

      gems:
        - jekyll-seo-tag
      
    5. 编辑default.html 以在<head> 中包含{% seo %},以便在页面发布时触发SEO gem。我还从 Minimal 模板中删除了现有的 <title> 标签,因为插件插入了自己的标题。

    6. SEO tag instructions的基础上,将description:logo:author:等添加到_config.yml文件中。这些也可以添加到单独的 .md 文件中,但在这种情况下我只有一个。

    将这些更改推送到 GitHub 后,Open Graph 和其他元数据开始出现在渲染页面的 <head> 中。

    【讨论】:

      猜你喜欢
      • 2021-02-09
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2015-12-11
      • 1970-01-01
      • 2021-10-29
      • 1970-01-01
      相关资源
      最近更新 更多