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.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 |
# 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](https://daringfireball.net/projects/markdown/). Wprowadzenie ------------ [Markdown](https://en.wikipedia.org/wiki/Markdown) to język znaczników (oraz program), który został opracowany w 2004 roku ([John Gruber](https://en.wikipedia.org/wiki/John_Gruber) i [Aaron Swartz](https://en.wikipedia.org/wiki/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](http://www.pandoc.org/) — uniwersalny konwerter pozwalający dokonywać konwersji pomiędzy rożnymi formatami dokumentów. Cechy charakterystyczne formatu markdown ---------------------------------------- 1. Plik źródłowy w tym formacie jest bardzo prostym plikiem tekstowym, który może być przygotowany z użyciem najprostszych narzędzi. 2. Tworzonemu dokumentowi można nadawać strukturę: dzielić na rozdziały, podrozdziały,… 3. Można tworzyć listy proste i numerowane. 4. Można używać wyróżnień (wytłuszczenie, pochylenie tekstu) 5. Można wstawiać rysunki. 6. Można wstawiać fragmenty kodu. 7. Można korzystać z odsyłaczy. 8. 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](https://chrome.google.com/webstore/detail/caret/fljalecfjciodhpcledpamjachpmelml), 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](https://caret.io/) czy [Typora](https://typora.io/) 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](http://www.pandoc.org/). --- ### Kto używa markdown Z markdown (lub specjalnych jego wersji) korzysta: * [Wikipedia,](https://www.wikipedia.org/) * [GitHub,](https://github.com/) * [Jupyter,](http://jupyter.org/) * [StackExchange,](https://stackexchange.com/) * [Wordpress,](https://en.support.wordpress.com/markdown/) * [R,](https://www.r-project.org/) * [LaTeX,](https://ctan.org/pkg/markdown) * [Trello,](https://trello.com/) * na stronach [gov.uk,](https://www.gov.uk/guidance/how-to-publish-on-gov-uk/markdown) * … * last but not least [Jakub Słowiński](https://kmim.wm.pwr.edu.pl/slowinski/). 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ń:
|
1 2 3 4 |
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 |