Úvod do Haroopadu

V jednom z našich predchádzajúcich blogových článkov sme vám už predstavili Markdown - ľahko napísateľný, šikovný a veľmi flexibilný jazyk popisu dokumentu. Markdown umožňuje generovať dokumenty HTML a udržiavať technickú dokumentáciu, články v blogoch a prezentácie. Ďalej sme hovorili o písaní dokumentov Markdown pomocou textových editorov PileMD a EME. V tomto článku sa zameriavame na Haroopad, ktorý sa vyhlasuje za ďalšieho spracovateľa dokumentov pre jazyk Markdown s licenciou GPLv3.Ako dlhoroční autori sme jasne zistili, ktoré nástroje nám pomáhajú pri vytváraní textových dokumentov najproduktívnejším spôsobom - buď pomocou príkazového riadku, alebo pomocou grafického používateľského rozhrania (GUI). Napríklad Pandoc, Asciidoc a Asciidoctor sú nástroje príkazového riadku na transformáciu dokumentov Markdown na súbory HTML, zatiaľ čo PileMd, Vim-gtk, Atom a Haroopad namiesto toho používajú prístup založený na grafickom používateľskom rozhraní. Obrázok 1 ukazuje, ako vyzerá Haroopad - prístup s dvoma panelmi so zdrojovým kódom dokumentu vľavo a dokumentom preloženým do HTML na pravej strane.

postava 1

Inštalácia a nastavenie

Cieľom Haroopad je poskytnúť vám rovnaké skúsenosti s úpravami bez ohľadu na platformu, na ktorej pracujete. Haroopad, ktorý vyvinul kórejský programátor Rhio Kim, je k dispozícii na webových stránkach projektu pre Microsoft Windows, Mac OS X a Linux ako binárne balíčky pre 32 a 64 bitové systémy. V tomto článku sme testovali balík pre Debian GNU / Linux 9 (64 bitový) a stiahli sme si zodpovedajúci balík deb.

Ak chcete nainštalovať balík Haroopad na svoj počítač, použite nasledujúci príkaz (ako užívateľ root alebo prostredníctvom príkazu sudo):

$ dpkg -i haroopad-v0.13.1-x64.deb

V našom testovacom prostredí chýbal iba jeden softvérový balík - konfiguračná knižnica GNOME s názvom libgconf-2-4. Na inštaláciu chýbajúceho balíka použite buď apt, apt-get alebo aptitude:

$ apt-get nainštalovať libgconf-2-4

Samotný Haroopad je založený na NodeJS / webkit a je plne zdokumentovaný online. Binárny balík Haroopad neobsahuje manuálnu stránku ani možnosti pomoci Haroopad, pretože sú bežné pre programy UNIX / Linux, ako je napríklad -help. Ak si chcete pozrieť zdrojový kód aj dokumentáciu, musíte si tiež stiahnuť zodpovedajúci balík z GitHubu.

Po dokončení inštalácie môžete Haroopad spustiť príslušným výberom položky v časti Vývoj v ponuke softvéru na pracovnej ploche systému Linux alebo pomocou nasledujúceho príkazu v termináli:

$ haroopad

Podobne ako na obrázku 1 sa otvorí okno Haroopad, ktoré vám umožní okamžite upraviť nový dokument. Ako už bolo vysvetlené vyššie, ľavý panel obsahuje editačné okno (zdrojový kód dokumentu Markdown) a pravý panel obsahuje jeho preklad, ktorý je synchronizovaný so zdrojovým kódom dokumentu, akonáhle ho zmeníte. Nad panelmi nájdete ponuku s bežnými položkami na otváranie a zatváranie súborov, vyhľadávanie textu podľa vzoru, vkladanie konkrétnych prvkov Markdown a úpravu spôsobu, akým vyzerá grafické rozhranie Haroopad.

Spodný riadok okna Haroopad (pozri obrázok 2) obsahuje niekoľko položiek, ktoré sa pohybujú od pomocného okna po štatistické informácie, tlačidlá darovania, priame publikovanie na rôznych kanáloch sociálnych médií a možnosti zobrazenia. Tlačidlo medzery umožňuje upraviť šírku karty v okne editora a tlačidlo stĺpca prepína medzi spôsobom, akým sa text zobrazuje vo výstupnom dokumente - ako jeden, dvojitý alebo tri stĺpce. Koliesko na pravom konci umožňuje prepínať medzi normálnym a zobrazením na celú obrazovku.

Obrázok 2

Export dokumentov

Keď skončíte s dokumentom, Haroopad ponúkne jeho uloženie v rôznych formátoch, ako je e-mail, ako surový HTML a HTML v kombinácii s CSS. Aktuálnu verziu sa nepodarilo exportovať, ale položka ponuky „Súbor“ -> „Uložiť ako“ fungovala a vytvorila stránku HTML / CSS (pozri obrázok 3).

obrázok 3

Skúsenosti z Haroopadu

Čo sa nám na Haroopade páči, je to, že jeho zložitosť je k dispozícii vo veľmi jednoduchom používateľskom rozhraní v kombinácii s prístupom Čo vidíš je to, čo dostaneš (WYSIWYG). Písanie Markdown je v každom prípade ľahké, ale Haroopad to ešte viac zjednodušuje. Patrí sem automatické dopĺňanie zoznamov, ako aj preddefinované textové moduly pre vložený kód, zvýraznenie textu, odkazy a blokové úvodzovky. Existuje tiež podpora pre niekoľko dialektov Markdown, ktoré sa používajú napríklad v GitHub. Ak je to potrebné, môžete povoliť viazanie klávesov pre Vi / Vim. Obrázok 4 zobrazuje príslušné menu Vložiť.

Obrázok 4

Haroopad je veľmi prispôsobiteľný, čo sa týka tém pre grafické používateľské rozhranie, ako aj všeobecného rozloženia, veľkosti písma, odsadenia textu a automatických opráv, ak je to potrebné. Obrázok 5 zobrazuje dialógové okno predvolieb. Zoznam dostupných tém môžete rozšíriť pridaním vlastných rozložení založených na CSS.

Obrázok 5

Haroopad je možné použiť aj na vedecké dokumenty. Pomocou nástroja JavaScript MathJax je možné exportovať matematické rovnice do prehliadača. Podporovaný je aj výstup LaTeX.

Nevýhodou Haroopadu je, že niektoré časti softvérového balíka potrebujú ďalšie vylepšenia a že oficiálna dokumentácia je v kórejčine. Pre nekórejských hovorcov môže byť teda trochu ťažké sa v Haroopade zorientovať. Preklad do angličtiny je krok za krokom hotový.

Predvolená téma je tiež dosť tmavá a trochu komplikuje čítanie zdrojového kódu dokumentu. Alternatívou môže byť ľahšia téma, ktorá zlepší použiteľnosť.

Záver

Haroopad vám veľmi zjednodušuje život. Je dosť stabilný a jeho použitie je zábavné. Haroopad je pre dané platformy neustále vo vývoji. Je to silný konkurent spoločností Atom, Remarkable a ReText. Sme nadšení, keď vidíme, ako rastie. Výborne!

Poďakovanie

Autor sa chce poďakovať Mandy Neumeyerovej za podporu pri príprave tohto článku.