X-Git-Url: http://git.wpitchoune.net/gitweb/?p=www.git;a=blobdiff_plain;f=www%2Fnews%2Fnews.html;h=14df524ad3f32b87b5abfab468ff833ed4390a77;hp=f1eafa0e4f712463f2fb9f5ad1d7a28b0be38771;hb=3c638b2889f6e5edb61204f457117dd080c2ee4c;hpb=388192e2f7ecca47f4095717cdc5d02193e33150 diff --git a/www/news/news.html b/www/news/news.html index f1eafa0..14df524 100644 --- a/www/news/news.html +++ b/www/news/news.html @@ -1,23 +1,57 @@ - + - + +News - +
- -

Asciidoctor to RSS

2016-11-07
+ + +
+
+

Asciidoctor to RSS

+
2016-11-07
+
+
-

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.

+

In order to ease the edition of this website and +the management of the server, I want it to be purely +static and generated from Asciidoctor documents.

+
+
+

The news part of the website is also written as Asciidoctor +documents, asciidoctor_to_rss is converting them into static +HTML pages and generates a RSS 2.0 file.

@@ -30,10 +64,10 @@ generates a RSS 2.0 feed.

@@ -60,18 +94,47 @@ mvn clean install

Howto write news

-

Each news has to be written in a separate Asciidoctor document +

Each news must be written in an 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 +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

+

Here is an example of news:

+
+
+
+
= Asciidoctor to RSS
+Jean-Philippe Orsini <jeanfi@gmail.com>
+:date: 2016-11-07
+:icons: font
+
+In order to ease the edition of this website and
+the management of the server, I want it to be purely
+static and generated from http://asciidoctor.org[Asciidoctor] documents.
+
+The _news_ part of the website is also written as Asciidoctor
+documents, `asciidoctor_to_rss` is converting them into static
+HTML pages and generates a RSS 2.0 file.
+
+== Installation of asciidoctor_to_rss
+
+It is required to install:
+
+* http://maven.apache.org/download.cgi[Apache Maven] (3.3.9)
+
+* http://www.oracle.com/technetwork/java/javase/downloads/index.html[Java] (Sun JDK >=1.8)
+
+
+
@@ -79,10 +142,37 @@ The source document of this news is at Configuration
-

The configuration of the utility can be done in text file.

+

The configuration file of asciidoctor_to_rss is text file containing key/value pairs.

+
+
+
+
+
feed.title=News
+feed.description=News of the wpitchoune.net website.
+feed.link=https://wpitchoune.net/news/feed.xml
+feed.baseurl=https://wpitchoune.net/news
+
+html.header.file=src/header.html
+
+
+
+

feed.title: the title used for the feed, in the RSS 2.0 and news.html files.

+
+
+

feed.description: the description used in the RSS 2.0 file.

+
+
+

feed.link: URI of the RSS 2.0 file.

-

See an example at https://wpitchoune.net/gitweb/?p=www.git;a=blob;f=src/asciidoctorrss.props;hb=HEAD .

+

feed.baseurl: base URI where the HTML news files will be located.

+
+
+

html.header.file: the content of the denoted file will be added in the head block of +the generated HTML documents.

@@ -101,10 +191,10 @@ The source document of this news is at -

OUT_DIR: the output directory which contains all generated files

+

OUT_DIR: the output directory which contains all generated files.

-

CFG_FILE: the path to the configuration file

+

CFG_FILE: the path to the configuration file.

The OUT_DIR will contain:

@@ -112,20 +202,25 @@ The source document of this news is at
- - -

RSS Feed

2016-04-07
+
+
+
+

RSS Feed

+
2016-04-07
+
+

It is now possible to follow news and announces of the website with the following RSS feed: https://wpitchoune.net/news/feed.xml

@@ -135,9 +230,25 @@ website with the following RSS feed: 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 .

-
- -

New website

2016-14-06
+
+
+
+

Call for contributions for the translation of psensor

+
2016-14-06
+
+
+

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

+
2016-14-06
+
+

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.

@@ -153,15 +264,22 @@ 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.

-
- -

Call for contributions for the translation of psensor

2016-14-06
-

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.

-
+ - + + \ No newline at end of file