Revert "Prepare DocBook conversion"

This reverts commit 93dc872f67.
2023-04-17 22:15:55 +02:00 · 2023-04-17 22:15:55 +02:00 · 9d31a132e1
parent 93dc872f67
commit 9d31a132e1
67 changed files with 1308 additions and 2784 deletions
--- a/20
+++ b/20
@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = Contesetlgendesvol1
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
--- a/README.dbk
+++ b/README.dbk
@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Nerv Tales Network Documentation</title>
-  </info>
-  <para>
-    XMPP client and server, authoring tool, library, accessibility,
-    adaptation, copyright exemption, risk, pdca, documents and
-    accounting management system.
-  </para>
-  <para>
-    Documentation only
-  </para>
-</article>
--- a/README.rst
+++ b/README.rst
@ -0,0 +1,6 @@
+Nerv Tales Network Documentation
+################################
+
+XMPP client and server, authoring tool, library, accessibility, adaptation, copyright exemption, risk, pdca, documents and accounting management system.
+
+Documentation only
--- a/make.bat
+++ b/make.bat
@ -0,0 +1,36 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+set SPHINXPROJ=Contesetlgendesvol1
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd
--- a/make.sh
+++ b/make.sh
@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+mkdir build
+make -e SPHINXOPTS="-D language='en'" -e BUILDDIR=build/en html
+make -e SPHINXOPTS="-D language='fr'" -e BUILDDIR=build/fr html
+make -e SPHINXOPTS="-D language='nl'" -e BUILDDIR=build/nl html
+
+make -e SPHINXOPTS="-D language='en'" -e BUILDDIR=build/en gemini
+make -e SPHINXOPTS="-D language='fr'" -e BUILDDIR=build/fr gemini
+make -e SPHINXOPTS="-D language='nl'" -e BUILDDIR=build/nl gemini
--- a/requirements.txt
+++ b/requirements.txt
@ -0,0 +1,19 @@
+sphinxcontrib-bibtex
+sphinx-galleria
+pybtex-apa-style
+sphinxcontrib-actdiag
+sphinxcontrib-blockdiag
+sphinxcontrib-nwdiag
+sphinxcontrib-seqdiag
+sphinx-issues
+sphinx-sitemap
+sphinxemoji
+sphinx-git
+sphinx-intl
+sphinxcontrib-bibtex
+reportlab
+ablog
+pybtex
+#sphinx-storymaker
+sphinx-fasvg
+sphinx-nervproject-theme
--- a/source/about.dbk
+++ b/source/about.dbk
@ -1,163 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>About Nerv Tales Network</title>
-  </info>
-  <para>
-    Nerv Project ASBL develops Nerv Tales Network for it's internal
-    usage and all authorized entities for work adaptations. We want to
-    give an open-source and free of charge software to help all people
-    and foundations.
-  </para>
-  <informaltable>
-    <tgroup cols="2">
-      <colspec align="left" />
-      <colspec align="left" />
-      <thead>
-        <row>
-          <entry>
-            Details
-          </entry>
-          <entry>
-            Nerv Project ASBL
-          </entry>
-        </row>
-      </thead>
-      <tbody>
-        <row>
-          <entry>
-            Contact
-          </entry>
-          <entry>
-            contact AT nerv-project.eu
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Status
-          </entry>
-          <entry>
-            ASBL
-          </entry>
-        </row>
-        <row>
-          <entry>
-            <para>
-              Address
-            </para>
-          </entry>
-          <entry>
-            <blockquote>
-<literallayout>Rue Longue 27 Bte K10
-1420 Eigenbrakel
-Belgium</literallayout>
-            </blockquote>
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Phone
-          </entry>
-          <entry>
-            +32 (0)2 319 888 0
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Enterprise
-          </entry>
-          <entry>
-            0756.741.342
-          </entry>
-        </row>
-        <row>
-          <entry>
-            VAT
-          </entry>
-          <entry>
-            BE0756741342
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Editor number KBR
-          </entry>
-          <entry>
-            15066
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Publication
-          </entry>
-          <entry>
-            Nerv Project ASBL
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Production
-          </entry>
-          <entry>
-            Nerv Project ASBL
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Webmaster
-          </entry>
-          <entry>
-            Nerv Project ASBL
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Author
-          </entry>
-          <entry>
-            Nerv Project ASBL except expressly set out
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Video
-          </entry>
-          <entry>
-            Nerv Project ASBL
-          </entry>
-        </row>
-        <row>
-          <entry>
-            Hosting
-          </entry>
-          <entry>
-            IT4Freedom
-          </entry>
-        </row>
-        <row>
-          <entry>
-            IBAN
-          </entry>
-          <entry>
-            BE02 7512 1068 4040
-          </entry>
-        </row>
-        <row>
-          <entry>
-            BIC
-          </entry>
-          <entry>
-            AXABBE22
-          </entry>
-        </row>
-      </tbody>
-    </tgroup>
-  </informaltable>
-  <para>
-    Please contact us if you want to donate, as we need some
-    informations to create your invoice.
-  </para>
-</article>
--- a/source/about.rst
+++ b/source/about.rst
@ -0,0 +1,34 @@
+About Nerv Tales Network
+========================
+
+Nerv Project ASBL develops Nerv Tales Network for
+it's internal usage and all authorized entities for
+work adaptations. We want to give an open-source
+and free of charge software to help all people and
+foundations.
+
+
+======================   ====================
+Details                  Nerv Project ASBL
+======================   ====================
+Contact                  contact AT nerv-project.eu
+Status                   ASBL
+Address                   | Rue Longue 27 Bte K10
+                          | 1420 Eigenbrakel
+                          | Belgium
+Phone                    +32 (0)2 319 888 0
+Enterprise               0756.741.342
+VAT                      BE0756741342
+Editor number KBR        15066
+Publication              Nerv Project ASBL
+Production               Nerv Project ASBL
+Webmaster                Nerv Project ASBL
+Author                   Nerv Project ASBL except expressly set out
+Video                    Nerv Project ASBL
+Hosting                  IT4Freedom
+IBAN                     BE02 7512 1068 4040
+BIC                      AXABBE22
+======================   ====================
+
+Please contact us if you want to donate, as we
+need some informations to create your invoice.
--- a/source/administration/index.dbk
+++ b/source/administration/index.dbk
@ -1,43 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Administration manual</title>
-  </info>
-  <para>
-    Danger
-  </para>
-  <para>
-    Please read this documentation before installing. Nerv Tales Network
-    uses encryption at multiple levels. You need to backup database and
-    keys. You'll lost all your data if you lost keys.
-  </para>
-  <para>
-    Danger
-  </para>
-  <para>
-    Do not use same process and same servers to manage, backup, restore,
-    control, provide or use the core server and the security server.
-    Sensible and private data can not be read in a compromised database
-    without keys to unencrypt. Separate all tools avoid compromising
-    data and keys in same time.
-  </para>
-  <para>
-    Using same server or same bastion for data and for key management is
-    prohibited in some cases.
-  </para>
-  <para>
-    Danger
-  </para>
-  <para>
-    You have to assign Data Protection Officier and Security Officier
-    roles before using software. You can have at most two security
-    officiers. DPO and SO can be the same person but DPO and SO can not
-    be in IT or management team (except some legal cases).
-  </para>
-  <para>
-    Nothing here. Sorry, we're working on the first version of software.
-  </para>
-</article>
--- a/source/administration/index.rst
+++ b/source/administration/index.rst
@ -0,0 +1,34 @@
+Administration manual
+=====================
+
+.. danger::
+
+   Please read this documentation before installing.
+   Nerv Tales Network uses encryption at multiple
+   levels. You need to backup database and keys.
+   You'll lost all your data if you lost keys.
+
+.. danger::
+
+   Do not use same process and same servers to
+   manage, backup, restore, control, provide or
+   use the core server and the security server.
+   Sensible and private data can not be read in
+   a compromised database without keys to unencrypt.
+   Separate all tools avoid compromising data and
+   keys in same time.
+
+   Using same server or same bastion for data and
+   for key management is prohibited in some cases.
+
+.. danger::
+
+   You have to assign Data Protection Officier and
+   Security Officier roles before using software.
+   You can have at most two security officiers. DPO
+   and SO can be the same person but DPO and SO can
+   not be in IT or management team (except some
+   legal cases).
+
+Nothing here. Sorry, we're working on the first
+version of software.
--- a/source/conf.py
+++ b/source/conf.py
@ -0,0 +1,258 @@
+# -*- coding: utf-8 -*-
+import os
+
+project = 'Nerv Tales Network Documentation'
+basename = 'nervtn-docs'
+project_uid = basename  # ISBN, etc.
+baseurl = 'https://tn.nerv-project.eu'
+copyright = '2021, Nerv Project ASBL'
+author = 'Nerv Project ASBL'
+publisher = 'Nerv Project ASBL'
+site_url = 'https://tn.nerv-project.eu/'
+vcs_uri = "https://procrastinator.nerv-project.eu/"
+use_bibtex = True
+use_git = True
+html_favicon = '_static/favicon.ico'
+language = 'en'
+
+version = "0.1"
+release = "0.1"
+
+if use_git:
+    from git import Repo
+    repository_name = 'nerv-project/'
+    repository_name += basename
+
+    repo = Repo(
+        os.path.join(
+            os.path.dirname(os.path.realpath(__file__)),
+            '..'
+        )
+    )
+    repo.config_reader()
+
+    if not repo.head.is_detached:
+        version = repo.head.ref.name
+    release = version + ' [' + repo.commit().hexsha[:20] + ']'
+
+    repository_uri = vcs_uri + repository_name
+    issues_uri = repository_uri + "/issues/{issue}"
+    issues_pr_uri = repository_uri + "/merge_requests/{pr}"
+    issues_commit_uri = repository_uri + "/commit/{commit}"
+    issues_user_uri = vcs_uri + "/{user}"
+
+extensions = [
+    'sphinxemoji.sphinxemoji',
+    'sphinxcontrib.actdiag',
+    'sphinxcontrib.blockdiag',
+    'sphinxcontrib.nwdiag',
+    'sphinxcontrib.seqdiag',
+    'sphinx_galleria',
+    'sphinx.ext.extlinks',
+    'sphinx.ext.intersphinx',
+    'sphinx.ext.todo',
+    'sphinx_issues',
+    'sphinx_sitemap',
+    'sphinx_fasvg',
+]
+
+if use_git:
+    extensions.append('sphinx_git')
+
+if use_bibtex:
+    extensions.append('sphinxcontrib.bibtex')
+
+locale_dirs = ['locale/']
+
+templates_path = ['_templates']
+
+source_suffix = '.rst'
+master_doc = 'index'
+
+exclude_patterns = []
+pygments_style = 'sphinx'
+
+
+html_logo = '_static/logo.svg'
+html_theme = 'nervproject'
+html_theme_options = {
+    "logoalt": project,
+    "social": [
+        ('solid', 'building', 'BCE&nbsp;0756.741.342', 'https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=756741342'),
+        ('solid', 'receipt', 'TVA&nbsp;BE0756741342', 'https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=756741342'),
+        ('solid', 'books', 'KBR&nbsp;Éditeur&nbsp;15066', 'https://www.kbr.be'),
+        ('brands', 'twitter', 'twitter', 'http://twitter.com/@nerv_project'),
+        ('solid', 'mug-hot', 'gitea', 'https://procrastinator.nerv-project.eu/nerv-project/nervtn'),
+        ('solid', 'hashtag', 'xmpp', 'xmpp:technique@clac.nerv-project.eu'),
+        ('regular', 'comments', 'movim', 'https://clac.nerv-project.eu/'),
+        ('solid', 'paragraph', 'gemini', 'gemini://tales.nerv-project.eu'),
+        ('solid', 'rss', 'rss', 'https://www.nerv-project.eu/blog/atom.xml'),
+    ],
+    'external_languages': [
+        # ('code', 'name', 'baseurl'),
+        ('en', 'en', 'https://tn.nerv-project.eu/en'),
+        ('fr', 'fr', 'https://tn.nerv-project.eu/fr'),
+        ('nl', 'nl', 'https://tn.nerv-proect.eu/nl'),
+    ],
+    "twitter_user": "nerv_project",
+    "fathom": {
+        'url': '//casanabo.nerv-project.eu',
+        'id': 'BJLEM',
+    },
+    "license": {
+        'type': 'EUPL-1.2',
+        'text': 'EUPL-1.2',
+        'subtype': '',
+        'version': '',
+        'url': 'https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12'
+    }
+}
+html_static_path = ['_static']
+html_sidebars = {
+    '**': [
+        'about.html',
+        'postcard.html', 'util/sidetoc.html',
+        'recentposts.html', 'tagcloud.html',
+        'categories.html',  'archives.html',
+        'social.html',
+        'util/searchbox.html',
+    ],
+}
+html_baseurl = baseurl
+
+htmlhelp_basename = basename
+
+pyppeteer_pdf_options = {
+    'printBackground': True,
+    'format': 'A4',
+    'margin': {
+        'top': '0mm',
+        'bottom': '0mm',
+        'left': '0mm',
+        'right': '0mm'
+    }
+}
+
+latex_engine = 'xelatex'
+latex_toplevel_sectioning = 'chapter'
+latex_show_urls = 'footnote'
+latex_elements = {
+    # 'figure_align': 'htbp',
+    # 'extraclassoptions': '',
+    'papersize': 'a4paper',
+    'pointsize': '12pt',
+    'extraclassoptions': 'twoside',
+    'fontpkg': r'''
+        \defaultfontfeatures{Ligatures=TeX}
+        \setmainfont{Luciole}
+        \setsansfont{Luciole}
+    '''
+}
+latex_show_pagerefs = True
+latex_documents = [
+    (master_doc, basename + '.tex', project,
+     author, 'book'),
+]
+
+
+man_pages = [
+    (master_doc, basename.lower(), project, [author], 1)
+]
+
+
+texinfo_documents = [
+    (master_doc, basename, project,
+     author, basename, '',
+     'Miscellaneous'),
+]
+
+
+epub_title = project
+epub_author = author
+epub_publisher = publisher
+epub_copyright = copyright
+
+epub_identifier = project_uid
+epub_uid = ''
+epub_exclude_files = [
+   'index.xhtml',
+   'search.xhtml',
+   'blog.xhtml',
+   'submit_success.xhtml',
+   'contact.xhtml',
+   '403.xhtml',
+   '404.xhtml',
+   'blog/archive.xhtml',
+   'blog/category.xhtml',
+   'blog/drafts.xhtml',
+   'blog/author.xhtml',
+   'blog/language.xhtml',
+   'blog/location.xhtml',
+   'blog/location/braine-lalleud.xhtml',
+   'blog/language/francais.xhtml',
+   'blog/author/kujiu.xhtml',
+   'blog/2014.xhtml',
+   'blog/2015.xhtml',
+   'blog/2016.xhtml',
+   'blog/2017.xhtml',
+   'blog/2018.xhtml',
+   'blog/2019.xhtml',
+   'blog/2020.xhtml',
+   'blog/2021.xhtml',
+   'blog/2022.xhtml',
+   'blog/2023.xhtml',
+   'blog/2024.xhtml',
+   'google82f190054a773ed9.xhtml',
+   'nav.xhtml',
+]
+epub_theme = 'epub'
+epub_show_urls = 'footnote'
+
+diag_antialias = True
+diag_transparency = True
+diag_html_image_format = "SVG"
+diag_latex_image_format = "PDF"
+diag_fontpath = os.path.dirname(os.path.realpath(__file__))
+diag_fontpath = os.path.join(diag_fontpath, '_static', 'biolinumrah.ttf')
+diag_debug = False
+
+actdiag_antialias = diag_antialias
+actdiag_transparency = diag_transparency
+actdiag_html_image_format = diag_html_image_format
+actdiag_latex_image_format = diag_latex_image_format
+actdiag_fontpath = diag_fontpath
+actdiag_debug = diag_debug
+
+blockdiag_antialias = diag_antialias
+blockdiag_transparency = diag_transparency
+blockdiag_html_image_format = diag_html_image_format
+blockdiag_fontpath = diag_fontpath
+blockdiag_latex_image_format = diag_latex_image_format
+blockdiag_debug = diag_debug
+
+nwdiag_antialias = diag_antialias
+nwdiag_transparency = diag_transparency
+nwdiag_html_image_format = diag_html_image_format
+nwdiag_latex_image_format = diag_latex_image_format
+nwdiag_fontpath = diag_fontpath
+nwdiag_debug = diag_debug
+
+seqdiag_antialias = diag_antialias
+seqdiag_transparency = diag_transparency
+seqdiag_html_image_format = diag_html_image_format
+seqdiag_latex_image_format = diag_latex_image_format
+seqdiag_fontpath = diag_fontpath
+seqdiag_debug = diag_debug
+
+
+if use_bibtex:
+    from pybtex.style import formatting
+    from pybtex.richtext import Text, Tag
+
+    class NervPybtexStyle(formatting.BaseStyle):
+        def format_article(self, entry):
+            return Text(Tag('em', entry.fields['key']))
+
+    bibtex_bibfiles = ['refs.bib']
+    bibtex_default_style = 'unsrtalpha'
+    bibtex_reference_style = 'label'
--- a/source/contributing.dbk
+++ b/source/contributing.dbk
@ -1,78 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Contributing</title>
-  </info>
-  <section xml:id="how-to-contribute">
-    <title>How to contribute?</title>
-    <para>
-      Before contributing, you must accept your work will be published
-      with EUPL-1.2 license or newer version. You keep intellectual
-      property of your contribution.
-    </para>
-    <para>
-      You can join us on XMPP, on
-      <link xlink:href="xmpp:technique@clac.nerv-project.eu">technique@clac.nerv-project.eu</link>
-      channel.
-    </para>
-    <para>
-      You can find all tickets (not only technical) in
-      <link xlink:href="https://procrastinator.nerv-project.eu/nerv-project/nervtn/issues">our
-      gitea instance</link>.
-    </para>
-  </section>
-  <section xml:id="wheres-the-source-code">
-    <title>Where's the source code?</title>
-    <para>
-      All code is in
-      <link xlink:href="https://procrastinator.nerv-project.eu/nerv-project/nervtn">our
-      git repository</link>.
-    </para>
-  </section>
-  <section xml:id="can-i-contribute-if-im-not-a-developer">
-    <title>Can I contribute if I'm not a developer?</title>
-    <para>
-      Of course, yes! We need a lot of competencies, like:
-    </para>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>
-          translating;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          testing;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          specifying interfaces;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          managing community;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          writing manuals;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          helping users;
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          and all you can do!
-        </para>
-      </listitem>
-    </itemizedlist>
-  </section>
-</article>
--- a/source/contributing.rst
+++ b/source/contributing.rst
@ -0,0 +1,35 @@
+Contributing
+============
+
+How to contribute?
+~~~~~~~~~~~~~~~~~~
+
+Before contributing, you must accept your work will be
+published with EUPL-1.2 license or newer version. You
+keep intellectual property of your contribution.
+
+You can join us on XMPP, on
+`technique@clac.nerv-project.eu <xmpp:technique@clac.nerv-project.eu>`_
+channel.
+
+You can find all tickets (not only technical) in
+`our gitea instance <https://procrastinator.nerv-project.eu/nerv-project/nervtn/issues>`_.
+
+Where's the source code?
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+All code is in
+`our git repository <https://procrastinator.nerv-project.eu/nerv-project/nervtn>`_.
+
+Can I contribute if I'm not a developer?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Of course, yes! We need a lot of competencies, like:
+
+- translating;
+- testing;
+- specifying interfaces;
+- managing community;
+- writing manuals;
+- helping users;
+- and all you can do!
--- a/source/developing/index.dbk
+++ b/source/developing/index.dbk
@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Developing manual</title>
-  </info>
-  <para>
-    Nothing here. Sorry, we're working on the first version of software.
-  </para>
-</article>
--- a/source/developing/index.rst
+++ b/source/developing/index.rst
@ -0,0 +1,5 @@
+Developing manual
+=================
+
+Nothing here. Sorry, we're working on the first
+version of software.
--- a/source/history.rst
+++ b/source/history.rst
@ -0,0 +1,21 @@
+Document history
+================
+
+Current version
+^^^^^^^^^^^^^^^
+
+These informations are automatically generated
+by git.
+
+.. git_commit_detail::
+    :branch:
+    :commit:
+    :uncommitted:
+    :untracked:
+    :sha_length: 20
+
+Versions log
+^^^^^^^^^^^^
+
+.. git_changelog::
+   :revisions: 1000000
--- a/source/index.dbk
+++ b/source/index.dbk
@ -1,144 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Nerv Tales Network Documentation</title>
-  </info>
-  <para>
-    Nerv Tales Network is a free software to manage all aspects about
-    books. It fits needs of writers, editors, adaptation to people with
-    specific needs, libraries, book shops, online libraries and book
-    shops, museums, schools, ebooks distributors and readers. It
-    manages:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Accessibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Documents
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Communication
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Stocks and items
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Projects
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Accounting
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Risks and objectives
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Learning and documentary surveillance
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        On-line services
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Help and consultancy
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        High security and confidentiality
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Synchronization
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Note
-  </para>
-  <para>
-    You can also use Nerv Tales Network on other applications if it fits
-    your needs.
-  </para>
-  <para>
-    Danger
-  </para>
-  <para>
-    Even if Nerv Tales Network have enough features and security
-    systems, it can't be used in the following cases:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        classified documents management and storage;
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        health management except for entities authorized to deliver
-        adaptations of work of art;
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        any activity where the software need an agreement, a
-        certification, an habilitation, an audit or other administrative
-        stuff.
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    However, you can use Nerv Tales Network in these cases if you pass
-    all legal steps by yourself. You can't ask help to the community or
-    to Nerv Project ASBL in these cases, and you must conform to the
-    EUPL-1.2 license.
-  </para>
-  <para>
-    All works, the software, all plugins and documentations are under
-    the EUPL-1.2 license.
-  </para>
-  <para>
-    about roadmap contributing history
-  </para>
-  <para>
-    Please select the documentation you want to consult.
-  </para>
-  <para>
-    user/index administration/index developing/index
-    specifications/index
-  </para>
-  <section xml:id="bibliography">
-    <title>Bibliography</title>
-    <para>
-      Important
-    </para>
-    <para>
-      Even if we use standards in our bibliography and if we want to
-      implement them, Nerv Tales Network and Nerv Project ASBL are not
-      certified. If you need certification for your software, you must
-      pass them yourself.
-    </para>
-  </section>
-</article>
--- a/source/index.rst
+++ b/source/index.rst
@ -0,0 +1,84 @@
+Nerv Tales Network Documentation
+################################
+
+Nerv Tales Network is a free software to manage all
+aspects about books. It fits needs of writers,
+editors, adaptation to people with specific needs,
+libraries, book shops, online libraries and book
+shops, museums, schools, ebooks distributors and
+readers. It manages:
+
+- Accessibility
+- Documents
+- Communication
+- Stocks and items
+- Projects
+- Accounting
+- Risks and objectives
+- Learning and documentary surveillance
+- On-line services
+- Help and consultancy
+- High security and confidentiality
+- Synchronization
+
+.. note::
+
+   You can also use Nerv Tales Network on other
+   applications if it fits your needs.
+
+.. danger::
+
+   Even if Nerv Tales Network have enough features
+   and security systems, it can't be used in the
+   following cases:
+
+   - classified documents management and storage;
+   - health management except for entities
+     authorized to deliver adaptations of work of
+     art;
+   - any activity where the software need an
+     agreement, a certification, an habilitation,
+     an audit or other administrative stuff.
+
+   However, you can use Nerv Tales Network in these
+   cases if you pass all legal steps by yourself.
+   You can't ask help to the community or to
+   Nerv Project ASBL in these cases, and you must
+   conform to the EUPL-1.2 license.
+
+All works, the software, all plugins and
+documentations are under the EUPL-1.2 license.
+
+.. toctree::
+   :hidden:
+   :caption: Community
+
+   about
+   roadmap
+   contributing
+   history
+
+Please select the documentation you want to consult.
+
+.. toctree::
+   :caption: Documentation
+   :maxdepth: 1
+
+   user/index
+   administration/index
+   developing/index
+   specifications/index
+
+Bibliography
+~~~~~~~~~~~~
+
+.. important::
+
+   Even if we use standards in our bibliography and if
+   we want to implement them, Nerv Tales Network and
+   Nerv Project ASBL are not certified. If you need
+   certification for your software, you must pass them
+   yourself.
+
+.. bibliography::
+   :all:
--- a/source/roadmap.dbk
+++ b/source/roadmap.dbk
@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Roadmap</title>
-  </info>
-  
-</article>
--- a/source/roadmap.rst
+++ b/source/roadmap.rst
@ -0,0 +1,2 @@
+Roadmap
+=======
--- a/source/specifications/accessibility.dbk
+++ b/source/specifications/accessibility.dbk
@ -1,39 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Accessibility</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        WCAG 3.0 :cite<literal>WCAG3.0</literal> Gold level
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Conforms to COGA-Usable :cite<literal>COGA-Usable</literal>,
-        UAAG :cite<literal>UAAG</literal> and ATAG
-        :cite<literal>ATAG</literal>
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Compatibility with EN301549 :cite<literal>EN301549</literal>
-        requirements
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Client in Qt, Web, telnet, SSH, TUI and audio only
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Hardware client
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/accessibility.rst
+++ b/source/specifications/accessibility.rst
@ -0,0 +1,10 @@
+Accessibility
+=============
+
+- WCAG 3.0 :cite:p:`WCAG3.0` Gold level
+- Conforms to COGA-Usable :cite:p:`COGA-Usable`,
+  UAAG :cite:p:`UAAG` and ATAG :cite:p:`ATAG`
+- Compatibility with EN301549 :cite:p:`EN301549`
+  requirements
+- Client in Qt, Web, telnet, SSH, TUI and audio only
+- Hardware client
--- a/source/specifications/accounting.dbk
+++ b/source/specifications/accounting.dbk
@ -1,89 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Accounting</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Implementing IFRS standard for small and middle-sized
-        organization (but no certification)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Double-entry book-keeping
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Multi-currency with conversion rates
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        CO2 equivalent double-entry book-keeping (parallel accounting to
-        manage environmental impacts)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Purchases, loans, subscriptions and selling
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Point of sale, with specific screens for catering, libraries,
-        shops, etc.
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Self-service point of sale
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Payment terminal
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Legal reporting
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        VAT declaration in XML for Belgium
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Human resources
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Paid and unpaid leaves
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Payroll
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Taxes calculator (general, specific products, employees, etc.)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Copyright bills, copyright exemption declarations
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/accounting.rst
+++ b/source/specifications/accounting.rst
@ -0,0 +1,22 @@
+Accounting
+==========
+
+- Implementing IFRS standard for small and middle-sized
+  organization (but no certification)
+- Double-entry book-keeping
+- Multi-currency with conversion rates
+- CO2 equivalent double-entry book-keeping (parallel
+  accounting to manage environmental impacts)
+- Purchases, loans, subscriptions and selling
+- Point of sale, with specific screens for catering,
+  libraries, shops, etc.
+- Self-service point of sale
+- Payment terminal
+- Legal reporting
+- VAT declaration in XML for Belgium
+- Human resources
+- Paid and unpaid leaves
+- Payroll
+- Taxes calculator (general, specific products,
+  employees, etc.)
+- Copyright bills, copyright exemption declarations
--- a/source/specifications/communication.dbk
+++ b/source/specifications/communication.dbk
@ -1,115 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Communication</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Secure chat and group chat (XMPP backend)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Text, audio and video chatting (XMPP backend)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add reactions and replies to messages
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Link to documents or other object in Nerv Tales Network (use
-        generic link to object)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Mail client and delivery system
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Share email folders and addresses with other users
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Confidential emails must disappear after the first user set it
-        as it (like disability proof)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Convert emails to tickets, save attachments as documents
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        SMTP, IMAP, EAS and JMAP compatibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Contact management with tags and groups (CardDAV compatibility)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Birthday announcements
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Event management and sharing (CalDAV compatibility)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Calendar management (internal and external)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Online registration to event/adviser
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Contact forms
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Bulletin board system with hierarchical categories (mixing with
-        XMPP group chat) - public and private boards
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Phone calls (can write textual notes during a call) with SIP
-        compatibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Communication with federated instances (XMPP chat)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Ticket management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Notifications (XMPP ?)
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/communication.rst
+++ b/source/specifications/communication.rst
@ -0,0 +1,33 @@
+Communication
+=============
+
+- Secure chat and group chat (XMPP backend)
+- Text, audio and video chatting (XMPP backend)
+- Add reactions and replies to messages
+- Link to documents or other object in Nerv Tales
+  Network (use generic link to object)
+- Mail client and delivery system
+- Share email folders and addresses with other
+  users
+- Confidential emails must disappear after the first
+  user set it as it (like disability proof)
+- Convert emails to tickets, save attachments as
+  documents
+- SMTP, IMAP, EAS and JMAP compatibility
+- Contact management with tags and groups (CardDAV
+  compatibility)
+- Birthday announcements
+- Event management and sharing (CalDAV
+  compatibility)
+- Calendar management (internal and external)
+- Online registration to event/adviser
+- Contact forms
+- Bulletin board system with hierarchical categories
+  (mixing with XMPP group chat) - public and
+  private boards
+- Phone calls (can write textual notes during a
+  call) with SIP compatibility
+- Communication with federated instances (XMPP
+  chat)
+- Ticket management
+- Notifications (XMPP ?)
--- a/source/specifications/documents.dbk
+++ b/source/specifications/documents.dbk
@ -1,536 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Documents</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Documents in standard and simplified languages
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Documents in sign languages
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        In video, audio or text
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Read with speech synthesis or audio files
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Subtitles for video
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Audio-description for video
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Text-description for video
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Transcription of video
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Bibliography management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Citation management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Glossary
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Highlight current sentence in multimedia presentation (like
-        audio+text or video+text or audio+video+text)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Styles for descriptions, dialogues, actions and other types of
-        paragraphs/sentences
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Styles for verbs, nouns, and other grammatical functions
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Style for grammatical groups
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add little images and sounds for better comprehension
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Alt text for images (mandatory)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage translations
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        DRM and encryption
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Credentials and classification (secret and zone level)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Versioning (with git)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Dictionary (with synonyms)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Digital and physical documents (link with stocks)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        External and internal use, licensing
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Peer-adaptation with other organizations
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Share by link, with other users, with federated instance, by
-        mail, by chat or by DODP (if permitted, DRMize or encrypt if
-        needed)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        WebDAV synchronization
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Slide show for photo
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Compatibility with PDF, ePub, HTML, RTF, RST, Markdown, docx,
-        doc, xls, xlsx, odt, ods and DAISY
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Connector for OCR
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Automatic and manual classification by hierarchical tags
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Printing to authorized printers (standard, label, braille)
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Document creation:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Raw, vi and WYSIWYG mode
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add video track, synchronize with text
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add audio track, synchronize with text
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Multi-track audio/video editor (with simple tools)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add images (alt mandatory, option if images is only to help
-        comprehension)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Import existing audio or video clip
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Import existing text
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Import existing images
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Organize titles
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Characters, items, arenas, connections, scenes,
-        episodes/chapters, symbols and themes sheets
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Dictionary and synonyms
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Translation interface
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Diagram editor (general, network, sequences, user activities)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Bibliography editor
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    For stories and fictions:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Resumes available
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Character, arena, item sheets updated during the reading
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Maps with characters
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        List of characters in scene
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Timeline with events
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Avatar for each character, item and arena
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Display avatar on each dialogue line
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Display avatar on each reference
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Display mood when changing
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Classic and visual novel presentation
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Metadata:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Compatibility with RDA :cite<literal>RDA</literal>,
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Peering with other instances
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Synchronizing with other catalogs (OPAC, LRM, Fediverse,
-        Vidiverse, Electre, Dilibel, Dilicom, PRISM and others)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Compatibility with ISBD, MARC21, MarcXML, UNIMARC, INTERMARC,
-        DID - Digital Item Declaration, DCMI, BIBFRAME, MODS, EAD, METS,
-        PREMIS, MPEG21-DIDL, RDA, RDA-FR, FRAD, FRSAD, FRBR and LRM
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Support of ISBN, ISSN and EAN
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Recommendation
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Difficulty level (syntax, vocabulary, spelling, specialization)
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Copyright (only European laws):
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Prepare declarations for copyright collects
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage licenses, number of digital copies, number of days of
-        loans, number of loans, number of digitalizations, number of
-        photocopies (with pages ranges)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        DRM (LCP), encryption, PDTB and tokens management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Warns about obligation of anti-copy paper
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage copyright exemptions with legal requirements (with forms)
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    For all exemptions:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Not in public domain
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        License is less permissive than the exemption
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Not for commercial use
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Exemption is for a limited number of special cases
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Do not strike a blow at normal business
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Do not harm legitimate interest of holder of the right
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Exemption for adaptation for disabled people:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Authorization of legal entity
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Link to a legal license or a book in stock
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        No adaptation in standard market
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Restrict reproduction, distribution, communication and disposal
-        (DRM, encryption, anti-copy paper or ink, braille)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Diligently adapt
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Display all requirements on the web sites (with automatic
-        refresh)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Link to the membership of beneficiary
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Active proof of disability of beneficiary
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Active license on adaptation
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    Submission for editing:
-  </para>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Limit by dates and categories
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Check-list for requirements
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Form with personal data and selection of committee
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Add document, automatically convert to internal structure
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Check if new format is correct
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Personal account for submitter
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Traceability of reading and decision process, with reporting to
-        the submitter
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Number of documents to review before in the submitter report
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Decisions are anonymous, no private data to review a manuscript
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Template for contracts
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        If used by authors: follow-up to your submissions in your own
-        instance, manage contracts and accounting
-      </para>
-    </listitem>
-  </itemizedlist>
-  <para>
-    See also stock and items management for other properties of physical
-    documents.
-  </para>
-</article>
--- a/source/specifications/documents.rst
+++ b/source/specifications/documents.rst
@ -0,0 +1,156 @@
+Documents
+=========
+
+- Documents in standard and simplified languages
+- Documents in sign languages
+- In video, audio or text
+- Read with speech synthesis or audio files
+- Subtitles for video
+- Audio-description for video
+- Text-description for video
+- Transcription of video
+- Bibliography management
+- Citation management
+- Glossary
+- Highlight current sentence in multimedia
+  presentation (like audio+text or video+text or
+  audio+video+text)
+- Styles for descriptions, dialogues, actions and
+  other types of paragraphs/sentences
+- Styles for verbs, nouns, and other grammatical
+  functions
+- Style for grammatical groups
+- Add little images and sounds for better
+  comprehension
+- Alt text for images (mandatory)
+- Manage translations
+- DRM and encryption
+- Credentials and classification (secret and
+  zone level)
+- Versioning (with git)
+- Dictionary (with synonyms)
+- Digital and physical documents (link with stocks)
+- External and internal use, licensing
+- Peer-adaptation with other organizations
+- Share by link, with other users, with federated
+  instance, by mail, by chat or by DODP (if
+  permitted, DRMize or encrypt if needed)
+- WebDAV synchronization
+- Slide show for photo
+- Compatibility with PDF, ePub, HTML, RTF, RST,
+  Markdown, docx, doc, xls, xlsx, odt, ods and DAISY
+- Connector for OCR
+- Automatic and manual classification by
+  hierarchical tags
+- Printing to authorized printers (standard, label,
+  braille)
+
+Document creation:
+
+- Raw, vi and WYSIWYG mode
+- Add video track, synchronize with text
+- Add audio track, synchronize with text
+- Multi-track audio/video editor (with simple tools)
+- Add images (alt mandatory, option if images is
+  only to help comprehension)
+- Import existing audio or video clip
+- Import existing text
+- Import existing images
+- Organize titles
+- Characters, items, arenas, connections, scenes,
+  episodes/chapters, symbols and themes sheets
+- Dictionary and synonyms
+- Translation interface
+- Diagram editor (general, network, sequences, user
+  activities)
+- Bibliography editor
+
+For stories and fictions:
+
+- Resumes available
+- Character, arena, item sheets updated during the
+  reading
+- Maps with characters
+- List of characters in scene
+- Timeline with events
+- Avatar for each character, item and arena
+- Display avatar on each dialogue line
+- Display avatar on each reference
+- Display mood when changing
+- Classic and visual novel presentation
+
+Metadata:
+
+- Compatibility with RDA :cite:p:`RDA`,
+- Peering with other instances
+- Synchronizing with other catalogs (OPAC, LRM,
+  Fediverse, Vidiverse, Electre, Dilibel, Dilicom,
+  PRISM and others)
+- Compatibility with ISBD, MARC21, MarcXML, UNIMARC,
+  INTERMARC, DID - Digital Item Declaration,
+  DCMI, BIBFRAME, MODS, EAD, METS, PREMIS,
+  MPEG21-DIDL, RDA, RDA-FR, FRAD,
+  FRSAD, FRBR and LRM
+- Support of ISBN, ISSN and EAN
+- Recommendation
+- Difficulty level (syntax, vocabulary, spelling,
+  specialization)
+
+Copyright (only European laws):
+
+- Prepare declarations for copyright collects
+- Manage licenses, number of digital copies, number
+  of days of loans, number of loans, number of
+  digitalizations, number of photocopies (with
+  pages ranges)
+- DRM (LCP), encryption, PDTB and tokens management
+- Warns about obligation of anti-copy paper
+- Manage copyright exemptions with legal
+  requirements (with forms)
+
+For all exemptions:
+
+- Not in public domain
+- License is less permissive than the exemption
+- Not for commercial use
+- Exemption is for a limited number of special cases
+- Do not strike a blow at normal business
+- Do not harm legitimate interest of holder of the
+  right
+
+Exemption for adaptation for disabled people:
+
+- Authorization of legal entity
+- Link to a legal license or a book in stock
+- No adaptation in standard market
+- Restrict reproduction, distribution, communication
+  and disposal (DRM, encryption, anti-copy paper
+  or ink, braille)
+- Diligently adapt
+- Display all requirements on the web sites (with
+  automatic refresh)
+- Link to the membership of beneficiary
+- Active proof of disability of beneficiary
+- Active license on adaptation
+
+Submission for editing:
+
+- Limit by dates and categories
+- Check-list for requirements
+- Form with personal data and selection of committee
+- Add document, automatically convert to internal
+  structure
+- Check if new format is correct
+- Personal account for submitter
+- Traceability of reading and decision process, with
+  reporting to the submitter
+- Number of documents to review before in the
+  submitter report
+- Decisions are anonymous, no private data to review
+  a manuscript
+- Template for contracts
+- If used by authors: follow-up to your submissions
+  in your own instance, manage contracts and accounting
+
+See also stock and items management for other
+properties of physical documents.
--- a/source/specifications/help.dbk
+++ b/source/specifications/help.dbk
@ -1,110 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Help management</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Internal and external help and documentation system
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Ticketing system and contact forms
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Send notifications
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Questions and answers
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Documentation, blog and website management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Chat (see <literal>communication</literal>)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Bulletin board system (see <literal>communication</literal>)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Knowledge management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Record in beneficiary/user file
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Credentials on sensitive data depending on level of privacy
-        (health data in database)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Private messages to personal adviser
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        ITIL implementation of service center
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        GDPR complaints in separated channel
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Security complaints in separated channel
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Public legal information management (DPO, privacy, terms of use,
-        terms of sale, address, legal identifiers, etc.)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Internal legal information management (anti-harassment,
-        anti-bribery, human resources documentation, emergency
-        documentation)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Quality documentation, process documentation
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Disaster recovery plan
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Crisis communication manual
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/help.rst
+++ b/source/specifications/help.rst
@ -0,0 +1,28 @@
+Help management
+===============
+
+- Internal and external help and documentation
+  system
+- Ticketing system and contact forms
+- Send notifications
+- Questions and answers
+- Documentation, blog and website management
+- Chat (see :doc:`communication`)
+- Bulletin board system (see :doc:`communication`)
+- Knowledge management
+- Record in beneficiary/user file
+- Credentials on sensitive data depending on level
+  of privacy (health data in database)
+- Private messages to personal adviser
+- ITIL implementation of service center
+- GDPR complaints in separated channel
+- Security complaints in separated channel
+- Public legal information management (DPO,
+  privacy, terms of use, terms of sale, address,
+  legal identifiers, etc.)
+- Internal legal information management
+  (anti-harassment, anti-bribery, human resources
+  documentation, emergency documentation)
+- Quality documentation, process documentation
+- Disaster recovery plan
+- Crisis communication manual
--- a/source/specifications/index.dbk
+++ b/source/specifications/index.dbk
@ -1,108 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Specifications</title>
-  </info>
-  <section xml:id="neps">
-    <title>NEPs</title>
-    <para>
-      Nerv Tales Network Enhancement Proposals are the official
-      continuous specification of project and of management process. See
-      doc:neps/00001 for more information.
-    </para>
-    <para>
-      Note
-    </para>
-    <para>
-      Title of NEP contains its status:
-    </para>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>
-          [E.] Experimental
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [P.] Proposed
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [S.] Stable
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [D.] Deprecated
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [O.] Obsolete
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [R.] Rejected or retracted
-        </para>
-      </listitem>
-    </itemizedlist>
-    <para>
-      and type:
-    </para>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>
-          [.I] Informational
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [.P] Procedural
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [.F] Feature
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [.A] Architectural
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          [.N] Protocol
-        </para>
-      </listitem>
-    </itemizedlist>
-    <section xml:id="active">
-      <title>Active</title>
-      <para>
-        neps/00000 neps/00001 neps/00002 neps/00005 neps/00006
-        neps/00007 neps/00008 neps/00009
-      </para>
-    </section>
-    <section xml:id="archive">
-      <title>Archive</title>
-      <para>
-      </para>
-    </section>
-  </section>
-  <section xml:id="roadmap">
-    <title>Roadmap</title>
-    <para>
-      Some big features need to be developed, but we don't write the NEP
-      at this moment.
-    </para>
-    <para>
-      accessibility documents communication stocks projects accounting
-      quality_risk learning services help security synchronization
-    </para>
-  </section>
-</article>
--- a/source/specifications/index.rst
+++ b/source/specifications/index.rst
@ -0,0 +1,103 @@
+Specifications
+==============
+
+
+NEPs
+^^^^
+
+Nerv Tales Network Enhancement Proposals are the
+official continuous specification of project and
+of management process. See doc:`neps/00001`
+for more information.
+
+.. note::
+
+   Title of NEP contains its status:
+
+   - [C] Continuously updated
+   - [E] Experimental
+   - [P] Proposed
+   - [S] Stable
+   - [D] Deprecated
+   - [O] Obsolete
+   - [R] Rejected or retracted
+
+   Only procedural and informational NEP can be
+   continuously updated.
+
+Active
+~~~~~~
+
+Procedural
+----------
+
+.. toctree::
+   :maxdepth: 1
+
+   neps/00001
+   neps/00002
+
+Informational
+-------------
+
+Protocol
+--------
+
+.. toctree::
+   :maxdepth: 1
+
+   neps/00003
+   neps/00004
+
+Features
+--------
+
+.. toctree::
+   :maxdepth: 1
+
+   neps/00005
+   neps/00006
+   neps/00007
+   neps/00008
+
+Other
+-----
+
+Archive
+~~~~~~~
+
+Procedural
+----------
+
+Informational
+-------------
+
+Protocol
+--------
+
+Features
+--------
+
+Other
+-----
+
+Features to develop
+^^^^^^^^^^^^^^^^^^^
+
+Some big features need to be developed, but we don't
+write the NEP at this moment.
+
+.. toctree::
+
+   accessibility
+   documents
+   communication
+   stocks
+   projects
+   accounting
+   quality_risk
+   learning
+   services
+   help
+   security
+   synchronization
--- a/source/specifications/learning.dbk
+++ b/source/specifications/learning.dbk
@ -1,46 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Learning</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Room management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Planning management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Student management, grading
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Lessons, exams and exercises
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Incorporate other documents
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Learner projects
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        For learning in centre or online
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/learning.rst
+++ b/source/specifications/learning.rst
@ -0,0 +1,10 @@
+Learning
+========
+
+- Room management
+- Planning management
+- Student management, grading
+- Lessons, exams and exercises
+- Incorporate other documents
+- Learner projects
+- For learning in centre or online
--- a/source/specifications/neps/00000.dbk
+++ b/source/specifications/neps/00000.dbk
@ -1,60 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00000" xml:lang="en">
-  <info>
-    <title>[EI] NEP00000 - NEP Template</title>
-    <biblioid class="other" otherclass="NEP">NEP00000</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <bibliorelation class="other" otherclass="NEP" type="requires">NEP00001</bibliorelation>
-    <abstract>
-      <para>Use this document as template for your NEP.</para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release - little description here</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Informational</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-      What objectives do you answer with this document?
-    </para>
-  </section>
-  <section xml:id="title1">
-    <title>Title1</title>
-    <para>
-      Your stuff
-    </para>
-  </section>
-  <section xml:id="title2">
-    <title>Title2</title>
-    <para>
-      Your stuff
-    </para>
-    <section xml:id="subtitle">
-      <title>Subtitle</title>
-      <para>
-        Other stuff
-      </para>
-    </section>
-  </section>
-</refentry>
--- a/source/specifications/neps/00001.dbk
+++ b/source/specifications/neps/00001.dbk
@ -1,90 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00001" xml:lang="en">
-  <info>
-    <title>[EP] NEP00001 - NEP and development process</title>
-    <biblioid class="other" otherclass="NEP">NEP00001</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para>This document defines development process for NervTN project.</para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release - based on XEP-0001 from XSF Foundation</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Procedural</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="base-requirements">
-    <title>Base requirements</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="documentation">
-    <title>Documentation</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="testing">
-    <title>Testing</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="code">
-    <title>Code</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="submission">
-    <title>Submission</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="publication">
-    <title>Publication</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="code-contribution">
-    <title>Code contribution</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="external-libraries">
-    <title>External libraries</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="risk-management">
-    <title>Risk management</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="issues">
-    <title>Issues</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00001.rst
+++ b/source/specifications/neps/00001.rst
@ -0,0 +1,42 @@
+[C] NEP00001 - NEP and development process
+==========================================
+
+Objectives
+^^^^^^^^^^
+
+Nerv Tales Network Enhancement Proposals or NEPs define
+the development process, protocol, features and all
+information needed for the project.
+
+Base requirements
+^^^^^^^^^^^^^^^^^
+
+NEP Types
+^^^^^^^^^
+
+Submission
+^^^^^^^^^^
+
+Approval
+^^^^^^^^
+
+NEP states
+^^^^^^^^^^
+
+Documentation
+^^^^^^^^^^^^^
+
+Testing
+^^^^^^^
+
+Code contribution
+^^^^^^^^^^^^^^^^^
+
+External libraries
+^^^^^^^^^^^^^^^^^^
+
+Risk management
+^^^^^^^^^^^^^^^
+
+Issues
+^^^^^^
--- a/source/specifications/neps/00002.dbk
+++ b/source/specifications/neps/00002.dbk
@ -1,75 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00002" xml:lang="en">
-  <info>
-    <title>[EI] NEP00002 - Code convention</title>
-    <biblioid class="other" otherclass="NEP">NEP00002</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Informational</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="restructuredtext">
-    <title>ReStructuredText</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="rust">
-    <title>Rust</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="python">
-    <title>Python</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="javascript">
-    <title>JavaScript</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="vue.js">
-    <title>Vue.js</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="html">
-    <title>HTML</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="css">
-    <title>CSS</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00002.rst
+++ b/source/specifications/neps/00002.rst
@ -0,0 +1,20 @@
+[C] NEP00002 - Code convention
+==============================
+
+ReStructuredText
+^^^^^^^^^^^^^^^^
+
+Python
+^^^^^^
+
+JavaScript
+^^^^^^^^^^
+
+Vue.js
+^^^^^^
+
+HTML
+^^^^
+
+CSS
+^^^
--- a/source/specifications/neps/00003.dbk
+++ b/source/specifications/neps/00003.dbk
@ -1,40 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00003" xml:lang="en">
-  <info>
-    <title>[EI] NEP00003 - Code of conduct</title>
-    <biblioid class="other" otherclass="NEP">NEP00003</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Informational</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00003.rst
+++ b/source/specifications/neps/00003.rst
@ -0,0 +1,9 @@
+[E] NEP00003 - Base protocol
+============================
+
+Objectives
+^^^^^^^^^^
+
+XMPP use
+^^^^^^^^
+
--- a/source/specifications/neps/00004.dbk
+++ b/source/specifications/neps/00004.dbk
@ -1,55 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00004" xml:lang="en">
-  <info>
-    <title>[EA] NEP00004 - General architecture</title>
-    <biblioid class="other" otherclass="NEP">NEP00004</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Architectural</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="architecture">
-    <title>Architecture</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="encryption">
-    <title>Encryption</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="key-management">
-    <title>Key management</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00004.rst
+++ b/source/specifications/neps/00004.rst
@ -0,0 +1,14 @@
+[E] NEP00004 - Security protocol
+================================
+
+Objectives
+^^^^^^^^^^
+
+Architecture
+^^^^^^^^^^^^
+
+Encryption
+^^^^^^^^^^
+
+Key management
+^^^^^^^^^^^^^^
--- a/source/specifications/neps/00005.dbk
+++ b/source/specifications/neps/00005.dbk
@ -1,55 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00005" xml:lang="en">
-  <info>
-    <title>[EN] NEP00005 - Authentication and encryption</title>
-    <biblioid class="other" otherclass="NEP">NEP00005</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Protocol</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="authentication-process">
-    <title>Authentication process</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="encryption-level">
-    <title>Encryption level</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="database-encryption">
-    <title>Database encryption</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00005.rst
+++ b/source/specifications/neps/00005.rst
@ -0,0 +1,16 @@
+[E] NEP00005 - Authentication and encryption
+============================================
+
+Objectives
+^^^^^^^^^^
+
+Authentication process
+^^^^^^^^^^^^^^^^^^^^^^
+
+Encryption level
+^^^^^^^^^^^^^^^^
+
+Database encryption
+^^^^^^^^^^^^^^^^^^^
+
+
--- a/source/specifications/neps/00006.dbk
+++ b/source/specifications/neps/00006.dbk
@ -1,40 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00006" xml:lang="en">
-  <info>
-    <title>[EN] NEP00006 - Node communication</title>
-    <biblioid class="other" otherclass="NEP">NEP00006</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Protocol</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00006.rst
+++ b/source/specifications/neps/00006.rst
@ -0,0 +1,33 @@
+[E] NEP00006 - Contact management
+=================================
+
+Objectives
+^^^^^^^^^^
+
+Contact list
+^^^^^^^^^^^^
+
+Informations
+^^^^^^^^^^^^
+
+Avatar
+^^^^^^
+
+Update process
+^^^^^^^^^^^^^^
+
+Using internal or provided informations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Contact Sharing
+^^^^^^^^^^^^^^^
+
+vCard export
+^^^^^^^^^^^^
+
+DAV connector
+^^^^^^^^^^^^^
+
+JMAP connector
+^^^^^^^^^^^^^^
+
--- a/source/specifications/neps/00007.dbk
+++ b/source/specifications/neps/00007.dbk
@ -1,40 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00007" xml:lang="en">
-  <info>
-    <title>[EN] NEP00007 - Component communication</title>
-    <biblioid class="other" otherclass="NEP">NEP00007</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Protocol</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00007.rst
+++ b/source/specifications/neps/00007.rst
@ -0,0 +1,102 @@
+[E] NEP00007 - Messaging (chat and mail)
+========================================
+
+Objectives
+^^^^^^^^^^
+
+Instant and non-instant
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Private and group chat
+^^^^^^^^^^^^^^^^^^^^^^
+
+Notification
+^^^^^^^^^^^^
+
+Formatting
+^^^^^^^^^^
+
+Contact management
+^^^^^^^^^^^^^^^^^^
+
+Threading
+^^^^^^^^^
+
+Forwarding
+^^^^^^^^^^
+
+Servers, categories and rooms
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Mailing-list
+^^^^^^^^^^^^
+
+Tags and folders
+^^^^^^^^^^^^^^^^
+
+File attachment
+^^^^^^^^^^^^^^^
+
+Images and animations
+^^^^^^^^^^^^^^^^^^^^^
+
+Emoticons and stickers
+^^^^^^^^^^^^^^^^^^^^^^
+
+Links
+^^^^^
+
+Audio and video messages
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Streams and calls
+^^^^^^^^^^^^^^^^^
+
+Message sharing
+^^^^^^^^^^^^^^^
+
+Mailbox sharing
+^^^^^^^^^^^^^^^
+
+Communication with anonymous
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Website chat and contact form
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Blog, document, file or other object's comments
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Security and HTML threats
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+SPAM management
+^^^^^^^^^^^^^^^
+
+Log and headers
+^^^^^^^^^^^^^^^
+
+Accessibility features
+^^^^^^^^^^^^^^^^^^^^^^
+
+(like subtitling and/or signing by other people)
+
+IMAP connector
+^^^^^^^^^^^^^^
+
+JMAP connector
+^^^^^^^^^^^^^^
+
+SMTP connector
+^^^^^^^^^^^^^^
+
+DKIM, SPF and DMARC
+^^^^^^^^^^^^^^^^^^^
+
+SIP connector
+^^^^^^^^^^^^^
+
+Social network connectors
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+(Connect to Matrix, Mastodon, Diaspora, Facebook, Twitter).
--- a/source/specifications/neps/00008.dbk
+++ b/source/specifications/neps/00008.dbk
@ -1,85 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00008" xml:lang="en">
-  <info>
-    <title>[EF] NEP00008 - Contact management</title>
-    <biblioid class="other" otherclass="NEP">NEP00008</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Feature</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="contact-list">
-    <title>Contact list</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="informations">
-    <title>Informations</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="avatar">
-    <title>Avatar</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="update-process">
-    <title>Update process</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="using-internal-or-provided-informations">
-    <title>Using internal or provided informations</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="contact-sharing">
-    <title>Contact Sharing</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="vcard-export">
-    <title>vCard export</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="dav-connector">
-    <title>DAV connector</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="jmap-connector">
-    <title>JMAP connector</title>
-    <para>
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/neps/00008.rst
+++ b/source/specifications/neps/00008.rst
@ -0,0 +1,5 @@
+[E] NEP00008 - File management
+==============================
+
+Objectives
+^^^^^^^^^^
--- a/source/specifications/neps/00009.dbk
+++ b/source/specifications/neps/00009.dbk
@ -1,197 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" version="5.1" xml:id="nep00009" xml:lang="en">
-  <info>
-    <title>[EF] NEP00009 - Messaging</title>
-    <biblioid class="other" otherclass="NEP">NEP00009</biblioid>
-    <author>
-      <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-    </author>
-    <org class="nonprofit"><orgname>Nerv Project ASBL</orgname></org>
-    <copyright><year>2022</year><holder>Nerv Project ASBL</holder></copyright>
-    <legalnotice>
-      <title>License</title>
-      <para>This work is licensed under <link linkend="https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12">EUPL-1.2</link></para>
-    </legalnotice>
-    <date>2022-04-25</date>
-    <pubdate>2022-04-25</pubdate>
-    <edition>0.1</edition>
-    <productname>Nerv Tales Network</productname>
-    <abstract>
-      <para></para>
-    </abstract>
-    <revhistory>
-      <revision>
-        <revnumber>0.1</revnumber>
-        <date>2022-04-25</date>
-        <author>
-          <personname><firstname>Christophe</firstname><surname>Buffenoir</surname></personname>
-        </author>
-        <revremark>Initial release</revremark>
-      </revision>
-    </revhistory>
-    <meta name="nep-status">Experimental</meta>
-    <meta name="nep-type">Feature</meta>
-  </info>
-  <section xml:id="objectives">
-    <title>Objectives</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="instant-and-non-instant">
-    <title>Instant and non-instant</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="private-and-group-chat">
-    <title>Private and group chat</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="notification">
-    <title>Notification</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="formatting">
-    <title>Formatting</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="contact-management">
-    <title>Contact management</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="threading">
-    <title>Threading</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="forwarding">
-    <title>Forwarding</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="servers-categories-and-rooms">
-    <title>Servers, categories and rooms</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="mailing-list">
-    <title>Mailing-list</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="tags-and-folders">
-    <title>Tags and folders</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="file-attachment">
-    <title>File attachment</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="images-and-animations">
-    <title>Images and animations</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="emoticons-and-stickers">
-    <title>Emoticons and stickers</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="links">
-    <title>Links</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="audio-and-video-messages">
-    <title>Audio and video messages</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="streams-and-calls">
-    <title>Streams and calls</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="message-sharing">
-    <title>Message sharing</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="mailbox-sharing">
-    <title>Mailbox sharing</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="communication-with-anonymous">
-    <title>Communication with anonymous</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="website-chat-and-contact-form">
-    <title>Website chat and contact form</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="blog-document-file-or-other-objects-comments">
-    <title>Blog, document, file or other object's comments</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="security-and-html-threats">
-    <title>Security and HTML threats</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="spam-management">
-    <title>SPAM management</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="log-and-headers">
-    <title>Log and headers</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="accessibility-features">
-    <title>Accessibility features</title>
-    <para>
-      (like subtitling and/or signing by other people)
-    </para>
-  </section>
-  <section xml:id="imap-connector">
-    <title>IMAP connector</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="jmap-connector">
-    <title>JMAP connector</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="smtp-connector">
-    <title>SMTP connector</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="dkim-spf-and-dmarc">
-    <title>DKIM, SPF and DMARC</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="sip-connector">
-    <title>SIP connector</title>
-    <para>
-    </para>
-  </section>
-  <section xml:id="social-network-connectors">
-    <title>Social network connectors</title>
-    <para>
-      (Connect to Matrix, Mastodon, Diaspora, Facebook, Twitter).
-    </para>
-  </section>
-</refentry>
--- a/source/specifications/projects.dbk
+++ b/source/specifications/projects.dbk
@ -1,41 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Projects</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Objectives, quality, risk and task management per project
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Specific funds for project
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Time sheets per project
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Services and products of project (purchases and selling)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Grant management and reporting
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Event and convention management
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/projects.rst
+++ b/source/specifications/projects.rst
@ -0,0 +1,10 @@
+Projects
+========
+
+- Objectives, quality, risk and task management per
+  project
+- Specific funds for project
+- Time sheets per project
+- Services and products of project (purchases and selling)
+- Grant management and reporting
+- Event and convention management
--- a/source/specifications/quality_risk.dbk
+++ b/source/specifications/quality_risk.dbk
@ -1,103 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Quality and risk management</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Define quality requirements
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Internal documentation for process
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage PDCA cycles
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        SLR and SLA management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Catalog of services and products
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Test management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Audit management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Create objectives for company or by projects
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Set tags on objectives (like GDPR, ISO27001, etc.)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage tickets, feedbacks and incidents with levels of priority,
-        of frequency and of seriousness
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Set indicators automatically or manually
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage impact of decision, incident, or indicator
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Treatment of risks with evaluation on objectives, risks, and
-        costs
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Evaluation of social and environmental impacts
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Create templates of objectives and risks
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Complete ITIL implementation
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Disaster recovery plan
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Online surveys (anonymous and non-anonymous)
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/quality_risk.rst
+++ b/source/specifications/quality_risk.rst
@ -0,0 +1,24 @@
+Quality and risk management
+===========================
+
+- Define quality requirements
+- Internal documentation for process
+- Manage PDCA cycles
+- SLR and SLA management
+- Catalog of services and products
+- Test management
+- Audit management
+- Create objectives for company or by projects
+- Set tags on objectives (like GDPR, ISO27001, etc.)
+- Manage tickets, feedbacks and incidents with
+  levels of priority, of frequency and of
+  seriousness
+- Set indicators automatically or manually
+- Manage impact of decision, incident, or indicator
+- Treatment of risks with evaluation on objectives,
+  risks, and costs
+- Evaluation of social and environmental impacts
+- Create templates of objectives and risks
+- Complete ITIL implementation
+- Disaster recovery plan
+- Online surveys (anonymous and non-anonymous)
--- a/source/specifications/security.dbk
+++ b/source/specifications/security.dbk
@ -1,84 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Security</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Encrypted database
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Encrypted hashed passwords
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Separate server for key management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Update database when a key expires
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Credentials management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Limit to two Security Officers
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Two-factor authentication for all operations
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Three or four-factor authentication for sensitive operations
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Send notification to user when accessing on sensitive private
-        data
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        List of private data
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Auto-expiration of private data with anonymization
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Technician mode to help users, with no displayed data or fictive
-        data (except with agreement of user and security officer)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Digital rights management (LCP) or encryption of all documents
-        except public documents
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Archive classification (restricted, secret, top secret levels)
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/security.rst
+++ b/source/specifications/security.rst
@ -0,0 +1,23 @@
+Security
+========
+
+- Encrypted database
+- Encrypted hashed passwords
+- Separate server for key management
+- Update database when a key expires
+- Credentials management
+- Limit to two Security Officers
+- Two-factor authentication for all operations
+- Three or four-factor authentication for sensitive
+  operations
+- Send notification to user when accessing on
+  sensitive private data
+- List of private data
+- Auto-expiration of private data with anonymization
+- Technician mode to help users, with no displayed
+  data or fictive data (except with agreement of
+  user and security officer)
+- Digital rights management (LCP) or encryption of
+  all documents except public documents
+- Archive classification (restricted, secret, top
+  secret levels)
--- a/source/specifications/services.dbk
+++ b/source/specifications/services.dbk
@ -1,77 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Online services</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        e-shop
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        e-library
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        e-learning
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Accessible queue management in reception
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Public mural screens and vocal announcements
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Time sheets
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        On-site services with travel expenses
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Custom reporting of actions in beneficiary file
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Hotline management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Subscription management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Capacity supervision
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Implementation of ITIL and ISO9001 requirements but no
-        certification
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Catering
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/services.rst
+++ b/source/specifications/services.rst
@ -0,0 +1,17 @@
+Online services
+===============
+
+- e-shop
+- e-library
+- e-learning
+- Accessible queue management in reception
+- Public mural screens and vocal announcements
+- Time sheets
+- On-site services with travel expenses
+- Custom reporting of actions in beneficiary file
+- Hotline management
+- Subscription management
+- Capacity supervision
+- Implementation of ITIL and ISO9001 requirements but
+  no certification
+- Catering
--- a/source/specifications/stocks.dbk
+++ b/source/specifications/stocks.dbk
@ -1,122 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Stocks and items</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Items can be books, historical art, historical monuments,
-        digital books, video, CD, DVD, or what you want
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        List all previous and current owners (if needed)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        List all restorations and corresponding reports
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Requirements for preservation, transport and exhibition
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Insurance management for preservation, transport and exhibition
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Security management for preservation, transport and exhibition -
-        connecting to alarm systems
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Set context of archeological discovery with reports, photo,
-        illustration, links to articles
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Linked bibliography and documents
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Derivative and composed manufactured products
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Number of items in stock with individual sheet if historical
-        item or secondhand
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Place in stock, in shop or in shelves
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Alerts on minimum and maximum limit in stocks or in shelves
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Maps of stocks, route for employees to prepare orders
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Print labels for shipping
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Manage RMA, serial numbers and guarantee
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Special stock units (for packages)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Expiry date and queue management (LIFO, FIFO, etc.)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Automatically update stocks on shipping and reception, projected
-        stocks with current in and out orders
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Provisioning contracts with libraries by adding a panel of
-        titles
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Interact with other stock solutions (like Kardex)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Display informations on big screens in stocks (configurable)
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/stocks.rst
+++ b/source/specifications/stocks.rst
@ -0,0 +1,36 @@
+Stocks and items
+================
+
+- Items can be books, historical art, historical
+  monuments, digital books, video, CD, DVD, or
+  what you want
+- List all previous and current owners (if needed)
+- List all restorations and corresponding reports
+- Requirements for preservation, transport and
+  exhibition
+- Insurance management for preservation, transport and
+  exhibition
+- Security management for preservation, transport and
+  exhibition - connecting to alarm systems
+- Set context of archeological discovery with reports,
+  photo, illustration, links to articles
+- Linked bibliography and documents
+- Derivative and composed manufactured products
+- Number of items in stock with individual sheet if
+  historical item or secondhand
+- Place in stock, in shop or in shelves
+- Alerts on minimum and maximum limit in stocks or in
+  shelves
+- Maps of stocks, route for employees to prepare orders
+- Print labels for shipping
+- Manage RMA, serial numbers and guarantee
+- Special stock units (for packages)
+- Expiry date and queue management (LIFO, FIFO, etc.)
+- Automatically update stocks on shipping and
+  reception, projected stocks with current in and out
+  orders
+- Provisioning contracts with libraries by adding a
+  panel of titles
+- Interact with other stock solutions (like Kardex)
+- Display informations on big screens in stocks
+  (configurable)
--- a/source/specifications/synchronization.dbk
+++ b/source/specifications/synchronization.dbk
@ -1,98 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>Synchronization and API</title>
-  </info>
-  <itemizedlist spacing="compact">
-    <listitem>
-      <para>
-        Mail synchronization with SMTP, IMAP, EAS and JMAP
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Print automatically
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Contact, calendar and file synchronization with JMAP, CalDAV,
-        CardDAV and WebDAV
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        SmartSync compatibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        REST API (documented)
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        GraphQL API
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        DODP - Daisy Online Delivery Protocol
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        XMPP for instant messages, audio and video chat
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        OMEMO support
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        SIP for phone calls
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        LDAP and ActiveDirectory compatibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        KMIP protocol for key management
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Kerberos, OAUTH2, FIDO, X509, PKCS11, CAS, SAML and OpenID
-        authentication
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Atom/RSS feeds
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        FTP, SFTP and FTPS compatibility
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        Send HTTP/HTTPS requests
-      </para>
-    </listitem>
-    <listitem>
-      <para>
-        ESB features, low-code and automation
-      </para>
-    </listitem>
-  </itemizedlist>
-</article>
--- a/source/specifications/synchronization.rst
+++ b/source/specifications/synchronization.rst
@ -0,0 +1,22 @@
+Synchronization and API
+=======================
+
+- Mail synchronization with SMTP, IMAP, EAS and JMAP
+- Print automatically
+- Contact, calendar and file synchronization with
+  JMAP, CalDAV, CardDAV and WebDAV
+- SmartSync compatibility
+- REST API (documented)
+- GraphQL API
+- DODP - Daisy Online Delivery Protocol
+- XMPP for instant messages, audio and video chat
+- OMEMO support
+- SIP for phone calls
+- LDAP and ActiveDirectory compatibility
+- KMIP protocol for key management
+- Kerberos, OAUTH2, FIDO, X509, PKCS11, CAS, SAML
+  and OpenID authentication
+- Atom/RSS feeds
+- FTP, SFTP and FTPS compatibility
+- Send HTTP/HTTPS requests
+- ESB features, low-code and automation
--- a/source/user/index.dbk
+++ b/source/user/index.dbk
@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<!DOCTYPE article>
-<article
-  xmlns="http://docbook.org/ns/docbook" version="5.0"
-  xmlns:xlink="http://www.w3.org/1999/xlink" >
-  <info>
-    <title>User manual</title>
-  </info>
-  <para>
-    Nothing here. Sorry, we're working on the first version of software.
-  </para>
-</article>
--- a/source/user/index.rst
+++ b/source/user/index.rst
@ -0,0 +1,5 @@
+User manual
+===========
+
+Nothing here. Sorry, we're working on the first
+version of software.
--- a/update-translation.sh
+++ b/update-translation.sh
@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+make gettext
+sphinx-intl update -p build/gettext -l fr -l nl