<!doctype linuxdoc system>
<ARTICLE>
<!--------------- FRONT MATTER -------------------- -->
<title>
Guide de l'utilisateur de daCode
<Author>Jean-Baptiste Combes
<date>v 0.2.1, 2001/06/15
<abstract>
Ce document décrit comment utiliser, modérer et administrer un
forum réalisé à l'aide de daCode. 
</abstract>
<!--******** Section 1: Features ********-->
<sect>
Fonctionnalités
<p>
daCode propose les fonctionalités suivantes:
<itemize>
<item>
système complet de gestion des news
<item>
possibilité de commenter des articles et de répondre aux commentaires 
<item>
notation des commentaires et sélection de ceux-ci en fonction de
leur note
<item>
possibilité de changer de thème
<item>
système de modération des news et des commentaires
<item>
sélection des news par sujet
<item>...
</itemize>
<!--******** Section 2: description of front page ********-->
<sect>
Page d'accueil
<!---------- Sec. 2.1: page layout ---------->
<sect1>
Structure de la page
<P>
<!-- À adapter selon vos besoins -->
La page d'accueil est divisée en trois colonnes. Chacune d'elles est
divisée en boîtes. Ces trois colonnes sont:
<itemize>
<item>
Colonne de gauche: liens généraux
<item>
Au milieu: les news
<item>
À droite: des liens vers d'autres fonctionnalités de daCode
</itemize>
<!---------- Sec. 2.2: the role of each element ---------->
<sect1>
Quel est le rôle de chaque élément?
<sect2>
Colonne de gauche
<p>
Vous trouverez ici des liens généraux:
<itemize>
<item>
daCode: le lien «&nbsp;Proposer une news&nbsp;» dans cette boîte
vous permet de soumettre un nouvel article à l'équipe de modération
<item>
Lien locaux: liens vers les autres parties du sites, ou des sites
amis. 
<item>
Topics: cliquez sur un sujet pour ne voir que les news relatives
à ce sujet.
</itemize>
<sect2>
Colonne du milieu
<p> 
 
Cette colonne contient les news. Pour envoyer un mail à la
personne qui a rédigé la news, cliquez sur son nom (si elle a donné
une adresse email publique). Cliquez sur «&nbsp;[M]&nbsp;» pour savoir
qui a modéré cette news. Cliquez sur l'image à côté du texte de la news
pour avoir toutes les nouvelles relatives au même sujet. Les liens en
dessous de la news vous amènent vers des pages proposant des
informations complémentaires; le drapeau indique la langue de ces
pages. Pour voir les commentaires ou commmenter vous-même, cliquez sur
«&nbsp;x commentaire(s)&nbsp;» en dessous de la news. Les images en bas
à droite (le cas échéant) vous permettent de visualiser les
attachements.
<sect2>
Colonne de droite: 
<p>
Vous trouverez ici des liens vers les fonctions avancées de daCode.
<sect3>
Edito
<p>
Comme son nom l'indique, c'est un espace libre pour
l'administrateur du site.
<sect3>
Authentification
<p>
Cette boîte vous permet de vous authentifier. Si vous n'avez pas
de compte utilisateur, cliquez sur «&nbsp;Créer un nouveau
compte&nbsp;». Si vous avez un compte, mais que vous avez perdu votre
mot de passe, cliquez sur «&nbsp;Oublié ton mot de passe ?&nbsp;».
Celui-ci vous sera alors envoyé par email. 
<!-- fixme : add cross references -->
<sect3>
Votre nom
<p>
Cette boîte remplace la boîte d'authentification quand vous vous
êtes authentifié. Pour changer votre mot de passe, cliquez sur
«&nbsp;Préférences&nbsp;». Pour terminer votre session (redevenir
utilisateur anonyme), cliquez sur «&nbsp;Fermer sa session&nbsp;».
Veillez toujours à faire ceci lorsque l'ordinateur que vous utilisez peut
être utilisé par d'autres personnes.
</sect>
<!--******** Section 3: The comments page ********-->
<sect>
Lire une news et les commentaires qui vont 
avec : la page de commentaires.
<p>
Pour arriver sur cette page, cliquez sur «&nbsp;x
commentaire(s)&nbsp;» en dessous de la news.
<sect1>
Commenter une news et répondre aux commentaires
<p>
<itemize>
<item>
Pour répondre à un commentaire, cliquez sur le lien
«&nbsp;répondre&nbsp;» sous le commentaire. Avant de répondre à un
commentaire, lisez les autres afin d'éviter les redites.
<item>
Pour commenter une news, cliquez sur le bouton
«&nbsp;répondre&nbsp;» en dessous de la news. N'utilisez cette
possibilité que si votre commentaire ne peut être considéré comme une
réponse à un commentaire précédent. 
</itemize>
<sect1>
Sélectionner le nombre de commentaires à afficher
<sect2>
La notation des commentaires
<p>
Chaque commentaire est noté (un score lui est attribué). Le score
est une valeur comprise entre -1 et 5. -1 est réservé aux commentaires
obscènes, diffamatoires ou ceux qui n'ont rien à faire à cet endroit
(du genre "je m'appelle Toto." ou "qsdftgazefg"). Les commentaires
postés en «&nbsp;anonyme&nbsp;» ont la valeur 0 par défaut.
<sect2>
Sélectionner les commentaires
<p>
Vous pouvez ajuster la qualité minimale des commentaires que vous
voulez lire. Pour cela, utilisez le menu déroulant sous la news. Ce
menu vous propose un choix de score, avec pour chacun, le
nombre de commentaires correspondants. Les options correspondent au
score minimal des commentaires à afficher. Sélectionnez l'option qui
vous convient, puis cliquez sur le bouton «&nbsp;Changer&nbsp;» à côté
du menu déroulant.
<sect1>
voir les commentaires masqués 
<p>
Tous les comentaires en dessous de votre seuil sont masqués,
i.e. ne sont affichés que le titre et le score du commentaire, ainsi
qu'un "+" à gauche. Pour en lire un sans modifier votre seuil,
cliquuez sur le "+". 
<sect><!-- Submitting news : the news submission form. -->
Proposer une news : le formulaire de proposition de news
<!-- Old version, for ISF in french, Q'n'D HTML  --> 
<sect1>
Première étape
<p><!-- To be modified according to your needs -->
Pour ce faire, cliquez sur le lien «&nbsp;Proposer une
news&nbsp;» dans la boîte «&nbsp;daCode&nbsp;» en haut à gauche. Vous
vous retrouver alors devant le formulaire de saisie de nouvelles.
<p>
Saisissez vos nom, mail et le sujet (ce qui apparaîtra en
titre) de la news dans les champs appropriés. La liste
«&nbsp;topics&nbsp;» vous permet de choisir à
quoi se rapporte votre news. <Bf/Veillez à
choisir le sujet approprié/. La liste «&nbsp;sections&nbsp;» vous
permet de selectionner la section dans laquelle doit apparare votre
news. Là encore, veillez à choisir la section la plus appropriée.  Le
département est un 
espace de libre expression, mettez ce que vous voulez, ou rien du
tout. Sur la ligne suivante, vous avez une liste qui vous permet de
choisir le type de formattage de votre texte. Celui-ci peut être
"texte" ou "html". Si vous choisissez "texte" (choix par défaut),
votre texte apparaîtra tel que vous l'avez tapé. Si vous choisissez
"html", il sera formatté selon un sous-ensemble du language
HTML. N'utilisez cette option que si vous savez ce que vous faites. 
Saisissez ensuite votre texte. Si vous comptez joindre un fichier en
attachement, cochez la case «&nbsp;Fichier attaché&nbsp;». 
<sect1>
Les liens HTML 
<P>
Lorsque vous avez fini, cliquez sur le bouton
«&nbsp;Suite&nbsp;» en bas de la page. 
<sect1>
Deuxième étape: vérification 
<P>
Vous pouvez voir comment apparaîtra la news. Si cela vous
convient, cliquez sur le bouton «&nbsp;Suite&nbsp;». Si vous avez coché
la case «&nbsp;Fichier attaché&nbsp;», vous vous retrouverez à l'étape
3, sinon à l'étape 4. Si vous voulez joindre un fichier, mais que vous
avez oublié de le faire à l'étape précedente, vous pouvez toujours le
faire ici. 
<P>
Si la news ne vous convient pas, vous pouvez la modifier et
vérifier autant de fois qu'il vous plaira. Vous resterez à l'étape 2
tant que vous faite des modifications sur votre news. 
<sect1>
Troisième étape: joindre les fichiers attachés 
<p>
Entrez le chemin d'accès complet aux fichiers que vous voulez
joindre en attachement ou cliquez sur le bouton
«&nbsp;Parcourir&nbsp;» pour les selectionner, puis cliquez sur
«&nbsp;Suite&nbsp;» 
<sect1>
Quatrième étape: confirmation 
<p>
Si tout s'est bien passé, vous verrez une page vous indiquant que
votre message a bien été enregistré. Si vous n'avez pas cette page,
il y a eu un problème quelque part, vous êtes donc prié de
recommencer, et de signaler à l'administrateur du site les eventuels
messages d'erreur et autres insultes qui ont pu apparaître. 
<!--******** Section5: New user page ********-->
<sect>
S'enregistrer en tant qu'utilisateur du site: la page «&nbsp;Nouvel utilisateur&nbsp;» 
<p> 
Cette page vous permet de vous créer un nouveau compte. Nous
utilisons les cookies pour vous identifier et vous éviter d'entrer
votre mot de passe à chaque fois que vous venez. Les inconvénients
sont:
<itemize>
<item>
Votre navigateur doit accepter les cookies.
<item>
Si vous utilisez un ordinateur que vous partagez avec d'autres
personnes, veillez à toujours fermer votre session. Fermer votre
navigateur ne le fera pas pour vous.
</itemize>
<p>
 Un fois le formulaire validé, le
serveur  vous enverra un email contenant votre mot de passe, puis vous
redirigera vers la page web d'où vous venez. Les erreurs, les
informations manquantes ou erronées vous seront indiquées sinon.
<p>
 Le champ Login doit contenir de 3 à 20 caractères non accentués.
<P>
Le champ Email doit contenir votre adresse email. C'est à 
cette adresse que sera envoyé le mot de passe.
<p><label id="fake-email">
Le champ Fake Email doit contenir une adresse email. Cette
adresse sera utilisée lors des interventions sur ce forum. Entrez
votre adresse avec une extension 'antispam', par exemple, ou sinon
laissez le champ vierge et l'on vous proposera une adresse antispam
basée sur celle fournie dans le champ Email. Les champs Nom et Prénom
contiendront, respectivement, vos nom et prénom.   
<!--******** Section 6: The preferences page ********-->
<sect>
Changer vos préférences et votre mot de passe: la page de 
préférences
<p>
Sur cette page, vous pouvez modifier vos paramètres:
<itemize>
<item>
votre "fake email". Pour savoir ce que c'est, allez voir:
<ref id="fake-email" name="Fake email">
<item>
vos nom et prénom(s)
<item>
vous pouvez faire savoir que vous avez une page web
<item>
vous pouvez entrer une signature. Cette signature sera ajoutée à
la fin de tous les messages que vous posterez sur le forum
<item>
enfin, vous pouvez changer votre mot de passe
</itemize>
</article>
