Вывод метаданных страницы

Плагин meta.py для генератора сайтов Poole выводит в код страницы метаданные, описывающие страницу и весь сайт.  Пример подключения и настройки (файл macros.py):

from plugins.meta import *
BASE_URL = "http://example.com"
WEBSITE_NAME = "Example Website"
OG_COUNTRY = "Russia"
OG_LOCALITY = "St. Petersburg"
OG_EMAIL = "[email protected]"
DEFAULT_LANGUAGE = "ru-RU"

Пример описания страницы:

title: Some page
keywords: light bulb, howto
summary: Instructions on installing a light bulb.
labels: blog, howto
lang: en-US
date: 2013-12-10 00:21:49
image: light-bulb.png
---
Let me tell you how to install a light bulb.

Плагин выводи в код страницы базовые метаданные (title, keywords, description), данные для Open Graph и каноническую ссылку на страницу.

Используемые глобальные свойства:

  • BASE_URL, без него не будет никаких ссылок, в том числе канонической (которая формируется исходя из адреса страницы и необязательности «index.html»).
  • WEBSITE_NAME, выводится в Open Graph как имя сайта, также используется плагином feeds.py и, возможно, другими.
  • OG_COUNTRY, OG_LOCALITY, OG_EMAIL выводятся в Open Graph и только.
  • DEFAULT_LANGUAGE содержит базовый язык для всех страниц, который может быть изменён для конкретной страницы с помощью свойства lang.

Используемые свойства страницы:

  • date, уходит в «article:published_time» (Open Graph).
  • image, уходит в «og:image»; исходя из содержимого указанного файла добавляются «og:image:width», «og:image:height», «og:image:type».
  • labels, наличие ключевого слова "blog" меняет формат данных для Open Graph.
  • lang, уходит в «og:locale».
  • summary, уходит в «og:description» и meta description.
  • tags, разделённые запятыми элементы уходят в «article:tag» (Open Graph).
  • title, уходит в <title> и «og:title».