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.
Run the utility
The command line usage is:
asciidoctor_to_rss.sh <IN_DIR> <OUT_DIR> <CFG_FILE>
IN_DIR:
OUT_DIR:
CFG_FILE:
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 it is now the good timeframe. See the instructions.
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.
With the help of Atom and a couple of addons dedicated to Asciidoctor, it is easy and quick to write content. I am happy to no more have to worry about the painful admistration of Wordpress, upgrading it, taking care of security, spamming of comments and bot account creation, and backup of databases.
If you want to know how the website is built, everything is on a GIT repository: http://git.wpitchoune.net/gitweb/?p=www.git. It is simple, really simple… but enough for my needs.