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ů
The extension links directly to image thumbnails which often don't exist. You must catch 404 errors and generate the missing thumbnails. You can do this with any one of these solutions:


 * Set an Apache RewriteRule in .htaccess to thumb.php for missing thumbnails:
 * or set the Apache 404 handler to Wikimedia's thumb-handler. This is a general-purpose 404 handler with Wikimedia-specific code, not simply a thumbnail generator.
 * For MediaWiki >= 1.20, you can simply redirect to thumb_handler.php:
 * Or in apache2.conf:
 * For MediaWiki >= 1.20, you can simply redirect to thumb_handler.php:
 * Or in apache2.conf:
 * Or in 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

 * In order to use the page quality system, it is necessary to create five categories. The names of these categories must be defined in Mediawiki:Proofreadpage_quality0_category to Mediawiki:Proofreadpage_quality4_category.
 * Ensure that you have installed

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.
 * (when and in which namespace is the djvu file itself uploaded?)
 * 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 Manual:$wgUseInstantCommons 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: ,

Viz též

 * — 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