Widget:Video/doc

Toto je dokumentace k widgetu Widget:Video.

Vedle návodu k použití obsahuje kategorie, odkazy interwiki a další obsah, který není součástí kódu widgetu.

Tento widget umožňuje vkládat do wiki stránek audio a video sekvence, včetně titulků. Soubory mohou být uloženy na libovolné veřejně dostupné URL serveru TheWoodcraft.org, ale technicky je možné přehrávat i soubory z jiného veřejně dostupného serveru.

Widget:Video umožňuje přeskočit na konkrétní čas a přehrát pouze vybraný úsek. Není tedy nutné vybraný úsek ukládat jako samostatný soubor a zbytečně duplikovat data.

AUDIO soubory

Soubory se zvukem, ve formátu .mp3, lze nahrávat přímo do úložiště wiki – tak jako obrázky či DjVu dokumenty.

VIDEO soubory

Videosoubory ve formátu .mp4 mají vyhrazen adresář /pub/wiki/video.

Titulky a soubory kapitol

Se ukládají do stejného adresáře jako video soubory. Widget počítá s formátem .vtt, a pojmenování by mělo dodržovat následující úzus:

• <title>.<lancode>.vtt (titulky)
• <title>.chapters.<lancode>.vtt (kapitoly)

Widget využívá následující soubory:

• video.min.js zdroj verze 5.17.0 z 7.2.2017
• video-js.css
• videojs-offset.js zdroj commit fb55794 z 28.4.2017

Použití

Základní atributy

title

Tento atribut by neměl chybět, pokud se má na jedné stránce použít Widget:Video ve více instancích. Hodnota by tedy měla být pokud možno unikátní.

url

URL k audio či video souboru

audio

Je atributem speciálně vyhrazeným pro AUDIO soubory. Bez jeho použití, by se použila standarní velikost okna přehrávače 320x240 pixelů. Jeho použití má dvojí efekt.

• Jednak lze změnit podporu výchozí typu audio souboru 'mp3' na jiný,
• a přenastaví výchozí hodnotu atributů pro velikost okna přehrávače na 0 pixelů.

fluid

Je volitelný atribut, kterým lze určit jakým způsobem se bude okno přehrávače vložené do stránky chovat.

true přizpůsobí okno rozměrům nadřazeného elementu.

false nastaví fixní velikost okna podle následujících atributů:

width

Šířka okna přehrávače v pixelech. U audio souborů, pokud chceme mít během přehrávání viditelnou kontrolní lištu, je doporučená hodnota 200 (audio default 0, video 320).

height

Výška okna přehrávače v pixelech (audio default 0, video 320). (audio default 0, video 240 pixelů).

Atributy pro volbu sekvence

begin

(default 0) Udává začátek přehrávané sekvence v sekundách.

end

(default 20) Udává konec přehrávané sekvence v sekundách, od začátku souboru(!)

Atributy pro titulky a kapitoly

Přehrávané soubory mohou být doplněny o titulky. Widget:Video je napsaný tak, aby ho bylo možné efektivně použít s multijazyčnou wiki TheWoodcraft.org.

subtitles

cesta k titulkům (vtt soubory) soubor s kapitolami má navíc suffix .chapters, před jazykovám kódem

lang

(default 'en') kódu pro volbu jazyka titulků

Description

Název jazyka titulků odpovídajících použitému jazykovému kódu (default 'Subtitles')

V případě audiosouborů je třeba přenastavit u okna přehrávače atribut height, aby byly titulky viditelné.

Delší multimediální soubory mohou používat také soubory, ve kterých jsou nastaveny kapitoly. Ty umožňují přeskakovat v rámci jednoho souboru na různé úseky.

Chapters

Titulek pro kapitoly (default 'Chapters')

Základní rozdíl mezi přehráváním souboru s využitím kapitol a přehráváním vybrané sekvence je především v množství přenášených dat.

Přehrávání audio souboru

Ukázkový příklad aplikace na přehrání Audio souboru v mp3 formátu. Pro přehrání klikněte na tlačítko zobrazené napravo:

{{block
  |10
  |right
  | {{#widget:Video
      | title = Pětkohrad
      | url = https://www.thewoodcraft.org/pub/keny/petkohrad.mp3
      | audio = mp3
      | width = 200
      | height = 0
    }}
}}

Přehrávání videa

Takto vypadá kód pro vložení videa:

{{block
  |60
  |center
  | {{center
      | {{#widget:Video
          | url = /pub/hornilouka/videa/manual_2020-04-23.mp4
          | width = 300
          | height = 240
        }}
    }}
}}

Obvykle se vkládá kód v koncentrovanější formě, v ukázkových přékladech použití byl pro lepší přehlednost odsazen mezerami:

{{block|60|center|{{center|{{#widget:Video|url=manual_2020-04-23.mp4|width=300|height=240}}}}}}