Les articles soumis à Drupal comportent la plupart du temps trois composantes principales: - Titre - Résumé - Corps
Il peut aussi y avoir, dépendamment du type de texte soumis, d'autres paramètres tels que le Sujet, le Type, la date, l'auteur, le parent, le log, etc. Ces composantes sont traités dans d'autres section.
Aussi, prière de réviser votre texte avant de l'envoyer. Il y a un bouton "preview" juste pour ça.
Plusieurs raccourcis existent dans L'Insomniaque vous permettant de séparer logiquement votre texte, de rajouter du style ou faire des liens vers d'autres documents. Ceci est accompli avec un ensemble de filtre qui sont appliqués sur le texte soumis.
Note: Les notions avancées sont indiquées par des astérisques (*).
Les paragraphes du texte doivent être séparés par 2 fins de lignes (i.e. des retours de chariots). Pour faire simplement une nouvelle ligne (<br />), on peut utiliser le raccourci %%%. Exemple:
Cette ligne est brisée %%% en deux par 3 pourcentages.
Donne:
Cette ligne est brisée
en deux par 3 pourcentages.
Un ou plusieurs points d'exclamations en début de ligne marquent un titre. Le nombre de points d'exclamations marque le niveau du titre. Ainsi:
! Titre de niveau 1
!! Titre de niveau 2
!!! Titre de niveau 3
donne:
Les filtres de L'Insomniaque sont capables de reconnaître des structures de liste simples. Les éléments des listes non-numérotées doivent être précédés d'un astérisque et d'un espace (* ), comme suit:
* item
* item
* item
donne la liste:
Les filtres reconnaissent également les listes numérotées. Il suffit de précéder chaque ligne par signe "#" suivi d'un espace. Exemple:
# item 1
# item 2
# item 3
donne:
Notez que chaque item de la liste doit être sur une seule ligne, sinon le filtre risque de devenir confus.
Les filtres supportent également les notes de bas de page. Les notes sont automatiquement numérotées. Pour marquer du texte comme faisant partie d'une note, il suffit de l'entourer de deux accolades. La référence de la note apparaît à l'endroit où les accolades ont été placées et la note est placée en bas de page. Par exemple:
Si je veux placer une note ici, je fais{{ceci est une note}} et je continue mon texte.
ce qui donne:
Si je veux placer une note ici, je fais[1] et je continue mon texte.
Pour faire une citation en bloc, on met un la chaîne ";:" devant chaque ligne et le contenu est rendu en italique, avec un retrait à gauche et à droite. Exemple:
;: Modern man has a kind of poverty of the spirit which stands
;: in great contrast to his remarkable scientific and technological
;: achievements. We've learned to walk in outer space and yet we
;: haven't learned to walk to earth as brothers and sisters. -- Dr. Martin Luther King, Jr.
donne:
Modern man has a kind of poverty of the spirit which stands in great contrast to his remarkable scientific and technological achievements. We've learned to walk in outer space and yet we haven't learned to walk to earth as brothers and sisters. -- Dr. Martin Luther King, Jr.
Parfois, il est peut être embêtant d'utiliser le raccourci %%% pour séparer toutes les lignes d'un paragraphe. On indente alors le texte avec des espaces. Le texte sera aussi rendu en une fonte de taille fixe, pour permettre l'art ASCII. Exemple:
owl-1 10/96
,___,
(9v9)
(_^((\
jgs^^^"^" \\^^^^
^^^^^^^^^^^^^
On peut mettre de l'accent sur certains termes en entourant ces ces termes d'astérisques (*). Pour mettre de l'/emphase/ sur du texte, on peut utiliser la barre oblique (\/) ou le caractère souligné (_). Les marqueurs entrants doivent être précédés d'un espace et les marqueurs fermants doivent en être suivis. Exemple: \/emphase\/, _emphase_ et *accent* nous donnent: /emphase/, emphase et accent.
Noter que si on oublie de mettre des espaces ou de la ponctuation autour des raccourcis, ils ne fonctionne pas. Exemple: il n'yapas d'espaces dans le rac/cour/ci, alors ça ne marche pas.
Note: il est pour l'instant impossible de mettre l'accent ou de l'emphase sur du texte situé en début ou fin de texte. Pour éviter ce problème, rajouter un espace avant ou après l'accent ou l'emphase, ou encore faire suivre le style de ponctuation.
Les crochets ([ et ]) sont utilisés pour créer des hyperliens. On utilise donc deux crochets ouvrants et deux fermants pour marquer du texte à mettre en hyperlien. On distingue 5 méthodes pour marquer les liens:
Il peut arriver que l'on ait besoin de mettres des caractères qui soient /a priori/ interprétés par les filtres, mais que ce ne soit pas désiré. Il faut alors s'échapper des filtres. Pour ce faire, on utilise la syntaxes des entités HTML. Voici donc la liste des caractères spéciaux des filtres et du HTML ainsi que leur échappement HTML, pour plus de facilité.
Et c'est tout!
--
[1] ceci est une note