added news
[www.git] / www / news / news.html
index 7c06f43..5285000 100644 (file)
+<!DOCTYPE html>
 <html>
+<head>
+<link rel="stylesheet" href="/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>
+</head>
 <body>
+<div id='header'>
+<h1>News</h1>
+</div><div id='content'>
 
-<div>
-<h2>2016/06/14 - Call for contributions for the translation of psensor</h2>
+<div><h2><a href='http://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 (&gt;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 &lt;IN_DIR&gt; &lt;OUT_DIR&gt; &lt;CFG_FILE&gt;</pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>IN_DIR</code>:</p>
+</div>
+<div class="paragraph">
+<p><code>OUT_DIR</code>:</p>
+</div>
+<div class="paragraph">
+<p><code>CFG_FILE</code>:</p>
+</div>
+</div>
+</div></div>
+
+<div><h2><a href='http://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>
+</div>
+<div class="paragraph">
+<p>Under the bridge it is automaticaly generated
+with a very simple program from Asciidoctor
+documents. You can get the sources
+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><a href='http://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="/psensor/contribute.html">instructions</a>.</p>
-</div>
-</div>
+<a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
+</div></div>
 
-<div>
-<h2>2016/06/14 - New website</h2>
-<div class="paragraph">
+<div><h2><a href='http://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>
@@ -30,7 +145,7 @@ account creation, and backup of databases.</p>
 <p>If you want to know how the website is built, everything is on
 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&#8230;&#8203; but enough for my needs.</p>
-</div>
+</div></div>
 </div>
 </body>
-</html>
+</html>
\ No newline at end of file