<!doctype linuxdoc system>
<ARTICLE>
<!--------------- FRONT MATTER -------------------- -->

<title>
<:en daCode User's Guide:>
<:fr Guide de l'utilisateur de daCode:>
<Author>Jean-Baptiste Combes
<date>v 0.2.1, 2001/06/15

<abstract>
<:en This document describes how to use, moderate and
administrate a forum powered by daCode.:>
<:fr Ce document décrit comment utiliser, modérer et administrer un
forum réalisé à l'aide de daCode.:> 
</abstract>

<!--******** Section 1: Features ********-->

<sect>
<:en Features:>
<:fr Fonctionnalités:>
<p>
<:en The features of daCode are::>
<:fr daCode propose les fonctionalités suivantes::>
<itemize>
<item>
<:en a complete news system:>
<:fr système complet de gestion des news:>
<item>
<:en possibility to comment on articles and to reply to comments:>
<:fr possibilité de commenter des articles et de répondre aux commentaires:> 
<item>
<:en scoring of comments and selection by score:>
<:fr notation des commentaires et sélection de ceux-ci en fonction de
leur note:>
<item>
<:en theme switching:>
<:fr possibilité de changer de thème:>
<item>
<:en moderation system for news and comments:>
<:fr système de modération des news et des commentaires:>
<item>
<:en filtering of articles by topic:>
<:fr sélection des news par sujet:>
<item>...
</itemize>


<!--******** Section 2: description of front page ********-->

<sect>
<:en Front page:>
<:fr Page d'accueil:>

<!---------- Sec. 2.1: page layout ---------->
<sect1>
<:en Page layout:>
<:fr Structure de la page:>
<P>
<:en <!-- To adapt according to your own needs -->
The front page is divided up into three columns. Each column is divided up
into boxes. The three columns are::>
<:fr <!-- À 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>
<:en Left column: general links:>
<:fr Colonne de gauche: liens généraux:>
<item>
<:en Middle : the news:>
<:fr Au milieu: les news:>
<item>
<:en Right : links to other features of daCode:>
<:fr À droite: des liens vers d'autres fonctionnalités de daCode:>
</itemize>

<!---------- Sec. 2.2: the role of each element ---------->
<sect1>
<:en What does each element do?:>
<:fr Quel est le rôle de chaque élément?:>

<sect2>
<:en First column (on the left):>
<:fr Colonne de gauche:>

<p>
<:en Here you will find general links. Below is a description of the
boxes::>
<:fr Vous trouverez ici des liens généraux::>

<itemize>
<item>
<:en daCode: the "submit a news" link allows users to submit an article for
moderation.:>
<:fr 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>
<:en Local links: links to other areas of the website:>
<:fr Lien locaux: liens vers les autres parties du sites, ou des sites
amis.:> 
<item>
<:en Topics: click on a topic to limit the news displayed to the
corresponding topic.:>
<:fr Topics: cliquez sur un sujet pour ne voir que les news relatives
à ce sujet.:>
</itemize>


<sect2>
<:en Second column (in the middle):>
<:fr Colonne du milieu:>

<p> 
<:en This is where all the news articles appear. Click on the poster's name
to send him an email (if he has given a public email adress). Click on "[M]"
to see who moderated the news. Click on the picture beside the news to see
all news relative to this topic. The links below the news allow you to get
more informations. To view attachments, click on the picture on the right
under the news. To comment the news or view other's comments, click on the
link below the news labeled "x comment(s)", where x is a number.:> 
<:fr 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>
<:en Third column (on the right):>
<:fr Colonne de droite: :>

<p>
<:en Here you will find links to specific functions of daCode.:>
<:fr Vous trouverez ici des liens vers les fonctions avancées de daCode.:>

<sect3>
<:en Editorial:>
<:fr Edito:>

<p>
<:en This is a space for site specific messages.:>
<:fr Comme son nom l'indique, c'est un espace libre pour
l'administrateur du site.:>

<sect3>
<:en Authentication:>
<:fr Authentification:>

<p>
<:en This is where you log in.  You can also create a new account, if you do
not already have one, by clicking on "new account".  If you forget your
password, click on "forgot your password?" and it will be mailed to you.:>

<:fr 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>
<:en Your name:>
<:fr Votre nom:>

<p>
<:en This box replaces the authentication box once you have logged in. To
change your password or your preferences, click on "Preferences". To
logout and become an anonymous user, click on "Close your session".  You
should always do this if you are using a computer or browser that may be
used by others.:>
<:fr 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>
<:en View an article and any comments: the comments page.:>
<:fr Lire une news et les commentaires qui vont 
avec : la page de commentaires.:>

<p>
<:en To get to this page, click on the link "x comments" below the news on
the front page. :>
<:fr Pour arriver sur cette page, cliquez sur «&nbsp;x
commentaire(s)&nbsp;» en dessous de la news.:>

<sect1>
<:en Commenting on an article and replying to comments:>
<:fr Commenter une news et répondre aux commentaires:>

<p>

<itemize>
<item>
<:en To reply to a comment, click on the link "reply" below the
comment. Be sure to have read all comments posted before to avoid
redundancy. :>
<:fr 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>
<:en To comment on an article, click on the "Reply" button beneath the news.
Do not use it to reply to a specific comment.:>
<:fr 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>
<:en Limiting the comments to display:>
<:fr Sélectionner le nombre de commentaires à afficher:>

<sect2>
<:en The scoring of comments:>
<:fr La notation des commentaires:>

<p>
<:en Each comment is scored. Its score is a value between -1 and
five. -1 is for comments which are rude, defamatory, or otherwise
inapropriate to the forum. Comments posted anonymously get scored 0 value by
default.  <!-- Comments posted from a normal user get scored 1 by default
n'est-ce pas? On devrait le dire non? --> :>
<:fr 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>
<:en Filtering comments:>
<:fr Sélectionner les commentaires:>

<p>
<:en You can set the minimal score for the comments displayed.  For this,
use the pulldown menu below the news. This menu displays the scores
available and the number of comments for each level. Select the one you
want, then click on the button "Change" beside the menu.:>

<:fr 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>
<:en Viewing hidden comments :>
<:fr voir les commentaires masqués :>

<p>
<:en All the comments under your currently selected score are hidden. That
means only the title and score of the comment are displayed, along
with a "+" on the left. To view one of them without changing your
score, click on the "+" sign.:>
<:fr 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. -->
<:en Submitting news: the news submission form:>
<:fr Proposer une news : le formulaire de proposition de news:>
<!-- Old version, for ISF in french, Q'n'D HTML  --> 

<sect1>
<:en First stage:>
<:fr Première étape:>

<p><!-- To be modified according to your needs -->
<:en Click on "Submit a news" in the daCode box on the front page, upper
left.:>
<:fr 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>
<:en Type your name, (fake) email and the subject (title) of the news. You
have to choose the most relevant option from the list of topics and the list
of sections. <Bf/Please choose an appropriate topic and section./  The
department is free space,  you can put anything there, or just leave it
empty. You have then to choose the formatting you want from the pull-down
menu on the next line. This can be text or html.  If you choose text the
news will appear exactly as you typed it.  If you choose html you are
allowed a limited selection of html tags in your news.  You should specify
line breaks and paragraphs with &lt;br&gt; and &lt;p&gt;.
Then type in your text. If you want to attach a file to your news,
then check the «&nbsp;Attached file&nbsp;» checkbox.
:>
<:fr 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>
<:en The HTML links section :>
<:fr Les liens HTML :>
<P>
<:en If you want to add some links to pages related to your news, this
is where to do it! Type the name (what will appear on the news) in the left
column. Type the address of the page you are linking to on the
right. This adress should begin with http://;
<Bf/You must also always set the language!/ (pull-down menu on the far
right). If you don't tell daCode what language a link is your link will
be silently erased.

<:fr Si vous avez des liens vers d'autres pages web à proposer,
les lignes en dessous sont faites pour ça. Tapez à
gauche (colonne «&nbsp;nom&nbsp;») le texte qui
apparaîtra et à droite l'adresse complète de la
page (<Bf>elle doit commencer par http://</Bf>),
et enfin <Bf/choisissez la langue. Si vous n'indiquez pas de
langue, le lien n'appaîtra pas!/ :>

<p>
<:en Once you've finished, click on the "Verify" button, at the bottom
of the page. :>
<:fr Lorsque vous avez fini, cliquez sur le bouton
«&nbsp;Suite&nbsp;» en bas de la page. :>
<sect1>
<:en Second stage: verification:>
<:fr Deuxième étape: vérification :>
<P>
<:en You can view how the news will be displayed. If it's ok, then
click on the «&nbsp;Submit&nbsp;» button. You will be taken to stage 3
if you checked the «&nbsp;Attached file&nbsp;» checkbox, or stage 4 if
you didn't. If you forgot to do that in the first stage, you can still
do it here.:>
<:fr 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>
<:en If you want to change the news, you can edit it and verifiy it as many
times as you want. You will remain at stage 2 as long as you modify your
news.:>
<:fr 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>
<:en Third stage: specifying attached files :>
<:fr Troisième étape: joindre les fichiers attachés :>
<p>
<:en Just type in the complete paths to the files you want to attach,
or use the «&nbsp;Browse&nbsp;» button; then click on
«&nbsp;Next&nbsp;»  :>
<:fr 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>
<:en Fourth stage: confirmation :>
<:fr Quatrième étape: confirmation :>
<p>
<:en If all went well, you should see a page saying your message has been
added to the moderation queue. If not, something went wrong, so please
retry.  If there were any problems you should contact the webmaster of the
news site with any error messages.:>
<:fr 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>
<:en Register as am user: the "New account" page:>
<:fr S'enregistrer en tant qu'utilisateur du site: la page «&nbsp;Nouvel utilisateur&nbsp;»:> 

<p> 
<:en This page allows you to create a new account. We use cookies for
authentication and so you do not need to type your password every time.  The
drawbacks are::>

<:fr 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>
<:en Your browser has to accept cookies for this to work.:>
<:fr Votre navigateur doit accepter les cookies.:>
<item>
<:en If you use a computer that can be used by other people, always
logout. Just closing the browser won't do it.:>
<:fr 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>
<:en Once the form has been submitted, the server will send you an email
with your password, and will redirect you to the page you come
from. The system will tell you if you made mistakes or forgot to fill
a mandatory field.:>

<:fr  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>
<:en The login must consist of 3 to 20 normal characters. No special
characters please!:>
<:fr  Le champ Login doit contenir de 3 à 20 caractères non accentués.:>
<P>
<:en The email field must contain your real email address or you will never
get your password.:>
<:fr Le champ Email doit contenir votre adresse email. C'est à 
cette adresse que sera envoyé le mot de passe.:>
<p><label id="fake-email">
<:en The fake email is the one that will be displayed when you post
something on the site.  This facility exists because some people scan web
pages to create lists for spamming.
This is free space, but it should be easy (for a human being) to
derive your real email adress from this one. For exemple, my mail is 
"jbcombes@netscape.net". A fake email would be something like
"jbcombes@ANTISPAM.netscape.net". If you leave this field blank,
daCode will create a fake email for you.:>
<:fr 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>
<:en Changing your preferences and password: the preferences page:>
<:fr Changer vos préférences et votre mot de passe: la page de 
préférences:>

<p>
<:en This page is for setting your preferences. You can set::>
<:fr Sur cette page, vous pouvez modifier vos paramètres::>
<itemize>
<item>
<:en your fake email. To learn what it is, look there:>
<:fr votre "fake email". Pour savoir ce que c'est, allez voir::>
<ref id="fake-email" name="Fake email">
<item>
<:en your first and last names:>
<:fr vos nom et prénom(s):>
<item>
<:en your web page:>
<:fr vous pouvez faire savoir que vous avez une page web:>
<item>
<:en you can set a signature. This signature will be appended at the
end of each comment you post:>
<:fr vous pouvez entrer une signature. Cette signature sera ajoutée à
la fin de tous les messages que vous posterez sur le forum:>
<item>
<:en last but not least, you can change your password:>
<:fr enfin, vous pouvez changer votre mot de passe:>
</itemize>

</article>
