<!doctype linuxdoc system>
 
<!-- 	$Id: niouzes.fr.m4,v 1.10 2011/02/13 23:46:06 gilles Exp gilles $	 -->

<!-- Bienvenue dans le monde SGML et m4 -->
<!--


	




-->
<article> 

<titlepag>
   <title>Publication de nouvelles</title>
   <author>
    <name>
     <htmlurl 
	name="Florian Hatat" 
	url="mailto:mlfo@listes.linux-france.org?subject=lfoyer 0.01">
    </name>
   </author> 
   
   <date>
    Lundi 14 février 2011 $Revision: 1.10 $
   </date>
   
   <abstract> 
    Publication de nouvelles
   </abstract>
  </titlepag>
   

<p>
Vous trouverez la dernière version du présent document à l'adresse:
<newline> <tt><url url="http://www.linux-france.org/prj/lfoyer"></tt>

<sect>Comment créer une nouvelle ?
<p>

Chacun peut publier des nouvelles sur la page d'accueil de Linux-France,
grâce au script <url url="http://www.linux-france.org/~fhatat/getmyrss/"
name="getmyrss">.

Pour cela, créez un fichier <tt/niouzes.xml/ dans votre répertoire
<tt>$HOME/html/</tt> sur Linux-France. Le format de ce fichier est, au
choix :

<list>
<item>n'importe quel format lu par le module <tt><url
url="http://www.feedparser.org/" name="feedparser"></tt> de Python (RSS
0.90, Netscape RSS 0.91, Userland RSS 0.91, RSS 0.92, RSS 0.93, RSS
0.94, RSS 1.0, RSS 2.0, Atom 0.3, Atom 1.0, ou CDF),
<item>ou bien le format historique de niouzes spécifique à Linux-France.
</list>

<p>
Le script <tt>getmyrss</tt> agrège les nouvelles de tous les
contributeurs de Linux-France pour les présenter en page d'accueil, en
fil RSS 2 (pour les plus récentes), et au format HTML (en intégralité).

Il n'est pour l'instant pas possible de programmer la publication d'une
nouvelle, en lui attribuant une date dans le futur.

La publication des nouvelles est instantanée dès que vous avez édité
votre fichier <tt/niouzes.xml/.

<sect>Affichage des actualités
<p>

Les dix actualités les plus récentes sont affichées sur la <url
url="http://www.linux-france.org/" name="page d'accueil de Linux-France">
(mais pas sur les sites miroirs).

Elles sont également regroupées au format RSS 2 : <url
url="http://www.linux-france.org/cgi-bin/getmyrss">. Un lien vers ce fil
est donné dans l'en-tête HTML de la page d'accueil de Linux-France, pour
permettre aux agrégateurs de découvrir automatiquement le fil.

L'intégralité des actualités triées est donnée sur la page des
archives : <url url="http://www.linux-france.org/lesniouzes2arch.shtml">.

<sect>Format XML historique
<p>

Au format historique de Linux-France, le fichier <tt>niouzes.xml</tt>
est un fichier XML dont la racine est une balise <tt>nouvelles</tt>.
Chaque actualité est contenue dans une balise <tt>news</tt> à
l'intérieur de la balise <tt>nouvelles</tt>.

L'actualité est datée grâce à l'attribut <tt>date="AAAAMMJJ"</tt> de la
balise <tt>news</tt>. Les balises HTML block ou inline sont autorisées
dans le contenu de l'actualité : les noms de balises et attributs seront
passés en minuscules par le script.

Voici un exemple de fichier contenant deux actualités :
<code>
<?xml version="1.0" encoding="ISO-8859-1"?>
<nouvelles>
    <news date="20011007">
        Nouvelle version de ma <a href="qqpart.html">documentation&lt;/a>.
    &lt;/news>
    <news date="20010910">
        Première publication de ma <a href="qqpart.html">documentation&lt;/a>.
    &lt;/news>
&lt;/nouvelles>
</code>

<p>Le texte des actualités est amputé :

<list>
<item>au début, s'il commence par une chaîne qui ressemble à une date
suivi de deux points. Par exemple : <tt/mardi 8 février 2011: blah/,
<item>à la fin, s'il se termine par une chaîne qui ressemble à un nom de
personne entre parenthèses. Par exemple : <tt/blah. (John DOE)/
</list>

<p>La date est tout simplement supprimée. Le nom de l'auteur est repris
dans le champ correspondant pour la sortie RSS, et remis en forme dans
les autres formats de sortie.

<list>
<item>Les actualités sans date sont ignorées.
<item>Faites attention à l'encodage du fichier : en l'absence de
l'attribut <tt/encoding="..."/, l'encodage par défaut est l'UTF-8.
</list>


 </article>
<!-- Local IspellDict: francais -->

