Šajā rakstā mēs aplūkojam konversiju starp Markdown [1] un DOCX - Microsoft Word vietējo dokumentu formātu, kas tiek izmantots kopš 2007. gada. Jums var rasties jautājums, kāpēc Markdown un Asciidoc entuziasts (tāpat kā es) nodarbojas ar šo lietu. Sadarbība ar citu rakstnieku grupu var radīt situāciju, turpretī viens vai vairāki dalībnieki kā izejas formātu pieprasa DOCX. Nepievieniet nevienu un tā vietā uzziniet, kādi ierobežojumi pastāv, un kā mēs varam mēģināt iepriecināt visus grupas dalībniekus.
Kas ir Markdown?
Kā jau norādīts “Ievads Markdown” [2], Markdown nolūks ir vienkāršs teksta pārveidošana HTML formātā. Ideja bija padarīt tīmekļa lapu, dokumentācijas un jo īpaši emuāra ierakstu rakstīšanu tikpat vienkāršu kā e-pasta rakstīšana. No šodienas tas ir de facto-sinonīms vieglo marķējumu aprakstu valodu klasei, un mērķi var uzskatīt par sasniegtu.
Markdown izmanto vienkārša teksta formatēšanas sintaksi. Izmantojot līdzīgu pieeju kā HTML, vairāki marķieri tekstā norāda virsrakstus, sarakstus, attēlus un atsauces. Dažas zemāk redzamās rindas ilustrē pamatdokumentu, kurā ir divi virsraksti (1. un 2. līmenis), kā arī divas rindkopas un saraksta vide.
## Francija
Šī ir vietu izvēle:
* Parīze (_Ile de France_)
* Strasbūra (_Alsace_)
Pareizam apmeklējuma plānam apmēram nedēļu.
Konvertēšana uz DOCX
Lai konvertētu Markdown dokumentu uz DOCX, izmantojiet pandoc rīku [3]. Pandoc ir Haskell bibliotēka, kas sevi raksturo kā “universālo dokumentu pārveidotāju” vai “Šveices armijas nazi dokumentu pārveidošanai”. Tas ir pieejams dažādām platformām, piemēram, Linux, Microsoft Windows, Mac OS X un BSD. Pandoc parasti tiek iekļauts kā pakete Linux izplatīšanai, piemēram, Debian GNU / Linux, Ubuntu un CentOS.
Vienkāršs zvans uz reklāmguvumu ir šāds:
$ pandoc -o tests.docx tests.mdPirmais parametrs '-o' attiecas uz izvades failu, kam seko faila nosaukums ('test.docx '). Faila paplašinājums palīdz pandoc identificēt vēlamo izvades formātu. Otrais parametrs nosauc ievades failu - mūsu gadījumā tas vienkārši ir “tests”.md '.
Iepriekš parādītajā komandas garajā versijā ir divi parametri '-f markdown' un '-t docx'. Pirmais saīsina terminu “aromāts” un apraksta ievades faila formātu. Otrais dara to pašu izejas failam un saīsina '-to'.
Pilna komanda ir šāda:
$ pandoc -o tests.docx -f markdown -t docx tests.mdAtverot konvertēto failu, izmantojot Microsoft Word, tiek parādīta šāda izeja:
Dažādiem teksta elementiem Pandoc izmanto stilu lapas. Tas ļauj vēlāk pielāgot šos elementus atbilstoši jūsu vajadzībām visā dokumentā. Jaunākās Pandoc versijas piedāvā arī otrādi - DOCX failu varat pārveidot Markdown šādi:
$ pandoc -o tests.md tests.docxTad izveidotajam failam ir šāds saturs:
Ieteicamās apskates vietas Eiropā=====================================
Francija
------
Šī ir vietu izvēle:
- Parīze (* Ile de France *)
- Strasbūra (* Elzasa *)
Pareizam apmeklējuma plānam apmēram nedēļu.
Noderīgas komandrindas opcijas
Pandoc opciju saraksts ir diezgan garš. Šie rezultāti palīdz jums sasniegt labākus rezultātus un ievērojami atvieglo jūsu dzīvi:
* '-P' (garā versija '-preserve-tabs'): saglabājiet cilnes, nevis pārveidojot tās par atstarpēm. Tas ir noderīgi kodu blokiem ar ievilktām līnijām, kas ir daļa no jūsu teksta.
* '-S' (garā versija '-smart'): izveidojiet tipogrāfiski pareizu izvadi.
Šī opcija izlabo pēdiņas, defises / domuzīmes, kā arī elipses (“…”). Pēc noteiktiem saīsinājumiem, piemēram, “Mr.”.
* '-track-changes = value': norāda, ko darīt ar ievietojumiem, dzēšanu un komentāriem, kas tiek veidoti, izmantojot Microsoft Word līdzekļa “Izmaiņu izsekošana” palīdzību. Vērtība var būt vai nu pieņemt, noraidīt vai visu, lai iekļautu vai noņemtu dokumentā veiktās izmaiņas. Rezultāts ir plakans fails.
Lai uzzinātu vairāk iespēju, skatiet dokumentāciju un Pandoc rokasgrāmatas lapu.
Kopsavilkums
Konvertēšana starp Markdown un DOCX vairs nav noslēpums. Tas tiek veikts dažu soļu laikā un darbojas ļoti labi. Laimīgu uzlaušanu 🙂
Saites un atsauces
* [1] Atlaide
* [2] Frenks Hofmans: Ievads Markdown
* [3] Pandoc
Pateicības
Autore vēlas pateikties Annetei Kalbow par palīdzību raksta sagatavošanā.