Ceci est la sous-page de documentation du modèle {{Guitar string}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.
Cette page constitue la documentation du 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 :
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é.
Dans sa version actuelle, l'inconvénient de ce modèle est le volume énorme d'informations inutiles substituées dans le code source de la page avant la production d'HTML, c'est-à-dire avant le passage de sa forme "pre-expand" à "post-expand". Au delà d'un certain nombre d'appels du modèle dans une même page, la forme pre-expand de la page est tout simplement trop volumineuse : le code-source du modèle n'est plus interprété, ce qui génère des erreurs d'affichage. Ce problème n'a été que partiellement résolu en renonçant à inclure la documentation du modèle dans sa page : la taille de la forme "pre-expand" des pages a été divisée de moitié (les délimiteurs "no include" autour de la documentation d'un modèle placée dans le modèle ne servent qu'à indiquer qu'une partie du code-source du modèle doit être effacée dans le passage de la forme "pre-expand" à "post-expand", mais ne réduisent pas la taille de sa 1ère forme, aussi volumineuse avec, que sans ces délimiteurs).
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).
En fonction du navigateur et des polices disponibles, les indications de noms de notes peuvent ne pas donner un rendu correct pour les petites échelles. Si aucune police de taille inférieure à une douzaine de pixels n'est disponible, une échelle < 1 provoquera en général une erreur d'affichage.
scale : échelle souhaitée pour le diagramme (facultatif, par défaut 1 ; éviter les valeurs < 0.6)
neck : nom du groupe d'images (facultatif, plain par défaut).
note : nom de la note jouée (facultatif).
note_size : taille de la note en pixels (facultatif, 10px par défaut).
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 - spécifie 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.
