added news about psensor 1.2.0 release
[www.git] / www / news / news.html
index 5285000..6e345db 100644 (file)
@@ -1,23 +1,48 @@
 <!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>
+<title>News</title>
 </head>
-<body>
+       <body>
 <div id='header'>
 <h1>News</h1>
 </div><div id='content'>
-
-<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">
+                       <article>
+                               <header>
+                                       <h1><a href='https://wpitchoune.net/news/psensor_v1_2_0.html'>Psensor v1.2.0</a></h1>
+<div class='date'>2017-04-02</div>
+                               </header>
+<div class="paragraph">
+<p>Psensor v1.2.0 has been released.</p>
+</div>
+<div class="paragraph">
+<p>The source can be download at:
+<a href="https://wpitchoune.net/psensor/files" class="bare">https://wpitchoune.net/psensor/files</a></p>
+</div>
+<div class="paragraph">
+<p>The news can be read at:
+<a href="https://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=NEWS.html" class="bare">https://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=NEWS.html</a></p>
+</div>                 </article>
+                       <article>
+                               <header>
+                                       <h1><a href='https://wpitchoune.net/news/asciidoctor_to_rss.html'>Asciidoctor to RSS</a></h1>
+<div class='date'>2016-11-07</div>
+                               </header>
+<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>
+<p>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 <a href="http://asciidoctor.org">Asciidoctor</a> documents.</p>
+</div>
+<div class="paragraph">
+<p>The <em>news</em> part of the website is also written as Asciidoctor
+documents, <code>asciidoctor_to_rss</code> is converting them into static
+HTML pages and generates a RSS 2.0 file.</p>
 </div>
 </div>
 </div>
@@ -30,10 +55,10 @@ generates a RSS 2.0 feed.</p>
 <div class="ulist">
 <ul>
 <li>
-<p>maven</p>
+<p><a href="http://maven.apache.org/download.cgi">Apache Maven</a> (3.3.9)</p>
 </li>
 <li>
-<p>java (&gt;1.7)</p>
+<p><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java</a> (Sun JDK &gt;=1.8)</p>
 </li>
 </ul>
 </div>
@@ -60,18 +85,47 @@ mvn clean install</pre>
 <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
+<p>Each <em>news</em> must be written in an <a href="http://asciidoctor.org">Asciidoctor</a> 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
+the utility is based on the Java bridge of Asciidoctor.
+I have added an attribute <code>date</code> 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>
+<p>Here is an example of <em>news</em>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-asciidoc" data-lang="asciidoc">= Asciidoctor to RSS
+Jean-Philippe Orsini &lt;jeanfi@gmail.com&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 &gt;=1.8)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You can see few 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 <em>news</em> 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>
@@ -79,10 +133,37 @@ The source document of this news is at <a href="https://wpitchoune.net/gitweb/?p
 <h2 id="_configuration">Configuration</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>The configuration of the utility can be done in text file.</p>
+<p>The configuration file of <code>asciidoctor_to_rss</code> is text file containing key/value pairs.</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 class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-text" data-lang="text">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</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>feed.title</code>: the title used for the feed, in the RSS 2.0 and <code>news.html</code> files.</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>
+<p><code>feed.description</code>: the description used in the RSS 2.0 file.</p>
+</div>
+<div class="paragraph">
+<p><code>feed.link</code>: URI of the RSS 2.0 file.</p>
+</div>
+<div class="paragraph">
+<p><code>feed.baseurl</code>: base URI where the HTML news files will be located.</p>
+</div>
+<div class="paragraph">
+<p><code>html.header.file</code>: the content of the denoted file will be added in the <code>head</code> block of
+the generated HTML documents.</p>
 </div>
 </div>
 </div>
@@ -98,18 +179,39 @@ The source document of this news is at <a href="https://wpitchoune.net/gitweb/?p
 </div>
 </div>
 <div class="paragraph">
-<p><code>IN_DIR</code>:</p>
+<p><code>IN_DIR</code>: the directory containing the news as Asciidoctor documents.</p>
 </div>
 <div class="paragraph">
-<p><code>OUT_DIR</code>:</p>
+<p><code>OUT_DIR</code>: the output directory which contains all generated files.</p>
 </div>
 <div class="paragraph">
-<p><code>CFG_FILE</code>:</p>
+<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></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">
+<div class="ulist">
+<ul>
+<li>
+<p>one HTML file for each Asciidoctor document,</p>
+</li>
+<li>
+<p>the <a href="https://wpitchoune.net/news/news.html"><code>news.html</code></a> file,</p>
+</li>
+<li>
+<p>and the <a href="https://wpitchoune.net/news/news.html"><code>feed.xml</code></a> file which is a feed
+compatible with RSS v2.0.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>                 </article>
+                       <article>
+                               <header>
+                                       <h1><a href='https://wpitchoune.net/news/added_rss_feed.html'>RSS Feed</a></h1>
+<div class='date'>2016-04-07</div>
+                               </header>
+<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>
@@ -119,17 +221,13 @@ website with the following RSS feed:
 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="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
-</div></div>
-
-<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">
+</div>                 </article>
+                       <article>
+                               <header>
+                                       <h1><a href='https://wpitchoune.net/news/new_website.html'>New website</a></h1>
+<div class='date'>2016-14-06</div>
+                               </header>
+<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>
@@ -145,7 +243,34 @@ 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>                 </article>
+                       <article>
+                               <header>
+                                       <h1><a href='https://wpitchoune.net/news/call_contribution.html'>Call for contributions for the translation of psensor</a></h1>
+<div class='date'>2016-14-06</div>
+                               </header>
+<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>                 </article>
 </div>
-</body>
+<footer>
+        <ul>
+                <li><i class="fa fa-rss" aria-hidden="true"></i>
+                        Feed: <a href="https://wpitchoune.net/news/feed.xml">RSS 2.0</a>
+                </li>
+
+                <li><i class="fa fa-envelope" aria-hidden="true"></i>
+                    Email: <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>
+                </li>
+
+                <li><i class="fa fa-git-square" aria-hidden="true"></i>
+                    Source repository: <a href="https://git.wpitchoune.net/gitweb">gitweb</a>
+                </li>
+        </ul>
+</footer>
+       </body>
 </html>
\ No newline at end of file