Modification MediaWiki

De EjnTricks

Pages spéciales

Sidebar

Modification

L'édition de la page "Sidebar" s'effectue par lien: http://hostname/rootpath/index.php?title=MediaWiki:Sidebar&action=edit

La page est accessible depuis le lien http://hostname/rootpath/index.php/MediaWiki:Sidebar

Viewer icon.png Voir aussi

Documentation officielle: http://www.mediawiki.org/wiki/Manual:Interface/Sidebar


Personnalisation

Le contenu original de la page est:

* navigation
** mainpage|mainpage-description
** portal-url|portal
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help
* SEARCH
* TOOLBOX
* LANGUAGES

Les deux lignes suivantes ont été ajoutées en fin de page, afin de rajouter un bloc avec un accès rapide:

* navigation
** mainpage|mainpage-description
** portal-url|portal
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help
* SEARCH
* TOOLBOX
* LANGUAGES
* Accès rapide
** Special:Categories|Catégories

Il est possible d'injecter des liens vers des sites externes. Pour ce wiki, la section liens utiles a été mis en place avec deux liens:

Pour cela, il faut utiliser la synthaxe lien|Titre, donnant le texte suivant:

* Liens utiles
** http://www.charles.torda.net|Un expert Alfresco
** http://www.amexio.fr|Amexio, l'expertise parisienne ECM
* navigation
** mainpage|mainpage-description
** portal-url|portal
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help
* SEARCH
* TOOLBOX
** Special:MultipleUpload|multiupload-toolbox ("Upload multiple files")
* LANGUAGES
* Accès rapide
** Special:Categories|Catégories

Attention, lors de la modification du code de la page, la prévisualisation est déroutante. Sur le premier lien injecté, les caractères |Un sont intégrés aux liens, donnant le rendu suivant:


Mais, le rendu dans la barre horizontale sera correct.


Gestion des catégories

Utilisation

L'utilisation des catégories est très simple sous MédiaWiki. Il suffit d'ajouter le tag [[Category:Nom Catégorie]] dans la page. Ce tag peut être positionné n'importe où dans la page, mais par convention ils sont placés à la fin. Puis il faut créer la page de cette catégorie en cliquant sur le lien et en modifiant le contenu de celle-ci.

L'utilisation de sous catégorie s'effectue en modifiant la page de la sous catégorie et en ajoutant le tag [[Category:Catégorie Parente]] sur la page de la catégorie fille. Le mot clé Category peut être remplacé par Catégorie sur une installation en français.

L'ensemble des catégories est visible sur la page Special:Categories, accessible par le lien: http://hostname/root/index.php/Special:Categories

Viewer icon.png Voir aussi

Documentation officielle: http://meta.wikimedia.org/wiki/Help:Category


Table des matières

Masquer

Afin de masquer la table des matières sur une page, il faut ajouter la syntaxe suivante en fin d'article: __NOTOC__

Gestion des liens

Vers du contenu

Il est possible de stocker des documents dans le wiki. Mais comment faire pour mettre en place un lien pointant sur ces documents ? Deux syntaxes sont possibles. Dans les exemples présentés nous prendront pour exemple la documentation de Documentum.

Direction vers le document

La première syntaxe présentée permet de diriger l'utilisateur vers la page décrivant le document.

[[file:Documentum_Foundation_Classes_6.5_Release_Notes.pdf]]

Fichier:Documentum Foundation Classes 6.5 Release Notes.pdf

Téléchargement

La première syntaxe ne permet donc pas de télécharger le document, ce qui est problématique lorsque l'on veut donner un accès rapide à celui ci. Il faut donc utiliser la deuxième syntaxe:

[[media:Documentum_Foundation_Classes_6.5_Release_Notes.pdf]]

Vers une page

Lien simple

L'écriture d'un lien vers une autre page du wiki s'effectue ainsi:

[[NOM PAGE]]

Modification du libellé

Il est parfois utile de modifier le libellé du lien, cf #Liens vers du contenu. Pour cela, il faut ajouter le texte après le nom de la page, séparé par le caractère |:

[[NOM PAGE|Libellé du lien]]

Vers une section

Afin de présenter une lien vers une section particulière d'une page, la syntaxe est similaire aux ancrages en HTML. Il faut identifier le libellé de la section et l'ajouter au nom de la page, préfixé du caractère #

[[NOM PAGE#NOM SECTION|Libellé du lien]]

Page sur le même serveur

Le WIKI peut être exposé sous un serveur "central" qui abrite d'autre site / application. Pour référencer une page externe au WIKI mais sur le même serveur, le lien s'écrit ainsi:

[http://{{SERVERNAME}}/URL Nom du lien]

Liens vers une catégorie

Pour positionner un lien vers une catégorie, la syntaxe impose préfixer le lien par la caractère :. Pour écrire un lien sur la catégorie MediaWiki, il faut écrire "[[:Category:MediaWiki]]", qui produit Category:MediaWiki. Les options de formatages des liens est disponibles.

Viewer icon.png Voir aussi

Documentation officielle: http://www.mediawiki.org/wiki/Help:Interwiki_linking

http://www.mediawiki.org/wiki/Help:Categories#Linking_to_a_category

Utilisation de modèle

Utilisation d'un modèle appelant un modèle

MédiaWiki permet de mettre en place des modèles de pages que l'on peut appeler avec des arguments. La page d'accueil, http://www.mediawiki.org/wiki/MediaWiki, est d'ailleurs basée sur ce principe. Une des grandes puissance est qu'un modèle peut inclure un autre modèle et ainsi de suite. La première mise en place de ce principe sur ce wiki, concerne les liens vers les documents dans les pages de documentation, cf Documentation Documentum.

Ces modèles ont été créés avec pour but:

Afficher un lien pour télécharger un document contenu dans le wiki, passé en tant que premier argument.
Afficher un text à la place du lien, passé en tant que second argument.
Utiliser une CSS passée en paramètre, passé en tant que troisième argument.

Les étapes de création sont les suivantes:

  • Ecriture dans la page du code suivant [[Modèle:FileRef]]. Le modèle n'existant pas déjà, le lien n'est pas disponible et en cliquant dessus, il est proposé de le créer.
  • Edition du modèle et saisie du code suivant:
<span class="file {{{3}}}">[[media:{{{1}}}|{{{2}}}]]</span>
<noinclude>[[Category:Modèle Référence Fichiers|Modèle Référence Fichiers]]</noinclude>

Avec les argument d'appel suivants:

  1. Mon document.pdf
  2. Mon document
  3. pdf

L'utilisation est:

{{FileRef|Mon document.pdf|Mon document|pdf}}

Et le rendu est:

<span class="file pdf">[[media:Mon document.pdf|Mon document]]</span>

Il suffit ensuite de supprimer le code [[Modèle:FileRef]] écrit pour avoir un lien vers le modèle.

  • L'étape suivante consiste en la création d'un modèle pour ne pas avoir à indiquer le format pdf, et de n'indiquer que le nom du média. Le principe de création est le même, le code [[Modèle:PdfFileRef]] dans la page. Le modèle est ensuite modifié avec le contenu:
{{FileRef|{{{1|}}}|{{{2|}}}|pdf}}
<noinclude>[[Category:Modèle Référence Fichiers|Modèle Référence Fichiers]]</noinclude>

En reprenant l'exemple précédent, les arguments d'appels sont:

  1. Mon document.pdf
  2. Mon document

L'utilisation:

{{PdfFileRef|Mon document.pdf|Mon document|pdf}}

Le code temporaire généré est donc:

{{FileRef|Mon document.pdf|Mon document|pdf}}

Ce qui entraine donc le rendu du lien comme précédemment.

Résumé

  • Inclure un modèle: {{NOM MODELE}}
  • Dans l'exemple présenté, la balise noinclude est utilisé au niveau des modèles. Cela permet de définir un contenu dans le modèle, mais qui ne sera pas affiché dans la page incluant le modèle.

Viewer icon.png Voir aussi

Documentation officielle: http://www.mediawiki.org/wiki/Help:Templates


Syntax SyntaxHighlight GeSHi

Cette section a pour but de lister les principales utilisation du plugin SyntaxHighlight GeSHi, voir Plugin Code Style.

Format couramment utilisé

La syntaxe utilisé est <syntaxhighlight lang="-"></syntaxhighlight>. Les code fréquemment utilisés sont:

Code Language
bash Bash
css Cascading Style Sheets (CSS)
html4strict HTML
java Java
java5 Java(TM) 2 Platform Standard Edition 5.0
javascript JavaScript
plsql PL/SQL
plsql PL/SQL
sql SQL
xml XML

Viewer icon.png Voir aussi

Documentation officielle: http://www.mediawiki.org/w/index.php?title=Extension:SyntaxHighlight_GeSHi


Zone affichable

Trois modèles sont mis en place afin de mettre en place une zone masquable et affichable par simple lien, comme c'est le cas pour les tables de matière. Ces modèles sont copiés depuis WikiPédia:

  • hidden
  • hidden begin
  • hidden end

Installation

Ces modèles nécessite l'installation de l'extension ParserFunctions. Les modèles installés sont:

Cela nécessite également la mise à disponible de Javascript:

Le CSS commun est également modifié:

Le code suivant est ajoutés:

Viewer icon.png Voir aussi

Utilisation modèle Hidden: http://en.wikipedia.org/wiki/Template:Hidden

Utilisation modèle Hidden begin et Hidden end: http://en.wikipedia.org/wiki/Template:Hidden_begin, http://en.wikipedia.org/wiki/Template:Hidden_end