Asiakirjojen muuntaminen merkinnöistä Microsoft Word -muotoon

Muiden toimintojen joukossa tekstidokumenttien kirjoittaminen ja muokkaaminen kuuluu yleisimpiin toimintoihin, joihin käytämme (pöytätietokoneita). Tarkka tapa, jolla se tehdään, seuraa eri polkuja - paljaan tekstieditorin käytöstä, kuten Vim, graafisiin sovelluksiin, kuten Open / Libre Office tai pilvipohjaisiin palveluihin, joihin pääsee selaimen, kuten Google Docsin kautta. Haittamme on, että jokaisella työkalulla on oma alkuperäinen dokumenttimuoto sekä valikoima muita tuettuja asiakirjamuotoja. Näiden muotojen muuntamisen laatu vaihtelee suuresti, ja se voi johtaa paljon turhautumiseen muodon rajoja ylittäessä.

Tässä artikkelissa tarkastelemme muunnosta Markdownin [1] ja DOCX: n - Microsoft Wordin alkuperäisen asiakirjamuodon välillä, joka on ollut käytössä vuodesta 2007. Saatat ihmetellä, miksi Markdownin ja Asciidocin harrastaja (kuten minä) käsittelee tätä tapausta. Yhteistyö muiden kirjoittajien ryhmän kanssa voi johtaa tilanteeseen, kun yksi tai useampi osallistuja pyytää DOCX: ta lähtömuodoksi. Älä jätä ketään pettymään ja selvitä, mitkä rajoitukset ovat sen sijaan olemassa ja miten voimme yrittää tehdä kaikista ryhmän jäsenistä onnellisia.

Mikä on Markdown?

Kuten "Johdatus Markdowniin" [2] jo todettiin, Markdownin tarkoitus on yksinkertainen teksti HTML-muunnokseen. Sen takana oli tehdä verkkosivujen, dokumentaation ja erityisesti blogimerkintöjen kirjoittaminen yhtä helppoa kuin sähköpostin kirjoittaminen. Tästä päivästä lähtien se on tosiasiallisesti synonyymi luokan kevyille merkintäkuvauskielille, ja tavoite voidaan nähdä saavutettuna.

Markdown käyttää pelkkää tekstin muotoilun syntaksia. HTML-koodia vastaavalla tavalla useat merkit osoittavat otsikoita, luetteloita, kuvia ja viitteitä tekstissäsi. Muutama alla oleva rivi kuvaa perusasiakirjaa, joka sisältää kaksi otsikkoa (1. ja 2. taso) sekä kaksi kappaletta ja luetteloympäristön.

# Suositeltavaa käyntikohtaa Euroopassa
## Ranska
Tämä on valikoima paikkoja:
* Pariisi (_Ile de France_)
* Strasbourg (_Alsace_)
Oikea vierailusuunnitelma noin viikko.

Muunnos DOCX: ksi

Muunna Markdown-dokumenttisi DOCX: ksi käyttämällä pandoc-työkalua [3]. Pandoc on Haskell-kirjasto, joka kuvaa itseään nimellä "yleinen asiakirjanmuunnin" tai "Sveitsin armeijan veitsi asiakirjojen muuntamiseen". Se on saatavana useille alustoille, kuten Linux, Microsoft Windows, Mac OS X ja BSD. Pandoc sisältyy yleisesti pakettina Linux-jakeluille, kuten Debian GNU / Linux, Ubuntu ja CentOS.

Yksinkertainen muutospyyntö on seuraava:

$ pandoc -o -testi.docx-testi.md

Ensimmäinen parametri '-o' viittaa ulostulotiedostoon, jota seuraa tiedoston nimi ('testi.docx '). Tiedostotunniste auttaa pandocia tunnistamaan halutun tulostusmuodon. Toinen parametri nimeää syötetiedoston - tapauksessamme se on yksinkertaisesti 'testi.md '.

Yllä esitetyn komennon pitkä versio sisältää kaksi parametria '-f markdown' ja '-t docx'. Ensimmäinen lyhentää termiä 'maku' ja kuvaa syötetiedoston muodon. Toinen tekee saman tulostiedostolle ja lyhentää '-to'.

Koko komento on seuraava:

$ pandoc -o -testi.docx -f markdown -t docx-testi.md

Muunnetun tiedoston avaaminen Microsoft Wordilla tuottaa seuraavan tuloksen:

Eri tekstielementtejä varten Pandoc käyttää tyylitaulukoita. Tämän avulla voit säätää näitä elementtejä myöhemmin tarpeidesi mukaan koko asiakirjassa. Pandocin uudemmat versiot tarjoavat myös päinvastoin - voit muuntaa DOCX-tiedoston Markdowniksi seuraavasti:

$ pandoc -o -testi.md-testi.docx

Sitten luotulla tiedostolla on seuraava sisältö:

Suositeltavat käyntikohteet Euroopassa
=====================================
Ranska
------
Tämä on valikoima paikkoja:
-   Pariisi (* Ile de France *)
-   Strasbourg (* Alsace *)
Oikea vierailusuunnitelma noin viikko.

Hyödyllisiä komentorivivalintoja

Luettelo Pandoc-vaihtoehdoista on melko pitkä. Seuraavat auttavat sinua tuottamaan parempia tuloksia ja helpottavat elämääsi paljon:

* '-P' (pitkä versio '-preserve-tabs'): Säilytä välilehdet sen sijaan, että muunnat ne välilyönteiksi. Tästä on hyötyä koodilohkoissa, joissa on sisennyttä riviä ja jotka ovat osa tekstiäsi.

* '-S' (pitkä versio '-smart'): Tuota typografisesti oikea tulos.

Tämä vaihtoehto korjaa lainausmerkkejä, väliviivoja / viivoja sekä ellipsejä (“…”). Lisää, ei-rikkomattomia välilyöntejä lisätään tiettyjen lyhenteiden, kuten “Mr.”.

* '-track-changes = value': Määrittää, mitä tehdä lisäyksille, poistamisille ja kommenteille, jotka tuotetaan Microsoft Wordin "Seuraa muutoksia" -ominaisuuden avulla. Arvo voi olla joko hyväksy, hylkää tai kaikki, jotta dokumenttiin tehdyt muutokset voidaan sisällyttää tai poistaa. Tuloksena on tasainen tiedosto.

Katso lisää vaihtoehtoja tutustumalla Pandocin dokumentaatioon ja manuaaliseen sivuun.

Yhteenveto

Muuntaminen Markdownin ja DOCX: n välillä ei ole enää mysteeri. Se tehdään muutamassa vaiheessa ja toimii hyvin. Hyvää hakkerointia 🙂

Linkit ja viitteet

* [1] Markdown
* [2] Frank Hofmann: Johdatus Markdowniin
* [3] Pandoc

Kiitokset

Kirjoittaja haluaa kiittää Annette Kalbowia avusta artikkelin valmistelussa.