<!DOCTYPE html>
<html>
<head>
-<link rel="stylesheet" href="/style.css">
+<link rel="stylesheet" href="https://wpitchoune.net/style.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
-<script src="/nav.js"></script>
+<script src="https://wpitchoune.net/nav.js"></script>
</head>
<body>
<div id='header'>
<h1>News</h1>
</div><div id='content'>
-<div><h2>Call for contributions for the translation of psensor</h2><div class='date'>2016-14-06</div><div class="paragraph">
-<p>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
-translations. If you want to contribute to the translation of psensor
-it is now the good timeframe. See the
-<a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
+<div><h2><a href='https://wpitchoune.net/news/asciidoctor_to_rss.html'>Asciidoctor to RSS</a></h2><div class='date'>2016-11-07</div><div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>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.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_installation_of_asciidoctor_to_rss">Installation of asciidoctor_to_rss</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>It is required to install:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>maven</p>
+</li>
+<li>
+<p>java (>1.7)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>The sources can be retrieved from GIT:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Compilation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>cd asciidoctor_to_rss
+mvn clean install</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_howto_write_news">Howto write news</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Each news has to be written in a separate Asciidoctor document
+and all documents must be dropped into a directory.</p>
+</div>
+<div class="paragraph">
+<p>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
+to know the publication date of the news.</p>
+</div>
+<div class="paragraph">
+<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> .
+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>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_configuration">Configuration</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The configuration of the utility can be done in text file.</p>
+</div>
+<div class="paragraph">
+<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>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_run_the_utility">Run the utility</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The command line usage is:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>asciidoctor_to_rss.sh <IN_DIR> <OUT_DIR> <CFG_FILE></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>IN_DIR</code>: the directory containing the news as Asciidoctor documents.</p>
+</div>
+<div class="paragraph">
+<p><code>OUT_DIR</code>: the output directory which contains all generated files</p>
+</div>
+<div class="paragraph">
+<p><code>CFG_FILE</code>: the path to the configuration file</p>
+</div>
+<div class="paragraph">
+<p>The <code>OUT_DIR</code> will contain:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>one HTML file for each Asciidoctor document</p>
+</li>
+<li>
+<p>the <code>news.html</code> file</p>
+</li>
+<li>
+<p>the <code>feed.xml</code> file which is a feed compatible with RSS v2.0.</p>
+</li>
+</ul>
+</div>
+</div>
</div></div>
-<div><h2>
RSS Feed</h2><div class='date'>2016-04-07</div><div class="paragraph">
+<div><h2>
<a href='https://wpitchoune.net/news/added_rss_feed.html'>RSS Feed</a></h2><div class='date'>2016-04-07</div><div class="paragraph">
<p>It is now possible to follow news and announces of the
website with the following RSS feed:
<a href="https://wpitchoune.net/news/feed.xml" class="bare">https://wpitchoune.net/news/feed.xml</a></p>
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>
</div></div>
-<div><h2>
New website</h2><div class='date'>2016-14-06</div><div class="paragraph">
+<div><h2>
<a href='https://wpitchoune.net/news/new_website.html'>New website</a></h2><div class='date'>2016-14-06</div><div class="paragraph">
<p>After being bored with Wordpress for years, the <a href="http://wpitchoune.net">wpitchoune.net</a>
website is changing. It is now based on <a href="http://asciidoctor.org">Asciidoctor</a> and
a simple shell script to generate it.</p>
a GIT repository: <a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare">http://git.wpitchoune.net/gitweb/?p=www.git</a>.
It is simple, really simple…​ but enough for my needs.</p>
</div></div>
+
+<div><h2><a href='https://wpitchoune.net/news/call_contribution.html'>Call for contributions for the translation of psensor</a></h2><div class='date'>2016-14-06</div><div class="paragraph">
+<p>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
+translations. If you want to contribute to the translation of psensor
+it is now the good timeframe. See the
+<a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
+</div></div>
</div>
</body>
</html>
\ No newline at end of file
projects / www.git / blobdiff