{"id":24078,"date":"2018-03-02T15:33:27","date_gmt":"2018-03-02T14:33:27","guid":{"rendered":"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/?p=24078"},"modified":"2018-03-02T15:33:27","modified_gmt":"2018-03-02T14:33:27","slug":"pandoc","status":"publish","type":"post","link":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/2018\/03\/02\/pandoc\/","title":{"rendered":"Pandoc"},"content":{"rendered":"<p>&nbsp;<\/p>\n<h2 id=\"wst\u0119p\">Wst\u0119p<\/h2>\n<p>Program pandoc to narz\u0119dzie dzia\u0142aj\u0105ce w linii polece\u0144. Wi\u0119c poni\u017cszy wpis mo\u017ce bardziej zainteresowa\u0107 u\u017cytkownik\u00f3w korzystaj\u0105cych z linii polece\u0144 na co dzie\u0144. Doda\u0107 trzeba, \u017ce w jednakowym stopniu dotyczy to systemu Windows jak i Linux.<\/p>\n<h2 id=\"co-mo\u017ce-pandoc\">Co mo\u017ce pandoc?<\/h2>\n<p>\u017beby pokaza\u0107 co potrafi program pandoc, <a href=\"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/2018\/03\/01\/markdown\/\">kod \u017ar\u00f3d\u0142owy strony WWW opisuj\u0105cej j\u0119zyk markdown<\/a>. Tak, zosta\u0142a ona tak w\u0142a\u015bnie przygotowana. Znajduje si\u0119 on poni\u017cej, mo\u017cna te\u017c <a href=\"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-content\/uploads\/sites\/2\/2018\/03\/Markdown.md\">\u015bci\u0105gn\u0105\u0107 go na dysk<\/a>.<\/p>\n<pre class=\"font:monospace wrap:true lang:default decode:true\"># Markdown\r\nCreated sobota 24 luty 2018\r\n\r\nS\u0142\u00f3w kilka na wst\u0119pie\r\n---------------------\r\n\r\nJak wiadomo, standardem *de facto* tworzenia dokument\u00f3w na uczelni jest Najpopularniejszy Komercyjny Procesor Tekstu. W\u0142adze Uczelni r\u00f3wnie\u017c ch\u0119tnie z niego korzystaj\u0105. R\u00f3wnie\u017c Oficyna Wydawnicza dokumenty do publikacji najch\u0119tniej przyjmuje w tym formacie.\r\n\r\nOrganizatorzy konferencji nie wyobra\u017caj\u0105 sobie, \u017ceby u\u017cy\u0107 innego formatu.\r\n\r\nCo wi\u0119cej Ministerstwo r\u00f3wnie\u017c preferuje t\u0119 aplikacj\u0119 rozsy\u0142aj\u0105 przygotowane dokumenty i oczekuj\u0105c sprawozda\u0144 w tym formacie. Jedynie dokument podlegaj\u0105ce p\u00f3\u017aniej automatycznemu przetwarzaniu przesy\u0142ane s\u0105 w inny spos\u00f3b.\r\n\r\nNatomiast istnieje wiele innych sposob\u00f3w przygotowania tekstu \u2014 czy na swoje potrzeby, czy do publikacji. Jednym z nich jest LaTeX.\r\n\r\nTym razem chcia\u0142em jednak wspomnie\u0107 o formacie [Markdown](https:\/\/daringfireball.net\/projects\/markdown\/).\r\n\r\nWprowadzenie\r\n------------\r\n\r\n[Markdown](https:\/\/en.wikipedia.org\/wiki\/Markdown) to j\u0119zyk znacznik\u00f3w (oraz program), kt\u00f3ry zosta\u0142 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\u015bl\u0105 o \u0142atwiejszym przygotowywaniu zawarto\u015bci sformatowanej jako HTML.\r\nJ\u0119zyk wzbudzi\u0142 spore zainteresowanie i obr\u00f3s\u0142 r\u00f3\u017cnymi interesuj\u0105cymi narz\u0119dziami (z kt\u00f3rych najciekawszym jest program [pandoc](http:\/\/www.pandoc.org\/) \u2014 uniwersalny konwerter pozwalaj\u0105cy dokonywa\u0107 konwersji pomi\u0119dzy ro\u017cnymi formatami dokument\u00f3w.\r\n\r\nCechy charakterystyczne formatu markdown\r\n----------------------------------------\r\n\r\n1. Plik \u017ar\u00f3d\u0142owy w tym formacie jest bardzo prostym plikiem tekstowym, kt\u00f3ry mo\u017ce by\u0107 przygotowany z u\u017cyciem najprostszych narz\u0119dzi.\r\n2. Tworzonemu dokumentowi mo\u017cna nadawa\u0107 struktur\u0119: dzieli\u0107 na rozdzia\u0142y, podrozdzia\u0142y,\u2026\r\n3. Mo\u017cna tworzy\u0107 listy proste i numerowane.\r\n4. Mo\u017cna u\u017cywa\u0107 wyr\u00f3\u017cnie\u0144 (wyt\u0142uszczenie, pochylenie tekstu)\r\n5. Mo\u017cna wstawia\u0107 rysunki.\r\n6. Mo\u017cna wstawia\u0107 fragmenty kodu.\r\n7. Mo\u017cna korzysta\u0107 z odsy\u0142aczy.\r\n8. Bardzo \u0142atwo wstawia\u0107 proste tabele.\r\n\r\nNarz\u0119dzia\r\n---------\r\n\r\n### Edytory\r\n\r\nJest bardzo wiele edytor\u00f3w oferuj\u0105cych jakie\u015b wsparcie dla j\u0119zyka markdown.\r\n\r\n* Najprostszy **og\u00f3lny** edytor tekstowy (notatnik, Notepad++,\u2026 w Windows lub jakikolwiek edytor tekstowy pod linuksem: vim, geany,\u2026)\r\n\r\nW najprostszym przypadku b\u0119dzie jedynie kolorowanie sk\u0142adni.\r\n\r\n* Sympatycznym, uniwersalnym i prostym rozwi\u0105zaniem rozwi\u0105zaniem \u201ewielosystemowym\u201c mo\u017ce by\u0107 edytor [caret](https:\/\/chrome.google.com\/webstore\/detail\/caret\/fljalecfjciodhpcledpamjachpmelml), instalowany jako rozszerzenie do przegl\u0105darki Google Chrome.\r\n\r\n---\r\n\r\nJest te\u017c ca\u0142a grupa uniwersalnych edytor\u00f3w oferuj\u0105cych, na przyk\u0142ad, kolorowanie sk\u0142adni dla bardzo wielu j\u0119zyk\u00f3w, w tym i dla markdown. Praktycznie ka\u017cdy \u201edobry\u201d edytor dla programist\u00f3w b\u0119dzie oferowa\u0142 jakie\u015b wsparcie dla markdown.\r\n\r\nNa drugim ko\u0144cu s\u0105 specjalizowane edytory oferuj\u0105ce zaawansowane wsparcie dla markdown. Nale\u017c\u0105 do nich [Caret](https:\/\/caret.io\/) czy [Typora](https:\/\/typora.io\/) oferuj\u0105ce zaawansowany podgl\u0105d tworzonych dokument\u00f3w, edycj\u0119 wizualn\u0105 czy konwersj\u0119 do wielu format\u00f3w.\r\n\r\n---\r\n\r\n### Programy do konwersji\r\n\r\nJ\u0119zyk markdown powsta\u0142 r\u00f3wnocze\u015bnie z perlowym skryptem (programem) umo\u017cliwiaj\u0105cym konwersj\u0119 do HTML. Wraz z rozprzestrzenianiem si\u0119 standardu przybywa\u0142o aplikacji korzystaj\u0105cych z tego sposobu prezentowania zawarto\u015bci.\r\n\r\nDzi\u015b jednym z daj\u0105cych najwi\u0119ksze mo\u017cliwo\u015bci program\u00f3w jest [pandoc](http:\/\/www.pandoc.org\/).\r\n\r\n---\r\n\r\n### Kto u\u017cywa markdown\r\n\r\nZ markdown (lub specjalnych jego wersji) korzysta:\r\n\r\n* [Wikipedia,](https:\/\/www.wikipedia.org\/)\r\n* [GitHub,](https:\/\/github.com\/)\r\n* [Jupyter,](http:\/\/jupyter.org\/)\r\n* [StackExchange,](https:\/\/stackexchange.com\/)\r\n* [Wordpress,](https:\/\/en.support.wordpress.com\/markdown\/)\r\n* [R,](https:\/\/www.r-project.org\/)\r\n* [LaTeX,](https:\/\/ctan.org\/pkg\/markdown)\r\n* [Trello,](https:\/\/trello.com\/)\r\n* na stronach [gov.uk,](https:\/\/www.gov.uk\/guidance\/how-to-publish-on-gov-uk\/markdown)\r\n* \u2026\r\n* last but not least [Jakub S\u0142owi\u0144ski](https:\/\/kmim.wm.pwr.edu.pl\/slowinski\/).\r\n\r\nCo dalej?\r\n---------\r\n\r\nW kolejnych odcinkach opowiem o mo\u017cliwych zastosowaniach j\u0119zyka markdown.\r\n<\/pre>\n<p>Program pandoc zosta\u0142 u\u017cyty do skonwertowanie tekstu do nast\u0119puj\u0105cych format\u00f3w:<\/p>\n<ul>\n<li><a href=\"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-content\/uploads\/sites\/2\/2018\/03\/Markdown.pdf\">PDF<\/a>,<\/li>\n<li><a href=\"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-content\/uploads\/sites\/2\/2018\/03\/Markdown.md_.slides.pdf\">prezentacji PDF<\/a>,<\/li>\n<li><a href=\"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-content\/uploads\/sites\/2\/2018\/03\/Markdown.odt\">ODT (dokument LibreOffice)<\/a><\/li>\n<li><a href=\"http:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-content\/uploads\/sites\/2\/2018\/03\/Markdown.docx\">DOCX (dokument Word)<\/a><\/li>\n<\/ul>\n<p>Wszystkie konwersje wykonane zosta\u0142y za pomoc\u0105 nast\u0119puj\u0105cych polece\u0144:&nbsp;<\/p>\n<pre class=\"font:monospace lang:sh decode:true \">pandoc Markdown.md -o Markdown.pdf \r\npandoc Markdown.md -t beamer -V theme=NewPwr --slide-level 2 -o Markdown.md.slides.pdf \r\npandoc Markdown.md -o Markdown.odt \r\npandoc Markdown.md -o Markdown.docx<\/pre>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp; Wst\u0119p Program pandoc to narz\u0119dzie dzia\u0142aj\u0105ce w linii polece\u0144. Wi\u0119c poni\u017cszy wpis mo\u017ce bardziej zainteresowa\u0107 u\u017cytkownik\u00f3w korzystaj\u0105cych z linii polece\u0144 na co dzie\u0144. Doda\u0107 trzeba, \u017ce w jednakowym stopniu dotyczy to systemu Windows jak i Linux. Co mo\u017ce pandoc? \u017beby pokaza\u0107 co potrafi program pandoc, kod \u017ar\u00f3d\u0142owy strony WWW opisuj\u0105cej j\u0119zyk markdown. Tak, zosta\u0142a &hellip; <a href=\"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/2018\/03\/02\/pandoc\/\" class=\"more-link\">Czytaj dalej <span class=\"screen-reader-text\">Pandoc<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":24086,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"footnotes":""},"categories":[1,17],"tags":[23,241,243,153],"class_list":["post-24078","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-bez-kategorii","category-publikacje","tag-featured","tag-markdown","tag-pandoc","tag-publikacje"],"publishpress_future_action":{"enabled":false,"date":"2026-04-24 15:05:43","action":"change-status","newStatus":"draft","terms":[],"taxonomy":"category","extraData":[]},"publishpress_future_workflow_manual_trigger":{"enabledWorkflows":[]},"_links":{"self":[{"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/posts\/24078","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/comments?post=24078"}],"version-history":[{"count":4,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/posts\/24078\/revisions"}],"predecessor-version":[{"id":24088,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/posts\/24078\/revisions\/24088"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/media\/24086"}],"wp:attachment":[{"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/media?parent=24078"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/categories?post=24078"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kmim.wm.pwr.edu.pl\/myszka\/wp-json\/wp\/v2\/tags?post=24078"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}