www/news/news.html

   1 <!DOCTYPE html>
   2 <html>
   3 <head>
   4 <link rel="stylesheet" href="https://wpitchoune.net/style.css">
   5 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
   6 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
   7 <script src="https://wpitchoune.net/nav.js"></script>
   8 <title>News</title>
   9 </head>
  10         <body>
  11 <div id='header'>
  12 <h1>News</h1>
  13 </div><div id='content'>
  14                         <article>
  15                                 <header>
  16                                         <h1><a href='https://wpitchoune.net/news/psensor_v1_2_1.html'>Psensor v1.2.1</a></h1>
  17 <div class='date'>2020-29-06</div>
  18                                 </header>
  19 <div class="paragraph">
  20 <p>Psensor v1.2.1 has been released.</p>
  21 </div>
  22 <div class="paragraph">
  23 <p>The source tarball can be download at:
  24 <a href="https://wpitchoune.net/psensor/files" class="bare">https://wpitchoune.net/psensor/files</a></p>
  25 </div>
  26 <div class="paragraph">
  27 <p>The information about the changes can be read at:
  28 <a href="https://gitlab.com/jeanfi/psensor/-/raw/v1.2.1/NEWS" class="bare">https://gitlab.com/jeanfi/psensor/-/raw/v1.2.1/NEWS</a></p>
  29 </div>                  </article>
  30                         <article>
  31                                 <header>
  32                                         <h1><a href='https://wpitchoune.net/news/psensor_git_moved_gitlab.html'>Psensor is moving to GitLab</a></h1>
  33 <div class='date'>2018-28-09</div>
  34                                 </header>
  35 <div class="paragraph">
  36 <p>The source code of Psensor is moving to GitLab at:
  37 <a href="https://gitlab.com/jeanfi/psensor" class="bare">https://gitlab.com/jeanfi/psensor</a></p>
  38 </div>                  </article>
  39                         <article>
  40                                 <header>
  41                                         <h1><a href='https://wpitchoune.net/news/psensor_v1_2_0.html'>Psensor v1.2.0</a></h1>
  42 <div class='date'>2017-04-02</div>
  43                                 </header>
  44 <div class="paragraph">
  45 <p>Psensor v1.2.0 has been released.</p>
  46 </div>
  47 <div class="paragraph">
  48 <p>The source can be download at:
  49 <a href="https://wpitchoune.net/psensor/files" class="bare">https://wpitchoune.net/psensor/files</a></p>
  50 </div>
  51 <div class="paragraph">
  52 <p>The news can be read at:
  53 <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>
  54 </div>                  </article>
  55                         <article>
  56                                 <header>
  57                                         <h1><a href='https://wpitchoune.net/news/asciidoctor_to_rss.html'>Asciidoctor to RSS</a></h1>
  58 <div class='date'>2016-11-07</div>
  59                                 </header>
  60 <div id="preamble">
  61 <div class="sectionbody">
  62 <div class="paragraph">
  63 <p>In order to ease the edition of this website and
  64 the management of the server, I want it to be purely
  65 static and generated from <a href="http://asciidoctor.org">Asciidoctor</a> documents.</p>
  66 </div>
  67 <div class="paragraph">
  68 <p>The <em>news</em> part of the website is also written as Asciidoctor
  69 documents, <code>asciidoctor_to_rss</code> is converting them into static
  70 HTML pages and generates a RSS 2.0 file.</p>
  71 </div>
  72 </div>
  73 </div>
  74 <div class="sect1">
  75 <h2 id="_installation_of_asciidoctor_to_rss">Installation of asciidoctor_to_rss</h2>
  76 <div class="sectionbody">
  77 <div class="paragraph">
  78 <p>It is required to install:</p>
  79 </div>
  80 <div class="ulist">
  81 <ul>
  82 <li>
  83 <p><a href="http://maven.apache.org/download.cgi">Apache Maven</a> (3.3.9)</p>
  84 </li>
  85 <li>
  86 <p><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java</a> (Sun JDK &gt;=1.8)</p>
  87 </li>
  88 </ul>
  89 </div>
  90 <div class="paragraph">
  91 <p>The sources can be retrieved from GIT:</p>
  92 </div>
  93 <div class="listingblock">
  94 <div class="content">
  95 <pre>git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git</pre>
  96 </div>
  97 </div>
  98 <div class="paragraph">
  99 <p>Compilation:</p>
 100 </div>
 101 <div class="listingblock">
 102 <div class="content">
 103 <pre>cd asciidoctor_to_rss
 104 mvn clean install</pre>
 105 </div>
 106 </div>
 107 </div>
 108 </div>
 109 <div class="sect1">
 110 <h2 id="_howto_write_news">Howto write news</h2>
 111 <div class="sectionbody">
 112 <div class="paragraph">
 113 <p>Each <em>news</em> must be written in an <a href="http://asciidoctor.org">Asciidoctor</a> document
 114 and all documents must be dropped into a directory.</p>
 115 </div>
 116 <div class="paragraph">
 117 <p>There is not any restriction concerning the syntax because
 118 the utility is based on the Java bridge of Asciidoctor.
 119 I have added an attribute <code>date</code> which allows the utility
 120 to know the publication date of the news.</p>
 121 </div>
 122 <div class="paragraph">
 123 <p>Here is an example of <em>news</em>:</p>
 124 </div>
 125 <div class="listingblock">
 126 <div class="content">
 127 <pre class="highlight"><code class="language-asciidoc" data-lang="asciidoc">= Asciidoctor to RSS
 128 Jean-Philippe Orsini &lt;jeanfi@gmail.com&gt;
 129 :date: 2016-11-07
 130 :icons: font
 131
 132 In order to ease the edition of this website and
 133 the management of the server, I want it to be purely
 134 static and generated from http://asciidoctor.org[Asciidoctor] documents.
 135
 136 The _news_ part of the website is also written as Asciidoctor
 137 documents, `asciidoctor_to_rss` is converting them into static
 138 HTML pages and generates a RSS 2.0 file.
 139
 140 == Installation of asciidoctor_to_rss
 141
 142 It is required to install:
 143
 144 * http://maven.apache.org/download.cgi[Apache Maven] (3.3.9)
 145
 146 * http://www.oracle.com/technetwork/java/javase/downloads/index.html[Java] (Sun JDK &gt;=1.8)</code></pre>
 147 </div>
 148 </div>
 149 <div class="paragraph">
 150 <p>You can see few examples at
 151 <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>.
 152 The source document of this <em>news</em> is at
 153 <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>
 154 </div>
 155 </div>
 156 </div>
 157 <div class="sect1">
 158 <h2 id="_configuration">Configuration</h2>
 159 <div class="sectionbody">
 160 <div class="paragraph">
 161 <p>The configuration file of <code>asciidoctor_to_rss</code> is text file containing key/value pairs.</p>
 162 </div>
 163 <div class="paragraph">
 164 <p>See an example at
 165 <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>
 166 </div>
 167 <div class="listingblock">
 168 <div class="content">
 169 <pre class="highlight"><code class="language-text" data-lang="text">feed.title=News
 170 feed.description=News of the wpitchoune.net website.
 171 feed.link=https://wpitchoune.net/news/feed.xml
 172 feed.baseurl=https://wpitchoune.net/news
 173
 174 html.header.file=src/header.html</code></pre>
 175 </div>
 176 </div>
 177 <div class="paragraph">
 178 <p><code>feed.title</code>: the title used for the feed, in the RSS 2.0 and <code>news.html</code> files.</p>
 179 </div>
 180 <div class="paragraph">
 181 <p><code>feed.description</code>: the description used in the RSS 2.0 file.</p>
 182 </div>
 183 <div class="paragraph">
 184 <p><code>feed.link</code>: URI of the RSS 2.0 file.</p>
 185 </div>
 186 <div class="paragraph">
 187 <p><code>feed.baseurl</code>: base URI where the HTML news files will be located.</p>
 188 </div>
 189 <div class="paragraph">
 190 <p><code>html.header.file</code>: the content of the denoted file will be added in the <code>head</code> block of
 191 the generated HTML documents.</p>
 192 </div>
 193 </div>
 194 </div>
 195 <div class="sect1">
 196 <h2 id="_run_the_utility">Run the utility</h2>
 197 <div class="sectionbody">
 198 <div class="paragraph">
 199 <p>The command line usage is:</p>
 200 </div>
 201 <div class="listingblock">
 202 <div class="content">
 203 <pre>asciidoctor_to_rss.sh &lt;IN_DIR&gt; &lt;OUT_DIR&gt; &lt;CFG_FILE&gt;</pre>
 204 </div>
 205 </div>
 206 <div class="paragraph">
 207 <p><code>IN_DIR</code>: the directory containing the news as Asciidoctor documents.</p>
 208 </div>
 209 <div class="paragraph">
 210 <p><code>OUT_DIR</code>: the output directory which contains all generated files.</p>
 211 </div>
 212 <div class="paragraph">
 213 <p><code>CFG_FILE</code>: the path to the configuration file.</p>
 214 </div>
 215 <div class="paragraph">
 216 <p>The <code>OUT_DIR</code> will contain:</p>
 217 </div>
 218 <div class="ulist">
 219 <ul>
 220 <li>
 221 <p>one HTML file for each Asciidoctor document,</p>
 222 </li>
 223 <li>
 224 <p>the <a href="https://wpitchoune.net/news/news.html"><code>news.html</code></a> file,</p>
 225 </li>
 226 <li>
 227 <p>and the <a href="https://wpitchoune.net/news/news.html"><code>feed.xml</code></a> file which is a feed
 228 compatible with RSS v2.0.</p>
 229 </li>
 230 </ul>
 231 </div>
 232 </div>
 233 </div>                  </article>
 234                         <article>
 235                                 <header>
 236                                         <h1><a href='https://wpitchoune.net/news/added_rss_feed.html'>RSS Feed</a></h1>
 237 <div class='date'>2016-04-07</div>
 238                                 </header>
 239 <div class="paragraph">
 240 <p>It is now possible to follow news and announces of the
 241 website with the following RSS feed:
 242 <a href="https://wpitchoune.net/news/feed.xml" class="bare">https://wpitchoune.net/news/feed.xml</a></p>
 243 </div>
 244 <div class="paragraph">
 245 <p>Under the bridge it is automaticaly generated
 246 with a very simple program from Asciidoctor
 247 documents. You can get the sources
 248 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>
 249 </div>                  </article>
 250                         <article>
 251                                 <header>
 252                                         <h1><a href='https://wpitchoune.net/news/call_contribution.html'>Call for contributions for the translation of psensor</a></h1>
 253 <div class='date'>2016-14-06</div>
 254                                 </header>
 255 <div class="paragraph">
 256 <p>The version 1.2.0 of psensor is going to be released in the coming
 257 weeks. This release will include many changes which impact the
 258 translations. If you want to contribute to the translation of psensor
 259 it is now the good timeframe. See the
 260 <a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
 261 </div>                  </article>
 262                         <article>
 263                                 <header>
 264                                         <h1><a href='https://wpitchoune.net/news/new_website.html'>New website</a></h1>
 265 <div class='date'>2016-14-06</div>
 266                                 </header>
 267 <div class="paragraph">
 268 <p>After being bored with Wordpress for years, the <a href="http://wpitchoune.net">wpitchoune.net</a>
 269 website is changing. It is now based on <a href="http://asciidoctor.org">Asciidoctor</a> and
 270 a simple shell script to generate it.</p>
 271 </div>
 272 <div class="paragraph">
 273 <p>With the help of <a href="http://atom.io">Atom</a> and a couple of addons dedicated to
 274 Asciidoctor, it is easy and quick to write content. I am happy to no
 275 more have to worry about the painful admistration of Wordpress,
 276 upgrading it, taking care of security, spamming of comments and bot
 277 account creation, and backup of databases.</p>
 278 </div>
 279 <div class="paragraph">
 280 <p>If you want to know how the website is built, everything is on
 281 a GIT repository: <a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare">http://git.wpitchoune.net/gitweb/?p=www.git</a>.
 282 It is simple, really simple&#8230;&#8203; but enough for my needs.</p>
 283 </div>                  </article>
 284 </div>
 285 <footer>
 286         <ul>
 287                 <li><i class="fa fa-rss" aria-hidden="true"></i>
 288                         Feed: <a href="https://wpitchoune.net/news/feed.xml">RSS 2.0</a>
 289                 </li>
 290
 291                 <li><i class="fa fa-envelope" aria-hidden="true"></i>
 292                     Email: <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>
 293                 </li>
 294
 295                 <li><i class="fa fa-git-square" aria-hidden="true"></i>
 296                     Source repository: <a href="https://git.wpitchoune.net/gitweb">gitweb</a>
 297                 </li>
 298         </ul>
 299 </footer>
 300         </body>
 301 </html>