github/pelican
1
0
Fork 1
mirror of https://github.com/getpelican/pelican.git synced 2025-10-15 20:28:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add doc about use of metadata per article in custom templates

Browse source
This commit is contained in:
Martin De Wulf 2013-11-07 13:41:19 +01:00
commit dc0edb2b2b
1 changed files with 26 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/themes.rst
View file

@ -188,6 +188,32 @@ article The article object to be displayed
category The name of the category for the current article
============= ===================================================
All the metadata that your inserted in the header of the article source file
are available as fields on the article object. The field name is the downcased
name of the metadata field.
For example, if you inserted the meta `FacebookImage` at the end of your metadata in
an article, like this:
.. code-block:: markdown
Title: I love Python more than music
Date: 2013-11-06 10:06
Tags: personal, python
Category: Tech
Slug: python-je-l-aime-a-mourir
Author: Francis Cabrel
FacebookImage: http://franciscabrel.com/images/pythonlove.png
This metadata will be made available as `article.facebookimage` in your `article.html` template.
You could for example use this to specify an image for the Facebook open graph tags that will
change for each article, like this
.. code-block:: html+jinja
<meta property="og:image" content="{{article.facebookimage}}"/>
page.html
---------