[{"_1":2,"_197":-5,"_198":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_173":174},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":90,"_113":114,"_162":-5,"_163":11,"_164":21,"_165":11,"_166":-5,"_167":11,"_168":-5,"_169":170,"_171":115,"_172":-7},"canonicalUrl","https://hub.docker.com/r/fiware/md2pdf/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","fiware","reponame","md2pdf","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":75,"_80":21,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2016-02-05T08:37:21.224511Z","description","md2pdf allows you to generate a PDF document from a set of Markdown files.\n","is_private","last_updated","2016-04-13T15:19:13.341803Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.distribution.manifest.v1+prettyjws","name","pull_count",2489,"repository_type","star_count",2,"status",1,"status_description","active","source","collaborator_count",0,"full_description","# md2pdf\n\n[![MIT license][license-image]][license-url]\n[![Docker][docker-image]][docker-url]\n[![Support][support-image]][support-url]\n[![Build Status][travis-image]][travis-url]\n\n## About\n\n**md2pdf** is a Python package which allows you to generate a PDF document from a set of Markdown files. If you have any kind of issue feel free to contact us at using the tag 'md2pdf'\n\n\n## Markdown guidelines\n\nA list of considerations that must be followed for writing the markdown files is described in the [GUIDELINES](GUIDELINES.md) file.\n\n## Quick Start Guide (with Docker)\n\nThis section assumes that you already have installed Docker in your machine. If you don't, you can install it following the instruccions for your operating system in \n\n### Using a Read the Docs or MkDocs configuration file\n\nIf you have a *Read the Docs* or *MkDocs* configuration file, you can use it directly with md2pdf.\n\nFor example, if you have your documentation under the folder `/Users/myusername/myEnabler` with an structure like:\n\n```\ndocs/\n Introduction.md\n User-Guide.md\n ....\n images/\nsrc/\nmkdocs.yml\n...\n```\n\nYou can run the command \n\n```\ndocker run -v=/Users/myusername/myEnabler:/md2pdf fiware/md2pdf -i /md2pdf/mkdocs.yml -o /md2pdf/documentation.pdf\n```\n\nAnd it will generate the documentation in the file `/Users/myusername/myEnabler/documentation.pdf`\n\n#### Executable example\nIf you copy the directory `markdown_examples/` to `/Users/myusername/markdown_examples` and run:\n```\ndocker run -v=/Users/myusername/markdown_examples:/md2pdf fiware/md2pdf -i /md2pdf/mkdocs_user_cover.yml -o /md2pdf/documentation.pdf\n```\n### Using a custom configuration file\n\nIf you **don't use** a Read the Docs or MkDocs configuration file, you should provide a configuration file specifying the files order and the cover metadata.\n\nFor example, if you have a directory like:\n\n```\ndocs/\n Introduction.md\n User-Guide.md\n ....\n images/\nsrc/\nmd2pdf.yml\n...\n```\n\nWhere `md2pdf.yml` is like:\n\n```\nfiles_order:\n - 'docs/Introduction.md'\n - 'docs/User-guide.md'\n ...\ncover_metadata:\n title: 'Document title'\n Author: 'foo barr'\n Another Data: 'data value'\n \n```\n\n**Note:** Path to the documentation file should be relative.\n\n\nYou can run the command with Docker using:\n\n```\ndocker run -v=/Users/myusername/myEnabler:/md2pdf fiware/md2pdf -i /md2pdf/md2pdf.yml -o /md2pdf/documentation.pdf\n```\n\n#### Executable example\n\nIf you copy the directory `markdown_examples/usercover/` to `/Users/myusername/usercover` and run:\n\n```\ndocker run -v=/Users/myusername/usercover:/md2pdf fiware/md2pdf -i /md2pdf/md2pdf.yml -o /md2pdf/documentation.pdf\n```\n\nThe file documentation.pdf should have been generated in /Users/myusername/usercover\n\n## Detailed instructions \n### Installing dependencies (without Docker)\n\n**Important: When following next instructions, make sure that Pandoc v1.15.1 is installed.** Using a greater version may introduce incompatibilities with md2pdf (ie. an anomalous behaviour have been detected in Pandoc v1.15.2 when converting tables).\n\n#### Ubuntu\n\n1. Install [Python 2.7](https://www.python.org/) from repository.\n\n sudo apt-get install python2.7\n\n2. Install PIP (Python packages manager) from repository.\n\n sudo apt-get install python-pip\n\n3. Download and install [Pandoc v1.15.1](https://github.com/jgm/pandoc/releases/1.15.1).\n\n4. Install a full version of [LaTeX](http://www.latex-project.org/) from repository.\n\n sudo apt-get install texlive-full\n\n5. Download and install [PDFtk](https://www.pdflabs.com/tools/pdftk-server/)\n\n#### Windows\n\n1. Install [Python2](https://www.python.org/). Make sure PIP is also installed by marking it in the installation wizard.\n\n2. Install [Pandoc v1.15.1](https://github.com/jgm/pandoc/releases/1.15.1).\n\n3. Install [MiKTeX](http://miktex.org/).\n 1. Download MiKTeX 2.9.5721 for [32 bits](http://mirrors.ctan.org/systems/win32/miktex/setup/setup-2.9.5721.exe) or [64 bits](http://mirrors.ctan.org/systems/win32/miktex/setup/setup-2.9.5721-x64.exe).\n 2. Run the intaller and select the following:\n 1. Download MiKTeX.\n 2. Complete MiKTeX.\n 3. Select a downloading folder.\n 3. **Run again** previous installer.\n 1. Select \"Install MiKTeX\"\n 2. Select the downloading folder set in last step.\n 3. When presented the option \"Install missing packages on-the-fly\", select \"yes\".\n\n4. Install [PDFtk](https://www.pdflabs.com/tools/pdftk-server/) - Tested version: [pdftk_free-2.02-win](https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/pdftk_free-2.02-win-setup.exe)\n\n\n#### OSX\n\n1. Download and install MacTeX \n\n2. Download and install Pandoc 1.15.1 version from . You need to download the ```.pkg``` binary.\n\n3. Download and install PDFtk-server for Mac OSX from
**IMPORTANT!:** If you are using an *OS 10.11.X El Capitan*, you should install this package instead.\n\n4. Install pip \n\n### Installing md2pdf\n\nRun the following commands for cloning this repo and installing the Python package for md2pdf.\n\n git clone git@github.com:Fiware/tools.Md2pdf.git\n cd markdown_to_pdf\n sudo python setup.py install\n\n### Usage\n\n**md2pdf** is executed as follows\n\n```\nmd2pdf -i -o \n```\n\nwhere *\\* could be a **Read the Docs or MkDocs** configuration file.\n\n\n\nIf you don't use a **Read the Docs or MkDocs** configuration file, you should provided a YAML configuration file containing:\n* A list of paths to the Markdown files that we want to include in the PDF. The paths must be relative to the configuration file itself.\n* Data related to cover.\n\nAn example of the configuration file is below:\n\n```\nfiles_order:\n - 'first-document.md'\n - 'second-document.md'\n - 'third-document.md'\n\ncover_metadata:\n title: 'Document title'\n Author: 'foo barr'\n Another Data: 'data value'\n```\n\n\n**Cover metadata notes:**\n* The cover metadata section accepts any key-value pair. The title is the only that it's treated specially, the rest simply are placed using a new line per pair with the key in bold.\n* The cover metadata could be specified using a different configuration file if **-c** option is passed ```md2pdf -i conf_file.yml -c cover_metatada.yml -o output.pdf```.\n\nFor generating a PDF from the documentation example, execute:\n\n```\nmd2pdf -i markdown_examples/user_cover/markdown_to_pdf.yml -o /var/tmp/orion_user_manual.pdf \n```\n\nFor runing unit tests ([unittest](https://docs.python.org/2/library/unittest.html) required), execute (**from within the repository root directory**):\n\n```\npython2 markdown_to_pdf/test_markdown_to_pdf.py\n```\n\n\n\n### Usage with Docker\n\n\nThe tool is published in the Docker Hub repository as fiware/md2pdf. You can also build it from the dockerfile provided inside the docker folder. \n\n To build the Docker image with the Dockerfile simply use the command `docker build -t .` inside the docker folder. Don't forget the final dot.\n\nOnce the image is created, you can execute it with:\n\n```\ndocker run --volume=: -o -i \n```\n\nIf you are using the Docker Hub container simply replace **** by **fiware/md2pdf**:\n\n```\ndocker run --volume=: fiware/md2pdf -o -i \n```\n\nWhere:\n * **** is the folder where the documentation is hosted in your machine.\n * **** is the folder where the is mounted in the Docker container.\n * **** is the path to the output file related to the Docker container.\n * **** is where the configuration is located inside the Docker container.\n * **** is the image name used when the image was created.\n \n**Example**:\n\nIf we have the folder `/User/username/ExampleEnabler` with an structure like:\n\n```\n -docs/\n - m2pdf.yml\n - README.md\n - Chapter1.md\n - Chapter2.md\n \n -src/\n ...\n```\n\nIf we want to save the output to ```/User/username/ExampleEnabler/documentation.pdf``` and supposing that we have created the Docker machine with ```docker build -t m2pdf-docker .```\n\nWe should generate the documentation with the command:\n\n```\ndocker run --volume=/User/username/ExampleEnabler/:/m2pdf m2pdf-docker -o /m2pdf/documentation.pdf -i /m2pdf/docs/m2pdf.yml\n```\n\nIf we are using the Docker Hub Container the command should be:\n\n```\ndocker run --volume=/User/username/ExampleEnabler/:/m2pdf fiware/md2pdf -o /m2pdf/documentation.pdf -i /m2pdf/docs/m2pdf.yml\n```\n\n \n**IMPORTANT NOTE:** All documentation must be located under the and all references between its elements (a link to another document, an image..) should be relative.\n\n\n[travis-image]: https://travis-ci.org/Fiware/tools.Md2pdf.svg?branch=master\n[travis-url]: https://travis-ci.org/Fiware/tools.Md2pdf\n\n[license-image]: https://img.shields.io/badge/license-MIT-blue.svg\n[license-url]: https://github.com/Fiware/tools.Md2pdf/blob/master/LICENSE\n\n[docker-image]: https://img.shields.io/docker/pulls/fiware/md2pdf.svg\n[docker-url]: https://hub.docker.com/r/fiware/md2pdf/\n\n[support-image]: https://img.shields.io/badge/support-askbot-yellowgreen.svg\n[support-url]: http://ask.fiware.org","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":21,"_84":11,"_85":11},"read","write","admin","user","storage_size",7630562360,"orgData",{"_91":92,"_93":94,"_95":96,"_97":33,"_98":99,"_100":101,"_102":99,"_103":104,"_105":106,"_107":108,"_109":110,"_111":110,"_112":21},"id","2abccdcb15714598b4a43d8d3c1b31bf","uuid","2abccdcb-1571-4598-b4a4-3d8d3c1b31bf","type","organization","orgname","full_name","FIWARE","location","Europe","company","profile_url","http://fiware.org/","date_joined","2015-04-23T00:06:18.052957Z","gravatar_url","https://www.gravatar.com/avatar/3a391cc62ad420936326f24df7d83fc6?s=80&r=g&d=mm","gravatar_email","","badge","is_active","recentTags",[115,151],{"_116":44,"_117":118,"_119":120,"_91":121,"_122":123,"_50":140,"_141":118,"_142":33,"_143":56,"_57":144,"_145":146,"_147":131,"_148":140,"_149":66,"_150":21},"content_type","creator",282933,"full_size",1119740957,1925346,"images",[124],{"_125":126,"_127":128,"_129":110,"_130":131,"_132":133,"_134":110,"_135":110,"_136":-5,"_137":138,"_63":66,"_139":-5},"architecture","amd64","digest","sha256:bdd3701b7db79690e77f4491c6aad15080d2a28340eb8895adf47a23a203ba20","features","last_pulled","2026-10-01T00:06:32.31790648Z","last_pushed","2016-04-13T15:18:57Z","os","os_features","os_version","size",1119741053,"variant","2016-04-13T15:18:56.96905Z","last_updater","last_updater_username","media_type","latest","repository",513904,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_116":44,"_117":118,"_119":152,"_91":153,"_122":154,"_50":160,"_141":118,"_142":33,"_143":56,"_57":161,"_145":146,"_147":157,"_148":160,"_149":66,"_150":21},1115690709,1924877,[155],{"_125":126,"_127":156,"_129":110,"_130":157,"_132":158,"_134":110,"_135":110,"_136":-5,"_137":159,"_63":66,"_139":-5},"sha256:95c17a18399c0b252c48335107751b6812e901c987329c5199230d8811030a3b","2026-09-17T07:13:02.863828086Z","2016-02-05T09:21:25Z",1115690805,"2016-02-05T09:21:24.610283Z","0.2.2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":175,"_182":183,"_169":195,"_196":11},{"_40":176,"_42":177,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":178,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":179,"_80":21,"_81":181,"_86":33,"_87":88},[],[44],[56],{"_76":11,"_77":180},[79],{"_83":21,"_84":11,"_85":11},"tags",{"_184":62,"_185":-5,"_186":-5,"_187":188},"count","next","previous","results",[189,192],{"_116":44,"_117":118,"_119":120,"_91":121,"_122":190,"_50":140,"_141":118,"_142":33,"_143":56,"_57":144,"_145":146,"_147":131,"_148":140,"_149":66,"_150":21},[191],{"_125":126,"_127":128,"_129":110,"_130":131,"_132":133,"_134":110,"_135":110,"_136":-5,"_137":138,"_63":66,"_139":-5},{"_116":44,"_117":118,"_119":152,"_91":153,"_122":193,"_50":160,"_141":118,"_142":33,"_143":56,"_57":161,"_145":146,"_147":157,"_148":160,"_149":66,"_150":21},[194],{"_125":126,"_127":156,"_129":110,"_130":157,"_132":158,"_134":110,"_135":110,"_136":-5,"_137":159,"_63":66,"_139":-5},[],"canDeleteTags","actionData","errors"]

fiware/md2pdf

Tags for fiware/md2pdf