Rozšíření:Proofread Page

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Proofread Page and the translation is 79% complete.
Other languages:
English • ‎español • ‎français • ‎čeština • ‎العربية • ‎नेपाली • ‎中文 • ‎日本語
Základní informace k tomuto rozšíření MediaWiki
OOjs UI icon advanced.svg
Proofread Page
Stav rozšíření: produkční
Proofread Page editor.png
Zavádí Page action , ContentHandler , Tag , API , Database
Popis The Proofread Page extension can render a book either as a column of OCR text beside a column of scanned images, or broken into its logical organization (such as chapters or poems) using transclusion.
Napsal(i) ThomasV (original author)
Tpt (current maintainer)
Aktuální verze continuous updates
Compatibility policy release branches
MediaWiki current master
PHP 7.0+
Změny v databázi dělá
Licence GNU General Public License 2.0 or later
Zdrojový kód
Download extension
Git [?]:
Příklad s:Index:Wind in the Willows (1913).djvu
Jmenný prostor Page, Index
Parametry
  • $wgProofreadPageNamespaceIds
  • $wgProofreadPagePageSeparator
  • $wgProofreadPagePageJoiner
  • $wgProofreadPagePageSeparatorPlaceholder
Přidaná práva
pagequality
Použité háčky (hooks)
Přeložte rozšíření Proofread Page, jsou-li dostupné jeho lokalizační zprávy na webu translatewiki.net
Podívejte se kdo a v jaké verzi toto rozšíření používá.
Issues Open tasks · Report a bug

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.[1]

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éž Manual:How to use DjVu with MediaWiki .
  • Kromě toho, se vám při použití ProofreadPage budou hodit i následující rozšíření:

Instalace

Rozšíření

  • Stáhněte soubor/y a vložte do adresáře pojmenovaného ProofreadPage ve vaší složce extensions/.
  • Na konec vašeho souboru LocalSettings.php přidejte řádek s následujícím kódem: 
    wfLoadExtension( 'ProofreadPage' );
  • Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
  • Yes Hotovo – Přejděte na stránku Special:Version vaší wiki, a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Pro ty co používají MediaWiki 1.24 a starší:

Výše uvedené instrukce se týkají instalace přes wfLoadExtension(), což je novější způsob instalace rozšíření. Pokud potřebujete toto rozšíření nainstalovat na starší verzi (MediaWiki 1.24 či starší), musíte místo wfLoadExtension( 'ProofreadPage' ); použít: 

require_once "$IP/extensions/ProofreadPage/ProofreadPage.php";

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:
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb.php?f=$1&p=$2&w=$3 [L,QSA]
  • 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.
    ErrorDocument 404 /w/extensions/upload-scripts/404.php
  • For MediaWiki >= 1.20, you can simply redirect to thumb_handler.php:
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^/w/images/thumb/[0-9a-f]/[0-9a-f][0-9a-f]/([^/]+)/page([0-9]+)-?([0-9]+)px-.*$ /w/thumb_handler.php [L,QSA]
  • Or in apache2.conf:
    ErrorDocument 404 /w/thumb_handler.php
Varování Varování: WARNING: There is an .htaccess file in the images directory that may interfere with any .htaccess rules you install.

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 ProofreadPage.namespaces.php. 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 LocalSettings.php , 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: 

define( 'NS_PROOFREAD_PAGE', 250);
define( 'NS_PROOFREAD_PAGE_TALK', 251);
define( 'NS_PROOFREAD_INDEX', 252);
define( 'NS_PROOFREAD_INDEX_TALK', 253);
$wgExtraNamespaces[NS_PROOFREAD_PAGE] = 'Page';
$wgExtraNamespaces[NS_PROOFREAD_PAGE_TALK] = 'Page_talk';
$wgExtraNamespaces[NS_PROOFREAD_INDEX] = 'Index';
$wgExtraNamespaces[NS_PROOFREAD_INDEX_TALK] = 'Index_talk';
$wgProofreadPageNamespaceIds = array(
    'index' => NS_PROOFREAD_INDEX,
    'page' => NS_PROOFREAD_PAGE
);

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

Nastavení jmenného prostoru index

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: 

{
  "ID": { //id of the metadata (first parameter of proofreadpage_index_attributes)
    "type": "string", //the property type (for compatibility reasons the values have not to be of this type). Possibles values: string, number, page. If set, the newly set values should be valid according to the type (e.g. for a number a valid number, for a page an existing wiki page...)
    "size": 1, //only for the type string : number of lines of the input (third parameter of proofreadpage_index_attributes)
    "values":  {"a":"A", "b":"B","c":"C", "d":"D"}, //an array values : label that list the possible values (for compatibility reasons the stored values have not to be one of these)
    "default": "", //the default value
    "header": false, //add the property to Mediawiki:Proofreadpage_header_template template (true is equivalent to being listed in proofreadpage_js_attributes)
    "label": "ID", //the label in the form (second parameter of proofreadpage_index_attributes)
    "help": "", //a short help text
    "delimiter": [], //list of delimiters between two part of values. By example ["; ", " and "] for strings like "J. M. Dent; E. P. Dutton and A. D. Robert"
    "data": "" //proofreadpage's metadata type that the property is equivalent to
  }
}

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é wgProofreadPagePageSeparator. Ve výchozím stavu obsahuje   (mezera). Chcete-li ho zcela potlačit, nastavte wgProofreadPagePageSeparator = "".

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é wgProofreadPagePageJoiner, ve výchozím stavu je to '-' (pomlčka -).

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 podle toho jak píše Manual:How to use DjVu with MediaWiki .
  • (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 Page:Carroll - Alice's Adventures in Wonderland.djvu.
  • 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 true).
  • Pro vložený soubor vytvořte indexovou stránku Index:Carroll - Alice's Adventures in Wonderland.djvu
    • Do vstupního pole Stránky vložte tag <pagelist />, 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: <pages>, <pagelist>

Poznámky

  1. ↑ Protože stránky nejsou umístěny v hlavním jmenném prostoru, nemohou být zahrnuty do celkové součtu, ve statistice zpracovaných textových jednotek.

Viz též

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:Proofread_Page/cs&oldid=3197705"