From 9234a77da20ecb7929559a65d68534ec39131fe3 Mon Sep 17 00:00:00 2001 From: ng0 Date: Wed, 25 Dec 2019 10:39:59 +0000 Subject: add small documentation for news system. add initial draft for 0.6.0 rel. --- doc/WRITING-NEWS | 68 +++++++++++++++++++++++++++++++++++++++ locale/de/LC_MESSAGES/messages.po | 4 +-- locale/en/LC_MESSAGES/messages.po | 4 +-- locale/es/LC_MESSAGES/messages.po | 4 +-- locale/fr/LC_MESSAGES/messages.po | 4 +-- locale/it/LC_MESSAGES/messages.po | 4 +-- locale/pt/LC_MESSAGES/messages.po | 4 +-- locale/ru/LC_MESSAGES/messages.po | 8 ++--- news/2019-12.html.j2 | 14 ++++++++ www.yml | 5 +++ 10 files changed, 103 insertions(+), 16 deletions(-) create mode 100644 doc/WRITING-NEWS create mode 100644 news/2019-12.html.j2 diff --git a/doc/WRITING-NEWS b/doc/WRITING-NEWS new file mode 100644 index 00000000..65d3ead8 --- /dev/null +++ b/doc/WRITING-NEWS @@ -0,0 +1,68 @@ +WRITING NEWS +------------ + +make_website.py calls gen_site() with "news" and other arguments +when news are to be created. +A news item needs to be added in the file www.yml to 'newsposts' like +so: + +- page: filename.html + date: YYYY-MM-DD + title: the title of the news + abstract: + content: + +abstract and content are filled by make_website.py in a way which works +but needs further improvements, as you can't use jinja2 templating for +urls (yet). +The news are ordered via the yaml file right now, which means that new +posts should get inserted at the top. + +The news is written in the file 'filename.html.j2' in the folder 'news'. +This .html.j2 file must extend "common/news.j2". Since we already have +a
which wraps the content of the filename.html.j2, we do not need +further surrounding elements in the news itself. + +News previews are generated from the plaintext of the first

element +with common html elements (not jinja2!) stripped out. Some but not all +jinja2 elements are stripped as well. +Small newspreviews (as used by taler.net) do not process the first +

element but process the date, title, and pagename. + +The rss is generated in a similar fashion like the website, by processing +a .xml.j2 file and generating a .xml page from it. Too much structure +relies on the yaml file (www.yml). + + +A news template could look like this: + + +news/2022-09-01.html.j2: + +{% extends "common/news.j2" %} +{% block body_content %} +

2022-09-01: GNU Taler v0.7.0 released

+

+ We are happy to announce the release of GNU Taler v0.5.0. + The main new feature is customer tipping, which allows + merchants to pay small rewards directly into a customer's + wallet. Technical improvements include numerous performance + improvements and bug fixes, as well as a new, simpler to use + API for merchants that also enables the implementation of + GNU Taler wallets on platforms that do not support + WebExtensions. +

+

+ The Chrome and Chromium wallets are available for download + via the App store. The exchange, merchant backend and bank + components are on the GNU FTP mirrors. +

+{% endblock body_content %} + + +www.yml: +- page: 2022-09-01.html + date: 2022-09-01 + title: GNU Taler v0.7.0 released + abstract: + content: diff --git a/locale/de/LC_MESSAGES/messages.po b/locale/de/LC_MESSAGES/messages.po index 8cdf7e90..65347eb3 100644 --- a/locale/de/LC_MESSAGES/messages.po +++ b/locale/de/LC_MESSAGES/messages.po @@ -2,14 +2,14 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: 2017-06-02 09:46+0100\n" "Last-Translator: Stefan Kügel \n" "Language-Team: de \n" -"Language: en\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: en\n" "Plural-Forms: nplurals=2; plural=(n!=1)\n" "Generated-By: Babel 2.4.0\n" diff --git a/locale/en/LC_MESSAGES/messages.po b/locale/en/LC_MESSAGES/messages.po index 7e8d5a30..aaacf75c 100644 --- a/locale/en/LC_MESSAGES/messages.po +++ b/locale/en/LC_MESSAGES/messages.po @@ -2,14 +2,14 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: en \n" -"Language: en\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: en\n" "Plural-Forms: nplurals=2; plural=(n!=1)\n" "Generated-By: Babel 2.3.4\n" diff --git a/locale/es/LC_MESSAGES/messages.po b/locale/es/LC_MESSAGES/messages.po index 53226e6e..aa4afe5f 100644 --- a/locale/es/LC_MESSAGES/messages.po +++ b/locale/es/LC_MESSAGES/messages.po @@ -2,14 +2,14 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: 2017-08-10 06:24+0200\n" "Last-Translator: \n" "Language-Team: es \n" -"Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: es\n" "Plural-Forms: nplurals=2; plural=(n!=1);\n" "Generated-By: Babel 2.3.4\n" "X-Generator: Poedit 2.0.2\n" diff --git a/locale/fr/LC_MESSAGES/messages.po b/locale/fr/LC_MESSAGES/messages.po index 6023514a..6d0ab709 100644 --- a/locale/fr/LC_MESSAGES/messages.po +++ b/locale/fr/LC_MESSAGES/messages.po @@ -2,14 +2,14 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: fr \n" -"Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: fr\n" "Plural-Forms: nplurals=2; plural=(n!=1)\n" "Generated-By: Babel 2.3.4\n" diff --git a/locale/it/LC_MESSAGES/messages.po b/locale/it/LC_MESSAGES/messages.po index 30ab0a5b..bacc2a10 100644 --- a/locale/it/LC_MESSAGES/messages.po +++ b/locale/it/LC_MESSAGES/messages.po @@ -2,14 +2,14 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: it \n" -"Language: it\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: it\n" "Plural-Forms: nplurals=2; plural=(n!=1)\n" "Generated-By: Babel 2.3.4\n" diff --git a/locale/pt/LC_MESSAGES/messages.po b/locale/pt/LC_MESSAGES/messages.po index 7bb54722..2ef6e935 100644 --- a/locale/pt/LC_MESSAGES/messages.po +++ b/locale/pt/LC_MESSAGES/messages.po @@ -6,14 +6,14 @@ msgid "" msgstr "" "Project-Id-Version: GNU taler master\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: 2018-01-28 15:27-0200\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Brazilian Portuguese\n" -"Language: pt_BR\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Language: pt_BR\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" "X-Generator: Virtaal 1.0.0-beta1\n" "Generated-By: Babel 2.5.3\n" diff --git a/locale/ru/LC_MESSAGES/messages.po b/locale/ru/LC_MESSAGES/messages.po index 5d4cbcb4..c9871fb7 100644 --- a/locale/ru/LC_MESSAGES/messages.po +++ b/locale/ru/LC_MESSAGES/messages.po @@ -7,16 +7,16 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-12-23 01:47+0100\n" +"POT-Creation-Date: 2019-12-25 10:37+0000\n" "PO-Revision-Date: 2017-12-29 11:14+0100\n" "Last-Translator: FULL NAME \n" "Language-Team: ru \n" -"Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" -"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n" +"Language: ru\n" +"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%" +"10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n" "Generated-By: Babel 2.5.1\n" #: common/base.j2:5 common/news.j2:5 diff --git a/news/2019-12.html.j2 b/news/2019-12.html.j2 new file mode 100644 index 00000000..8c0c5007 --- /dev/null +++ b/news/2019-12.html.j2 @@ -0,0 +1,14 @@ +{% extends "common/news.j2" %} +{% block body_content %} +

2019-12: GNU Taler v0.6.0 released

+

+We are happy to announce the release of GNU Taler v0.6.0. +Here we will describe the changes. +

+

+The Chrome and Chromium wallets are available for download +via the App store. The exchange, merchant backend and +bank components are distributed via the GNU FTP mirrors. +Put some links and checksums here for direct download. +

+{% endblock body_content %} diff --git a/www.yml b/www.yml index ff589c52..4e48793e 100644 --- a/www.yml +++ b/www.yml @@ -26,6 +26,11 @@ staticfiles: - robots.txt meetingnotes: newsposts: + - page: 2019-12.html + date: 2019-12-27 + title: GNU Taler v0.6.0 released + abstract: + content: - page: 2018-04.html date: 2018-04-01 title: GNU Taler v0.5.0 released -- cgit v1.2.3