Extension:Proofread Page/cs

Rozšíření Proofread Page (Rozšíření: Stránka korektury) generuje stránku knihy buď jako:


 * 1) dva sloupce, kdy se na jedné straně zobrazuje textový obsah, pokud bylo aplikováno OCR, a vedle něj obrázek naskenovaného originálu nebo
 * 2) zalomenou do kapitol či lépe bloků, přičemž  textový obsah na stránce MediaWiki je zalomen pod obrázkem dokumentu (přes transkluzi - zahrnutí části nebo celého elektronického dokumentu do jednoho nebo více dalších dokumentů pomocí hypertextového odkazu).

Rozšíření je navrženo tak, aby umožnilo snadné porovnání textu s digitalizovaným originálem.

Textový obsah dokáže zobrazit několika různými způsoby, aniž by při tom docházelo k jeho duplikování.

Použití
Toto rozšíření je nainstalováno na všechny wikiny Wikisource. O syntaxi se více dozvíte na stránce $1. Bylo také použito na Bibliowiki.



Co potřebujete a co je doporučeno

 * Přístup k příkazovému řádku je vyžadován, pokud selže spuštění aktualizačního skriptu (maintenance/update.php) z webového prohlížeče (dokumentace zde a zde).
 * Pokud chcete používat dokumenty v DjVu formátu (volitelný a doporučený)(otevřený souborový formát vyvinutý pro ukládání naskenovaných dokumentů), stačí v nastavení povolit, aby se používal nativní (v nezměněném stavu) DjVu handler (speciální systémový software pro obsluhu událostí). Viz též.
 * Kromě toho, se vám při použití ProofreadPage budou hodit i následující rozšíření:
 * (silně doporučeno)
 * (výchozí patička stránek obsahuje tag
 * (může vyžadovat doinstalování dalších balíčků, které rozšíří možnosti PHP) — přidává podporu pro PDF
 * (povoluje CSS specifické pro index)
 * (umožňuje korekturu Lua library)
 * (povoluje CSS specifické pro index)
 * (umožňuje korekturu Lua library)
 * (umožňuje korekturu Lua library)

Generování náhledů
Rozšíření odkazuje přímo na miniatury obrázků, které často neexistují. Musíte zachytit chybu 404 a vygenerovat chybějící miniatury. Můžete to udělat pomocí některého z těchto řešení:


 * Nastavte Apache RewriteRule v .htaccess na pro chybějící miniatury:
 * nebo nastavte popisovač Apache 404 na thumb-handler na Wikimedii. Toto je obecný obslužný program 404 s kódem specifickým pro Wikimedii, ne generátor miniatur.
 * U MediaWiki >= 1,20 můžete jednoduše přesměrovat na thumb_handler.php:
 * nebo na apache2.conf:
 * U MediaWiki >= 1,20 můžete jednoduše přesměrovat na thumb_handler.php:
 * nebo na apache2.conf:
 * nebo na apache2.conf:

Pokud narazíte na problém podobný následujícímu:


 * T301291 – Soubory PDF a DjVu na Commons se nepodařilo zpracovat (žádné miniatury, nula stránek), ale jinak platné
 * T298417 – Neodstraněné soubory DjVu zobrazují nesprávná metadata: Velikost 0x0, žádné informace o čísle stránky
 * T299521 – Soubor PDF má v Commons velikost obrázku 0x0 po nahrání nové verze, když je číslo stránky správné

Zkuste následující kroky:

 oprava miniatur pro soubory DjVu jádra MediaWiki (pro PDF použijte mimetype )



potřebné pro aktualizaci informací o počtu stránek z

 

Jmenné prostory
ProofreadPage zakládá při instalaci dva uživatelsky definované jmenné prostory, v angličtině pojmenované "Page" a "Index", které mají id 250 a 252.

Pokud vaše wiki používá jako výchozí jiný jazyk než angličtinu, budou jejich názvy přeložené. .

Názvy těchto jmenných prostorů i jejich ID můžete změnit: Vytvořte si vlastní jmenné prostory v konfiguračním souboru a nastavte jim ID, jaké vám vyhovuje, přes globání proměnnou $wgProofreadPageNamespaceIds. Váš kód v konfiguraci pak bude vypadat asi takto:

Vezměte ale na vědomí fakt, že si s tím můžete do budoucna komplikovat situaci, protože nelze vyloučit, že se metoda pro zakládání vlastních jmenných prostorů změní.

Konfigurace

 * Aby bylo možné použít systém kvality stránky, je nutné vytvořit pět kategorií. Názvy těchto kategorií musí být definovány v MediaWiki:Proofreadpage_quality0_category a MediaWiki:Proofreadpage_quality4_category.
 * Ujistěte se, že máte nainstalováno.



Nastavení jmenného prostoru index
Další podrobnosti najdete na stránce 
 * Aby se vám vygenerovala indexová stránka, musíte nejprve vytvořit stránku MediaWiki:Proofreadpage_index_template. Tato stránka je ve své podstatě šablona, jejíž parametry vyplňujete prostřednictvím editačního formuláře.
 * Nastavení jednotlivých položek formuláře se provádí přes stránku MediaWiki:Proofreadpage_index_data_config.json, kterou musíte vytvořit. Nastavení této stránky přepisuje obsah stránek MediaWiki:Proofreadpage_index_attributes a MediaWiki:Proofreadpage_js_attributes, přes které se nastavení dělalo dříve.

Konfigurace je ve formátu JSON. Takto vypadá struktura pro jedno formulářové pole a jeho výchozí parametry. Pokud některý vynecháte, použije se výchozí hodnota:

Parametr data může obsahovat některou z následujících hodnot: "type", "language", "title", "author", "translator", "illustrator", "editor", "school", "year", "publisher", "place", "progress"



Oddělovač stránek
Rozšíření vkládá mezi transkludované (automatické vkládání obsahu do stránky s využitím dvojitých složených závorek " – ") stránky oddělovač, který je uložen v proměnné. Ve výchozím stavu obsahuje  (mezera). Chcete-li jej zcela potlačit, nastavte.



Spojení slov rozdělených mezi stránky
Přechází-li slovo rozdělené pomlčkou na další stránku, budou obě části spojeny do jednoho slova. Konkrétně: z "hi-" a "storie" bude "historie". Jako "spojovník" je interpretován znak uložený v proměnné, ve výchozím stavu je to '-' (znak ASCII spojovník).



Konfigurace změnových značek (volitelné)
Pokud chcete nastavit značky pro změnu, podívejte se na změny označení (change tagging).

Použití


Vytvoření první stránky (pro DjVu soubor)

 * Předtím, než budete pokračovat, zkontrolujte, jestli máte vaši konfiguraci nastavenou jak uvádí.
 * (kdy a v jakém jmenném prostoru je samotný soubor DjVu nahrán?)
 * Pokračujte založením stránky ve jmenném prostoru "Page" (jeho název se může pochopitelně lišit, pokud používáte jinou wiki než anglickou a máte intenacionalizované názvy jmenných prostorů). Pokud se váš jmenný prostor jmenuje 'Page', tak založte stránku.
 * Poté si do wiki nainstalujte soubor odpovídající této stránce commons:File:Carroll - Alice's Adventures in Wonderland.djvu (nebo si nastavte proměnnou na  ).
 * Pro vložený soubor vytvořte indexovou stránku.
 * Do vstupního pole Pages (stránky) vložte tag, aby se vám vygeneroval seznam odkazů na stránky.
 * Kliknete-li na číslo 5, které vede na stranu 'Page:Carroll - Alice's Adventures in Wonderland/5' a můžete začít stránku editovat.

Syntaxe
Toto rozšíření zavádí následující tagy: ,

Poznámky
submodul meta
 * — Vlastnosti jednotlivých stránek související s korekturou
 * — Přístup k datům indexových stránek (pole a kategorie)
 * — Seznam stránek v daném indexu
 * — Umožňuje použít Proofread Page i na soubory v PDF formátu
 * Aktuální úplný popis a pokyny (v angličtině) najdete na: s:Help:Proofread
 * Statistiky pro Wikisource najdete zde: https://phetools.toolforge.org/statistics.php 
 * Seznam úkolů a seznam požadavků na funkce z komunity
 * Uživatelská příručka ve pro veřejnou doménu:
 * MediaWiki:OCR.js - skript OCR
 * MediaWiki:OCR.js - skript OCR