Modèle:Guitar string/Main/Documentation

Cette page constitue la documentation du Modèle:Guitar_string/Main, nouvelle version optimisée de Modèle:Guitar_string. Elle n'est pas visible sur la page du modèle, pour les raisons présentées ci-dessous à la section "Problèmes connus". Ce modèle est obsolète, et ne doit plus être utilisé. Il n'apparaît plus que dans les anciennes versions des pages suivantes :

c.f Modèle:Guitar String Documentation pour la documentation du jeu de modèles le plus récent.

Utilisation

Ce modèle est destiné à la construction de diagrammes d'accords et de grilles de gammes pour la guitare ou la basse. Il ne construit qu'une seule corde, par énumération du contenu de chaque frette. Le résultat produit une entrée de table, de délimiteurs <tr> </tr> . Les délimiteurs <table> </table> de la table qui contiendra cette entrée ne peuvent faire partie du modèle, ces derniers étant communs à chaque entrée décrivant le contenu d'une corde dans un diagramme donné.

Problèmes connus

Ce modèle consomme moins de mémoire (moins de la moitié pour des diagrammes d'accords de moins de 5 frettes de large) que l'ancien modèle, mais sa forme pre-expand est toujours assez volumineuse. La documentation n'a toujours pas été intégrée à la page du modèle, de manière à réduire la taille de cette forme.
Toutes les valeurs d'échelle ne donnent pas un rendu correct : pour certaines, les erreurs d'arrondis ne donnent pas la même hauteur pour toutes les images. Si une valeur particulière donne un affichage irrégulier (e.g. 0.9), essayez une autre valeur proche (0.95).
L'affichage est incorrect sous Internet Explorer lorsque la taille d'affichage des pages est plus grande que la taille dite "moyenne" - dans tous les cas, le temps de chargement d'une page contenant ce modèle est ridiculement long avec ce navigateur. Inversement, le temps de chargement est quasi-immédiat, et l'affichage correct pour la plupart des valeurs d'échelles sous Firefox. Le problème d'affichage est dû au fait qu'Explorer, contrairement à Firefox, impose aux lignes d'un tableau d'être de hauteur au moins égal à la taille des caractères de la police par défaut courante. Les nouvelles versions de ce modèle corrigeront ce problème.
Cette version n'intègre plus la gestion des noms de notes, ni l'usage d'une banque d'images autre que plain (c.f. la documentation de l'ancien modèle sur Documentation). Outre les problèmes d'affichage rencontrés dans l'ancienne version, le fait de gérer moins de paramètres consomme moins de mémoire.

Syntaxe

{{Guitar string
  | scale = nombre
  | string_length = chaîne
  | chaîne n.1
  | chaîne n.2
  | chaîne n.3
  |suite de chaînes
}}

Paramètres

scale : échelle souhaitée pour le diagramme (facultatif, par défaut 0.8)
string_length : Long ou Short (facultatif, par défaut Short - gestion de 5 frettes au plus pour Short, 12 frettes au plus pour Long)
chaîne n.1 : top ou mid ou bot (nécessaire - spécifie si la corde est en haut, au milieu ou en bas du manche)
chaîne n.2 : chaîne vide, ou open ou mute (nécessaire - specifie si la corde n'est frettée, à vide ou étouffée)
chaîne n.3 : chaîne vide, ou nut (nécessaire - spécifie s'il y a un sillet à gauche)
chaînes suivantes : bar_top (partie supérieure d'un barré), bar (partie médiane d'un barré), bar_bot (partie inférieure d'un barré), fret (frette vide), dot (frette appuyée). Les chaînes bar_bot et dot peuvent être complétées par l'un des suffixes _1, _2, _3, _4, _P ou _T pour indiquer le doigté d'une frette individuelle ou d'un barré, avec la correspondance usuelle _1 pour index, _2 pour majeur, _3 pour annulaire, _4 pour auriculaire, P pour pouce, et T pour thumb.