Rédaction

De ArchwikiFR

Le texte est formaté à l'aide de balises mediawiki, qui peuvent être complétées par certaines balises html.

Sommaire

Syntaxe

Titres

Vous pouvez diviser votre article en section et sous-sections.

Les titres peuvent être créés de la manière suivante :

  • = Section =
  • == titre ==
  • === titre ===
  • ==== titre ====
  • ===== titre =====

Typographie

Les caractères peuvent être mis en gras ou en italique en entourant l'expression d'apostrophes simples (') :

  • ''italique'' donne italique
  • '''gras''' donne gras
  • '''''gras et italique''''' donne gras et italique

Indentation

Pour indenter des lignes le caractère (:) est utilisé :

ceci est du texte non indenté
:ceci est du texte indenté
::ceci est du texte encore plus indenté

donne :

ceci est du texte non indenté

ceci est du texte indenté
ceci est du texte encore plus indenté

Listes et puces

  • Pour créer des listes , le caractère (#) est utilisé :
#premier élément
#deuxième élément
##premier sous élément
#troisième élément 

donne :

  1. premier élément
  2. deuxième élément
    1. premier sous élément
  3. troisième élément
  • Pour créer des puces , le caractère (*) est utilisé :
*item
**sous item
*item
*item

donne :

  • item
    • sous item
  • item
  • item

Bloc de code

Pour insérer un bloc de code, il suffit de placer un espace au début de la ligne :

 code

donne :

code

Les tableaux

Les tableaux commencent par {| et finnissent par |}.

  • Une cellule est une ligne débutant par |
  • Une cellule de titre est une ligne débutant par !
  • Une nouvelle ligne du tableau est une ligne débutant par |-

Exemple :

{| class="wikitable"
 !titre 1
 !titre2
 !titre3
 |-
 |foo
 |bar
 |foobar
 |}
titre 1 titre2 titre3
foo bar foobar

Les liens

Il existe différents types de liens.

Liens internes

Les liens internes pointent vers des pages wiki, existantes ou non. Ils utilisent la syntaxe [[Page]], où page est le nom de la page cible. Pour afficher un texte différent du nom de la page, la syntaxe est : [[Page|texte]]. Pour créer des liens vers une catégorie, la syntaxe est : [[:Category:xorg|X11]]

Liens inter-wiki

Les liens inter-wiki pointent vers des pages d'un autre wiki. La syntaxe est : [[Projet:page| texte]], ou projet doit être configuré.

Exemple : [[Wikipedia:fr:html]] pointe vers la page html de wikipedia francophone.

Liens extérieurs

Les liens extérieurs sont des liens hypertextes. La syntaxe est : [http://example.org texte_affiché]

Redirection

Pour rediriger vers une autre page, insérer #REDIRECT [[page]].

Attention: évitez plusieurs niveaux de redirections !

Variables et modèles

Les variables sont entourées par {{{variable}}}.

Les modèles sont stockés dans l'espace de nom Modèle:, vous pouvez les utilisez en mettant leur nom entre argument1.

Par exemple, {{Box GREEN|Exemple:|contenu}} affiche :

Exemple: contenu

Liste des modèles.
Vous pouvez aussi créer vos propres modèles.

Important: Un modèle qui ne sera utilisé que quelques fois ne sert pas à grand chose.

Quelques modèles utiles :

  • pkg : lien vers la page du paquet si le nom est exacte ou vers la page de recherche, exemple: kernel26
  • AUR : lien vers le paquet AUR, exemple: yaourt
  • AUR Search : lien vers la recherche de paquet AUR, exemple: yaourt
  • warning, tip et note créent des alertes, astuces ou note, exemple:
{{tip|ceci est une astuce}}
Astuce: ceci est une astuce
  • lien : affiche des liens sous la forme Site (fr) : {{lien|http://example.org|en}} donne : Site officiel (en)
  • keypress : affiche une touche ressemblant à une touche : {{keypress|Alt}} : Alt

Les catégories

Les pages sont classées dans différentes catégories. Une page peut appartenir à plusieurs catégories.

On définit les catégories en haut de la page avec : [[Category:Gestionnaire de fenêtre]]. La liste des catégories existantes peut être trouvé dans l'onglet Pages spéciales puis Liste des catégories.

Discussion

Les pages de discussions permet au contributeurs de communiquer.

Il est possible d'ajouter des nouveaux commentaires à la fin ou sous le commentaire auquel on répond, en indentant la réponse d'un niveau supplémentaire.

La chaine ~~~~ permet d'insérer son nom et la date du commentaire: Enjolras 23 février 2011 à 22:31 (CET).

Règles spécifiques

Note: En règle générale, merci de s'inspirer des pages/catégories/modèles déjà existants.
  • Les catégories, lien inter wiki vers les autres wiki Arch Linux, titre de la page doivent être placés en haut de page.
  • Pour une url propre, évitez les caractères accentués, parenthèses, etc. pour les noms de pages, vous pouvez utiliser {{DISPLAYTITLE:xx}} pour spécifier un titre.
  • Vous êtes invités à jeter un coup d'oeil aux modèles et à vous en servir quand c'est approprié.

Squelette d'une page:

[[Category:lambda]]
[[en:page sur wiki.archlinux.org]]
{{DISPLAYTITLE:Page squelette avec un titre qui contient des éèù etc.}}

Introduction

= Section =
== Installation ==
== Configuration ==
== Utilisation ==

...

= Ressources =
Note: Les niveaux de titres dans l'exemple sont à titre indicatif, il faut juste savoir que le nom de la page s'affiche avec le même style que le 1er niveau (= 1er niveau =), il vaut donc mieux l'utiliser quand une page utilise des sections tel que par exemple celle de NVIDIA

En vrac:

  • Lorsque vous mettez un ensemble de commande, même si c'est à lancer en root, un copie/coller passe mieux sans le # ou le $.
  • pacman -Sy est à proscrire ! En bref, cette commande installe la dernière version d'un paquet qui par définition est liée aux dernières bibliothèques sans forcément installer ces dernières. Pour des paquets importants, ça peut casser le système.
  • Pour éviter qu'une page devienne obsolète plus vite, il vaut mieux pointer vers des pages que détailler des options. Par exemple, il est préférable de pointer vers la page Java plutôt qu'expliquer comment installer jre ou openjdk etc.
  • Les pages se bornant à:
soft_magique_qui_fait_le_cafe est un soft magique qui fait le café.
== Installation ==
 pacman -S soft_magique_qui_fait_le_cafe
== Resources ==
[http://www.smqflc.org site officiel]

On peut facilement s'en passer. La recherche d'un paquet peut se faire par pacman, en utilisant un assistant AUR, depuis le site http://www.archlinux.org/packages ou encore http://aur.archlinux.org

  • A part quand il n'y a pas d'alternative, ne pas proposer la modification d'un fichier système, mais plutôt celui de l'utilisateur et éventuellement un fichier système mais qui ne sera pas écrasé à la première mise à jour.
Important: Le but de ce wiki n'est pas d'avoir un record de pages mais d'avoir des pages utiles, justes et dans la mesure du possible à jour.
Outils personnels