Article

Article is a complex content type, with title, excerpt and body. Articles are available through blog object, which is a "container" of articles.

Availability of articles

Articles are available on pages which are in "News & Blog" type. On a page of that kind, you can iterate over multiple articles like this

See also

Availability of articles

On blog page template, articles in this blog are available as an array:

  {% for article in articles %}
    <h1>{{ article.title }}</h1>
    <hr />
    {{ article.body }}
  {% endfor %}

Single article is available on article page (which, in turn, derives "News & Blog" page). On single article page you can use article variable directly:

  <h1>{{ article.title }}</h1>
  <hr />
  {{ article.body }}

Latest articles

There is also a accessor method on site to get latest 10 articles on site simply by using

  {% for article in site.latest_articles %}
    <b>{{ article.title }}</b><br/>
  {% endfor %}

To display only the latest article, limit keyword in for tag can be used

  {% for latest_article in site.latest_articles limit:1 %}
    <b>{{ latest_article.title }}<b/>
  {% endfor %}

Comments

Article may also have comments. See comments function for accessing them and how to use comments.

Available properties

author

Returns person object to access author properties

body

Returns body of this article

comments

Returns all published comments in order of their creation time.

For example, looping through all the comments for current article:

{% for comment in article.comments %}<p>{{ comment.body }}</p>{% endfor %}

comments_count

Number of comments associated with this article

  This article has <b>{{ article.comments_count }} comments</b>.

comments_url

Returns URL where new comments for this article should be submitted to in a POST request. Used to build comment forms.

<form action="{{ article.comments_url }}" method="post">...</form>

created_at

Date object representing when this article has been created. Use date filter to format it.

{{ article.created_at | date:"%d.%m.%Y" }}

excerpt

Returns excerpt of this article

title

Returns title of this article.

updated_at

Date object representing when this article has been updated. Use date filter to format it.

{{ article.updated_at | date:"%d.%m.%Y" }}

url

Absolute url for this article.

<a href="{{ article.url }}">{{ article.title }}</a>
=> <a href="/blog/article_path">Article title</a>