Nápověda:Jak pracovat s knihami

Přehled nápovědy
Nastavení práv pro mediawiki Registrace účtu a přihlášení
Editace obsahu
Nápověda:Jak editovat stránku Nápověda:Jak smazat stránku nebo soubor Nápověda:Kategorizace Nápověda:Jak psát správně odkazy Multijazyčné odkazy na stránky Nápověda:Jak kombinovat stránky Nápověda:Jak používat šablony Nápověda:Jak dokumentovat šablony Nápověda:Widgety Nápověda:Systémové proměnné a jejich použití Nápověda:Jazykové mutace stránek Nápověda:Jak pracovat s tabulkami Nápověda:Jak pracovat s obrázky Nápověda:Jak vkládat do wiki soubory Nápověda:Jak psát poznámky pod čarou Navigace pro související stránky
Pro thewoodcraft.org
Nápověda:Dynamicky generované stránky Nápověda:Rozcestníky a redirekty Nápověda:Webliografie článků
Knihy
Nápověda:Jak dělat správně korektury Nápověda:Jak pracovat s knihami Nápověda:Jak sestavit knihu
Systém wiki
Nápověda:Jmenné prostory a jejich význam Nápověda:Údržba a kontrola Nápověda:Navigační panel Nápověda:Komunikace mezi uživateli wiki
Zabezpečení stránek
Nápověda:Jak omezit přístup ke stránce Nápověda:Jak získat přístup do databáze
Zásady
Časté chyby Etiketa na wiki Jak používat diskuzi Autorská práva

Práci s elektronickými knihami je zde věnována návodná stránka Jak převádět text do elektronické formy, kde se dočtete:

• Jak založit indexovou stránku
• Jakým způsobem zakládat stránky a zpracovávat jejich textový obsah

Tato stránka je určena pro správce, a osoby oprávněné elektronické knihy zpracovávat.

K publikaci obsahu vícestránkových elektronických dokumentů se zde používá rozšíření ProofreadPage⁠, které umožňuje:

• vkládat do textu kotvy na které lze odkazovat
• doplnit originální obsah o další doplňující informace, odkazy atp.
• sestavit textový obsah knihy do singlepage stránky, na kterou lze aplikovat strojový překlad

Indexová stránka

Je výchozí stránka, která obsahuje základmí meta informace ke zpracovávanému souboru: Název knihy, jméno autora, rok vydání, atd. Její součástí je také informace o stavu zpracování (Progress) a odkazy na jednotlivé stránky (Pages)

Stránky

Stránky se nezakládají při založení indexové stránky (knihy) automaticky. Při založení indexové stránky se generují pouze odkazy, dané počtem stran v souboru, na zatím neexistující stránky.

Výchozí soubor (zdroj)

Je dokument, většinou ve formátu DjVu, i když je možné vkládat i vícestránkové soubory ve formátu PDF či TIFF.

DjVu je doporučený formát, protože se z něj mnohem efektivněji renderují náhledy stránek. PDF zde vkládáme jen ve výjimečných případech a to, pokud by konverze PDF dokumentu do DjVu formátu vedla k degradaci obrazové informace či zvýšení velikosti výchozího souboru.

Co se děje při založení stránky?

Při založení stránky dojde k vygenerování náhledu stránky, který pak bude dostupný přes záložku Soubor, v záhlaví stránky.

Extrakce textové vrstvy stránky se provede jen pokud taková vrstva existuje.

Zajímá vás, je-li možné dodatečně nahradit vygenerované náhledy stránek tím, že se místo té původní verze souboru nahraje nová, kvalitnější? Ano, pokud bude u kvalitněji zpracované verze zachován stejný počet stráněk. Pokud by se při novém zpracování počet stránek změnil, nebo se nějakým způsobem změní jejich pořadí, je potřeba již zpracované stránky dodatečně přesunout, tak aby jejich číslování odpovídalo aktualizované verzi.

U dodatečně aktualizovaného souboru, se provádí extrakce textového obsahu stránky pouze za předpokladu, že stránka dosud neexistuje. Tedy pokud stránka ještě nebyla založena, nebo pokud byla původní stránka odstraněna.

Indexová stránka z hlediska správce

Jedinou starostí uživatele při založení, nebo aktualizaci indexové stránky je to aby správně doplnil obsah zobrazeného formuláře. Formulář jako takový může upravit pouze administrátor

Jeho podobu může ovlivnit několika způsoby, které jsou zde popsány z hlediska priority při zpracování:

MediaWiki:Proofreadpage_index_data_config

Je preferovaná výchozí šablona formuláře pro indexovou stránku. Bohužel klíčovým problémem u šablony formuláře je lokalizace. Standardní lokalizační postupy zde totiž nefungují.

Rozšíření Proofreadpage zrovna v tomto případě bere vždy prioritně jazykovou verzi odpovídající výchozímu nastavení stránky.

Aktuální jazykové nastavení rozhraní se v tomto případě ignoruje. Není to zase taková tragédie, protože u šablony MediaWiki:Proofreadpage_index_template, která data z vyplněného formuláře zobrazuje, to lze obejít.

Formát stránky formuláře

Definice formuláře je v JSON formátu. Každá položka je definovaná kupř. takto:

"ID": {
   "type": "string",
   "size": 1,
   "default": "",
   "label": "ID file",
   "header": false,
   "data": "identificator"
},

type	{string|number|string/line|...|page|langcode|isbn|oclc|lccn|ark|arc}	Datový typ položky. V závislosti na zvoleném typu se pak bude zpracovávat obsah formulářového pole
size	číslo	Počet řádků formulářového pole. U většiny položek je uvedeno 1 (jeden řádek), pouze u typu string/line je číslo vyšší
default		Výchozí hodnota pole formuláře. Většinou to bývá prázdný řetězec, ale kupř. u nastavení jazyka může být předvyplněný výchozí kód jazyka. Také to může být výchozí hodnota (values) pro položku roletového menu.
label		Popis formulářového pole, který může být lokalizovaný, bohužel se však u formuláře v závislosti na jazykovém rozhraní dynamicky nemění.
header	{true|false}	U položek, které se mají zobrazovat pouze v případě, že pro ně existuje příslušná hodnota
data		Identifikátor formulářové položky
hidden	{true|false}	Volba, zda-li se položka, pokud nebude mít žádný obsah může skrýt
values	{ "A": "Popis A", "B": "Popis B" }	Nastavení položek roletového menu

Ukázkový kód, který by uživatelům k editaci zpřístupnil pouze typ publikace, její název a typ zdrojového souboru:

{
   "Type": {
       "type": "string",
       "size": 1,
       "default": "",
       "label": "Typ",
       "header": true,
       "values": {
           "book": "Kniha",
           "journal": "Časopis",
           "collection": "Sborník",
           "phdthesis": "Diplomová práce",
           "dictionary": "Slovník"
       },
       "help": "Typ publikace",
       "data": "type"
   },
   "Title": {
       "type": "page",
       "size": 1,
       "default": "",
       "label": "Název",
       "header": true,
       "data": "title"
   },
   "Source": {
       "type": "string",
       "size": 1,
       "default": "",
       "label": "Zdroj",
       "header": false,
       "values": {
           "": "other",
           "djvu": "djvu",
           "pdf": "pdf",
           "jpg": "jpg",
           "png": "png",
           "gif": "gif",
           "tif": "tif",
           "ogg": "ogg",
           "ogv": "ogv"
       }
   }
}

Pokud tato stránka ve jmenném prostoru MediaWiki neexistuje, hledá rozšíření v lokalizačních JSON souborech obsah proměnné Proofreadpage_index_data_config

Protože obsahem stránky je rovněž JSON, musí být v lokalizačním i18 souboru ošetřeny uvozovky pomocí zpětného lomítka

MediaWiki:Proofreadpage_index_template

Je komplexní šablona, která zobrazuje obsah vyplněného formuláře - rozhodující je pro ni ID příslušného datového pole. Pokud neexistuje (nebylo definováno) nezobrazuje obsah proměnné, ale proměnnou jakou řetězec.

U této šablony lze - na rozdíl od šablony formuláře - textový obsah popisu jednotlivých položek formuláře lokalizovat. Obsah nikoliv! Ten se řídí výchozím nastavením jazyka stránky.

Ne všechny položky z formuláře se musí zobrazit v této šabloně!

MediaWiki:Proofreadpage_index_attributes a MediaWiki:Proofreadpage_js_attributes

Pokud výše uvedená stránka MediaWiki:Proofreadpage_index_data_config neexistuje, a není nalezena ani odpovídající proměnná, použije rozšíření obsah stránek, přes které se indexový formulář konfiguroval dříve. Ovšem výsledek nemusí fungovat.