« Mediawiki » : différence entre les versions
(Trop de modifications. Se référer aux journal des modifications.) |
(Création de la section "Mises à jours" + déplacement de la source concernant la licence dans la bonne section + actualisation des balises de code + corrections typographiques) |
||
(Une version intermédiaire par le même utilisateur non affichée) | |||
Ligne 19 : | Ligne 19 : | ||
* Examiner le code HTML retourné, ex : | * Examiner le code HTML retourné, ex : | ||
< | <syntaxhighlight lang="html"> | ||
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"> | <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"> | ||
<img alt="Creative Commons License" border="0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /> | <img alt="Creative Commons License" border="0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /> | ||
Ligne 26 : | Ligne 26 : | ||
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"> | <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"> | ||
Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International</a>. | Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International</a>. | ||
</ | </syntaxhighlight> | ||
Il sera utile pour remplir les variables du LocalSettings.php. | Il sera utile pour remplir les variables du LocalSettings.php. | ||
Pour < | Pour <syntaxhighlight lang="php" inline>$wgRightsURL</syntaxhighlight> entrer l'info <syntaxhighlight lang="php" inline>href</syntaxhighlight> de la première ancre : | ||
< | <syntaxhighlight lang="php"> | ||
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"; | $wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"; | ||
</ | </syntaxhighlight> | ||
Pour < | Pour <syntaxhighlight lang="php" inline>$wgRightsText</syntaxhighlight lang="php" inline> entrer le texte des liens de la seconde ancre | ||
< | <syntaxhighlight lang="php"> | ||
$wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International"; | $wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International"; | ||
</ | </syntaxhighlight> | ||
Pour < | Pour <syntaxhighlight lang="php" inline>$wgRightsIcon</syntaxhighlight> entrer l'info <syntaxhighlight lang="php" inline>src</syntaxhighlight> du lien <syntaxhighlight lang="php" inline>img</syntaxhighlight> dans la première ancre. Pour copier le badge de son propre site au lieu de celui de Creative Commons : | ||
< | |||
<syntaxhighlight lang="php"> | |||
$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png"; | $wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png"; | ||
</ | </syntaxhighlight> | ||
Pour utiliser les métadonnées RDF dans le copyright ajouter au moins l'une des deux lignes suivante dans < | Pour utiliser les métadonnées ''RDF'' dans le copyright ajouter au moins l'une des deux lignes suivante dans <syntaxhighlight lang="bash" inline>LocalSettings.php</syntaxhighlight> : | ||
< | <syntaxhighlight lang="php"> | ||
$wgEnableCreativeCommonsRdf = true; | $wgEnableCreativeCommonsRdf = true; | ||
$wgEnableDublinCoreRdf = true; | $wgEnableDublinCoreRdf = true; | ||
</ | </syntaxhighlight> | ||
Ce qui donne : | Ce qui donne : | ||
< | <syntaxhighlight lang="php"> | ||
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"; | $wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr"; | ||
$wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International"; | $wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International"; | ||
$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png"; | $wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png"; | ||
$wgEnableCreativeCommonsRdf = true; | $wgEnableCreativeCommonsRdf = true; | ||
</ | </syntaxhighlight> | ||
=Source de la section= | |||
* https://www.mediawiki.org/wiki/Manual:LocalSettings.php/fr#D.C3.A9finir_les_droits_d.27auteur_du_site | |||
=Ajouter un thème= | =Ajouter un thème= | ||
Partie brouillonne afin de noter un élément pour plus tard | Partie brouillonne afin de noter un élément pour plus tard. | ||
==Glyph icons== | ==Glyph icons== | ||
Ce sont les pictogrammes que l'on retrouve dans les ''Modèles'' que l'on a créé pour notre Wiki comme | Ce sont les pictogrammes que l'on retrouve dans les ''Modèles'' que l'on a créé pour notre Wiki comme | ||
{{astuce|Le pouce, < | {{astuce|Le pouce, <syntaxhighlight lang="html" inline>class="glyphicon glyphicon-thumbs-up"</syntaxhighlight>.}} | ||
ou | ou | ||
{{info|Le i, < | {{info|Le i, <syntaxhighlight lang="html" inline>class="glyphicon glyphicon-info-sign"</syntaxhighlight>.}} | ||
Pour faire ces pictogrammes, la police de caractère [https://getbootstrap.com/docs/3.3/components/ glyphicon] est utilisé et une balise < | Pour faire ces pictogrammes, la police de caractère [https://getbootstrap.com/docs/3.3/components/ glyphicon] est utilisé et une balise <syntaxhighlight lang="html" inline><span></syntaxhighlight> comportant une classe avec le nom de l'icône à afficher. | ||
== | ==Source de la section== | ||
* https://www.mediawiki.org/wiki/Topic:S4xx36t9vixu85bz | * https://www.mediawiki.org/wiki/Topic:S4xx36t9vixu85bz | ||
Ligne 83 : | Ligne 87 : | ||
==Ajouter des liens== | ==Ajouter des liens== | ||
===Lien vers une catégorie=== | ===Lien vers une catégorie=== | ||
Pour faire un [https://www.mediawiki.org/wiki/Help:Categories lien vers une catégorie] du Wiki: | Pour faire un [https://www.mediawiki.org/wiki/Help:Categories lien vers une catégorie] du Wiki : | ||
< | <syntaxhighlight lang="bash"> | ||
[[:Category:Nom_catégorie|Texte à afficher]] | [[:Category:Nom_catégorie|Texte à afficher]] | ||
</ | </syntaxhighlight> | ||
===Lien avec domaine variable=== | |||
Le ''Mediawiki'' que vous consultez présentement étant synchronisé entre plusieurs sites avec des noms de domaine différents, il est possible d'utiliser une variable pour mettre celui ayant réaliser la dernière modification au moment de la génération de la page. Il serait plus adapté et plus simple de pouvoir mettre des chemins relatifs mais ceci ne semble pas possible... | |||
<syntaxhighlight lang="bash"> | |||
[https://{{SERVERNAME}}/chemin/à/lier mots du lien] | |||
</syntaxhighlight> | |||
=Mises à jours= | |||
==De MediaWiki== | |||
Pour mettre à jour ''MediaWiki'', il faut récupérer la version désirée sur le [https://www.mediawiki.org/wiki/Download site officiel]. | |||
Il faudra l'extraire à l'endroit où pointera l'hôte virtuel de votre serveur ''WEB'' et y importer les éléments personnalisés de votre installation actuelle : | |||
* <syntaxhighlight lang="bash" inline>LocalSettings.php</syntaxhighlight> | |||
* <syntaxhighlight lang="bash" inline>images/</syntaxhighlight> | |||
* Noter les extensions et les thèmes que vous utilisez et ajoutez leurs nouvelle versions dans le répertoire dédié | |||
Faire pointer le serveur ''WEB'' sur la nouvelle version. | |||
==De la base de données== | |||
Après avoir mis à jour ''MediaWiki'', il faut adapter la base de données à la nouvelle version en production. Pour ce faire, un [https://www.mediawiki.org/wiki/Manual:Update.php script] <syntaxhighlight lang="bash" inline>update.php</syntaxhighlight> est présent dans le répertoire <syntaxhighlight lang="bash" inline>maintenance</syntaxhighlight>. | |||
Il suffit simplement de l'exécuter comme suit : | |||
php update.php | |||
= | ==Source de la section== | ||
https://www.mediawiki.org/wiki/Manual: | * https://www.mediawiki.org/wiki/Manual:Upgrading | ||
* |
Dernière version du 27 août 2022 à 09:40
Mediawiki est la solution que nous utilisons pour documenter nos procédures. C'est également la solution utilisé par Wikipedia. Vous lisez actuellement ce texte depuis un Mediawiki.
Choix de la licence
Le choix de la licence est important car tout ce que vous écrivez est régit par défaut par le droit d'auteur. De fait, les utilisateurs consultant vos écrits ne peuvent rien faire de vos œuvres et c'est bien dommage pour le partage. Il convient donc de choisir la licence qui vous convient afin d'adapter au mieux le droit sur vos contenus.
Trouver une licence
Il existe une multitude de licences et il est facile de s'y perdre.
Nous avons fait le choix d'une licence Creative Commons qui permet de définir les autorisations accordées aux utilisateurs vis à vis des contenu partagés. Vous pouvez définir les caractéristiques de la licence avec ce simulateur qui permet également de générer les informations dont vous aurez besoin pour les afficher sur vos pages.
Exemple : licence Creative Commons
Pour la définir :
- Choisir la licence : http://creativecommons.org/choose/
- Examiner le code HTML retourné, ex :
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr">
<img alt="Creative Commons License" border="0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" />
</a>
Ce(tte) œuvre est mise à disposition selon les termes de la
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr">
Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International</a>.
Il sera utile pour remplir les variables du LocalSettings.php.
Pour $wgRightsURL
entrer l'info href
de la première ancre :
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr";
Pour $wgRightsText</syntaxhighlight lang="php" inline> entrer le texte des liens de la seconde ancre <syntaxhighlight lang="php"> $wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International";
Pour $wgRightsIcon
entrer l'info src
du lien img
dans la première ancre. Pour copier le badge de son propre site au lieu de celui de Creative Commons :
$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png";
Pour utiliser les métadonnées RDF dans le copyright ajouter au moins l'une des deux lignes suivante dans LocalSettings.php
:
$wgEnableCreativeCommonsRdf = true;
$wgEnableDublinCoreRdf = true;
Ce qui donne :
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/4.0/deed.fr";
$wgRightsText = "Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International";
$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png";
$wgEnableCreativeCommonsRdf = true;
Source de la section
Ajouter un thème
Partie brouillonne afin de noter un élément pour plus tard.
Glyph icons
Ce sont les pictogrammes que l'on retrouve dans les Modèles que l'on a créé pour notre Wiki comme
ASTUCE
Le pouce,class="glyphicon glyphicon-thumbs-up"
.ou
INFORMATION
Le i,class="glyphicon glyphicon-info-sign"
.Pour faire ces pictogrammes, la police de caractère glyphicon est utilisé et une balise <span>
comportant une classe avec le nom de l'icône à afficher.
Source de la section
Édition
Ajouter des liens
Lien vers une catégorie
Pour faire un lien vers une catégorie du Wiki :
[[:Category:Nom_catégorie|Texte à afficher]]
Lien avec domaine variable
Le Mediawiki que vous consultez présentement étant synchronisé entre plusieurs sites avec des noms de domaine différents, il est possible d'utiliser une variable pour mettre celui ayant réaliser la dernière modification au moment de la génération de la page. Il serait plus adapté et plus simple de pouvoir mettre des chemins relatifs mais ceci ne semble pas possible...
[https://{{SERVERNAME}}/chemin/à/lier mots du lien]
Mises à jours
De MediaWiki
Pour mettre à jour MediaWiki, il faut récupérer la version désirée sur le site officiel.
Il faudra l'extraire à l'endroit où pointera l'hôte virtuel de votre serveur WEB et y importer les éléments personnalisés de votre installation actuelle :
LocalSettings.php
images/
- Noter les extensions et les thèmes que vous utilisez et ajoutez leurs nouvelle versions dans le répertoire dédié
Faire pointer le serveur WEB sur la nouvelle version.
De la base de données
Après avoir mis à jour MediaWiki, il faut adapter la base de données à la nouvelle version en production. Pour ce faire, un script update.php
est présent dans le répertoire maintenance
.
Il suffit simplement de l'exécuter comme suit :
php update.php