Commit 0349597c authored by Champer's avatar Champer

MD

	nouveau fichier : README.md
	nouveau fichier : TODO.md
	nouveau fichier : contribuer/books.md
	nouveau fichier : contribuer/guide.md
	nouveau fichier : contribuer/texte.xml
parent 5e367151
# La FAQ anarchiste (francophone)
> Nous voulons, en un mot, l’égalité : l’égalité de
> fait, comme corollaire ou plutôt comme condition primordiale de
> la liberté. *De chacun selon ses facultés, à chacun selon
> ses besoins*; voilà ce que nous voulons… scélérats que nous
> sommes !
>
> Louise MICHEL
[Consulter la FAQ](http://tviblindi.legtux.org/afaq/).
*The Anarchist FAQ*, par *The Anarchist FAQ Editorial Collective*
est une monumentale foire à questions sur l’anarchisme.
Malheureusement pour nous autres francophones, elle est en
anglais.
En partant de la tentative de traduction de
[faqanarchiste.free.fr](http://faqanarchiste.free.fr), ce dépôt
vise à créer une FAQ cohérente et uniforme pour faciliter la
lecture et la compréhension du lecteur, une FAQ dont la qualité
d’édition est quasi-professionelle.
On utilise les fichiers de [*The Anarchist Library.org*](https://theanarchistlibrary.org/category/author/the-anarchist-faq-editorial-collective?sort=title_asc&rows=100) pour référence.
La version utilisée de la FAQ anglophone est la 1.3.
## Ce qui se fait
- Correction du texte avec Grammalecte
- Nettoyage et modernisation du code HTML
- Homepage plus accueillante
- Index de noms propres (complété au fur et à mesure)
- Index de groupes politiques (complété au fur et à mesure)
- Uniformisation des renvois vers des textes en ligne
- Citabilité des paragraphes
- Double système de notes
- Accessibilité (très relative) pour les personnes dyslexiques
- Format XML pour exporter en plein de formats
- Passage à UTF-8.
## Captures d’écran
### Page d’accueil
![Screenshot](doc/screen.png)
### Une section de la FAQ
![Screenshot](doc/screen2.png)
Les noms soulignés renvoient à l’index des noms propres.
## Contribuer
Consultez la page du [guide de contribution](contribuer/guide.md).
## Compiler le site
Utilisez `make` et copiez le contenu du dossier `out` qu’il génère.
## FAQ de la FAQ
### Est-ce une FAQ sur les libertariens ?
Non. Les libertariens sont des capitalistes. On ne saurait être
anarchiste et capitaliste.
### Pourquoi autant de XML ?
XML impose une certaine rigueur dans la structuration des documents.
La traduction de la FAQ va prendre **des mois, ou des années**. On ne
peut donc *pas* s’en remettre à la mémoire d’une seule personne
en ce qui concerne toutes les normes appliquées. D’ailleurs, même une
seule personne peut faire des oublis, des erreurs en s’occupant d’une
traduction de cette ampleur. La rigueur imposée par XML est donc
utile : si le document XML est valide, tout se passera bien, et s’il
ne l’est pas, ce sera immédiatement remarqué.
De plus, il est assez simple d’abstraire certaines choses avec, ce qui
permet d’éviter des erreurs de frappe.
Par exemple, un renvoi vers l’index des auteurs :
```
<idx s="name" id="proudhon">Pierre-Joseph Proudhon</idx>
```
Produira un lien dont l’URL sera normalisée. `s="name"` indique
que l’on veut renvoyer à l’index de noms (`s="group"` renvoit à
l’index des groupes politiques).
Avant le passage intégral à XML **[qui est encore en cours]**, le
même renvoi s’écrivait en HTML&#160;:
```
<!-- Si on est dans une section -->
<a class="idxref" href="../idx/names.php#proudhon">Pierre-Joseph Proudhon</idx>
<!-- Si on est dans une partie située à la racine du site -->
<a class="idxref" href="idx/names.php#proudhon">Pierre-Joseph Proudhon</idx>
```
XML couplé avec XPath permet aussi de repérer des problèmes,
assurer l’homogéneité des documents…
<!-- vim:set spelllang=fr: -->
# TODO
- Supprimer toc.xml et toc.xsl quand inc/toc.php sera devenu obselète
- Style idxref (renvoi auteur dans corps du texte)
- Style idxbooks (renvoi œuvres en ligne dans l’index)
# Éditer les ouvrages lisibles en lignes
Le fichier `books.php` est généré à partir de `books.xml`. Cela
permet de générer automatiquement les identifiants de chaque livre,
selon la forme `AUTEUR_IDLIVRE`, ou `AUTEUR_IDLIVRE_IDTOME` quand il y a
un tome précis à consulter.
Par exemple:
- `guerin_nogods` renvoie à *Ni dieu ni maître* de Daniel Guérin.
- `bakounine_completeworks_t1` correspond au tome 1 des *Œuvres complètes* de Bakounine.
This diff is collapsed.
<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="../datas/text.xsl" type="text/xsl"?>
<!-- Élément racine du document -->
<document>
<!-- Contient tous les éléments meta-textuels -->
<meta>
<!-- Décrit l’emplacement du texte dans la FAQ -->
<toc>
<!-- Section -->
<section>a</section>
<!-- Sous section. 0 équivaut à la section d’introduction -->
<subsection>5</subsection>
<!-- Si la ligne suivante est décommentée, il n’y a pas de sommaire de section généré-->
<!--<notable />-->
</toc>
<!-- Type de texte. Par défaut: faqtext -->
<type>faqtext</type>
<!--
État de la traduction:
not : Pas entamée
uncomplete : Pas finie
complete : Finie
-->
<translation>not</translation>
<!-- Titre de la page (onglet dans le navigateur) -->
<pagetitle>FAQ Anarchiste – Exemple de document traduit et structuré</pagetitle>
<!-- Titre de la section -->
<head>Exemple de document traduit et structuré</head>
</meta>
<!-- Le texte proprement dit (sauf ses notes de bas de page) -->
<text>
<!--
<div> structure en partie le texte.
<head> donne un titre à la partie (voire plus bas dans le fichier).
Une sous partie consiste en un <div> imbriqué, qui peut avoir son <head>.
Exemple:
<div>
<head>1. Titre de niveau 1</text>
... CONTENU ...
<div>
<head>1.1. Titre de niveau 2</text>
... CONTENU ...
</div>
</div>
-->
<div n="0">
<p class="first">
Ceci est le premier paragraphe de toute la section.
À ce titre, il a l’attribut @class égal à "first".
Dans les navigateurs qui le permettent, ce paragraphe
a une lettrine.
</p>
<p class="centered nocount">
Les paragraphes ayant "centered" dans leur attribut @class sont centrés.<br/>
On peut employer &lt;br&gt; pour retourner à la ligne.<br/>
En ajoutant "nocount" dant @class, on désactive la numérotation pour le
paragraphe.
</p>
<p>
En un clic, le lecteur peut aller sur la page d’index
de <idx s="name" id="proudhon">Proudhon</idx> ou de l’organisation
<idx s="group" id="iww">IWW</idx>.
</p>
<p>
On peut renvoyer à une œuvre en ligne. Par exemple,
<em>La conquête du pain</em> de <idx s="name" id="kropotkine">Kropotkine</idx>
<book author="kropotkine" id="bread" />. Pour savoir l’identifiant
de l’auteur, se référer à datas/books.xml.
</p>
<p>Ce schéma XML<fn s="normal" id="01">1</fn> permet aussi d’employer plusieurs systèmes
de notes en bas de page. Quand le système de notes "normal" est employé<fn id="02">2</fn>, il
n’est pas nécessaire de le préciser. Mais dans les autres cas<fn s="explain" id="01" />,
c’est obligatoire.</p>
<ol>
<li>Les listes ordonnées</li>
<li>sont possibles.</li>
</ol>
<ul>
<li>Les listes non-ordonnées</li>
<li>aussi.</li>
</ul>
<p>Les espaces insécables se codent avec &amp;#160; et non
&amp;nbsp;. Ça ne vous plaît pas&#160;? Employez &lt;e/&gt;<e/>!</p>
<p>
Les citations françaises entraînent beaucoup d’espaces insécables.
Plutôt que de laisser au traducteur le soin des guillemets,
on utilise &lt;cit&gt;<e/>: <cit>Sensationnel&#160;!</cit>.
</p>
<p>
Les <cit>guillemets <cit>imbriqués</cit> dans d’autres guillemets
se distinguent bien</cit> sans que le traducteur ait à s’en soucier.
</p>
<blockquote>
Dignissim, leo quis faucibus semper, massa est faucibus massa, sit
amet pharetra arcu nunc et sem. Aliquam tempor. Nam lobortis sem non
urna. Pellentesque et urna sit amet leo accumsan volutpat. Nam
molestie lobortis lorem. Quisque eu nulla. Donec id orci in ligula
dapibus egestas. Donec sed velit ac lectus mattis sagittis.
</blockquote>
<blockquote class="citation_author">Auteur</blockquote>
<blockquote class="citation_source">Œuvre<i>, p.20</i></blockquote>
<!--
Comme /document/meta/toc/section & /document/meta/toc/subsection
sont définis pour l’exemple avec des valeurs valides, le lien
vers A.4 ne fonctionne pas.
-->
<p>
Enfin, on peut renvoyer le lecteur à d’autres section, selon plusieurs
degré de précision. Lisez la <ref sec="j">section J</ref> en entier.
Intéressez vous à la <ref sec="a" sub="4">section A.4</ref>, voire à la
<ref sec="c" sub="10" anchor="1">section C.10.1</ref>.
</p>
<div n="1">
<head>Sous-titre</head>
<div n="1">
<head>Sous-titre</head>
</div>
</div>
</div>
</text>
<!-- Contenu des notes de bas de page -->
<footnotes>
<!--
Les notes sont regroupées par système de notes.
"normal" est le système par défaut.
"explain" est le système de notes pour les explications.
-->
<system name="normal">
<!--
@id est l’identifiant de la note. C’est grâce à ça qu’on lie
note et appel de note.
-->
<fn id="01">C’est comme cela que ça se nomme.</fn>
<fn id="02">Comme c’est le cas ici.</fn>
</system>
<system name="explain">
<fn id="01">
Par exemple, cette note sert à expliquer quelque
chose pour le lecteur francophone.
</fn>
</system>
</footnotes>
</document>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment