2016/06/14 - Call for contributions for the translation of psensor
Asciidoctor to RSS
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.
+Installation of asciidoctor_to_rss
+It is required to install:
+-
+
-
+
maven
+
+ -
+
java (>1.7)
+
+
The sources can be retrieved from GIT:
+git clone git clone https://git.wpitchoune.net/asciidoctor_to_rss.git+
Compilation:
+cd asciidoctor_to_rss +mvn clean install+
Howto write news
+Each news has to be written in a separate Asciidoctor document +and all documents must be dropped into a directory.
+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.
+You can see some examples at https://wpitchoune.net/gitweb/?p=www.git;a=tree;f=src/news;hb=HEAD . +The source document of this news is at https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/news/asciidoctor_to_rss.adoc;hb=HEAD
+Configuration
+The configuration of the utility can be done in text file.
+See an example at https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD .
+Run the utility
+The command line usage is:
+asciidoctor_to_rss.sh <IN_DIR> <OUT_DIR> <CFG_FILE>+
IN_DIR
: the directory containing the news as Asciidoctor documents.
OUT_DIR
: the output directory which contains all generated files
CFG_FILE
: the path to the configuration file
The OUT_DIR
will contain:
-
+
-
+
one HTML file for each Asciidoctor document
+
+ -
+
the
+news.html
file
+ -
+
the
+feed.xml
file which is a feed compatible with RSS v2.0.
+
RSS Feed
It is now possible to follow news and announces of the +website with the following RSS feed: +https://wpitchoune.net/news/feed.xml
+Under the bridge it is automaticaly generated +with a very simple program from Asciidoctor +documents. You can get the sources +from the GIT repository: https://git.wpitchoune.net/asciidoctor_to_rss.git .
+Call for contributions for the translation of psensor
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 @@ -19,7 +145,7 @@ it is now the good timeframe. See the instructions.
2016/06/14 - New website
New website
After being bored with Wordpress for years, the wpitchoune.net website is changing. It is now based on Asciidoctor and a simple shell script to generate it.