30.10.2024 – Pavel Klavík, Kamila Klavíková
V OrgPadu teď můžete dokumenty exportovat a importovat v různých formátech. Možnost exportu naleznete v postranním menu a lze ji provést ve třech formátech: interní formát OrgPadu jako EDN, JSON Canvas a lineární HTML export spolu se všemi obrázky a nahranými soubory. Import je podporovaný z formátů EDN, JSON Canvas a LucidChart.
#vylepšení, #změny, #export, #OrgPad
Naše práce je vytvářet OrgPad jako nástroj pro práci se strukturovanými daty ve formě diagramů. I když jsou data uložena v OrgPad cloudu, vždy platilo a vždy bude platit, že veškerá data patří našim zákazníkům. Naše práce je se o ně dobře starat, vytvářet pravidelné zálohy a vylepšovat nástroj OrgPad. Proto také je OrgPad placenou službou: nevyděláváme prodejem Vašich dat a zobrazováním otravné reklamy.
Abyste mohli se svými daty lépe nakládat, přidali jsme možnosti exportu OrgStránek. Tuto volbu naleznete v postraním menu pod Exportovat OrgStránku. Zobrazí se dialog, v kterém lze OrgStránku stáhnout ve třech exportních formátech.
Import lze provádět v seznamu dokumentů. V postraním menu stačí zvolit Import. Zobrazí se dialog, ve kterém nahrajete soubor a vytvoří se vám z něj OrgStránka. Podporované jsou v tuto chvíli tři formáty. Při prvním otevření importovaného dokumentu se automaticky vylepší rozmístěných buněk a spojů, aby sedělo pro spočítané velikosti.
Pokud máte data, které byste chtěli do OrgPadu importovat, v nějakých dalších formátech, dejte nám vědět. Ideálně nám i pošlete nějaké ukázkové soubory v tomto formátu. A pokud byste chtěli importovat rozsáhlejší kolekci dokumentů, kontaktuje nás na support@orgpad.info, budeme Vám s tím schopni pomoci.
OrgPad interně pracuje ve formátu EDN, což je stromový formát dat podobný JSONu a používaný v programovacích jazycích Clojure a ClojureScript, ve kterých je OrgPad vytvořený.
Při kliknutí na export se Vám stáhne buď EDN soubor s příponou .orgpage, nebo .zip soubor obsahující tento EDN soubor a všechny nahrané obrázky a soubory. Tento formát lze také zpět do OrgPadu importovat.
Základní struktura je, že OrgStránka je popsána jako mapa, která má klíče :orgpage/units (vektor buněk) a :orgpage/links (vektor spojů). Další klíče popisují id dokumentu, název, popis, štítky, vytvořené prezentace, atd. Všechna id jsou náhodně vygenerovaná UUIDv4.
V OrgStránce jsou dva typy units, zvolených v :unit/type. Knihy (typ :unit/book) jsou jednotlivé buňky, mají svoje nadpisy, barvy, pozice. Každá kniha sestává ze sekvence stránek (typ :unit/page) v :unit/child-unit-ids, vždy alespoň z jedné. Jednotlivé stránky mají svoje obsahy (:unit/content) jako sekvence HTML tagů ve formátu hiccup. Velikosti buněk nejsou nikde popsány, počítá si je přímo OrgPad při otevření dokumentů a závisí na konkrétním zařízení.
Spoj popisuje id propojených buněk v :link/endpoint-ids a vzhled v :link/props (barva, orientace, tloušťka).
(#:unit{:id #uuid"70b50862-691a-4247-8cc5-208367b1420c",
:type :unit/page,
:content ([:p {} "There is some "
[:strong {} "bold text"]
" here and some "
[:span {:style {:background-color "rgb(254, 245, 166)"}}
"yellow text"]
"."]
[:p {}
[:strong {} "Pythagoras Theorem:"]
" "
[:math #:math{:id #uuid"32494cdd-c975-443d-a901-cbef5b980835"}]
"."]
[:p {}]
[:p {:style {:text-align "center"}}
[:img {:width "181",
:src "/img/CPiwCrUDJGCIkE0q6At-Vy",
:height "170"}]])}
#:unit{:id #uuid"aab522e0-6554-44dd-943e-58b1d84c3658",
:type :unit/book,
:pos [-250.23569992614486 -148.19423894003708],
:child-unit-ids [#uuid"05b53a7d-c8ef-4759-880b-a77a80e752e6"],
:props #:props{:title-size :props/h2, :color :color/blue},
:title "A cell with just a title"}
#:unit{:id #uuid"05b53a7d-c8ef-4759-880b-a77a80e752e6",
:type :unit/page}
#:unit{:id #uuid"e2ffd3c0-0274-41c1-bb9d-53d4b5586cef",
:type :unit/book,
:pos [322 -120.5],
:child-unit-ids [#uuid"70b50862-691a-4247-8cc5-208367b1420c"],
:props #:props{:title-size :props/h2, :color :color/red},
:title "A cell with title and content"})(#:link{:id #uuid"5f533d75-c7a0-485d-bbb4-485a6ffe7b9a",
:endpoint-ids [#uuid"aab522e0-6554-44dd-943e-58b1d84c3658"
#uuid"e2ffd3c0-0274-41c1-bb9d-53d4b5586cef"],
:props #:props{:arrowhead :props/single,
:color :color/orange,
:weight :props/strong}})Podrobnější detaily popíšeme někdy v budoucnu, až bude hotové API pro OrgPad. Nejjednodušší je si vytvořit export nějakého ukázkového dokumentu a přímo se podívat, jak je v EDNu reprezentovaný. V budoucnu plánujeme strukturu tohoto formátu trochu měnit, podle potřeb OrgPadu.
Tento formát je vytvořený pro potřeby programu Obsidian je popsán na webu https://jsoncanvas.org/. Podporuje ho řada nástrojů s nekonečným plátnem a OrgPad je nově jedním z nich.
Cílem formátu je zajistit, že data vytvořená v aplikacích s nekonečným plátnem budou snadno čitelná a použitelná i jiných programech. Dává uživatelům plnou kontrolu nad jejich daty a je navržen tak, aby se s ním jednoduše pracovalo. Soubory ve formátu JSON Canvas mají příponu .canvas.
OrgStránky lze exportovat v tomto formátu. Oproti OrgPadu je však v řadě ohledů omezený, například neumožňuje mít buňky s více stránkami. Proto jsou jednotlivé stránky umístěné v exportu za sebou v jedné buňce. Formát Markdown pro obsahy je také mnohem omezenější než hiccup. Výsledek si budete muset v cílové aplikaci podporující JSON Canvas trochu upravit, ale export je použitelný.
Také lze do OrgPadu importovat soubory JSON Canvas. Vytvoříte tím nový dokument, do kterého se také nahrají obrázky z externích zdrojů. Při prvním otevření se vylepší pozice buněk podle spočítaných velikostí.
Export v tomto formátu vygeneruje zip soubor, který obsahuje text celé OrgStránky po jednotlivých buňkách pod sebou. Pokud máte nadefinovanou prezentaci, použije se pořadí buněk podle této prezentace, jinak jsou uspořádány po řádcích zleva doprava. Tento zip soubor také obsahuje všechny nahrané obrázky, soubory a další použité obrázky (například ikony příloh). Zde si můžete stáhnout 
HTML export IT architektury OrgPadu.
Lze importovat soubory .vsdx programu Lucidchart v Microsoft Visio formátu. Externí obrázky se automaticky nahrají do OrgPadu. Při prvním otevření se vylepší pozice buněk. Tady je ukázkový import jedné školní práce.
OrgPad má výbornou podporu pro schránku, čímž lze efektivně kopírovat data mezi OrgPadem a dalšími aplikacemi.
Pokud označíte buňky v OrgPadu a stiskněte CTRL+C (nebo CMD+C na MacOS), vloží se do schránky. Pokud chcete rychle označit všechny buňky v dokumentu, stačí stisknout CTRL+A (nebo CMD+A na MacOS). Ve schránce jsou data k dispozici ve třech formátech, takže záleží na cílové aplikaci:
Podobně do OrgPadu lze kopírovat formátovaný text z celé řady aplikací: Word, Google Docs, různě z webu, například Wikipedie. Narozdíl od jiných aplikací vám vložený text nerozbije formátování. Ponecháme totiž pouze základní formátování (tučný text, odkazy), ale odstraníme například barvu textu, pozadí, písmo, velikost, atd. Navíc například provádíme specifické čištění pro Wikipedii a další weby.
