www/news/feed.xml

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