<rss xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">\r
<channel>\r
<title>News</title>\r
- <link>http://wpitchoune.net/news/feed.xml</link>\r
+ <link>https://wpitchoune.net/news/feed.xml</link>\r
<description>News of the wpitchoune.net website.</description>\r
<item>\r
- <title>Call for contributions for the translation of psensor</title>\r
- <link>http://wpitchoune.net/news/call_contribution.html</link>\r
+ <title>New website</title>\r
+ <link>https://wpitchoune.net/news/new_website.html</link>\r
<description><div class="paragraph">\r
-<p>The version 1.2.0 of psensor is going to be released in the coming\r
-weeks. This release will include many changes which impact the\r
-translations. If you want to contribute to the translation of psensor\r
-it is now the good timeframe. See the\r
-<a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>\r
+<p>After being bored with Wordpress for years, the <a href="http://wpitchoune.net">wpitchoune.net</a>\r
+website is changing. It is now based on <a href="http://asciidoctor.org">Asciidoctor</a> and\r
+a simple shell script to generate it.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>With the help of <a href="http://atom.io">Atom</a> and a couple of addons dedicated to\r
+Asciidoctor, it is easy and quick to write content. I am happy to no\r
+more have to worry about the painful admistration of Wordpress,\r
+upgrading it, taking care of security, spamming of comments and bot\r
+account creation, and backup of databases.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>If you want to know how the website is built, everything is on\r
+a GIT repository: <a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare">http://git.wpitchoune.net/gitweb/?p=www.git</a>.\r
+It is simple, really simple&#8230;&#8203; but enough for my needs.</p>\r
</div></description>\r
<pubDate>Mon, 13 Jun 2016 22:00:00 GMT</pubDate>\r
- <guid isPermaLink="false">http://wpitchoune.net/news/call_contribution.html</guid>\r
+ <guid isPermaLink="false">https://wpitchoune.net/news/new_website.html</guid>\r
<dc:date>2016-06-13T22:00:00Z</dc:date>\r
</item>\r
<item>\r
<title>RSS Feed</title>\r
- <link>http://wpitchoune.net/news/added_rss_feed.html</link>\r
+ <link>https://wpitchoune.net/news/added_rss_feed.html</link>\r
<description><div class="paragraph">\r
<p>It is now possible to follow news and announces of the\r
website with the following RSS feed:\r
from the GIT repository: <a href="https://git.wpitchoune.net/asciidoctor_to_rss.git" class="bare">https://git.wpitchoune.net/asciidoctor_to_rss.git</a> .</p>\r
</div></description>\r
<pubDate>Sun, 03 Jul 2016 22:00:00 GMT</pubDate>\r
- <guid isPermaLink="false">http://wpitchoune.net/news/added_rss_feed.html</guid>\r
+ <guid isPermaLink="false">https://wpitchoune.net/news/added_rss_feed.html</guid>\r
<dc:date>2016-07-03T22:00:00Z</dc:date>\r
</item>\r
<item>\r
- <title>New website</title>\r
- <link>http://wpitchoune.net/news/new_website.html</link>\r
- <description><div class="paragraph">\r
-<p>After being bored with Wordpress for years, the <a href="http://wpitchoune.net">wpitchoune.net</a>\r
-website is changing. It is now based on <a href="http://asciidoctor.org">Asciidoctor</a> and\r
-a simple shell script to generate it.</p>\r
+ <title>Asciidoctor to RSS</title>\r
+ <link>https://wpitchoune.net/news/asciidoctor_to_rss.html</link>\r
+ <description><div id="preamble">\r
+<div class="sectionbody">\r
+<div class="paragraph">\r
+<p>In order to have a website based only on Asciidoctor\r
+documents, I have written a small utility which\r
+converts a set of Asciidoctor documents to HTML pages and\r
+generates a RSS 2.0 feed.</p>\r
</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_installation_of_asciidoctor_to_rss">Installation of asciidoctor_to_rss</h2>\r
+<div class="sectionbody">\r
<div class="paragraph">\r
-<p>With the help of <a href="http://atom.io">Atom</a> and a couple of addons dedicated to\r
-Asciidoctor, it is easy and quick to write content. I am happy to no\r
-more have to worry about the painful admistration of Wordpress,\r
-upgrading it, taking care of security, spamming of comments and bot\r
-account creation, and backup of databases.</p>\r
+<p>It is required to install:</p>\r
+</div>\r
+<div class="ulist">\r
+<ul>\r
+<li>\r
+<p>maven</p>\r
+</li>\r
+<li>\r
+<p>java (&gt;1.7)</p>\r
+</li>\r
+</ul>\r
</div>\r
<div class="paragraph">\r
-<p>If you want to know how the website is built, everything is on\r
-a GIT repository: <a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare">http://git.wpitchoune.net/gitweb/?p=www.git</a>.\r
-It is simple, really simple&#8230;&#8203; but enough for my needs.</p>\r
+<p>The sources can be retrieved from GIT:</p>\r
+</div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre>git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git</pre>\r
+</div>\r
+</div>\r
+<div class="paragraph">\r
+<p>Compilation:</p>\r
+</div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre>cd asciidoctor_to_rss\r
+mvn clean install</pre>\r
+</div>\r
+</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_howto_write_news">Howto write news</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph">\r
+<p>Each news has to be written in a separate Asciidoctor document\r
+and all documents must be dropped into a directory.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>There is not any restriction concerning the syntax because\r
+the utility is based on the java bridge of Asciidoctor.\r
+I have added an attribute 'date' which allows the utility\r
+to know the publication date of the news.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>You can see some examples at <a href="https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD" class="bare">https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD</a> .\r
+The source document of this news is at <a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD" class="bare">https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD</a></p>\r
+</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_configuration">Configuration</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph">\r
+<p>The configuration of the utility can be done in text file.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>See an example at <a href="https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD" class="bare">https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD</a> .</p>\r
+</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_run_the_utility">Run the utility</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph">\r
+<p>The command line usage is:</p>\r
+</div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre>asciidoctor_to_rss.sh &lt;IN_DIR&gt; &lt;OUT_DIR&gt; &lt;CFG_FILE&gt;</pre>\r
+</div>\r
+</div>\r
+<div class="paragraph">\r
+<p><code>IN_DIR</code>: the directory containing the news as Asciidoctor documents.</p>\r
+</div>\r
+<div class="paragraph">\r
+<p><code>OUT_DIR</code>: the output directory which contains all generated files</p>\r
+</div>\r
+<div class="paragraph">\r
+<p><code>CFG_FILE</code>: the path to the configuration file</p>\r
+</div>\r
+<div class="paragraph">\r
+<p>The <code>OUT_DIR</code> will contain:</p>\r
+</div>\r
+<div class="ulist">\r
+<ul>\r
+<li>\r
+<p>one HTML file for each Asciidoctor document</p>\r
+</li>\r
+<li>\r
+<p>the <code>news.html</code> file</p>\r
+</li>\r
+<li>\r
+<p>the <code>feed.xml</code> file which is a feed compatible with RSS v2.0.</p>\r
+</li>\r
+</ul>\r
+</div>\r
+</div>\r
+</div></description>\r
+ <pubDate>Sun, 10 Jul 2016 22:00:00 GMT</pubDate>\r
+ <guid isPermaLink="false">https://wpitchoune.net/news/asciidoctor_to_rss.html</guid>\r
+ <dc:date>2016-07-10T22:00:00Z</dc:date>\r
+ </item>\r
+ <item>\r
+ <title>Call for contributions for the translation of psensor</title>\r
+ <link>https://wpitchoune.net/news/call_contribution.html</link>\r
+ <description><div class="paragraph">\r
+<p>The version 1.2.0 of psensor is going to be released in the coming\r
+weeks. This release will include many changes which impact the\r
+translations. If you want to contribute to the translation of psensor\r
+it is now the good timeframe. See the\r
+<a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>\r
</div></description>\r
<pubDate>Mon, 13 Jun 2016 22:00:00 GMT</pubDate>\r
- <guid isPermaLink="false">http://wpitchoune.net/news/new_website.html</guid>\r
+ <guid isPermaLink="false">https://wpitchoune.net/news/call_contribution.html</guid>\r
<dc:date>2016-06-13T22:00:00Z</dc:date>\r
</item>\r
</channel>\r