{"id":20140620,"url":"https://github.com/goffinet/pdf-rapport","last_synced_at":"2026-03-06T11:31:38.373Z","repository":{"id":116034408,"uuid":"423550845","full_name":"goffinet/pdf-rapport","owner":"goffinet","description":"A partir d'un document Markdown, obtenir un fichier en PDF ou DOCX de qualité scientifique en passant par Latex avec Pandoc, pour des rapports, pour des travaux de fin d'étude ou pour des supports de cours.","archived":false,"fork":false,"pushed_at":"2022-03-26T13:07:30.000Z","size":554,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-02T23:28:20.384Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goffinet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-01T17:11:29.000Z","updated_at":"2022-01-28T10:16:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"17e03807-6800-4606-bd45-ad778dc89991","html_url":"https://github.com/goffinet/pdf-rapport","commit_stats":null,"previous_names":[],"tags_count":1,"template":true,"template_full_name":null,"purl":"pkg:github/goffinet/pdf-rapport","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goffinet%2Fpdf-rapport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goffinet%2Fpdf-rapport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goffinet%2Fpdf-rapport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goffinet%2Fpdf-rapport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goffinet","download_url":"https://codeload.github.com/goffinet/pdf-rapport/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goffinet%2Fpdf-rapport/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30173694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-13T21:52:50.277Z","updated_at":"2026-03-06T11:31:38.330Z","avatar_url":"https://github.com/goffinet.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Objectif\n\nA partir d'un document Markdown, obtenir un fichier en PDF ou DOCX de qualité scientifique en passant par Latex avec Pandoc, pour des rapports, pour des travaux de fin d'étude ou pour des supports de cours.\n\n- Liste des :\n    - listing de codes,\n    - figures,\n    - tableaux,\n    - références bibliographiques.\n- Mermaid.\n- Mathjax.\n- Notes de bas de page.\n- Mise en page:\n    - book,\n    - report,\n    - article.\n\n## Documentation\n\n### External documentation\n\n- [Pandoc Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown)\n- [Crossref filter](https://github.com/lierdakil/pandoc-crossref/blob/master/docs/index.md)\n- [Pandoc Defaults file](https://pandoc.org/MANUAL.html#default-files)\n\n## Container\n\n### Github actions\n\nVoir `.github/workflows/main.yml` :\n\n```yaml\nname: Build document\non:\n  push:\n    branches: [ master ]\n  pull_request:\n    branches: [ master ]\n  workflow_dispatch:\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: goffinet/pandoc-latex@master\n        with:\n          args: \"-d defaults_pdf.yml\"\n      - uses: goffinet/pandoc-latex@master\n        with:\n          args: \"-d defaults_docx.yml\"\n      - uses: actions/upload-artifact@master\n        with:\n          name: rapport\n          path: output/*\n```\n\n### Exécution locale\n\n[Get Docker](https://get.docker.com/)\n\nVoir `Dockerfile`\n\nContainer to use `ghcr.io/goffinet/pandoc-latex:master` ([Pandoc Latex container image](https://github.com/goffinet/pandoc-latex))\n\n```bash\ndocker run -it -v $PWD:/data ghcr.io/goffinet/pandoc-latex:master -d defaults_pdf.yml\ndocker run -it -v $PWD:/data ghcr.io/goffinet/pandoc-latex:master -d defaults_docx.yml\n```\n\nWith more command line options:\n\n```bash\ndocker run -it -v $PWD:/data ghcr.io/goffinet/pandoc-latex:master --pdf-engine=xelatex --toc --citeproc -F mermaid-filter -F pandoc-crossref -V mainfont=\\\"Arial\\\" -V geometry:a4paper,margin=2cm -o output/rapport.pdf input/rapport.md\n```\n\n## Configuration\n\n### Configuration générale\n\nCheck `defaults_pdf.yml` file.\n\n```yaml\nffrom: markdown\nto: pdf\noutput-file: output/rapport.pdf\ninput-files:\n- input/rapport.md\nverbosity: INFO\npdf-engine: xelatex\nwrap: auto\ntable-of-contents: true\ntoc-depth: 4\nhighlight-style: haddock\nciteproc: false\nfilters:\n- mermaid-filter\n- pandoc-crossref\n- citeproc\n```\n\n### Confguration dans l'en-tête du document\n\n```yaml\ntitle: Rapport de travail\nsubtitle: Rendu intermédiaire\nabstract: |\n  Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\nkeywords: lorem, ipsum\nauthor:\n - \"*Rob Knell*\"\ndate: \\today\nlang: fr-FR\nmainfont: Arimo #Arial, Arimo, Time New Roman, Verdana\nmonofont: FreeMono # Courier New, FreeMono\nfontsize: 10pt\npapersize: a4\ngeometry: portrait, headheight=25pt, tmargin=25mm, bmargin=20mm, innermargin=20mm, outermargin=20mm\ndocumentclass: report # book, report, article\ntoc-title: Table des matières\ntoc-own-page: false\ntop-level-division: default # part, chapter, section, or default\nnumbersections: true\nsection-divs: false\ntitle-prefix: \"\"\nstrip-empty-paragraphs: true\nlistings: false\nbibliography:\n- input/bibliography.yaml\ncsl: parisdiderot\nheader-includes:\n# Multicols\n    - \\usepackage{multicol}\n    - \\newcommand{\\hideFromPandoc}[1]{#1}\n    - \\hideFromPandoc{\n        \\let\\Begin\\begin\n        \\let\\End\\end}\n# Define tiny codeblocks\n    - \\usepackage{framed}\n    - \\colorlet{shadecolor}{white}\n    - \\renewenvironment{Shaded} {\\begin{snugshade}\\normalsize} {\\end{snugshade}}\n# Links color\n    - \\usepackage{hyperref}\n    - \\hypersetup{colorlinks=true,linkcolor=black,urlcolor=blue}\n---\n```\n\n### Bibliographie\n\n- Fichier bibiliography.yaml\n- Fichier parisdiderot.csl\n\n```yaml\nreferences:\n- type: article-journal\n  id: WatsonCrick1953\n  author:\n  - family: Watson\n    given: J. D.\n  - family: Crick\n    given: F. H. C.\n  issued:\n    date-parts:\n    - - 1953\n      - 4\n      - 25\n  title: 'Molecular structure of nucleic acids: a structure for deoxyribose\n    nucleic acid'\n  title-short: Molecular structure of nucleic acids\n  container-title: Nature\n  volume: 171\n  issue: 4356\n  page: 737-738\n  DOI: 10.1038/171737a0\n  URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html\n  language: en-GB\n- type: webpage\n  id: cisco1\n  author:\n  - family: Goffinet\n    given: F.-E.\n  issued: 2021\n  title: Chiffement des mots de passes locaux en Cisco IOS\n  url: https://cisco.goffinet.org/ccna/gestion-infrastructure/chiffrement-des-mots-de-passes-locaux-cisco-ios/\n  accessed: 2021/09/24\n...\n```\n\n## Fonts\n\nDans le conteneur.\n\n```\nAndale Mono\nArial\nArial Black\nArimo\nComic Sans MS\nCourier New\nCousine\nFixed\nFreeMono\nFreeSans\nFreeSerif\nGeorgia\nImpact\nNoto Music\nNoto Nastaliq Urdu\nNoto Sans\nNoto Sans ...\nNoto Serif\nNoto Serif Ahom\nNoto Serif Balinese\nNoto Serif Display\nOpen Sans\nTerminus\nTimes New Roman\nTinos\nTrebuchet MS\nVerdana\nWebdings\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoffinet%2Fpdf-rapport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoffinet%2Fpdf-rapport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoffinet%2Fpdf-rapport/lists"}