doc: improve the article examples a bit.

diff --git a/doc/css/page-layout.rst b/doc/css/page-layout.rst
index 48cdd9552c46acdcaeb3d488e2ad89f28950e39e..f7490de11201add644ec36439c0ed6939e6b5a72 100644 (file)
--- 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 d0a452c75b6689963d08974eee29e68ae2e1dd70..91264ae2dc50de7ccd5a97623d2be5bb228f3b28 100644 (file)
--- 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 1923e7705bd3e08e1ea32a2ff5c52cd8f1f5dbe9..5cda096f5ed8d3c6879712643e7d4b15ca0fc768 100644 (file)
--- 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 8321666760708bdac2ed51ffa06eeb0384db307a..d8c886b08eeca41e0db393a1ab166a6e4383f0b4 100644 (file)
--- 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.