Jekyll中文文档__Posts

汉瑜

已于 2023-05-12 16:36:15 修改

阅读量150

点赞数

分类专栏： jekyll 文章标签： ruby 开发语言

于 2023-04-05 19:58:50 首次发布

原文链接：https://jekyllrb.com/docs/posts/

版权

jekyll 专栏收录该内容

27 篇文章

订阅专栏

写博客已经嵌入到了 Jekyll 中。你把博客文章写成文本文件，Jekyll提供了把它变成博客所需的一切。

The Posts Folder

_posts 文件夹是您的博客文章所在的位置。你通常用 Markdown 写文章，当然也支持HTML。

Creating Posts

要创建一篇文章，请按以下格式将文件添加到 _posts 目录：

YEAR-MONTH-DAY-title.MARKUP

其中YEAR是一个四位数，MONTH和DAY都是两位数，MARKUP是表示文件中使用的格式的文件扩展名。例如，以下是有效的 post 文件名示例：

2011-12-31-new-years-eve-is-awesome.md
2012-09-12-how-to-write-a-blog.md

所有博客文章文件都必须以 front matter 开头，它通常用于设置 layout 或其他元数据。对于一个简单的例子，它可以是空的：

---
layout: post
title:  "Welcome to Jekyll!"
---

# Welcome

**Hello world**, this is my first Jekyll blog post.

I hope you like it!

ProTip™: 链接到其他文章

使用 post_url tag 链接到其他文章，而不必担心网站 permalink 样式更改时 URLs 会中断。

注意字符集

内容处理程序可以修改某些字符，使其看起来更好。例如，Redcarpet 中的 smart 扩展将标准ASCII引号字符转换为Unicode字符大括号。为了让浏览器正确显示这些字符，请通过在布局的 <head> 中包含 <meta charset=“utf-8”> 来定义字符集 meta value 。

Including images and resources

在某些情况下，您会希望在文本内容中包含图像、下载或其他数字资产。一种常见的解决方案是在项目目录的根目录中创建一个文件夹，称为类似 assets 的文件夹，其中可以放置任何图像、文件或其他资源。然后，在任何文章中，使用网站的根目录作为要包含的 asset 的路径，就可以链接到它们。做到这一点的最佳方法取决于网站（子）域和路径的配置方式，但以下是Markdown中的一些简单示例：

在文章中包含图像 asset ：

... which is shown in the screenshot below:
![My helpful screenshot](/assets/screenshot.jpg)

链接到PDF供读者下载：

... you can [get the PDF](/assets/mydoc.pdf) directly.

Displaying an index of posts

由于 Liquid 及其 tags ，在另一个页面上创建文章索引应该很容易。以下是一个简单的示例，说明如何创建指向博客文章的链接列表：

<ul>
  {% for post in site.posts %}
    <li>
      <a href="{{ post.url }}">{{ post.title }}</a>
    </li>
  {% endfor %}
</ul>

你可以完全控制你如何（以及在哪里）展示你的文章，以及你如何构建你的网站。如果你想了解更多，你应该阅读更多关于 how templates work with Jekyll 的信息。

请注意，post 变量只存在于上面的 for 循环中。如果希望访问当前渲染的页面/文章的变量（其中包含 for 循环的文章/页面的变量），请改用 page 变量。

Tags and Categories

Jekyll 对博客文章中的 tags 和 categories 有一流的支持。

Post excerpts

您可以通过在文章上使用 excerpt 变量来访问文章内容的片段。默认情况下，这是文章内容的第一段，但可以通过在 front matter 或 _config.yml 中设置一个 excerpt_separator 变量来自定义。

---
excerpt_separator: <!--more-->
---

Excerpt with multiple paragraphs

Here's another paragraph in the excerpt.
<!--more-->
Out-of-excerpt

下面是一个输出带有摘录的博客文章列表的示例：

<ul>
  {% for post in site.posts %}
    <li>
      <a href="{{ post.url }}">{{ post.title }}</a>
      {{ post.excerpt }}
    </li>
  {% endfor %}
</ul>

Drafts

草稿是文件名中没有日期的文章。它们是你仍在处理的文章，但还不想发布。要启动并运行草稿，请在站点根目录中创建一个 _drafts 文件夹，然后创建您的第一份草稿：

.
├── _drafts
│   └── a-draft-post.md
...

要使用草稿预览您的网站，请使用 --drafts 开关运行 jekyll serve 或者 jekyll build 。每篇草稿都将被分配草稿文件的修改时间值，来作为它的日期，因此您将看到当前编辑的草案作为最新的文章。

📃返回目录