Z Wikiknih

Obsah 1 Název 2 Použití 3 Popis 4 Volby 5 Příklady 5.1 Zjištění velikosti stránky 5.2 Vytažení neviditelné textové vrstvy 5.3 Vytažení anotací 5.4 Záloha/obnova textové vrstvy 5.5 Vytažení djvu stránky 5.6 Vytvoření náhledů 6 Příkazy pro djvused 6.1 Příkazy pro výběry 6.2 Různé příkazy 6.3 Příkazy pro práci s textem a poznámkami 6.4 Příkazy pro práci se záložkami 6.5 Příkazy pro práci s náhledy 6.6 Příkazy pro uložení 7 Syntaxe pro DjVu soubory 8 Omezení

[editovat] Název

djvused - Víceúčelový editor DjVu dokumentů

[editovat] Použití

djvused [volby] djvusoubor

[editovat] Popis

Aplikace djvused je silný konzolový nástroj pro práci s obsahem vícestránkových djvu dokumentů. Lze jej použít pro psaní či úpravu poznámek, skryté textové vrstvy, přípravu náhledů stránek, atd. Funguje tak, že nejprve načte djvu soubor a pak postupně vykonává předávané příkazy.

Tyto příkazy lze předat načtením ze souboru s odpovídající syntaxí (je-li takový soubor pomocí parametru -f určen), přímo z příkazové řádky (skrze parametr -e) nebo je zadávat interaktivně.

[editovat] Volby

-v

Volba způsobí že djvused vypisuje při zpracování podrobnou zprávu o tom co který příkaz dělá. Tato volba je zvláště užitečná pro debugování skriptů pro djvused, ale také při interaktivním zadávání příkazů pro djvused přímo na standardním vstupu.

-f /cesta/k/souboru_se_skriptem

Příkazy jsou načteny ze souboru s odpovídající syntaxí příkazů

-e 'sada příkazů'

Tato volba zajistí předání odpovídající sady příkazů přímo z příkazové řádky, není tedy nutné je mít uvedeny přímo v souboru se skriptem. Aby bylo zabráněno nežádoucí expanzi na příkazovém řádku, je třeba sadu příkazů uzavřít do jednoduchých uvozovek.

-s

Tato volba zajistí uložení změn po vykonání příslušných příkazů. Co do funkčnosti odpovídá volbě save při přímé editaci.

-n

Způsobí, že jsou editační příkazy prováděny "nasucho", bez toho aniž by došlo k jejich uložení. Tato volba je zvláště užitečná pro debugování skriptů pro djvused, bez toho aniž by docházelo k přepsání djvu souboru na disku.

[editovat] Příklady

Aplikaci djvused lze využívat mnoha způsoby, zde je několik příkladů jakým způsobem ji lze použít při zpracování djvu souborů.

[editovat] Zjištění velikosti stránky

Výstup z příkazu size vrací šířku a výšku zvolené stránky v pixelech. Příklad demonstruje vytažení rozměrů 3 strany z dokumentu soubor.djvu. (Souhrnné informace o celém dokumentu lze získat příkazem djvudump)

user@stroj:~$ djvused soubor.djvu -e 'select 3; size' width=4960 height=7016

[editovat] Vytažení neviditelné textové vrstvy

Výstup příkazu print-pure-txt vrací čistě textový obsah skryté textové vrstvy DjVu dokumentu. Řádky a stránky jsou odděleny obvyklými kontrolními znaky.

user@stroj:~$ djvused soubor.djvu -e 'print-pure-txt'

Příkaz print-txt poskytuje podrobnější výstup, jehož syntaxe odpovídá syntaxi popsané na hlavní stránce DjVuLibre. Pro každý element jsou mimo textového obsahu uvedeny také jeho souřadnice vůči stránce. V příkladu lze vidět jak vytáhnout podrobnou strukturu textové vrstvy pro stránku 3.

user@stroj:~$ djvused soubor.djvu -e 'select 3; print-txt'

[editovat] Vytažení anotací

user@stroj:~$ djvused soubor.djvu -e 'select 1; print-ant'

[editovat] Záloha/obnova textové vrstvy

user@stroj:~$ djvused soubor.djvu -e 'output-all' > soubor.dsed

user@stroj:~$ djvused soubor.djvu -f soubor.dsed -s

[editovat] Vytažení djvu stránky

user@stroj:~$ djvused soubor.djvu -e 'select 5; save-page' p05.djvu

[editovat] Vytvoření náhledů

Náhledy, které se později mohou zobrazit ve čtečce DjVu souborů se vytváří pomocí příkazu set-thumbnails. Následující příklad vygeneruje náhledy o velikosti 64x64 pixelů pro všechny stránky souboru soubor.djvu

user@stroj:~$ djvused soubor.djvu -e 'set-thumbnails 64' -s

[editovat] Příkazy pro djvused

Při spouštění djvused se může (ale nemusí) předat jeden i více příkazů případně komentář. Jednotlivé příkazy musí být odděleny středníkem ;. Za komentář je považováno vše co začíná mřížkou # až do konce aktuálního řádku.

[editovat] Příkazy pro výběry

ls

select [ identifikátor_souboru ]

select-shared-ant

create-shared-ant

[editovat] Různé příkazy

help

n

dump

size

[editovat] Příkazy pro práci s textem a poznámkami

print-pure-txt

print-txt

remove-txt

set-txt [ soubor_s_dsed_skriptem ]

output-txt

print-ant

print-merged-ant

remove-ant

set-ant

output-ant

print-meta

set-meta [ soubor_s_dsed_skriptem_pro_metainformace ]

output-all

[editovat] Příkazy pro práci se záložkami

print-outline

set-outline

[editovat] Příkazy pro práci s náhledy

set-thumbnails velikost_v_pixlech

remove-thumbnails

[editovat] Příkazy pro uložení

save

save-bundled jméno_souboru

save-indirect jméno_souboru

save-page jméno_souboru

save-page-with jméno_souboru

[editovat] Syntaxe pro DjVu soubory

Použitelná u dsed skriptů.

[editovat] Omezení

Současná verze djvused umožňuje práci buď s jedinou vybranou stránkou v DjVu dokumentu, nebo s celým dokumentem. Nelze provádět výběry několika stran.