Manual:Code/fr
From MediaWiki.org
Contents |
Cette page décrit les fichiers-sources principaux du code de MediaWiki.
[edit] Points d'accès
[edit] index.php
Principal point d'entrée du logiciel MediaWiki. Il se charge de la majorité des requêtes. Voir Manual:Index.php/fr.
[edit] api.php
L'autre point d'entrée de l'extérieur pour l'API, mais peut aussi être utilisé à l'interne par le reste du code. Voir API/fr pour une description approfondie.
[edit] img_auth.php
Script qui ne renvoie les images qu'aux utilisateurs enregistrés. Pour configurer le wiki pour utiliser ce script, voyez Manual:Image Authorisation(en).
[edit] opensearch_desc.php
Retourne un document de description OpenSearch (voyez http://www.opensearch.org/) qui pointe vers les moteurs de recherche du wiki.
[edit] profileinfo.php
Autorise les utilisateurs a voir les informations de profilage sauvegardées dans la base de données. Voyez How to debug#Profiling(en).
[edit] redirect.php
Réoriente vers l'article passé dans le paramètre wpDropdown de la requête.
[edit] thumb.php
Script qui redimensionne les images.
[edit] trackback.php
Ajoute un nouveau rétrolien dans la base de données.
[edit] Répertoire /includes/
Ce répertoire contient tous les fichiers requis par MediaWiki.
[edit] Article.php
Contient la classe Article. Elle représente un article du wiki, peut le modifier (actions edit, delete...) et pourvoit à son état (formatage du wikicode, flags, etc.). Voir Manual:Article.php (en).
[edit] LinkCache.php
Garde les informations à propos de l'existence des articles. Voir LINKCACHE.TXT (en).
[edit] Linker.php
[edit] OutputPage.php
Contient :
- la fonction output, appelée depuis la fonction finalCleanup de Wiki.php (en). Elle appelle la fonction outputPage de Skin.php (en) ;
- la fonction out, appelée depuis la fonction outputPage de Skin.php plusieurs fois pour envoyer le code HTML à l'utilisateur : $mBodytext précédé et suivi du code HTML.
Le fichier contient aussi la fonction addPrimaryWikiText (obsolète, remplacée par addWikiText de Article.php) qui :
- applique la fonction parse de Parser.php (en) au wikitexte $text, générant ainsi du code HTML $text ;
- applique la fonction addParserOutput au code HTML $text, qui elle-même applique la fonction addHTML à $text, annexant ainsi $text à $mBodytext.
[edit] Pager.php
Contient la classe IndexPager utilisée pour ordonner les résultats des requêtes MySQL. Voir Manual:Pager.php (en).
[edit] Parser.php
- sur SVN (répertoire "/includes/parser/" depuis la version 1.13)
Ce fichier définit l'objet Parser utilisé pur convertir le wikitexte en HTML. Voir Manual:Parser.php (en).
[edit] Setup.php
Ce fichier inclut plusieurs fichiers couramment utilisés et crée les variables objet globales (en) qui permettent à MediaWiki de fonctionner. Voir Manual:Setup.php (en).
[edit] Skin.php
Ce fichier gère l'apparence du wiki. Toutes les fonctions qui retournent du HTML et des options pour la mise en forme de ce dernier s'y trouvent, et sont appelées des différents fichiers au besoin.
Il contient la fonction outputPage, appelée depuis la fonction output de OutputPage.php bon nombre de fois, pour envoyer mBodyText à l'utilisateur avec le code HTML qui l'encadre.
L'objet StandardSkin est une implémentation complète, et est destiné à ce qu'on y greffe des sous-classes d'autres skins qui écraseront certaines des fonctions parentes. L'objet User contient une référence vers un skin (selon les préférences de l'utilisateur), et alors plutôt que d'avoir un objet "skin" global, nous relions le skin à l'objet User avec $wgUser->getSkin().
[edit] Title.php
Ce fichier représente le titre d'un article, et exécute tout le travail de traduction entre ses différentes formes telles que le texte en clair, l'URL, la clé de la base de données, etc. Par commodité, et pour des raisons historiques, il représente aussi certaines fonctionnalités des articles ne concernant pas le texte, notamment les droits d'accès.
[edit] User.php
Ce fichier décrit l'état de l'utilisateur visionnant/modifiant le site. Il peut être questionné sur les paramètres de l'utilisateur, son nom, etc. Il s'occupe des requêtes en lecture et en écriture de la table users (en) de la base de données, et gère les cookies et les sessions.
[edit] WebStart.php
Ce script initialise une requête Web : vérifications de sécurité, chargement de LocalSettings.php (en) et de Setup.php (en). Voir Manual:WebStart.php (en).
[edit] Wiki.php
Ce fichier consiste en la définition de la classe MediaWiki. Voir Manual:Wiki.php (en).
[edit] Répertoire /languages/
Ce répertoire contient les fichiers utilisés pour l'internationalisation (en).
[edit] Language.php
Ce fichier contient la classe Language (en), qui représente les langues utilisées pour accompagner le texte, et aussi quelques fonction d'encodage de caractères. Deux variables globales sont en lien avec cette classe : $wgContLang (en) pour la langue du site et $wgLang (en) pour la langue de l'utilisateur.
[edit] Répertoire /maintenance/
Ce répertoire contient des scripts de maintenance devant être exécutés en ligne de commande. Voir Manual:Maintenance scripts (en) pour une liste de ces scripts.
[edit] Répertoire /skins/
Ce répertoire contient toutes les classes de skins, le code Javascript, les CSS et les images utilisées par les skins.