Extension MahjongTuiles : Différence entre versions

De Wiki riichi mahjong
Aller à : navigation, rechercher
(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... »)
 
Ligne 1 : Ligne 1 :
−
'''MahjongTile''' is a [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] extension that makes it easy to output sequences of mahjong tile images, for example:
+
'''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}}
  
−
by use of the parser function <code>#mjt</code>. Specifically, it converts tile strings into their corresponding sequence of wiki markup image insertions, e.g.:
+
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>
  
−
:''MahjongTile'' is written by [[User:Bps|bps]]. Bug reports and feature requests are always welcome.
+
:''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.
  
−
: The [[Special:Version#Installed_extensions|current version]] is 1.1.
 
  
 
== Usage ==
 
== Usage ==
  
−
The command can be invoked at any point in the wiki markup.
+
La commande peut être appelée à n'importe quel endroit d'une page wiki.
  
−
=== Syntax ===
+
=== Syntaxe ===
  
 
<pre>
 
<pre>
−
{{ #mjt: tile string | size option }}
+
{{ #mjt: description de la main }}
 
</pre>
 
</pre>
  
−
=== Tile string ===
+
=== Description des tuiles ===
  
−
The tile string is similar to the way people communicate strings of tiles through text. First, an example, and its output:
+
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 :
 
|}
 
|}
  
−
The <code>123</code> part is self-explanatory, and the <code>m</code> part stands for [[man]]. <code>123m</code> is called the ''tile string''.
+
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''.
  
−
In general, a tile sequence consists of a series of digits (0 through 9) followed by a descriptor character describing which set they belong to. There are four groups:
+
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"
 
|-
 
|-
−
! Group || Descriptor || Full array (code) || Full array
+
! 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 :
 
|}
 
|}
  
−
More complex configurations can also be described, by simply concatenating strings like above. Another example:
+
Des configurations plus complexes peuvent aussi être décrites en alignant simplement différentes séries. Autre exemple :
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
! Code || Result
+
! Code || Résultat
 
|-
 
|-
 
|
 
|
Ligne 70 : Ligne 69 :
 
|}
 
|}
  
−
Spaces in a tile string are also ignored, so the following are equivalent:
+
Contrairement à l'extension originale, il ne faut pas insérer d'espace dans la description des tuiles.
  
−
<pre>
+
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]]) ayant les mêmes dimensions qu'une tuile ordinaire pour les besoins de mise en forme.
−
123m1111z
+
−
123m 1111z
+
−
123m    1111z
+
−
1 23m1111z
+
−
123m11 11z
+
−
12 3m1111    z
+
−
1 23  m1 11 1z
+
−
...
+
−
</pre>
+
−
 
+
−
The [[jihai]] group (see the table above) can also be used to refer to "unknown" or "face-down" tiles, as is often convenient when describing certain components of a hand. There is also a "blank" tile image ([[File:Tile-whitespace.png]]) with the same dimensions as an ordinary tile, in case something like that is ever needed. Examples:
+
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
! Code || Result
+
! Code || Résultat
 
|-
 
|-
 
|
 
|
 
<pre>
 
<pre>
−
The iipeikou yaku looks something like:
+
Le yaku iipeikō ressemble à ça :
  
 
{{#mjt: 345345m00000000z}}
 
{{#mjt: 345345m00000000z}}
 
</pre>
 
</pre>
−
|| The iipeikou yaku looks something like:
+
|| Le yaku iipeikō ressemble à ça :
  
 
{{#mjt: 345345m00000000z}}
 
{{#mjt: 345345m00000000z}}
Ligne 101 : Ligne 89 :
 
|
 
|
 
<pre>
 
<pre>
−
''Quiz''. What is the unknown tile in the following chii group?
+
''Quiz'' : quelle est la tuile inconnue dans la suite exposée suivante ?
  
−
{{#mjt: 13m9z'}}
+
{{#mjt: 9z'13m}}
  
−
''Answer''. {{#mjt: 2m}}
+
''Réponse''. {{#mjt: 2m}}
 
</pre>
 
</pre>
−
|| ''Quiz''. What is the unknown tile in the following chii group?
+
|| ''Quiz'' : quelle est la tuile inconnue dans la suite exposée suivante ?
  
−
{{#mjt: 13m9z'}}
+
{{#mjt: 9z'13m}}
  
−
''Answer''. {{#mjt: 2m}}
+
''Réponse''. {{#mjt: 2m}}
 
|}
 
|}
  
−
==== Tile orientation and stacking ====
+
==== Orientation des tuiles et empilement ====
  
−
There are additional flags that can be applied to specific tiles or entire tile groupings that adjust their orientation, or stack them up (for [[kan]] groups).
+
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 || Flag
+
! Orientation || Marqueur
 
|-
 
|-
−
| Sideways (pointing east/right)
+
| Tuile couchée
 
| <code>'</code>
 
| <code>'</code>
 
|-
 
|-
−
| Stacked (pointing west/left)
+
| Tuiles empilées
 
| <code>"</code>
 
| <code>"</code>
 
|}
 
|}
  
−
These can be applied after a digit, affecting that individual tile only, or after a descriptor, then affecting the entire sequence of tiles in that grouping. The following examples should make this clear:
+
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%" | Result || width="30%" | Comment
+
! width="30%" | Code || width="40%" | Résulat || width="30%" | Commentaire
 
|-
 
|-
 
|
 
|
Ligne 140 : Ligne 128 :
 
</pre>
 
</pre>
 
| {{#mjt: 123m 888p 333z 22z}} {{ #mjt: 11"1p }}
 
| {{#mjt: 123m 888p 333z 22z}} {{ #mjt: 11"1p }}
−
| A simple winning hand involving a [[kan]] of 1-pin.
+
| 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}}
−
| This more realistic example demonstrates how the feature might actually be used. Note the two commands separated by a space, for readability.
+
| 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"}}
−
| Here we see how the individually set orientation overrides the grouping orientation. This is just how it works, it's not indended for any magical purpose. It is probably more efficient.
+
| 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.
 
|}
 
|}
−
 
−
If you can think of a reason why upside down tiles should also be implemented, let me know and I will add that too. I really can't think of a (not incredibly contrived) situation that warrants upside down tile images.
 
−
 
−
'''Note'''. The old behaviour (before 2015-01-25) of the <code>"</code> flag was to make the tile point west/left. This was totally useless though, so it has been replaced with the above configuration.
 
  
 
=== Arrows and paifu ===
 
=== Arrows and paifu ===
−
The <code>x</code> descriptor offers a number of images that may be useful in construction of [[paifu]]. Note in particular that the height of the left- and right-arrows is equal to the usual height of an upright tile, so as to achieve proper centering. The mnemonic for remembering the arrow numbers is to start from zero, and count "up, down, left, right". I think this is the most natural way to enumerate the directions, at least in spoken English.
+
Le descripteur de famille <code>x</code> propose une série d'images qui peuvent être utiles pour la réalisation de [[paifu]].
−
 
+
−
=== Size option ===
+
−
 
+
−
This is the size option you would pass to any image. First, an explanation with a regular image:
+
−
 
+
−
{| class="wikitable"
+
−
|-
+
−
! Code || Result
+
−
|-
+
−
| <pre>[[File:13_red_x.png|50px]]</pre>
+
−
| [[File:13_red_x.png|50px]]
+
−
|}
+
−
 
+
−
Now, try with ''MahjongTile'':
+
−
 
+
−
{| class="wikitable"
+
−
|-
+
−
! Code || Result
+
−
|-
+
−
| <pre>{{#mjt: 1m1s' | 200px}}</pre>
+
−
| {{#mjt: 1m1s' | 200px}}
+
−
|}
+
  
−
It works a bit weird, so you should refer to [http://www.mediawiki.org/wiki/Help:Images#Size_and_frame the MediaWiki help page]. You may find you have to split up your sequence into multiple commands. If they are not separated by any whitespace, they should behave as if they were stuck together with just one command.
+
=== Taille des tuiles ===
  
−
=== Reserved tiles ===
+
Contrairement à l'extension originale il n'est pas possible d'ajuster la taille des tuiles.
−
Should you use a tile which has not been described above, you will get a tile like this instead: [[File:Tile-reserved.png]]. In particular, the <code>'</code>- or <code>"</code>-modified <code>x</code> (paifu group) tiles will give you this at the moment (version 1.1). The purpose of this aggressive output is to avoid use of codes which may in future have some other meaning.
+
  
−
== Potential new features ==
+
=== Tuiles réservées ===
−
You are always welcome to make suggestions for what could be added.
+
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.
−
* Implement some neat way of displaying score sticks.
+
  
 
== ChangeLog ==
 
== ChangeLog ==
−
==== 1.1 ====
 
−
* <code>89z</code> changed to whitespace and question mark tiles respectively.
 
−
* <code>"</code> flag changed from west-pointing sideways tiles to east-pointing stacked tiles (for kan groups).
 
−
* <code>z</code> descriptor added, principally for [[paifu]]. Only the unflagged tiles have been given assignments. The remainder output a reserved tile image to warn editors if used mistakenly.
 
−
* Parser now adds the <code>baseline</code> argument to the image code, for aesthetic qualities when formatting [[mentsu]].
 
−
** It would be nice to scan the wiki (automatically?) and update any previous cases where the sideways tiles were formatted in a centered position. This is necessary because updates to the extension do not automatically materialise in existing pages - they must be edited for changes to take effect.
 
 
==== 1 ====
 
==== 1 ====
−
Initial version.
+
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.
  
−
== Full list of tile images available ==
+
== Liste de toutes les images disponibles ==
 
{{#mjt: 0123456789m}}
 
{{#mjt: 0123456789m}}
  

Version du 21 septembre 2015 à 19:49

MahjongTuiles est une extension MediaWiki permettant d'afficher facilement une séquence d'images de tuiles de mahjong, par exemple :

Tile-1m.svgTile-9m.svgTile-1p.svgTile-9p.svgTile-1s.svgTile-9s.svgTile-1z.svgTile-2z.svgTile-3z.svgTile-4z.svg Tile-0z.svgTile-0z.svgTile-0z.svg

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.


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}}
Tile-1m.svgTile-2m.svgTile-3m.svg

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}}
 Tile-0m.svgTile-1m.svgTile-2m.svgTile-3m.svgTile-4m.svgTile-5m.svgTile-6m.svgTile-7m.svgTile-8m.svgTile-9m.svg
Pin p 
{{#mjt: 0123456789p}}
 Tile-0p.svgTile-1p.svgTile-2p.svgTile-3p.svgTile-4p.svgTile-5p.svgTile-6p.svgTile-7p.svgTile-8p.svgTile-9p.svg
Sou s 
{{#mjt: 0123456789s}}
 Tile-0s.svgTile-1s.svgTile-2s.svgTile-3s.svgTile-4s.svgTile-5s.svgTile-6s.svgTile-7s.svgTile-8s.svgTile-9s.svg
Jihai z 
{{#mjt: 0123456789z}}
 Tile-0z.svgTile-1z.svgTile-2z.svgTile-3z.svgTile-4z.svgTile-5z.svgTile-6z.svgTile-7z.svgTile-8z.svgTile-9z.svg
Paifu x 
{{#mjt: 0123456789x}}
 Tile-0x.svgTile-1x.svgTile-2x.svgTile-3x.svgTile-4x.svgTile-5x.svgTile-6x.svgTile-7x.svgTile-8x.svgTile-9x.svg

Des configurations plus complexes peuvent aussi être décrites en alignant simplement différentes séries. Autre exemple :

Code Résultat 
{{#mjt: 456m789s}}
Tile-4m.svgTile-5m.svgTile-6m.svgTile-7s.svgTile-8s.svgTile-9s.svg

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" (Tile-8z.png) 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 :

Tile-3m.svgTile-4m.svgTile-5m.svgTile-3m.svgTile-4m.svgTile-5m.svgTile-0z.svgTile-0z.svgTile-0z.svgTile-0z.svgTile-0z.svgTile-0z.svgTile-0z.svgTile-0z.svg 

''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 ?

Tile-9z-e.svgTile-1m.svgTile-3m.svg

Réponse. Tile-2m.svg

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: 123m 888p 333z 22z}} {{ #mjt: 11"1p }}
Tile-1m.svgTile-2m.svgTile-3m.svg Tile-1p.svgTile-1p-k.svgTile-1p.svg Une main simple avec un carré de 1 de rond. 
{{#mjt: 444m22p123678s}} {{#mjt: 111'z}}
Tile-4m.svgTile-4m.svgTile-4m.svgTile-2p.svgTile-2p.svgTile-1s.svgTile-2s.svgTile-3s.svgTile-6s.svgTile-7s.svgTile-8s.svg Tile-1z.svgTile-1z.svgTile-1z-e.svg 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.svgTile-3s-e.svgTile-3s-e.svg Tile-3s-k.svgFichier:Tile-7s-e-k.svgTile-7s-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.

Arrows and 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 : 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 wiki anglophone arcturus. Certaines fonctions absentes pourraient être portées par la suite si le besoin s'en fait sentir.

Liste de toutes les images disponibles

Tile-0m.svgTile-1m.svgTile-2m.svgTile-3m.svgTile-4m.svgTile-5m.svgTile-6m.svgTile-7m.svgTile-8m.svgTile-9m.svg

Tile-0p.svgTile-1p.svgTile-2p.svgTile-3p.svgTile-4p.svgTile-5p.svgTile-6p.svgTile-7p.svgTile-8p.svgTile-9p.svg

Tile-0s.svgTile-1s.svgTile-2s.svgTile-3s.svgTile-4s.svgTile-5s.svgTile-6s.svgTile-7s.svgTile-8s.svgTile-9s.svg

Tile-0z.svgTile-1z.svgTile-2z.svgTile-3z.svgTile-4z.svgTile-5z.svgTile-6z.svgTile-7z.svgTile-8z.svgTile-9z.svg

Tile-0x.svgTile-1x.svgTile-2x.svgTile-3x.svgTile-4x.svgTile-5x.svgTile-6x.svgTile-7x.svgTile-8x.svgTile-9x.svg

Tile-0m-e.svgTile-1m-e.svgTile-2m-e.svgTile-3m-e.svgTile-4m-e.svgTile-5m-e.svgTile-6m-e.svgTile-7m-e.svgTile-8m-e.svgTile-9m-e.svg

Tile-0m-k.svgTile-1m-k.svgTile-2m-k.svgTile-3m-k.svgTile-4m-k.svgTile-5m-k.svgTile-6m-k.svgTile-7m-k.svgTile-8m-k.svgTile-9m-k.svg

Tile-0p-e.svgTile-1p-e.svgTile-2p-e.svgTile-3p-e.svgTile-4p-e.svgTile-5p-e.svgTile-6p-e.svgTile-7p-e.svgTile-8p-e.svgTile-9p-e.svg

Tile-0p-k.svgTile-1p-k.svgTile-2p-k.svgTile-3p-k.svgTile-4p-k.svgTile-5p-k.svgTile-6p-k.svgTile-7p-k.svgTile-8p-k.svgTile-9p-k.svg

Tile-0s-e.svgTile-1s-e.svgTile-2s-e.svgTile-3s-e.svgTile-4s-e.svgTile-5s-e.svgTile-6s-e.svgTile-7s-e.svgTile-8s-e.svgTile-9s-e.svg

Tile-0s-k.svgTile-1s-k.svgTile-2s-k.svgTile-3s-k.svgTile-4s-k.svgTile-5s-k.svgTile-6s-k.svgTile-7s-k.svgTile-8s-k.svgTile-9s-k.svg

Tile-0z-e.svgTile-1z-e.svgTile-2z-e.svgTile-3z-e.svgTile-4z-e.svgTile-5z-e.svgTile-6z-e.svgTile-7z-e.svgTile-8z-e.svgTile-9z-e.svg

Tile-0z-k.svgTile-1z-k.svgTile-2z-k.svgTile-3z-k.svgTile-4z-k.svgTile-5z-k.svgTile-6z-k.svgTile-7z-k.svgTile-8z-k.svgTile-9z-k.svg

Tile-0x-e.svgTile-1x-e.svgTile-2x-e.svgTile-3x-e.svgTile-4x-e.svgTile-5x-e.svgTile-6x-e.svgTile-7x-e.svgTile-8x-e.svgTile-9x-e.svg

Tile-0x-k.svgTile-1x-k.svgTile-2x-k.svgTile-3x-k.svgTile-4x-k.svgTile-5x-k.svgTile-6x-k.svgTile-7x-k.svgTile-8x-k.svgTile-9x-k.svg

Récupérée de « http://www.chuuren.fr/w/index.php?title=Extension_MahjongTuiles&oldid=379 »