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.43
Změny v databázi	Ne
Licence	GNU General Public License pouze 2.0
Stáhnout	Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (Phabricator · GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu CHANGELOG
Příklad	Viz níže
Parametry $wgTimelineRsvgCommand $wgTimelineFontFile $wgTimelineFileBackend $wgTimelineFonts $wgTimelineFontDirectory $wgTimelinePloticusCommand $wgTimelinePerlCommand
Použité háčky (hooks) ParserFirstCallInit
Veřejné wiki používající rozšíření	7,989 (Ranked 20th)
Přeložte rozšíření EasyTimeline
Problémy	Otevřené úkoly · Nahlásit chybu

Další jazyky:

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
  • :en:Talk:Invention_of_radio/Archive_1#Timeline.2C_Players - vodorovně se š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: Extension: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é hranaté závorky lze normálně použít, včetně jazykového prefixu, např. [[de:foo|více o foo v němčině]]. Externí odkazy, uzavřené do jednoduchých hranatých závorek lze rovněž použít.

Unicode

EasyTimeline nemá plnou podporu unicode.

Srpen 2004: Byla přidaná alespoň minimální podpora UTF-8, což znamená že EasyTimeline umí rozeznat znaky v UTF-8. Ale podpora směru toku textu a komplexních znaků je velmi špatná. Výchozí font totiž neobsahuje všechna písmena. Ale prostřednictvím proměnné $wgTimelineFontFile se dá nastavit jiný font.

SVG na PNG

Aby se zobrazovaly texty v RTL jazycích (psaných zprava doleva, jako je Arabština, Perština, Hebrejština,…) správně, můžete využít svg2png. Stačí když uvedete ‎<timeline method="svg2png">…‎</timeline> místo ‎<timeline>…‎</timeline>. Graf se vygeneruje jako SVG obrázek, který se následně převede do PNG, takže RTL texty budou zobrazeny správně, ale bohužel nebudou aktivní linky.

Tipy

Zpočátku se může zdát použití EasyTimeline složité, ale je to pouze otázka zvyku. Orientace může být komplikovaná obzvláště u rozsáhlejších grafů. Naštěstí je mnoho prvků syntaxe nepovinných a lze používat i komentáře.

'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.
• Extension:Chart /(Extension:Graph )

Instalace

== Požadavky ==

This extension requires the following software to be installed on the server:

• Ploticus
• perl
• NConvert (pouze Windows)

Installation

See the installation instructions.