X-Git-Url: http://git.wpitchoune.net/gitweb/?p=www.git;a=blobdiff_plain;f=www%2Fnews%2Ffeed.xml;h=6e355c14749d79b876e0a37a746ebd2f003a0f5c;hp=90183efce29a8a2c07824501d282b3ab6b096f43;hb=100fa8ff715a4431da75c3225e1c79db9fa6ed16;hpb=d76e170141a0523ee30feded9154c933dd447609

diff --git a/www/news/feed.xml b/www/news/feed.xml
index 90183ef..6e355c1 100644
--- a/www/news/feed.xml
+++ b/www/news/feed.xml
@@ -2,18 +2,64 @@
 <rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
   <channel>
     <title>News</title>
-    <link>http://wpitchoune.net/news/feed.xml</link>
+    <link>https://wpitchoune.net/news/feed.xml</link>
     <description>News of the wpitchoune.net website.</description>
     <item>
+      <title>New website</title>
+      <link>https://wpitchoune.net/news/new_website.html</link>
+      <description>&lt;div class="paragraph"&gt;
+&lt;p&gt;After being bored with Wordpress for years, the &lt;a href="http://wpitchoune.net"&gt;wpitchoune.net&lt;/a&gt;
+website is changing. It is now based on &lt;a href="http://asciidoctor.org"&gt;Asciidoctor&lt;/a&gt; and
+a simple shell script to generate it.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;With the help of &lt;a href="http://atom.io"&gt;Atom&lt;/a&gt; and a couple of addons dedicated to
+Asciidoctor, it is easy and quick to write content. I am happy to no
+more have to worry about the painful admistration of Wordpress,
+upgrading it, taking care of security, spamming of comments and bot
+account creation, and backup of databases.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;If you want to know how the website is built, everything is on
+a GIT repository: &lt;a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare"&gt;http://git.wpitchoune.net/gitweb/?p=www.git&lt;/a&gt;.
+It is simple, really simple&amp;#8230;&amp;#8203; but enough for my needs.&lt;/p&gt;
+&lt;/div&gt;</description>
+      <pubDate>Mon, 13 Jun 2016 22:00:00 GMT</pubDate>
+      <guid isPermaLink="false">https://wpitchoune.net/news/new_website.html</guid>
+      <dc:date>2016-06-13T22:00:00Z</dc:date>
+    </item>
+    <item>
+      <title>RSS Feed</title>
+      <link>https://wpitchoune.net/news/added_rss_feed.html</link>
+      <description>&lt;div class="paragraph"&gt;
+&lt;p&gt;It is now possible to follow news and announces of the
+website with the following RSS feed:
+&lt;a href="https://wpitchoune.net/news/feed.xml" class="bare"&gt;https://wpitchoune.net/news/feed.xml&lt;/a&gt;&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;Under the bridge it is automaticaly generated
+with a very simple program from Asciidoctor
+documents. You can get the sources
+from the GIT repository: &lt;a href="https://git.wpitchoune.net/asciidoctor_to_rss.git" class="bare"&gt;https://git.wpitchoune.net/asciidoctor_to_rss.git&lt;/a&gt; .&lt;/p&gt;
+&lt;/div&gt;</description>
+      <pubDate>Sun, 03 Jul 2016 22:00:00 GMT</pubDate>
+      <guid isPermaLink="false">https://wpitchoune.net/news/added_rss_feed.html</guid>
+      <dc:date>2016-07-03T22:00:00Z</dc:date>
+    </item>
+    <item>
       <title>Asciidoctor to RSS</title>
-      <link>http://wpitchoune.net/news/asciidoctor_to_rss.html</link>
+      <link>https://wpitchoune.net/news/asciidoctor_to_rss.html</link>
       <description>&lt;div id="preamble"&gt;
 &lt;div class="sectionbody"&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;In order to have a website based only on Asciidoctor
-documents, I have written a small utility which
-converts a set of Asciidoctor documents to HTML pages and
-generates a RSS 2.0 feed.&lt;/p&gt;
+&lt;p&gt;In order to ease the edition of this website and
+the management of the server, I want it to be purely
+static and generated from &lt;a href="http://asciidoctor.org"&gt;Asciidoctor&lt;/a&gt; documents.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The &lt;em&gt;news&lt;/em&gt; part of the website is also written as Asciidoctor
+documents, &lt;code&gt;asciidoctor_to_rss&lt;/code&gt; is converting them into static
+HTML pages and generates a RSS 2.0 file.&lt;/p&gt;
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -26,10 +72,10 @@ generates a RSS 2.0 feed.&lt;/p&gt;
 &lt;div class="ulist"&gt;
 &lt;ul&gt;
 &lt;li&gt;
-&lt;p&gt;maven&lt;/p&gt;
+&lt;p&gt;&lt;a href="http://maven.apache.org/download.cgi"&gt;Apache Maven&lt;/a&gt; (3.3.9)&lt;/p&gt;
 &lt;/li&gt;
 &lt;li&gt;
-&lt;p&gt;java (&amp;gt;1.7)&lt;/p&gt;
+&lt;p&gt;&lt;a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html"&gt;Java&lt;/a&gt; (Sun JDK &amp;gt;=1.8)&lt;/p&gt;
 &lt;/li&gt;
 &lt;/ul&gt;
 &lt;/div&gt;
@@ -56,18 +102,47 @@ mvn clean install&lt;/pre&gt;
 &lt;h2 id="_howto_write_news"&gt;Howto write news&lt;/h2&gt;
 &lt;div class="sectionbody"&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;Each news has to be written in a separate Asciidoctor document
+&lt;p&gt;Each &lt;em&gt;news&lt;/em&gt; must be written in an &lt;a href="http://asciidoctor.org"&gt;Asciidoctor&lt;/a&gt; document
 and all documents must be dropped into a directory.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
 &lt;p&gt;There is not any restriction concerning the syntax because
-the utility is based on the java bridge of Asciidoctor.
-I have added an attribute 'date' which allows the utility
+the utility is based on the Java bridge of Asciidoctor.
+I have added an attribute &lt;code&gt;date&lt;/code&gt; which allows the utility
 to know the publication date of the news.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;You can see some examples at &lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD&lt;/a&gt; .
-The source document of this news is at &lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD&lt;/a&gt;&lt;/p&gt;
+&lt;p&gt;Here is an example of &lt;em&gt;news&lt;/em&gt;:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="listingblock"&gt;
+&lt;div class="content"&gt;
+&lt;pre class="highlight"&gt;&lt;code class="language-asciidoc" data-lang="asciidoc"&gt;= Asciidoctor to RSS
+Jean-Philippe Orsini &amp;lt;jeanfi@gmail.com&amp;gt;
+:date: 2016-11-07
+:icons: font
+
+In order to ease the edition of this website and
+the management of the server, I want it to be purely
+static and generated from http://asciidoctor.org[Asciidoctor] documents.
+
+The _news_ part of the website is also written as Asciidoctor
+documents, `asciidoctor_to_rss` is converting them into static
+HTML pages and generates a RSS 2.0 file.
+
+== Installation of asciidoctor_to_rss
+
+It is required to install:
+
+* http://maven.apache.org/download.cgi[Apache Maven] (3.3.9)
+
+* http://www.oracle.com/technetwork/java/javase/downloads/index.html[Java] (Sun JDK &amp;gt;=1.8)&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;You can see few examples at
+&lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD&lt;/a&gt;.
+The source document of this &lt;em&gt;news&lt;/em&gt; is at
+&lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD&lt;/a&gt;.&lt;/p&gt;
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -75,10 +150,37 @@ The source document of this news is at &lt;a href="https://wpitchoune.net/gitweb
 &lt;h2 id="_configuration"&gt;Configuration&lt;/h2&gt;
 &lt;div class="sectionbody"&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;The configuration of the utility can be done in text file.&lt;/p&gt;
+&lt;p&gt;The configuration file of &lt;code&gt;asciidoctor_to_rss&lt;/code&gt; is text file containing key/value pairs.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;See an example at &lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD&lt;/a&gt; .&lt;/p&gt;
+&lt;p&gt;See an example at
+&lt;a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD" class="bare"&gt;https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD&lt;/a&gt; .&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="listingblock"&gt;
+&lt;div class="content"&gt;
+&lt;pre class="highlight"&gt;&lt;code class="language-text" data-lang="text"&gt;feed.title=News
+feed.description=News of the wpitchoune.net website.
+feed.link=https://wpitchoune.net/news/feed.xml
+feed.baseurl=https://wpitchoune.net/news
+
+html.header.file=src/header.html&lt;/code&gt;&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;feed.title&lt;/code&gt;: the title used for the feed, in the RSS 2.0 and &lt;code&gt;news.html&lt;/code&gt; files.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;feed.description&lt;/code&gt;: the description used in the RSS 2.0 file.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;feed.link&lt;/code&gt;: URI of the RSS 2.0 file.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;feed.baseurl&lt;/code&gt;: base URI where the HTML news files will be located.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;html.header.file&lt;/code&gt;: the content of the denoted file will be added in the &lt;code&gt;head&lt;/code&gt; block of
+the generated HTML documents.&lt;/p&gt;
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;/div&gt;
@@ -94,23 +196,40 @@ The source document of this news is at &lt;a href="https://wpitchoune.net/gitweb
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;&lt;code&gt;IN_DIR&lt;/code&gt;:&lt;/p&gt;
+&lt;p&gt;&lt;code&gt;IN_DIR&lt;/code&gt;: the directory containing the news as Asciidoctor documents.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;&lt;code&gt;OUT_DIR&lt;/code&gt;:&lt;/p&gt;
+&lt;p&gt;&lt;code&gt;OUT_DIR&lt;/code&gt;: the output directory which contains all generated files.&lt;/p&gt;
 &lt;/div&gt;
 &lt;div class="paragraph"&gt;
-&lt;p&gt;&lt;code&gt;CFG_FILE&lt;/code&gt;:&lt;/p&gt;
+&lt;p&gt;&lt;code&gt;CFG_FILE&lt;/code&gt;: the path to the configuration file.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The &lt;code&gt;OUT_DIR&lt;/code&gt; will contain:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="ulist"&gt;
+&lt;ul&gt;
+&lt;li&gt;
+&lt;p&gt;one HTML file for each Asciidoctor document,&lt;/p&gt;
+&lt;/li&gt;
+&lt;li&gt;
+&lt;p&gt;the &lt;a href="https://wpitchoune.net/news/news.html"&gt;&lt;code&gt;news.html&lt;/code&gt;&lt;/a&gt; file,&lt;/p&gt;
+&lt;/li&gt;
+&lt;li&gt;
+&lt;p&gt;and the &lt;a href="https://wpitchoune.net/news/news.html"&gt;&lt;code&gt;feed.xml&lt;/code&gt;&lt;/a&gt; file which is a feed
+compatible with RSS v2.0.&lt;/p&gt;
+&lt;/li&gt;
+&lt;/ul&gt;
 &lt;/div&gt;
 &lt;/div&gt;
 &lt;/div&gt;</description>
       <pubDate>Sun, 10 Jul 2016 22:00:00 GMT</pubDate>
-      <guid isPermaLink="false">http://wpitchoune.net/news/asciidoctor_to_rss.html</guid>
+      <guid isPermaLink="false">https://wpitchoune.net/news/asciidoctor_to_rss.html</guid>
       <dc:date>2016-07-10T22:00:00Z</dc:date>
     </item>
     <item>
       <title>Call for contributions for the translation of psensor</title>
-      <link>http://wpitchoune.net/news/call_contribution.html</link>
+      <link>https://wpitchoune.net/news/call_contribution.html</link>
       <description>&lt;div class="paragraph"&gt;
 &lt;p&gt;The version 1.2.0 of psensor is going to be released in the coming
 weeks. This release will include many changes which impact the
@@ -119,49 +238,7 @@ it is now the good timeframe. See the
 &lt;a href="https://wpitchoune.net/psensor/contribute.html"&gt;instructions&lt;/a&gt;.&lt;/p&gt;
 &lt;/div&gt;</description>
       <pubDate>Mon, 13 Jun 2016 22:00:00 GMT</pubDate>
-      <guid isPermaLink="false">http://wpitchoune.net/news/call_contribution.html</guid>
-      <dc:date>2016-06-13T22:00:00Z</dc:date>
-    </item>
-    <item>
-      <title>RSS Feed</title>
-      <link>http://wpitchoune.net/news/added_rss_feed.html</link>
-      <description>&lt;div class="paragraph"&gt;
-&lt;p&gt;It is now possible to follow news and announces of the
-website with the following RSS feed:
-&lt;a href="https://wpitchoune.net/news/feed.xml" class="bare"&gt;https://wpitchoune.net/news/feed.xml&lt;/a&gt;&lt;/p&gt;
-&lt;/div&gt;
-&lt;div class="paragraph"&gt;
-&lt;p&gt;Under the bridge it is automaticaly generated
-with a very simple program from Asciidoctor
-documents. You can get the sources
-from the GIT repository: &lt;a href="https://git.wpitchoune.net/asciidoctor_to_rss.git" class="bare"&gt;https://git.wpitchoune.net/asciidoctor_to_rss.git&lt;/a&gt; .&lt;/p&gt;
-&lt;/div&gt;</description>
-      <pubDate>Sun, 03 Jul 2016 22:00:00 GMT</pubDate>
-      <guid isPermaLink="false">http://wpitchoune.net/news/added_rss_feed.html</guid>
-      <dc:date>2016-07-03T22:00:00Z</dc:date>
-    </item>
-    <item>
-      <title>New website</title>
-      <link>http://wpitchoune.net/news/new_website.html</link>
-      <description>&lt;div class="paragraph"&gt;
-&lt;p&gt;After being bored with Wordpress for years, the &lt;a href="http://wpitchoune.net"&gt;wpitchoune.net&lt;/a&gt;
-website is changing. It is now based on &lt;a href="http://asciidoctor.org"&gt;Asciidoctor&lt;/a&gt; and
-a simple shell script to generate it.&lt;/p&gt;
-&lt;/div&gt;
-&lt;div class="paragraph"&gt;
-&lt;p&gt;With the help of &lt;a href="http://atom.io"&gt;Atom&lt;/a&gt; and a couple of addons dedicated to
-Asciidoctor, it is easy and quick to write content. I am happy to no
-more have to worry about the painful admistration of Wordpress,
-upgrading it, taking care of security, spamming of comments and bot
-account creation, and backup of databases.&lt;/p&gt;
-&lt;/div&gt;
-&lt;div class="paragraph"&gt;
-&lt;p&gt;If you want to know how the website is built, everything is on
-a GIT repository: &lt;a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare"&gt;http://git.wpitchoune.net/gitweb/?p=www.git&lt;/a&gt;.
-It is simple, really simple&amp;#8230;&amp;#8203; but enough for my needs.&lt;/p&gt;
-&lt;/div&gt;</description>
-      <pubDate>Mon, 13 Jun 2016 22:00:00 GMT</pubDate>
-      <guid isPermaLink="false">http://wpitchoune.net/news/new_website.html</guid>
+      <guid isPermaLink="false">https://wpitchoune.net/news/call_contribution.html</guid>
       <dc:date>2016-06-13T22:00:00Z</dc:date>
     </item>
   </channel>