X-Git-Url: http://git.wpitchoune.net/gitweb/?p=www.git;a=blobdiff_plain;f=www%2Fnews%2Fnews.html;h=6e345db22a9ea79e585433a96a5a4750cf3a0a6d;hp=f1eafa0e4f712463f2fb9f5ad1d7a28b0be38771;hb=b26dc9659fedf65c199f71fc2a0f2233e686bad0;hpb=388192e2f7ecca47f4095717cdc5d02193e33150 diff --git a/www/news/news.html b/www/news/news.html index f1eafa0..6e345db 100644 --- a/www/news/news.html +++ b/www/news/news.html @@ -1,23 +1,48 @@ - + - + +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 +55,10 @@ generates a RSS 2.0 feed.

@@ -60,18 +85,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 +133,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.

+
+
+

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 +182,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 +193,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 +221,13 @@ 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
+
+
+
+

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 +243,34 @@ 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
+
+
+
+

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