У овом чланку ћемо погледати конверзију између Маркдовн [1] и ДОЦКС - изворног формата докумената Мицрософт Ворд-а који се користи од 2007. Можда се питате зашто се ентузијаст Маркдовна и Асциидоца (попут мене) бави овим случајем. Па, сарадња са групом других писаца може довести до ситуације док један или више учесника захтева ДОЦКС као излазни формат. Немојте никога изневјерити и умјесто тога сазнајте која ограничења постоје и како можемо покушати усрећити све чланове групе.
Шта је Маркдовн?
Као што је већ истакнуто у „Уводу у Маркдовн“ [2], намера Маркдовн-а је једноставна конверзија текста у ХТМЛ. Идеја која је стајала иза тога била је олакшати писање веб страница, документације и посебно уноса на блогу као писање е-поште. Од данас је то де фацто синоним за класу лаганих језика за описивање ознака, а циљ се може видети постигнутим.
Маркдовн користи синтаксу форматирања обичног текста. Са сличним приступом као ХТМЛ, број маркера означава наслове, листе, слике и референце у вашем тексту. Неколико редова у наставку илуструје основни документ који садржи два наслова (1. и 2. ниво), као и два пасуса и окружење листе.
## Француска
Ово је избор места:
* Париз (_Иле де Франце_)
* Стразбур (_Алсаце_)
За правилан план посете око недељу дана.
Конверзија у ДОЦКС
Да бисте конвертовали документ Маркдовн у ДОЦКС, користите алатку пандоц [3]. Пандоц је Хаскелл библиотека и себе описује као „универзални претварач докумената“ или „швајцарски војни нож за конверзију докумената“. Доступан је за разне платформе као што су Линук, Мицрософт Виндовс, Мац ОС Кс и БСД. Пандоц се обично укључује као пакет за Линук дистрибуције попут Дебиан ГНУ / Линук, Убунту и ЦентОС.
Једноставан позив за конверзију је следећи:
$ пандоц -о тест.доцк тест.доктор медицинеПрви параметар '-о' односи се на излазну датотеку, након чега следи име датотеке ('тест.доцк '). Екстензија датотеке помаже пандоц-у да идентификује жељени излазни формат. Други параметар именује улазну датотеку - у нашем случају то је једноставно 'тест.доктор медицине'.
Дуга верзија наредбе приказане горе садржи два параметра '-ф маркдовн' и '-т доцк'. Прва скраћује термин „укус“ и описује формат улазне датотеке. Друга чини исто за излазну датотеку и скраћеница '-то'.
Комплетна команда је следећа:
$ пандоц -о тест.доцк -ф умањење вредности -т доцк тест.доктор медицинеОтварање претворене датотеке помоћу Мицрософт Ворд-а резултира следећим резултатима:
За различите елементе текста Пандоц користи табеле стилова. То вам омогућава да касније прилагодите ове елементе у складу са својим потребама у целом документу. Новије верзије Пандоца нуде и обрнуто - ДОЦКС датотеку можете претворити у Маркдовн на следећи начин:
$ пандоц -о тест.мд тест.доцкЗатим генерисана датотека има следећи садржај:
Препоручена места за посету у Европи=====================================
Француска
------
Ово је избор места:
- Париз (* Ил де Франс *)
- Стразбур (* Алзас *)
За правилан план посете око недељу дана.
Корисне опције командне линије
Списак Пандоц опција је прилично дугачак. Следеће вам помажу да постигнете боље резултате и знатно вам олакшају живот:
* '-П' (дуга верзија '-пресерве-табс'): Очувајте картице уместо да их претварате у размаке. Ово је корисно за блокове кода са увученим линијама који су део вашег текста.
* '-С' (дуга верзија '-смарт'): Производи типографски исправан излаз.
Ова опција исправља цитате, цртице / цртице као и елипсе („...“). Додатни, непрекидни размаци додају се после одређених скраћеница као што је „Господин.”.
* '-трацк-цхангес = валуе': Одређује шта треба урадити са уметањем, брисањем и коментарима који су произведени уз помоћ функције Мицрософт Ворд „Трацк Цхангес“. Вредност може бити или прихватити, одбити или све како би се укључиле или уклониле промене направљене у документу. Резултат је равна датотека.
За више опција погледајте документацију и страницу упутстава за Пандоц.
Резиме
Конверзија између Маркдовн-а и ДОЦКС-а више није мистерија. То се ради у неколико корака и делује врло добро. Срећно хаковање 🙂
Везе и референце
* [1] Маркдовн
* [2] Франк Хофманн: Увод у Маркдовн
* [3] Пандоц
Захвалнице
Аутор се захваљује Аннетте Калбов на помоћи током припреме чланка.