Modèle:Générateur de code de courbe d'affluence

 Documentation[voir] [modifier] [historique] [purger]

Description

modifier

Ce modèle sert à obtenir le code EasyTimeline permettant de tracer une courbe d'évolution d'affluence. Ce modèle est en réalité davantage un outil qu'un véritable modèle comme on l'entend généralement. Il s'utilise en prévisualisation uniquement (voir utilisation ci-dessous) et ne doit pas être intégré en tant que tel dans un article.

Ce modèle est basé sur le Modèle:Graphique démographique, auquel a été ajouté le paramètre px par année pour pouvoir définir la largeur d'une année (valeur par défaut : 9).

Utilisation

modifier

Pour, avec l'aide de ce modèle, mettre une courbe d'évolution d'affluence dans un article, il faut procéder en trois étapes simples:

(1) Dans la fenêtre d'édition d'une page quelconque, placer ce modèle {{Générateur de code de courbe d'affluence}} avec ses paramètres (dont 3 paramètres obligatoires),
  • modifier si nécessaire le format des chiffres de population afin qu'ils soient tous ou bien sans espace, ou bien de la forme {{formatnum:1234567}}, et sans autre texte (pas de références).
(2) Prévisualiser (cela affiche le code EasyTimeline à utiliser) et copier le code EasyTimeline ainsi obtenu.
(3) Coller le code EasyTimeline dans l'article, prévisualiser pour vérifier que la courbe s'affiche correctement, et enfin publier.

Ce modèle est actuellement limité à 50 graduations pour l'échelle de l'affluence et 50 couples date / affluence. Rien n'empêche d'étendre ces limites dans le modèle si cela s'avérait utile.

Note: ce modèle fait appel à une sous-page intitulée "/Code Timeline" modèle:Générateur de code de courbe d'affluence/Code Timeline.

Syntaxe complète

modifier
{{Générateur de code de courbe d'affluence
|max échelle                         =<!-- obligatoire (il y a une valeur par défaut mais elle est arbitraire) -->
|incrément échelle                   =<!-- obligatoire (il y a une valeur par défaut mais elle est arbitraire) -->
|une gradation principale toutes les =<!-- obligatoire (il y a une valeur par défaut mais elle est arbitraire) -->
|hauteur additionnelle               =<!-- facultatif, nombre entier positif ou négatif, par défaut 0 -->
|année min                           =<!-- facultatif, par défaut 1790 -->
|année max                           =<!-- facultatif, par défaut 2010 -->
|marge de gauche                     =<!-- facultatif, une valeur adaptée à l'échelle de population est calculée par défaut -->
|px par année                        =<!-- facultatif, par défaut 9 -->
|année |spectateurs
|année |spectateurs
|année |spectateurs
|année |spectateurs
...
}}
  • Important: ce modèle ne fonctionne que pour un nombre de spectateurs de la forme 1234567 ou bien de la forme {{formatnum:1234567}}, il ne fonctionne pas si il y a un espace entre les chiffres d'une population ou bien des références.
Les données qui ne respectent pas l'une des deux formes possibles décrites ci-dessus sont ignorées et les points correspondants ne sont pas inclus dans le code EasyTimeline généré. Ils ne seront pas affichés dans le graphique, ni non plus la courbe à l'endroit de ces points.

Remarques

modifier
  • Si vous souhaitez modifier le code EasyTimeline généré, c'est bien sûr possible. La syntaxe EasyTimeline est expliquée ici: Aide:Frise chronologique (traduction de l'anglais Extension:EasyTimeline/syntax).
  • Il est possible de modifier la couleur de la courbe dans le code EasyTimeline (au tout début), en modifiant la ligne «  id:couleurcourbe value:rgb(0,0.6,0.4) » en donnant la couleur que vous voulez à la place de rgb(0,0.6,0.4). Il est essentiel de consulter au préalable la recommandation relative à l'usage des couleurs WP:COULEUR. Attention au contraste qui doit rester très fort pour des questions d'accessibilité.
Voir la syntaxe du code couleur sur Aide:Frise chronologique#Colors ou en anglais (plus complet) sur Extension:EasyTimeline/syntax#Colors.

Exemple 1

modifier
{{Générateur de code de courbe d'affluence
|max échelle                         =3000
|incrément échelle                   =500
|une gradation principale toutes les =2
|hauteur additionnelle               =<!-- par défaut 0 -->
|année min                           =1949
|année max                           =1963
|px par année                        =<!-- par défaut 9 -->
|1963|536
|1962|969
|1961|2925
|1960|868
|1959|801
|1958|1707
|1957|1059
|1956|1128
|1955|704
|1954|1636
|1953|2998
|1952|2384
|1951|2135
|1950|1702
|1949|2115
}}

Résultat

modifier

Le code génère le texte suivant (le graphique correspondant est après) :

COPIEZ-COLLEZ LE SCRIPT SUIVANT DANS L'ARTICLE POUR OBTENIR UNE COURBE D'AFFLUENCE :
(le script EasyTimeline lui-même est en vert et la partie en bleu est une suggestion de présentation)

<div style="text-align: center;">'''Évolution de la moyenne de spectateurs à domicile du CLUB depuis 1963'''</div><!--
---------- début de graphique en code Timeline, suite de l'article plus loin ------->

<div style="text-align: center;"><timeline>
Colors =
  id:grisclair value:gray(0.9)
  id:grisfonce value:gray(0.5)
  id:couleurcourbe value:rgb(0,0.6,0.4)
 
ImageSize = width:178 height:232
PlotArea = left:42 right:10 top:1 bottom:20
TimeAxis = orientation:horizontal
AlignBars = justify
DateFormat = yyyy
Period = from:1949 till:1963
ScaleMajor = unit:year increment:10 start:1949
 
BarData =
  bar:8 text:
  bar:7 text:3 000
  bar:6 text:
  bar:5 text:2 000
  bar:4 text:
  bar:3 text:1 000
  bar:2 text:
  bar:1 text:0
 
PlotData =
  color:grisclair width:0.5 # repères et légende axe vertical (nombre de spectateurs)
  bar:8 color:white from:start till:end
  bar:7 color:grisfonce from:start till:end
  bar:6 from:start till:end
  bar:5 color:grisfonce from:start till:end
  bar:4 from:start till:end
  bar:3 color:grisfonce from:start till:end
  bar:2 from:start till:end
  bar:1 color:grisfonce from:start till:end
 
LineData =
  layer:front color:couleurcourbe width:1 # courbe d'affluence
  points:(168,52)(159,78) # 1963: 536 s. à 1962: 969 s.
  points:(159,78)(150,195) # 1962: 969 s. à 1961: 2 925 s.
  points:(150,195)(141,72) # 1961: 2 925 s. à 1960: 868 s.
  points:(141,72)(132,68) # 1960: 868 s. à 1959: 801 s.
  points:(132,68)(123,122) # 1959: 801 s. à 1958: 1 707 s.
  points:(123,122)(114,83) # 1958: 1 707 s. à 1957: 1 059 s.
  points:(114,83)(105,87) # 1957: 1 059 s. à 1956: 1 128 s.
  points:(105,87)(96,62) # 1956: 1 128 s. à 1955: 704 s.
  points:(96,62)(87,118) # 1955: 704 s. à 1954: 1 636 s.
  points:(87,118)(78,199) # 1954: 1 636 s. à 1953: 2 998 s.
  points:(78,199)(69,162) # 1953: 2 998 s. à 1952: 2 384 s.
  points:(69,162)(60,147) # 1952: 2 384 s. à 1951: 2 135 s.
  points:(60,147)(51,122) # 1951: 2 135 s. à 1950: 1 702 s.
  points:(51,122)(42,146) # 1950: 1 702 s. à 1949: 2 115 s.
 
  color:black width:3 # points du nombre de spectateurs
  points:(168,51)(168,53) # 1963: 536 s.
  points:(159,77)(159,79) # 1962: 969 s.
  points:(150,194)(150,196) # 1961: 2 925 s.
  points:(141,71)(141,73) # 1960: 868 s.
  points:(132,67)(132,69) # 1959: 801 s.
  points:(123,121)(123,123) # 1958: 1 707 s.
  points:(114,82)(114,84) # 1957: 1 059 s.
  points:(105,86)(105,88) # 1956: 1 128 s.
  points:(96,61)(96,63) # 1955: 704 s.
  points:(87,117)(87,119) # 1954: 1 636 s.
  points:(78,198)(78,200) # 1953: 2 998 s.
  points:(69,161)(69,163) # 1952: 2 384 s.
  points:(60,146)(60,148) # 1951: 2 135 s.
  points:(51,121)(51,123) # 1950: 1 702 s.
  points:(42,145)(42,147) # 1949: 2 115 s.
 
# échelle de temps: le graphe commence à 1949 = 42 px, ensuite chaque année fait 9 px jusqu'à 1963 = 42+3x14 = 84 px
# échelle du nombre de spectateurs : le graphe va de 20px à 229px, donc 0 hab. = 20px et 1 habitant fait 209/3500 = 0.059714 pixel
# et donc l'ordonnée (nombre de spectateurs) des points est y = 20 + nb(habitants) x 0.059714
# Courbe réalisée avec l'aide du modèle [[modèle:Générateur de code de courbe d'affluence]]  
</timeline></div>

<!---------- fin du graphique en code Timeline --------------------------------------->
  • Notes importantes pour l'utilisation de ce modèle de génération de code EasyTimeline:
    1. Syntaxe: ce modèle ne fonctionne que pour des affluences de la forme 1234567 ou bien de la forme {{formatnum:1234567}}, il ne fonctionne pas si il y a un espace entre les chiffres d'une affluence ou bien des références.
    2. Si jamais les lignes horizontales de graduation de l'affluence sont trop épaisses, ré-essayez avec le paramètre hauteur additionnelle = 1 .
    3. Vous pouvez utiliser le paramètre hauteur additionnelle également pour tout simplement augmenter (ou diminuer si la valeur est négative) la hauteur de l'image.
    4. Pour plus de détails voyez la documentation de ce modèle Générateur de code de courbe d'affluence.
  • Pour information, valeurs utilisées pour générer le code EasyTimeline qui précède:

| max échelle = 3000
| incrément échelle = 500
| une gradation principale toutes les = 2
| hauteur additionnelle = 0
| année min = 1949
| année max = 1963
| px par année = 9

nb éléments échelle = 8 (calculé automatiquement par le modèle)
hauteur image = 232 (calculé automatiquement par le modèle)
hauteur graphe = 209 (calculé automatiquement par le modèle)
marge de gauche = 42 (calculé automatiquement par le modèle)
pixels par habitant = 0.059714285714286 (calculé automatiquement par le modèle)

Graphique

modifier

Le code obtenu ci-dessus donne la courbe suivante lorsqu'il est copié-collé dans un article :

Évolution de la moyenne de spectateurs à domicile du CLUB depuis 1963

Modèles connexes

modifier