Nápověda:Jak pracovat s knihami

Z thewoodcraft.org
Verze z 1. 8. 2024, 16:35, kterou vytvořil Keny (diskuse | příspěvky)
(rozdíl) ← Starší verze | zobrazit aktuální verzi (rozdíl) | Novější verze → (rozdíl)
Přehled nápovědy
Editace obsahu
Pro thewoodcraft.org
Knihy
Systém wiki
Zabezpečení stránek
Zásady

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.
PoznámkaDjVu 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.

Upozornění 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

PoznámkaProtož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.

Upozornění 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.