Pandoc

mar 2, 2018 3 min czytania Publikacje

Spis treści

Wstęp

Program pandoc to narzędzie działające w linii poleceń. Więc poniższy wpis może bardziej zainteresować użytkowników korzystających z linii poleceń na co dzień. Dodać trzeba, że w jednakowym stopniu dotyczy to systemu Windows jak i Linux.

Co może pandoc?

Żeby pokazać co potrafi program pandoc, kod źródłowy strony WWW opisującej język markdown. Tak, została ona tak właśnie przygotowana. Znajduje się on poniżej, można też ściągnąć go na dysk.

# Markdown Created sobota 24 luty 2018

Słów kilka na wstępie

Jak wiadomo, standardem -de facto- tworzenia dokumentów na uczelni jest Najpopularniejszy Komercyjny Procesor Tekstu. Władze Uczelni również chętnie z niego korzystają. Również Oficyna Wydawnicza dokumenty do publikacji najchętniej przyjmuje w tym formacie.

Organizatorzy konferencji nie wyobrażają sobie, żeby użyć innego formatu.

Co więcej Ministerstwo również preferuje tę aplikację rozsyłają przygotowane dokumenty i oczekując sprawozdań w tym formacie. Jedynie dokument podlegające później automatycznemu przetwarzaniu przesyłane są w inny sposób.

Natomiast istnieje wiele innych sposobów przygotowania tekstu — czy na swoje potrzeby, czy do publikacji. Jednym z nich jest LaTeX.

Tym razem chciałem jednak wspomnieć o formacie Markdown.

Wprowadzenie

Markdown to język znaczników (oraz program), który został opracowany w 2004 roku (John Gruber i Aaron Swartz) z myślą o łatwiejszym przygotowywaniu zawartości sformatowanej jako HTML. Język wzbudził spore zainteresowanie i obrósł różnymi interesującymi narzędziami (z których najciekawszym jest program pandoc — uniwersalny konwerter pozwalający dokonywać konwersji pomiędzy rożnymi formatami dokumentów.

Cechy charakterystyczne formatu markdown

Plik źródłowy w tym formacie jest bardzo prostym plikiem tekstowym, który może być przygotowany z użyciem najprostszych narzędzi.
Tworzonemu dokumentowi można nadawać strukturę: dzielić na rozdziały, podrozdziały,…
Można tworzyć listy proste i numerowane.
Można używać wyróżnień (wytłuszczenie, pochylenie tekstu)
Można wstawiać rysunki.
Można wstawiać fragmenty kodu.
Można korzystać z odsyłaczy.
Bardzo łatwo wstawiać proste tabele.

Narzędzia

Edytory

Jest bardzo wiele edytorów oferujących jakieś wsparcie dla języka markdown.

Najprostszy ogólny edytor tekstowy (notatnik, Notepad++,… w Windows lub jakikolwiek edytor tekstowy pod linuksem: vim, geany,…)

W najprostszym przypadku będzie jedynie kolorowanie składni.

Sympatycznym, uniwersalnym i prostym rozwiązaniem rozwiązaniem „wielosystemowym“ może być edytor caret, instalowany jako rozszerzenie do przeglądarki Google Chrome.

Jest też cała grupa uniwersalnych edytorów oferujących, na przykład, kolorowanie składni dla bardzo wielu języków, w tym i dla markdown. Praktycznie każdy „dobry” edytor dla programistów będzie oferował jakieś wsparcie dla markdown.

Na drugim końcu są specjalizowane edytory oferujące zaawansowane wsparcie dla markdown. Należą do nich Caret czy Typora oferujące zaawansowany podgląd tworzonych dokumentów, edycję wizualną czy konwersję do wielu formatów.

Programy do konwersji

Język markdown powstał równocześnie z perlowym skryptem (programem) umożliwiającym konwersję do HTML. Wraz z rozprzestrzenianiem się standardu przybywało aplikacji korzystających z tego sposobu prezentowania zawartości.

Dziś jednym z dających największe możliwości programów jest pandoc.

Kto używa markdown

Z markdown (lub specjalnych jego wersji) korzysta:

Co dalej?

W kolejnych odcinkach opowiem o możliwych zastosowaniach języka markdown.

Program pandoc został użyty do skonwertowanie tekstu do następujących formatów:

Wszystkie konwersje wykonane zostały za pomocą następujących poleceń:

pandoc Markdown.md -o Markdown.pdf 
pandoc Markdown.md -t beamer -V theme=NewPwr --slide-level 2 -o Markdown.md.slides.pdf 
pandoc Markdown.md -o Markdown.odt 
pandoc Markdown.md -o Markdown.docx

Markdown Pandoc Publikacje LaTeX