Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Mit der ''Vorlage Balkendiagramm'' lassen sich horizontale Balkendiagramme erstellen (siehe die Beispiele unten). Diese Vorlage wurde als Pendant zur Vorlage [[:en:Template:Bar box]] erstellt. 

Die Vorlagen 
* [[:Vorlage:Balkendiagramm]]
* [[:Vorlage:Balken Prozent]]
* [[:Vorlage:Balken Prozent 2]]
* [[:Vorlage:Balken Pixel]] 
* [[:Vorlage:Balken schmal Pixel]] 
sind eine Familie von Vorlagen für die Konstruktion von Balkendiagrammen.

== Kopiervorlage ==
 <nowiki>{{Balkendiagramm
| width    = Breite des Graphen (optional)
| barwidth = Breite der Balkenfläche (optional, Standardeinstellung 100px)
| float    = (left|right|none) (optional, Standardeinstellung none)
| title    = Überschrift des Diagramms (optional)
| titlebar = Hintergrundfarbe der Überschrift (optional, Standardeinstellung none)
| left1    = Beschriftung der ersten Spalte links (optional)
| left2    = Beschriftung der zweiten Spalte links (optional)
| right1   = Beschriftung der ersten Spalte rechts (optional)
| right2   = Beschriftung der zweiten Spalte rechts (optional)
| bars     = Diagramminhalt(siehe unten)
| caption  = Legende unter dem Diagramm (optional)
}}</nowiki>

=== Inhalt des Diagramms ===
Das Balkendiagramm kann eine beliebige Zahl von Balken enthalten. Es gibt zwei Sorten von Balken:
* Prozent-Balken: 
 <nowiki>{{</nowiki>Balken Prozent|row label|colour|value (Breite in Prozent)|optional value label<nowiki>}}</nowiki>

Wenn für "label" nichts eingegeben wird, wird als Beschriftung der Prozentwert mit "%" ausgegeben.
* Pixel-Balken: 
 <nowiki>{{</nowiki>Balken Pixel|row label|colour|value (Breite in Pixeln)|value suffix|optional value label<nowiki>}}</nowiki>

Wenn für "label" etwas eingegeben ist, wird "suffix" ignoriert. Andernfalls wird die Balkenbeschriftung aus "value" und "value suffix" konstruiert. Dies kann als Kürzel verwendet werden. Die beiden folgenden Beispiele ergeben dasselbe Resultat:
 <nowiki>{{</nowiki>Balken Pixel|foo|red|12||12,345<nowiki>}}</nowiki>
 <nowiki>{{</nowiki>Balken Pixel|foo|red|12|,345<nowiki>}}</nowiki>

== Beispiele ==
{{Balkendiagramm
| float    = right
| caption  = Verteilung der blubs.
| barwidth = 200px
| bars     =
{{Balken Prozent|foo|red|30}}
{{Balken Prozent|bar|green|40}}
{{Balken Prozent|baz|blue|20}}
{{Balken Prozent|bla|orange|8}}
{{Balken Prozent|bla|teal|2|1/50}}
}}
<pre>
{{Balkendiagramm
| float    = right
| caption  = Verteilung der blubs.
| barwidth = 200px
| bars     =
{{Balken Prozent|foo|red|30}}
{{Balken Prozent|bar|green|40}}
{{Balken Prozent|baz|blue|20}}
{{Balken Prozent|bla|orange|8}}
{{Balken Prozent|bla|teal|2|1/50}}
}}
</pre>

{{Balkendiagramm
| title    = Verteilung der blubs
| titlebar = #DDD
| left1    = Verteilung der blubs.
| right2   = Anzahl
| width    = 400px
| bars     =
{{Balken Pixel|Foobar|red|33|.213}}
{{Balken Pixel|Barfoo|green|123|.123}}
{{Balken Pixel|Bazbar|blue|210|.121}}
{{Balken Pixel|Barfoobaz|orange|13||12.854}}
| caption  = Einige blubs nach Menge.
}}
<pre>
{{Balkendiagramm
| title    = Verteilung der blubs
| titlebar = #DDD
| left1    = Verteilung der blubs.
| right2   = Anzahl
| width    = 400px
| bars     =
{{Balken Pixel|Foobar|red|33|.213}}
{{Balken Pixel|Barfoo|green|123|.123}}
{{Balken Pixel|Bazbar|blue|210|.121}}
{{Balken Pixel|Barfoobaz|orange|13||12.854}}
| caption  = Einige blubs nach Menge.
}}
</pre>

{{Balkendiagramm
| float    = right
| title    = Wahlergebnisse in Bayern
| titlebar = #AAF
| left1    = Partei
| left2    = Jahr
| right1   = Stimmen
| right2   = Veränderung
| width    = 300px
| bars     =
{{Balken Prozent 2|CSU|1998|silver|43|2008|black|52|+9 %p}}
{{Balken Prozent 2|Bayernpartei|1998|silver|30|2008|blue|25|−5 %p}}
{{Balken Prozent 2|Freie Wähler|1998|silver|17|2008|yellow|10|−7 %p}}
{{Balken Prozent 2|Andere|1998|silver|10|2008|gray|13|+3 %p}}
| caption  = Vergleich der bairischen Wahlen 1998 und 2008.
}}
<pre>
{{Balkendiagramm
| float    = right
| title    = Wahlergebnisse in Bayern
| titlebar = #AAF
| left1    = Partei
| left2    = Jahr
| right1   = Stimmen
| right2   = Veränderung
| width    = 300px
| bars     =
{{Balken Prozent 2|CSU|1998|silver|43|2008|black|52|+9 %p}}
{{Balken Prozent 2|Bayernpartei|1998|silver|30|2008|blue|25|−5 %p}}
{{Balken Prozent 2|Freie Wähler|1898|silver|17|2008|yellow|10|−7 %p}}
{{Balken Prozent 2|Andere|1898|silver|10|2008|gray|13|+3 %p}}
| caption  = Vergleich der bairischen Wahlen 1998 und 2008.
}}
</pre>

{{Balkendiagramm
| float    = none
| title    = Rüsselsheim: Einwohnerzahlen von 1834 bis 1967
| titlebar = CornflowerBlue
| left1    = Jahr
| left2    = &nbsp;
| right1   = &nbsp;
| right2   = Einwohner
| width    = 460px
| barwidth = 400px
| bars     =
{{Balken schmal Pixel|1834|CornflowerBlue|{{#expr:floor(400/55000 * 2010)}}||{{formatnum:2010}} }}
{{Balken schmal Pixel|1840|CornflowerBlue|{{#expr:floor(400/55000 * 2030)}}||{{formatnum:2030}} }}
{{Balken schmal Pixel|1846|CornflowerBlue|{{#expr:floor(400/55000 * 2130)}}||{{formatnum:2130}} }}
{{Balken schmal Pixel|1852|CornflowerBlue|{{#expr:floor(400/55000 * 2330)}}||{{formatnum:2330}} }}
{{Balken schmal Pixel|1858|CornflowerBlue|{{#expr:floor(400/55000 * 2530)}}||{{formatnum:2530}} }}
{{Balken schmal Pixel|1864|CornflowerBlue|{{#expr:floor(400/55000 * 2430)}}||{{formatnum:2430}} }}
{{Balken schmal Pixel|1871|CornflowerBlue|{{#expr:floor(400/55000 * 2700)}}||{{formatnum:2700}} }}
{{Balken schmal Pixel|1875|CornflowerBlue|{{#expr:floor(400/55000 * 2930)}}||{{formatnum:2930}} }}
{{Balken schmal Pixel|1885|CornflowerBlue|{{#expr:floor(400/55000 * 3030)}}||{{formatnum:3030}} }}
{{Balken schmal Pixel|1895|CornflowerBlue|{{#expr:floor(400/55000 * 5050)}}||{{formatnum:5050}} }}
{{Balken schmal Pixel|1905|CornflowerBlue|{{#expr:floor(400/55000 * 6030)}}||{{formatnum:6030}} }}
{{Balken schmal Pixel|1910|CornflowerBlue|{{#expr:floor(400/55000 * 10530)}}||{{formatnum:10530}} }}
{{Balken schmal Pixel|1925|CornflowerBlue|{{#expr:floor(400/55000 * 12030)}}||{{formatnum:12030}} }}
{{Balken schmal Pixel|1939|CornflowerBlue|{{#expr:floor(400/55000 * 14030)}}||{{formatnum:14030}} }}
{{Balken schmal Pixel|1946|CornflowerBlue|{{#expr:floor(400/55000 * 20030)}}||{{formatnum:20030}} }}
{{Balken schmal Pixel|1950|CornflowerBlue|{{#expr:floor(400/55000 * 30030)}}||{{formatnum:30030}} }}
{{Balken schmal Pixel|1956|CornflowerBlue|{{#expr:floor(400/55000 * 35030)}}||{{formatnum:35030}} }}
{{Balken schmal Pixel|1961|CornflowerBlue|{{#expr:floor(400/55000 * 38030)}}||{{formatnum:38030}} }}
{{Balken schmal Pixel|1967|CornflowerBlue|{{#expr:floor(400/55000 * 54030)}}||{{formatnum:54030}} }}
| caption  = Datenquelle: Historisches Gem.-Verzeichnis: Die Bevölkerung der Gemeinden 1834 - 1967.<br />Wiesbaden : Hessisches Statistisches Landesamt, 1968.
}}
<pre>
{{Balkendiagramm
| float    = none
| title    = Rüsselsheim: Einwohnerzahlen von 1834 bis 1967
| titlebar = CornflowerBlue
| left1    = Jahr
| left2    = &nbsp;
| right1   = &nbsp;
| right2   = Einwohner
| width    = 460 px
| barwidth = 400 px
| bars     =
{{Balken schmal Pixel|1834|CornflowerBlue|{{#expr:floor(400/55000 * 2010)}}||{{formatnum:2010}} }}
{{Balken schmal Pixel|1840|CornflowerBlue|{{#expr:floor(400/55000 * 2030)}}||{{formatnum:2030}} }}
{{Balken schmal Pixel|1846|CornflowerBlue|{{#expr:floor(400/55000 * 2130)}}||{{formatnum:2130}} }}
{{Balken schmal Pixel|1852|CornflowerBlue|{{#expr:floor(400/55000 * 2330)}}||{{formatnum:2330}} }}
{{Balken schmal Pixel|1858|CornflowerBlue|{{#expr:floor(400/55000 * 2530)}}||{{formatnum:2530}} }}
{{Balken schmal Pixel|1864|CornflowerBlue|{{#expr:floor(400/55000 * 2430)}}||{{formatnum:2430}} }}
{{Balken schmal Pixel|1871|CornflowerBlue|{{#expr:floor(400/55000 * 2700)}}||{{formatnum:2700}} }}
{{Balken schmal Pixel|1875|CornflowerBlue|{{#expr:floor(400/55000 * 2930)}}||{{formatnum:2930}} }}
{{Balken schmal Pixel|1885|CornflowerBlue|{{#expr:floor(400/55000 * 3030)}}||{{formatnum:3030}} }}
{{Balken schmal Pixel|1895|CornflowerBlue|{{#expr:floor(400/55000 * 5050)}}||{{formatnum:5050}} }}
{{Balken schmal Pixel|1905|CornflowerBlue|{{#expr:floor(400/55000 * 6030)}}||{{formatnum:6030}} }}
{{Balken schmal Pixel|1910|CornflowerBlue|{{#expr:floor(400/55000 * 10530)}}||{{formatnum:10530}} }}
{{Balken schmal Pixel|1925|CornflowerBlue|{{#expr:floor(400/55000 * 12030)}}||{{formatnum:12030}} }}
{{Balken schmal Pixel|1939|CornflowerBlue|{{#expr:floor(400/55000 * 14030)}}||{{formatnum:14030}} }}
{{Balken schmal Pixel|1946|CornflowerBlue|{{#expr:floor(400/55000 * 20030)}}||{{formatnum:20030}} }}
{{Balken schmal Pixel|1950|CornflowerBlue|{{#expr:floor(400/55000 * 30030)}}||{{formatnum:30030}} }}
{{Balken schmal Pixel|1956|CornflowerBlue|{{#expr:floor(400/55000 * 35030)}}||{{formatnum:35030}} }}
{{Balken schmal Pixel|1961|CornflowerBlue|{{#expr:floor(400/55000 * 38030)}}||{{formatnum:38030}} }}
{{Balken schmal Pixel|1967|CornflowerBlue|{{#expr:floor(400/55000 * 54030)}}||{{formatnum:54030}} }}
| caption  = Datenquelle: Historisches Gem.-Verzeichnis: Die Bevölkerung der Gemeinden 1834 - 1967.<br />Wiesbaden : Hessisches Statistisches Landesamt, 1968.
}}
</pre>