{"id":19299999,"url":"https://github.com/cloudogu/docker-doc_template","last_synced_at":"2026-01-29T03:39:11.351Z","repository":{"id":41817274,"uuid":"100424410","full_name":"cloudogu/docker-doc_template","owner":"cloudogu","description":"An example for generating PDF from Markdown with cloudogu/pandoc container","archived":false,"fork":false,"pushed_at":"2022-07-28T10:06:40.000Z","size":4153,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":13,"default_branch":"develop","last_synced_at":"2025-01-05T22:42:03.757Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/cloudogu/doc_template/","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudogu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-15T22:29:10.000Z","updated_at":"2022-04-28T07:57:18.000Z","dependencies_parsed_at":"2022-09-04T19:31:10.487Z","dependency_job_id":null,"html_url":"https://github.com/cloudogu/docker-doc_template","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudogu%2Fdocker-doc_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudogu%2Fdocker-doc_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudogu%2Fdocker-doc_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudogu%2Fdocker-doc_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudogu","download_url":"https://codeload.github.com/cloudogu/docker-doc_template/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240401345,"owners_count":19795532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T23:13:23.534Z","updated_at":"2026-01-29T03:39:06.315Z","avatar_url":"https://github.com/cloudogu.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](resources/images/markdown-pdf.png)\n\n# Cloudogu doc_template\n\n[![](https://images.microbadger.com/badges/image/cloudogu/doc_template.svg)](https://hub.docker.com/r/cloudogu/doc_template/)\n[![](https://images.microbadger.com/badges/version/cloudogu/doc_template.svg)](https://hub.docker.com/r/cloudogu/doc_template/)\n\n## About this Repository\n\n**Name:** cloudogu/doc_template\n\n**Description** A docker container for generating a PDF with Cloudogu Corporate Design from markdown files.\n\n## Requirements\n\n- Docker [https://www.docker.com/get-docker](https://www.docker.com/get-docker)\n\n## Using the Container\n\n1. Build container with `docker build . -t cloudogu/doc_template`\n2. \n   1. Navigate to a folder that contains markdown file(s)\n   2. Generate a PDF: `docker run -v $(pwd):/data cloudogu/doc_template *.md \u003cTemplate-Name\u003e` in a directory with Markdown\n      files (Use [Panddoc Markdown](http://pandoc.org/MANUAL.html#pandocs-markdown) syntax). The Template can be specified\n      since version 0.22.0. There are currently two templates `cloudogu` and `itz-bund`, the default template is `cloudogu`.\n   3. The finished .pdf will reside in the current folder and is called `document.pdf`.\n\n   Example:     \n   \u003e docker run -v $(pwd):/data cloudogu/doc_template Benutzerdoku_Projektvorlageagil.md itz-bund\n3. Result inside the project root: `document.pdf`\n\n## Features\n\n- Add a title page\n\nSyntax:\n\n```\n% Testpage\n% Cloudogu EcoSystem\n```\n\nEnhanced meta data format:\n\n```\n---\ntitle:  'Testpage'\nauthor:\n- \"Cloudogu GmbH\"\nversion: '1.0'\ndate: '23.01.2021' \n...\n```\n\n- Syntax highlighting\n\n- PlantUml\n\n- Tables\n\n- Long sequences\n\n`\\seqsplit{...abc...}`\n\nSee [sample.md](resources/sample/sample.md) for more information.\n\nOr [sample.pdf](resources/sample/sample.pdf) for the converted pdf.\n\n## Debugging\n\n* Add `--verbose` before the file parameter, like so: `docker run -v $(pwd):/data cloudogu/doc_template --verbose *.md`\n\n## Release\n\nBefore release of this tool, update and release the submodules and update them here with `git submodule update --remote --merge`\n(if you have trouble here, make sure the itz-bund sub-repo's branch is set to the prior released master branch).\nAfter this just create a regular git-flow release in the docker-doc_template.\n\n### Release on [Nexus registry](https://ecosystem.cloudogu.com/nexus/?ticket=ST-483-grh-sru8yBb5vuAwKCkW-EiS4Ww-cas#browse/browse:docker-registry:v2%2Fcloudogu)\nLogin `docker login ecosystem.cloudogu.com`, login via credentials from ecosystem.\n`docker build -t ecosystem.cloudogu.com/cloudogu/markdown_doc_template:\u003cversion\u003e .`\n\n`docker push ecosystem.cloudogu.com/cloudogu/markdown_doc_template:\u003cversion\u003e`\n\n### Release in [Docker registry](https://hub.docker.com/repository/docker/cloudogu/doc_template)\n\n`docker build -t cloudogu/doc_template:\u003cversion\u003e .`\n\n`docker push cloudogu/doc_template:\u003cversion\u003e`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudogu%2Fdocker-doc_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudogu%2Fdocker-doc_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudogu%2Fdocker-doc_template/lists"}