Как добавить Atom feed в свой блог | Метод научного тыка

Обратимся к Wikipedia для начала:

Atom — общее название двух связанных веб-технологий: формата для описания ресурсов на веб-сайтах и протокола для их публикации.

Формат Atom основан на XML и позволяет описывать наборы веб-ресурсов — например, новостные ленты, анонсы статей в блоге и тому подобное. Он решает те же задачи, что RSS, но возник позже и учёл многие его недостатки. Формат описан в RFC 4287 и сейчас активно поддерживается компанией Google во многих её проектах.

Итак, Atom это тот же RSS только немного другой :). Нас сейчас не интересует протокол публикации Atom. Мы сосредоточимся на формате выдачи новостной ленты Atom.

Что нам понадобится:

Необходимо в корне своего GitHub Pages репозитория создать файл atom.xml вот с таким содержимым:

---
---
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
 <title>{{ site.title }}</title>
 <link href="{{ site.url }}/atom.xml" rel="self"/>
 <link href="{{ site.url }}"/>
 <updated>{{ site.time | date_to_xmlschema }}</updated>
 <id>{{ site.url }}</id>
 <author>
     <name>{{ site.author }}</name>
     <email>{{ site.email }}</email>
 </author>
 {% for post in site.posts %}
 <entry>
     <title{{ post.title }}</title>
     <link href="{{ site.url }}{{ post.url }}"/>
     <updated>{{ post.date | date_to_xmlschema }}</updated>
     <id>{{ site.url }}{{ post.id }}</id>
     <content type="html">{{ post.content | xml_escape }}</content>
 </entry>
 {% endfor %}
</feed>

В секцию head надо вставить ссылку на вновь созданный файл:

 <head>
     ...
     <link rel="alternate" type="application/atom+xml" title="{{ site.title }}" href="/atom.xml">
     ...
 </head>

Добавить/обновить файл конфигурации _config.yml

 ...
 title: Заголовок сайта
 url: https://<your-user>.github.io
 author: Василий Алибабаевич Али-Баба
 email: vasya@somewhere.com
 ...

Ну и, конечно, никто не запрещает посмотреть как это сделано у меня

Как проверить, что всё работает

Для этого достаточно открыть ваш сайт и в конце добавить /atom.xml. Для меня эта ссылка выглядит вот так https://fomich0ff.github.io/atom.xml В зависимости от браузера и установленных плагинов конечный результат может выглядеть по-разному. Но в любом случае это должен быть список ваших постов с их содержимым в виде XML.

Пример:

<feed xmlns="http://www.w3.org/2005/Atom">
    <title>Метод научного тыка</title>
    <link href="https://fomich0ff.github.io/atom.xml" rel="self" />
    <link href="https://fomich0ff.github.io" />
    <updated>2017-08-04T16:54:13+00:00</updated>
    <id>https://fomich0ff.github.io</id>
    <author>
        <name>Олег Фомичёв</name>
        <email>o.g.fomichev@zoho.com</email>
    </author>
    <entry>
        <title>Как добавит Atom feed в свой блог</title>
        <link href="https://fomich0ff.github.io/2017/08/04/how-to-add-atom-feed/" />
        <updated>2017-08-04T00:00:00+00:00</updated>
        <id>https://fomich0ff.github.io/2017/08/04/how-to-add-atom-feed</id>
        <content type="html">  тут содержимое статьи  </content>
    </entry>
    <entry>
        <title>Привет из прошлого</title>
        <link href="https://fomich0ff.github.io/2017/08/01/post-from-future/" />
        <updated>2017-08-01T00:00:00+00:00</updated>
        <id>https://fomich0ff.github.io/2017/08/01/post-from-future</id>
        <content type="html">  тут содержимое статьи  </content>
    </entry>
    ...
</feed>