X-Git-Url: https://wpitchoune.net/gitweb/?a=blobdiff_plain;f=www%2Fnews%2Ffeed.xml;h=c84e42c0d5687b5a379475d6d50d774800fd8fd0;hb=2dd558f5533166a85045f581b042dd539505ecce;hp=74c6d6720c161ac6b1d417011a89d5f6afc07178;hpb=7ad4278575f413699b6d754ba7cf04cca9cd397c;p=www.git

diff --git a/www/news/feed.xml b/www/news/feed.xml
index 74c6d67..c84e42c 100644
--- a/www/news/feed.xml
+++ b/www/news/feed.xml
@@ -7,7 +7,119 @@
     <item>
       <title>Asciidoctor to RSS</title>
       <link>http://wpitchoune.net/news/asciidoctor_to_rss.html</link>
-      <description />
+      <description>&lt;div id="preamble"&gt;
+&lt;div class="sectionbody"&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;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.&lt;/p&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="sect1"&gt;
+&lt;h2 id="_installation_of_asciidoctor_to_rss"&gt;Installation of asciidoctor_to_rss&lt;/h2&gt;
+&lt;div class="sectionbody"&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;It is required to install:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="ulist"&gt;
+&lt;ul&gt;
+&lt;li&gt;
+&lt;p&gt;maven&lt;/p&gt;
+&lt;/li&gt;
+&lt;li&gt;
+&lt;p&gt;java (&amp;gt;1.7)&lt;/p&gt;
+&lt;/li&gt;
+&lt;/ul&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The sources can be retrieved from GIT:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="listingblock"&gt;
+&lt;div class="content"&gt;
+&lt;pre&gt;git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;Compilation:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="listingblock"&gt;
+&lt;div class="content"&gt;
+&lt;pre&gt;cd asciidoctor_to_rss
+mvn clean install&lt;/pre&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="sect1"&gt;
+&lt;h2 id="_howto_write_news"&gt;Howto write news&lt;/h2&gt;
+&lt;div class="sectionbody"&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;Each news has to be written in a separate Asciidoctor document
+and all documents must be dropped into a directory.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;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.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;You can see some examples at &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; .
+The source document of this news is at &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;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="sect1"&gt;
+&lt;h2 id="_configuration"&gt;Configuration&lt;/h2&gt;
+&lt;div class="sectionbody"&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The configuration of the utility can be done in text file.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;See an example at &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;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="sect1"&gt;
+&lt;h2 id="_run_the_utility"&gt;Run the utility&lt;/h2&gt;
+&lt;div class="sectionbody"&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The command line usage is:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="listingblock"&gt;
+&lt;div class="content"&gt;
+&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;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;IN_DIR&lt;/code&gt;: the directory containing the news as Asciidoctor documents.&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;OUT_DIR&lt;/code&gt;: the output directory which contains all generated files&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;&lt;code&gt;CFG_FILE&lt;/code&gt;: the path to the configuration file&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="paragraph"&gt;
+&lt;p&gt;The &lt;code&gt;OUT_DIR&lt;/code&gt; will contain:&lt;/p&gt;
+&lt;/div&gt;
+&lt;div class="ulist"&gt;
+&lt;ul&gt;
+&lt;li&gt;
+&lt;p&gt;one HTML file for each Asciidoctor document&lt;/p&gt;
+&lt;/li&gt;
+&lt;li&gt;
+&lt;p&gt;the &lt;code&gt;news.html&lt;/code&gt; file&lt;/p&gt;
+&lt;/li&gt;
+&lt;li&gt;
+&lt;p&gt;the &lt;code&gt;feed.xml&lt;/code&gt; file which is a feed compatible with RSS v2.0.&lt;/p&gt;
+&lt;/li&gt;
+&lt;/ul&gt;
+&lt;/div&gt;
+&lt;/div&gt;
+&lt;/div&gt;</description>
       <pubDate>Sun, 10 Jul 2016 22:00:00 GMT</pubDate>
       <guid isPermaLink="false">http://wpitchoune.net/news/asciidoctor_to_rss.html</guid>
       <dc:date>2016-07-10T22:00:00Z</dc:date>