Extension:Proofread Page/cs

Rozšíření Proofread Page 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,
 * 2) nebo zalomený do kapitol či lépe bloků, přičemž  textový obsah na stránce MediaWiki je zalomen pod obrázkem dokumentu (transkluze).

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

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

Použití
Toto rozšíření je nainstalováno na všechny wiki Wikisource. O syntaxi se více dozvíte na s:mul:Wikisource:ProofreadPage. Používá se i na Bibliowiki.

Co potřebujete a co je doporučeno

 * Pokud selže aktualizační skript (maintenance/update.php), který se spouští přes webový prohlížeč, potřebujete přístup k příkazové řádce (Viz dokumentace zde a zde).
 * Pokud chcete používat dokumenty v DjVu formátu (volitelný a doporučený), stačí v nastavení povolit, aby se používal nativní DjVu handler. 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
 * (může vyžadovat doinstalování dalších balíčků, které rozšíří možnosti PHP) — přidává podporu pro PDF

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 thumb.php pro chybějící miniatury:
 * nebo nastavte popisovač Apache 404 na thumb-handler na Wikimedia. Toto je obecný obslužný program 404 s kódem specifickým pro Wikimedia, 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:

Jmenné prostory
ProofreadPage si 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 lokalizované. Jak, to zjistíte v souboru. V odkazech ale můžete dál s klidem používat jejich výchozí anglické názvy.

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 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án

Nastavení jmenného prostoru index

 * 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 dělá přes stránku MediaWiki:Proofreadpage_index_data_config, kterou musíte vytvořit. Nastavení této stránky přebíjí obsah stránek MediaWiki:Proofreadpage_index_attributes a MediaWiki:Proofreadpage_js_attributes, přes které se to 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é stránky oddělovač, který je uložen v proměnné. Ve výchozím stavu obsahuje  (mezera). Chcete-li ho 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 '-' (pomlčka  &#45;).

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

 * Předtím, než budete pokračovat zkontrolujte, jestli máte vaši konfiguraci nastavenou podle toho jak píše.
 * (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 wiki co není v angličtině, a máte intenacionalizované názvy jmenných prostorů). Pokud se váš jmenný prostor jmenuje 'Page', tak založte stránku.
 * Pak si do wiki nahrejte 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 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' můžete začít stránku editovat.

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

Související odkazy

 * — umožňuje použít Proofread Page i na soubory v PDF formátu
 * Kompletní popis a popis (v angličtině) můžete najít na: s:Help:Proofread
 * Statistiky pro Wikisource najdete zde: ~phe/statistics.php
 * ToDo and feature request list from the Community
 * A public-domain user manual is being written at:
 * MediaWiki:OCR.js - the OCR script
 * A public-domain user manual is being written at:
 * MediaWiki:OCR.js - the OCR script