Extension MahjongTuiles : Différence entre versions
(Page créée avec « '''MahjongTile''' is a [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] extension that makes it easy to output sequences of mahjong tile images, for example: {{#mjt: 1... ») |
|||
(4 révisions intermédiaires par le même utilisateur non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | ''' | + | '''MahjongTuiles''' est une extension [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] permettant d'afficher facilement une séquence d'images de tuiles de mahjong, par exemple : |
{{#mjt: 19m19p19s1234z}} {{#mjt: 000z}} | {{#mjt: 19m19p19s1234z}} {{#mjt: 000z}} | ||
− | + | en utilisant la fonction <code>#mjt</code>. Plus exactement, cette séquence de caractères est convertie en une séquence de balises d'images, à savoir : | |
<pre> | <pre> | ||
Ligne 9 : | Ligne 9 : | ||
</pre> | </pre> | ||
− | :'' | + | :''MahjongTuiles'' a été écrite par [[User:Simon|Simon]]. Elle reprend les fonctions principales de l'extension ''MahjongTiles'' écrite par bps pour le [http://www.arcturus.su/wiki wiki anglophone arcturus], avec laquelle elle est à peu près compatible. La compatibilité n'étant pas parfaite, il est fortement conseillé de relire les pages que l'on a traduit pour s'assurer que l'affichage est correct. |
− | |||
== Usage == | == Usage == | ||
− | + | La commande peut être appelée à n'importe quel endroit d'une page wiki. | |
− | === | + | === Syntaxe === |
<pre> | <pre> | ||
− | {{ #mjt: | + | {{ #mjt: description de la main }} |
</pre> | </pre> | ||
− | === | + | === Description des tuiles === |
− | + | La description des tuiles est similaire à la façon dont il est d'usage de décrire les tuiles de façon textuelle. Voici un exemple et son résultat : | |
{| class="wikitable" | {| class="wikitable" | ||
Ligne 38 : | Ligne 37 : | ||
|} | |} | ||
− | + | La partie <code>123</code> ne requiert pas d'explication, et la partie <code>m</code> fait référence à [[man]]. <code>123m</code> est donc la ''description des tuiles''. | |
− | + | En général, une séquence de tuiles correspond à une série de chiffres (0 à 9) suivies par une lettre décrivant à quelle famille elles appartiennent. Il y a quatre familles : | |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! | + | ! Famille || Descripteur || Famille complète (code) || Famille complète |
|- | |- | ||
| [[Man]] || <code>m</code> || <pre>{{#mjt: 0123456789m}}</pre> || {{#mjt: 0123456789m}} | | [[Man]] || <code>m</code> || <pre>{{#mjt: 0123456789m}}</pre> || {{#mjt: 0123456789m}} | ||
Ligne 57 : | Ligne 56 : | ||
|} | |} | ||
− | + | Des configurations plus complexes peuvent aussi être décrites en alignant simplement différentes séries. Autre exemple : | |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! Code || | + | ! Code || Résultat |
|- | |- | ||
| | | | ||
Ligne 70 : | Ligne 69 : | ||
|} | |} | ||
− | + | Contrairement à l'extension originale, il ne faut pas insérer d'espace dans la description des tuiles. | |
− | + | La famille des [[jihai|honneurs]] comprend aussi des tuiles "inconnue" et "face cachée", qui sont souvent nécessaires pour décrire certaines main. Il y a aussi une tuile "invisible" ([[File:Tile-8z.png|baseline]]) ayant les mêmes dimensions qu'une tuile ordinaire pour les besoins de mise en forme. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! Code || | + | ! Code || Résultat |
|- | |- | ||
| | | | ||
<pre> | <pre> | ||
− | + | Le yaku iipeikō ressemble à ça : | |
{{#mjt: 345345m00000000z}} | {{#mjt: 345345m00000000z}} | ||
</pre> | </pre> | ||
− | || | + | || Le yaku iipeikō ressemble à ça : |
{{#mjt: 345345m00000000z}} | {{#mjt: 345345m00000000z}} | ||
Ligne 101 : | Ligne 89 : | ||
| | | | ||
<pre> | <pre> | ||
− | ''Quiz'' | + | ''Quiz'' : quelle est la tuile inconnue dans la suite exposée suivante ? |
− | {{#mjt: | + | {{#mjt: 9z'13m}} |
− | '' | + | ''Réponse''. {{#mjt: 2m}} |
</pre> | </pre> | ||
− | || ''Quiz'' | + | || ''Quiz'' : quelle est la tuile inconnue dans la suite exposée suivante ? |
− | {{#mjt: | + | {{#mjt: 9z'13m}} |
− | '' | + | ''Réponse''. {{#mjt: 2m}} |
|} | |} | ||
− | ==== | + | ==== Orientation des tuiles et empilement ==== |
− | + | Il y a des marqueurs additionnels qui peuvent être appliqués à des tuiles spécifiques ou à un groupe entier pour ajuster leur orientation ou les empiler (pour décrire les [[carrés]]). | |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! Orientation || | + | ! Orientation || Marqueur |
|- | |- | ||
− | | | + | | Tuile couchée |
| <code>'</code> | | <code>'</code> | ||
|- | |- | ||
− | | | + | | Tuiles empilées |
| <code>"</code> | | <code>"</code> | ||
|} | |} | ||
− | + | Ils peuvent être inscrits après un chiffre, n'affectant que la tuile en question, ou après un descripteur de famille, affectant toute la séquence de tuiles décrite. Ces exemples devraient clarifier cela : | |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! width="30%" | Code || width="40%" | | + | ! width="30%" | Code || width="40%" | Résulat || width="30%" | Commentaire |
|- | |- | ||
| | | | ||
<pre> | <pre> | ||
− | {{#mjt: | + | {{#mjt: 123m888p333z22z}} {{ #mjt: 11"1p }} |
</pre> | </pre> | ||
− | | {{#mjt: | + | | {{#mjt: 123m888p333z22z}} {{ #mjt: 11"1p }} |
− | | | + | | Une main simple avec un [[carré]] de 1 de rond. |
|- | |- | ||
| | | | ||
Ligne 147 : | Ligne 135 : | ||
</pre> | </pre> | ||
| {{#mjt: 444m22p123678s}} {{#mjt: 111'z}} | | {{#mjt: 444m22p123678s}} {{#mjt: 111'z}} | ||
− | | | + | | Cette exemple plus réaliste montre une utilisation plus probable de la fonction. Ici les deux descriptions sont séparées par une espace pour plus de lisibilité. |
|- | |- | ||
| | | | ||
Ligne 154 : | Ligne 142 : | ||
</pre> | </pre> | ||
| {{#mjt: 1"33s'}} {{#mjt: 37'7s"}} | | {{#mjt: 1"33s'}} {{#mjt: 37'7s"}} | ||
− | | | + | | On peut voir ici que contrairement à l'extension originale il n'est pas possible d'inclure des marqueurs individuels au sein d'une séquence ayant déjà un marqueur, autrement les tuiles concernées ne s'affichent pas. |
|} | |} | ||
− | + | === Flèches et paifu === | |
+ | Le descripteur de famille <code>x</code> propose une série d'images qui peuvent être utiles pour la réalisation de [[paifu]]. | ||
− | + | === Taille des tuiles === | |
− | + | Contrairement à l'extension originale il n'est pas possible d'ajuster la taille des tuiles. | |
− | + | ||
− | === | + | === Tuiles réservées === |
+ | Si vous tentez d'utiliser une tuile qui n'a pas été décrite encore, vous obtiendrez la tuile suivante : [[File:Tile-0x-k.png]]. Cela s'applique à toutes les images de la série ''paifu'' auxquelles vous essayez d'appliquer un marqueur d'inclinaison. | ||
− | + | == ChangeLog == | |
+ | ==== 1 ==== | ||
+ | Version initiale reprenant les fonctions principales de l'extension présente sur le [http://www.arcturus.su/wiki wiki anglophone arcturus]. Certaines fonctions absentes pourraient être portées par la suite si le besoin s'en fait sentir. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==== 1.1 ==== | ==== 1.1 ==== | ||
− | + | Remplacement des images des tuiles rastérisées (PNG) en images vectorisées (SVG). | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | == | + | == Liste de toutes les images disponibles == |
{{#mjt: 0123456789m}} | {{#mjt: 0123456789m}} | ||
Ligne 235 : | Ligne 192 : | ||
{{#mjt: 0123456789x"}} | {{#mjt: 0123456789x"}} | ||
+ | |||
+ | [[en:Manual:MahjongTile]] |
Version actuelle en date du 20 octobre 2015 à 17:42
MahjongTuiles est une extension MediaWiki permettant d'afficher facilement une séquence d'images de tuiles de mahjong, par exemple :
en utilisant la fonction #mjt
. Plus exactement, cette séquence de caractères est convertie en une séquence de balises d'images, à savoir :
19p -> [[File:Tile-1p.png]][[File:Tile-9p.png]]
- MahjongTuiles a été écrite par Simon. Elle reprend les fonctions principales de l'extension MahjongTiles écrite par bps pour le wiki anglophone arcturus, avec laquelle elle est à peu près compatible. La compatibilité n'étant pas parfaite, il est fortement conseillé de relire les pages que l'on a traduit pour s'assurer que l'affichage est correct.
Sommaire
Usage
La commande peut être appelée à n'importe quel endroit d'une page wiki.
Syntaxe
{{ #mjt: description de la main }}
Description des tuiles
La description des tuiles est similaire à la façon dont il est d'usage de décrire les tuiles de façon textuelle. Voici un exemple et son résultat :
Code | Result |
---|---|
{{#mjt: 123m}} |
La partie 123
ne requiert pas d'explication, et la partie m
fait référence à man. 123m
est donc la description des tuiles.
En général, une séquence de tuiles correspond à une série de chiffres (0 à 9) suivies par une lettre décrivant à quelle famille elles appartiennent. Il y a quatre familles :
Famille | Descripteur | Famille complète (code) | Famille complète |
---|---|---|---|
Man | m |
{{#mjt: 0123456789m}} |
|
Pin | p |
{{#mjt: 0123456789p}} |
|
Sou | s |
{{#mjt: 0123456789s}} |
|
Jihai | z |
{{#mjt: 0123456789z}} |
|
Paifu | x |
{{#mjt: 0123456789x}} |
Des configurations plus complexes peuvent aussi être décrites en alignant simplement différentes séries. Autre exemple :
Code | Résultat |
---|---|
{{#mjt: 456m789s}} |
Contrairement à l'extension originale, il ne faut pas insérer d'espace dans la description des tuiles.
La famille des honneurs comprend aussi des tuiles "inconnue" et "face cachée", qui sont souvent nécessaires pour décrire certaines main. Il y a aussi une tuile "invisible" () ayant les mêmes dimensions qu'une tuile ordinaire pour les besoins de mise en forme.
Code | Résultat |
---|---|
Le yaku iipeikō ressemble à ça : {{#mjt: 345345m00000000z}} |
Le yaku iipeikō ressemble à ça : |
''Quiz'' : quelle est la tuile inconnue dans la suite exposée suivante ? {{#mjt: 9z'13m}} ''Réponse''. {{#mjt: 2m}} |
Quiz : quelle est la tuile inconnue dans la suite exposée suivante ? |
Orientation des tuiles et empilement
Il y a des marqueurs additionnels qui peuvent être appliqués à des tuiles spécifiques ou à un groupe entier pour ajuster leur orientation ou les empiler (pour décrire les carrés).
Orientation | Marqueur |
---|---|
Tuile couchée | '
|
Tuiles empilées | "
|
Ils peuvent être inscrits après un chiffre, n'affectant que la tuile en question, ou après un descripteur de famille, affectant toute la séquence de tuiles décrite. Ces exemples devraient clarifier cela :
Code | Résulat | Commentaire |
---|---|---|
{{#mjt: 123m888p333z22z}} {{ #mjt: 11"1p }} |
Une main simple avec un carré de 1 de rond. | |
{{#mjt: 444m22p123678s}} {{#mjt: 111'z}} |
Cette exemple plus réaliste montre une utilisation plus probable de la fonction. Ici les deux descriptions sont séparées par une espace pour plus de lisibilité. | |
{{#mjt: 1"33s'}} {{#mjt: 37'7s"}} |
Fichier:Tile-1s-k-e.svg Fichier:Tile-7s-e-k.svg | On peut voir ici que contrairement à l'extension originale il n'est pas possible d'inclure des marqueurs individuels au sein d'une séquence ayant déjà un marqueur, autrement les tuiles concernées ne s'affichent pas. |
Flèches et paifu
Le descripteur de famille x
propose une série d'images qui peuvent être utiles pour la réalisation de paifu.
Taille des tuiles
Contrairement à l'extension originale il n'est pas possible d'ajuster la taille des tuiles.
Tuiles réservées
Si vous tentez d'utiliser une tuile qui n'a pas été décrite encore, vous obtiendrez la tuile suivante : . Cela s'applique à toutes les images de la série paifu auxquelles vous essayez d'appliquer un marqueur d'inclinaison.
ChangeLog
1
Version initiale reprenant les fonctions principales de l'extension présente sur le wiki anglophone arcturus. Certaines fonctions absentes pourraient être portées par la suite si le besoin s'en fait sentir.
1.1
Remplacement des images des tuiles rastérisées (PNG) en images vectorisées (SVG).