Extension:EasyTimeline

Příručka k rozšířením MediaWiki

EasyTimeline Stav rozšíření: stabilní
Implementace	Značka
Popis	Přidá ‎<timeline> tag pro vytváření časových os
Autoři	Erik Zachte
MediaWiki	>= 1.47.0
Změny v databázi	Ne
Parametry $wgTimelineRsvgCommand $wgTimelineFontFile $wgTimelineFileBackend $wgTimelineFonts $wgTimelineFontDirectory $wgTimelinePloticusCommand $wgTimelinePerlCommand
Použité háčky (hooks) ParserFirstCallInit
Licence	GNU General Public License 2.0 pouze
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball CHANGELOG
Příklad	Viz níže
Přeložte rozšíření EasyTimeline
Problémy	Otevřené úkoly · Nahlásit chybu

Pomoc na Wikipedii:

de es eu fr id it nl pt zh

Rozšíření EasyTimeline generuje z wikitextu graf, který vkládá do stránky jako bitmapový obrázek. Může to být buď jednoduchá časová osa (vertikální či horizontální) nebo dvourozměrný graf.

Jak nainstalovat rozšíření EasyTimeline je popsané ve zdejší nápovědě. Nejprve si prostudujte ukázkové příklady na stránce o EasyTimeline a pak si je můžete zkusit na test.wikipedia.org

K syntaxi EasyTimeline je zde v dispozici samostatná stránka.

Existuje dlouhodobé úsilí získat rozšíření Chart , které toto rozšíření nahradí.

Příklady grafů

Zde je několik příkladů, které demonstrují co všechno je možné. Pro složitější grafy viz

• WW II – Pacific Theatre – horizontální
• Časová osa letadlových lodí námořnictva Spojených států – horizontální
• Historie výpočetní techniky – horizontální
• Tour-de-France Sieger – vertikální
• Vokální a instrumentální rozsahy výšek (pěkný příklad diagramu, který vůbec není časovou osou) – horizontální
• Kompletní časová osa modelů Macintosh – horizontální
• Jednodušší časové osy:
  • Šablona:Grafická časová osa událostí vyhynutí – horizontální, používá Šablona:Horizontální časová osa
  • :cs:Diskuse:Vynález_rádia/Archiv_1#Časová osa.2C_Hráči – horizontální s šipkami
  • Šablona:Ranný vývoj žárovky – vertikální
  • Vynález rádia#Časová osa vynálezu rádia – vertikální
  • Gaius_Marius#Časová osa – vertikální
  • User:Syed Atif Nazir/Šablona:Časová osa imáma – vertikální
  • Populační vývoj – horizontální

Příklady kódu

Související stránky: Rozšíření:EasyTimeline/syntax

Pro demonstraci intuitivní syntaxe kódu následuje ukázkový kód výše uvedeného grafu s přehledem funkčního období sovětských vůdců v čase.

<timeline>
# All measures are in pixels

ImageSize  = width:160 height:550
PlotArea   = left:50 right:0 bottom:10 top:10
AlignBars  = justify

DateFormat = yyyy
Period     = from:1917 till:1991
TimeAxis   = orientation:vertical
ScaleMajor = unit:year increment:5 start:1920

# there is no automatic collision detection,
# so shift texts up or down manually to avoid overlap

Define $dx = 25 # shift text to right side of bar

PlotData=
  bar:Leaders color:red width:25 mark:(line,white) align:left fontsize:S

  from:start till:1924 shift:($dx,15)   text:Vladimir~Ilyich~[[Special:MyLanguage/Lenin|Lenin]]
  from:1924  till:1953 shift:($dx,5)    text:[[Special:MyLanguage/Stalin|Josef~Stalin]]
  from:1953  till:1964 shift:($dx,5)    text:Nikita~[[Special:MyLanguage/Khrushchev|Khrushchev]]
  from:1964  till:1982 shift:($dx,5)    text:Leonid~[[Special:MyLanguage/Brezhnev|Brezhnev]]
  from:1982  till:1984 shift:($dx,-12)  text:Yuri~[[Special:MyLanguage/Andropov|Andropov]]
  from:1984  till:1985 shift:($dx,4)    text:Konstantin~[[Special:MyLanguage/Chernenko|Chernenko]] fontsize:XS
  from:1985  till:end  shift:($dx,10)   text:Mikhail~[[Special:MyLanguage/Gorbachev|Gorbachev]]
</timeline>

Dvojité a jednoduché závorky lze použít stejně jako na Wikipedii a možné jsou i jazykové prefixy, např. [[de:foo|more about foo]]. Podporovány jsou také jednoduché závorky pro externí odkazy.

Unicode

EasyTimeline nemá plnou podporu unicode.

Srpen 2004: Byla přidána minimální podpora UTF-8, což znamená, že EasyTimeline nyní rozpoznává znaky kódované v UTF-8. Podpora pro směrovost a složité skripty však velmi chybí. Výchozí písmo nemusí obsahovat glyfy pro všechny znaky. Alternativní písmo lze zadat pomocí $wgTimelineFontFile.

SVG na PNG

Pro správné zobrazení textů v jazycích psaných zprava doleva (jako je arabština, perština, hebrejština atd.) můžete použít ‎<timeline method="svg2png">kód časové osy zde‎</timeline> místo ‎<timeline>kódu časové osy zde‎</timeline>. Zobrazuje časovou osu ve formátu png s namapovanými odkazy.

Tipy

Pro začínající uživatele se EasyTimeline nemusí zdát vůbec tak jednoduché. Stejně jako u všech skriptovacích jazyků si na něj člověk musí zvyknout. Také popis syntaxe může být kvůli své velikosti trochu matoucí. Naštěstí je mnoho prvků skriptovacího jazyka volitelných.

'Easy' v EasyTimeline totiž neznamená, že je jednoduché časovou osu vytvořit, ale to, že je snadné obsah generovaného grafu upravit. Také je snadné tímto způsobem dělat překlady grafů pro jejich využití na jinojazyčné Wikipedii.

Tipy:

• Podívejte se na některé příklady grafů a najděte něco, co byste si mohli vybrat a upravit pro své vlastní věci
• Umístěte každou časovou osu na samostatnou stránku šablony: Usnadňuje to úpravy, urychluje zobrazení náhledu, je možné ji zahrnout na několik stránek

Použití aktuálního data

Pokud chcete pracovat s aktuálním datem, pak musíte použít místo tagu syntaxi podobnou parametrizované šabloně, kdy oblast s kódem bude začínat {{#tag:timeline| a uzavřou ji dvojité složené závorky }}. Poté lze pomocí kouzelných slov vložit aktuální datum. Například {{#time: d/m/Y }} nebo {{CURRENTDAY2}}/{{CURRENTMONTH2}}/{{CURRENTYEAR}} oba zobrazí datum ve formátu dd/mm/rrrr.

Související odkazy

• Syntaxe kódu pro EasyTimeline
• Prezentace o EasyTimeline z Wikimanie 2005 (abstrakt, prezentace, poznámky přednášejícího)
• Šablona:Jednoduchá horizontální časová osa Jednodušší časová osa k použití na Wikipedii.
• w:en:Template:Graphical timeline
• Extension:Chart

Instalace

== Požadavky ==

Toto rozšíření vyžaduje, aby byl na serveru nainstalován následující software:

• Ploticus
• perl
• NConvert (pouze Windows)

Instalace

Viz instalační pokyny.