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/asciidoctor_to_rss.html'>Asciidoctor to RSS</a></h1>
  17 <div class='date'>2016-11-07</div>
  18                                 </header>
  19 <div id="preamble">
  20 <div class="sectionbody">
  21 <div class="paragraph">
  22 <p>In order to have a website based only on Asciidoctor
  23 documents, I have written a small utility which
  24 converts a set of Asciidoctor documents to HTML pages and
  25 generates a RSS 2.0 feed.</p>
  26 </div>
  27 </div>
  28 </div>
  29 <div class="sect1">
  30 <h2 id="_installation_of_asciidoctor_to_rss">Installation of asciidoctor_to_rss</h2>
  31 <div class="sectionbody">
  32 <div class="paragraph">
  33 <p>It is required to install:</p>
  34 </div>
  35 <div class="ulist">
  36 <ul>
  37 <li>
  38 <p>maven</p>
  39 </li>
  40 <li>
  41 <p>java (&gt;1.7)</p>
  42 </li>
  43 </ul>
  44 </div>
  45 <div class="paragraph">
  46 <p>The sources can be retrieved from GIT:</p>
  47 </div>
  48 <div class="listingblock">
  49 <div class="content">
  50 <pre>git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git</pre>
  51 </div>
  52 </div>
  53 <div class="paragraph">
  54 <p>Compilation:</p>
  55 </div>
  56 <div class="listingblock">
  57 <div class="content">
  58 <pre>cd asciidoctor_to_rss
  59 mvn clean install</pre>
  60 </div>
  61 </div>
  62 </div>
  63 </div>
  64 <div class="sect1">
  65 <h2 id="_howto_write_news">Howto write news</h2>
  66 <div class="sectionbody">
  67 <div class="paragraph">
  68 <p>Each news has to be written in a separate Asciidoctor document
  69 and all documents must be dropped into a directory.</p>
  70 </div>
  71 <div class="paragraph">
  72 <p>There is not any restriction concerning the syntax because
  73 the utility is based on the java bridge of Asciidoctor.
  74 I have added an attribute 'date' which allows the utility
  75 to know the publication date of the news.</p>
  76 </div>
  77 <div class="paragraph">
  78 <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> .
  79 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>
  80 </div>
  81 </div>
  82 </div>
  83 <div class="sect1">
  84 <h2 id="_configuration">Configuration</h2>
  85 <div class="sectionbody">
  86 <div class="paragraph">
  87 <p>The configuration of the utility can be done in text file.</p>
  88 </div>
  89 <div class="paragraph">
  90 <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>
  91 </div>
  92 </div>
  93 </div>
  94 <div class="sect1">
  95 <h2 id="_run_the_utility">Run the utility</h2>
  96 <div class="sectionbody">
  97 <div class="paragraph">
  98 <p>The command line usage is:</p>
  99 </div>
 100 <div class="listingblock">
 101 <div class="content">
 102 <pre>asciidoctor_to_rss.sh &lt;IN_DIR&gt; &lt;OUT_DIR&gt; &lt;CFG_FILE&gt;</pre>
 103 </div>
 104 </div>
 105 <div class="paragraph">
 106 <p><code>IN_DIR</code>: the directory containing the news as Asciidoctor documents.</p>
 107 </div>
 108 <div class="paragraph">
 109 <p><code>OUT_DIR</code>: the output directory which contains all generated files</p>
 110 </div>
 111 <div class="paragraph">
 112 <p><code>CFG_FILE</code>: the path to the configuration file</p>
 113 </div>
 114 <div class="paragraph">
 115 <p>The <code>OUT_DIR</code> will contain:</p>
 116 </div>
 117 <div class="ulist">
 118 <ul>
 119 <li>
 120 <p>one HTML file for each Asciidoctor document</p>
 121 </li>
 122 <li>
 123 <p>the <code>news.html</code> file</p>
 124 </li>
 125 <li>
 126 <p>the <code>feed.xml</code> file which is a feed compatible with RSS v2.0.</p>
 127 </li>
 128 </ul>
 129 </div>
 130 </div>
 131 </div>                  </article>
 132                         <article>
 133                                 <header>
 134                                         <h1><a href='https://wpitchoune.net/news/added_rss_feed.html'>RSS Feed</a></h1>
 135 <div class='date'>2016-04-07</div>
 136                                 </header>
 137 <div class="paragraph">
 138 <p>It is now possible to follow news and announces of the
 139 website with the following RSS feed:
 140 <a href="https://wpitchoune.net/news/feed.xml" class="bare">https://wpitchoune.net/news/feed.xml</a></p>
 141 </div>
 142 <div class="paragraph">
 143 <p>Under the bridge it is automaticaly generated
 144 with a very simple program from Asciidoctor
 145 documents. You can get the sources
 146 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>
 147 </div>                  </article>
 148                         <article>
 149                                 <header>
 150                                         <h1><a href='https://wpitchoune.net/news/new_website.html'>New website</a></h1>
 151 <div class='date'>2016-14-06</div>
 152                                 </header>
 153 <div class="paragraph">
 154 <p>After being bored with Wordpress for years, the <a href="http://wpitchoune.net">wpitchoune.net</a>
 155 website is changing. It is now based on <a href="http://asciidoctor.org">Asciidoctor</a> and
 156 a simple shell script to generate it.</p>
 157 </div>
 158 <div class="paragraph">
 159 <p>With the help of <a href="http://atom.io">Atom</a> and a couple of addons dedicated to
 160 Asciidoctor, it is easy and quick to write content. I am happy to no
 161 more have to worry about the painful admistration of Wordpress,
 162 upgrading it, taking care of security, spamming of comments and bot
 163 account creation, and backup of databases.</p>
 164 </div>
 165 <div class="paragraph">
 166 <p>If you want to know how the website is built, everything is on
 167 a GIT repository: <a href="http://git.wpitchoune.net/gitweb/?p=www.git" class="bare">http://git.wpitchoune.net/gitweb/?p=www.git</a>.
 168 It is simple, really simple&#8230;&#8203; but enough for my needs.</p>
 169 </div>                  </article>
 170                         <article>
 171                                 <header>
 172                                         <h1><a href='https://wpitchoune.net/news/call_contribution.html'>Call for contributions for the translation of psensor</a></h1>
 173 <div class='date'>2016-14-06</div>
 174                                 </header>
 175 <div class="paragraph">
 176 <p>The version 1.2.0 of psensor is going to be released in the coming
 177 weeks. This release will include many changes which impact the
 178 translations. If you want to contribute to the translation of psensor
 179 it is now the good timeframe. See the
 180 <a href="https://wpitchoune.net/psensor/contribute.html">instructions</a>.</p>
 181 </div>                  </article>
 182 </div>
 183 </body>
 184 </html>