From: Vladimír Vondruš <mosra@centrum.cz>
Date: Wed, 6 Dec 2017 11:30:52 +0000 (+0100)
Subject: doc: improve the article examples a bit.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=c3e41cb7f4635db16f10cf90ae92d41b8d11d3fb;p=blog.git

doc: improve the article examples a bit.
---

diff --git a/doc/css/page-layout.rst b/doc/css/page-layout.rst
index 48cdd955..f7490de1 100644
--- a/doc/css/page-layout.rst
+++ b/doc/css/page-layout.rst
@@ -460,11 +460,11 @@ font. Example markup and corresponding rendering:
 
         <article>
           <header>
-            <h1><a href="#" rel="bookmark" title="Permalink to An Article">
+            <h1><a href="#" rel="bookmark" title="Permalink to An article">
               <time class="m-date" datetime="2017-09-08T00:00:00+02:00">
               Sep <span class="m-date-day">8</span> 2017
               </time>
-              An Article
+              An article
             </a></h1>
             <p>Article summary paragraph. Lorem ipsum dolor sit amet, consectetur
             adipiscing elit. Aenean id elit posuere, consectetur magna congue, sagittis
@@ -485,11 +485,11 @@ font. Example markup and corresponding rendering:
 
         <article>
           <header>
-            <h1><a href="#" rel="bookmark" title="Permalink to An Article">
+            <h1><a href="#" rel="bookmark" title="Permalink to An article">
               <time class="m-date" datetime="2017-09-08T00:00:00+02:00">
               Sep <span class="m-date-day">8</span> 2017
               </time>
-              An Article
+              An article
             </a></h1>
             <p>Article summary paragraph. Lorem ipsum dolor sit amet, consectetur
             adipiscing elit. Aenean id elit posuere, consectetur magna congue, sagittis
@@ -550,7 +550,7 @@ such as `image grid <{filename}/css/components.rst#image-grid>`_ possible.
               <div class="m-row">
                 <div class="m-col-t-12 m-col-s-10 m-push-s-1 m-col-m-8 m-push-m-2">
                   <h1><a href="#" rel="bookmark" title="Permalink to An Ar­ti­cle — a jum­bo one">
-                    An Article
+                    An article
                   </a></h1>
                   <h2>a jumbo one</h2>
                 </div>
diff --git a/doc/examples/article.rst b/doc/examples/article.rst
index d0a452c7..91264ae2 100644
--- a/doc/examples/article.rst
+++ b/doc/examples/article.rst
@@ -22,15 +22,14 @@
     DEALINGS IN THE SOFTWARE.
 ..
 
-An Article
+An article
 ##########
 
 .. role:: language-la
     :class: language-la
 
-:date: 2017-09-08
+:date: 2017-09-08 0:00
 :category: Examples
-:tags: Example, Article
 :author: An Author
 :slug: article
 :summary: Article summary paragraph. :language-la:`Lorem ipsum dolor sit amet,
@@ -42,3 +41,7 @@ in, mattis ac diam. Aliquam placerat justo ut purus interdum, ac placerat lacus
 consequat. Mauris id suscipit mauris, in scelerisque lectus. Aenean nec nunc eu
 sem tincidunt imperdiet ut non elit. Integer nisi tellus, ullamcorper vitae
 euismod quis, venenatis eu nulla.`
+
+.. note-info::
+
+    Compare the look to a `jumbo article <{filename}/examples/jumbo-article.rst>`_.
diff --git a/doc/examples/jumbo-article.rst b/doc/examples/jumbo-article.rst
index 1923e770..5cda096f 100644
--- a/doc/examples/jumbo-article.rst
+++ b/doc/examples/jumbo-article.rst
@@ -22,16 +22,16 @@
     DEALINGS IN THE SOFTWARE.
 ..
 
-An Article --- a jumbo one
+An article --- a jumbo one
 ##########################
 
 .. role:: language-la
     :class: language-la
 
 :cover: {filename}/static/ship.jpg
-:date: 2017-09-08
+:date: 2017-09-08 1:00
 :category: Examples
-:tags: Example, Article, Jumbo
+:tags: Jumbo
 :author: An Author
 :slug: jumbo-article
 :summary: Article summary paragraph. :language-la:`Lorem ipsum dolor sit amet,
diff --git a/doc/pelican/theme.rst b/doc/pelican/theme.rst
index 83216667..d8c886b0 100644
--- a/doc/pelican/theme.rst
+++ b/doc/pelican/theme.rst
@@ -445,13 +445,14 @@ title and subtitle that's then rendered in a different font size. Example:
 
 .. code:: rst
 
-    An Article --- a jumbo one
+    An article --- a jumbo one
     ##########################
 
     :cover: {filename}/static/ship.jpg
-    :slug: jumbo-article
     :summary: Article summary paragraph.
 
+    Article contents.
+
 Sidebar with tag, category and author list shown in the classic article layout
 on the right is moved to the bottom for jumbo articles.