{"id":23415775,"url":"https://github.com/jacobwhall/plaited","last_synced_at":"2026-05-07T11:32:18.979Z","repository":{"id":65807262,"uuid":"413610587","full_name":"jacobwhall/plaited","owner":"jacobwhall","description":"Pandoc filter for publishing code notebooks","archived":false,"fork":false,"pushed_at":"2023-02-28T02:10:42.000Z","size":2238,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"trunk","last_synced_at":"2025-04-06T04:13:58.927Z","etag":null,"topics":["jupyter","pandoc","pandoc-filter","reproducible-research"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jacobwhall.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10-04T23:17:31.000Z","updated_at":"2023-02-11T06:22:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"f8c90c9c-8c82-4fc0-ab96-2b19efe3ded5","html_url":"https://github.com/jacobwhall/plaited","commit_stats":{"total_commits":458,"total_committers":3,"mean_commits":"152.66666666666666","dds":"0.14410480349344978","last_synced_commit":"bec544ea4ce2f005a20995c1bff5e5492302bfd1"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacobwhall%2Fplaited","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacobwhall%2Fplaited/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacobwhall%2Fplaited/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacobwhall%2Fplaited/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jacobwhall","download_url":"https://codeload.github.com/jacobwhall/plaited/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247988686,"owners_count":21029139,"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":["jupyter","pandoc","pandoc-filter","reproducible-research"],"created_at":"2024-12-22T21:28:05.196Z","updated_at":"2026-05-07T11:32:13.929Z","avatar_url":"https://github.com/jacobwhall.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plaited 🪢\n[![build](https://github.com/jacobwhall/plaited/actions/workflows/test-with-coverage.yml/badge.svg)](https://github.com/jacobwhall/plaited/actions/workflows/test-with-coverage.yml)\n[![Coverage Status](https://coveralls.io/repos/github/jacobwhall/plaited/badge.svg?branch=trunk)](https://coveralls.io/github/jacobwhall/plaited?branch=trunk)\n\nplaited is a [Pandoc](https://pandoc.org/) [filter](https://pandoc.org/filters.html) that uses [Jupyter](https://jupyter.org/) [kernels](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels) to generate code notebooks.\nIt's a flexible tool for publishing documents that include code execution in a variety of languages and formats.\nIt is a fork of [Knitty](https://github.com/kiwi0fruit/knitty), which is a fork of [Stitch](https://github.com/pystitch/stitch), which used code from [knitpy](https://github.com/jankatins/knitpy) and [nbconvert](https://github.com/jupyter/nbconvert).\n\n## Installation\n\nplaited is available on PyPI:\n\n```\npip install plaited\n```\n\nI will publish it to PyPI once it is more mature.\n\n## Getting Started\n\nplaited is plug-and-play with Pandoc:\n\n```bash\npandoc --filter plaited -o out.html input.md\n```\n\n## Motivation\n\n_Why another code notebook generator?_\n\nUltimately, plaited is a personal project that I work on for my own benefit.\nAfter reading about Codebraid, Stitch, and Knitty, I wanted a similar tool that meets the following criteria:\n\n### Pandoc filter\n\n- embrace Pandoc AST, allowing other filters, templates, or Pandoc itself to make any formatting decisions\n- use [Panflute](https://github.com/sergiocorreia/panflute) to manage document elements\n\n### Jupyter client\n\n- embrace [Jupyter kernels](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels) as the means of code execution\n- use [Jupyter Client](https://github.com/jupyter/jupyter_client) to interface with the kernels\n\n### modern Python package\n\n- aim to write hackable, maintainable code\n- use modern setuptools configuration\n\n## Contributing\n\nYou are more than welcome to submit a pull request to this repository, or open an issue, or send me an email…I'd love to hear from you!\n\n## Thanks\n\nplaited builds upon the work of hundreds of people! Here are a handful of them:\n\n- [John MacFarlane](https://johnmacfarlane.net/) and other contributors to [Pandoc](https://pandoc.org/)\n- [Sergio Correia](http://scorreia.com/) and other contributors to [Panflute](https://github.com/sergiocorreia/panflute)\n- [Tom Augspurger](https://github.com/TomAugspurger), who wrote [Stitch](https://github.com/pystitch/stitch)\n- [Peter Zagubisalo](https://github.com/kiwi0fruit), who created [Knitty](https://github.com/kiwi0fruit/knitty)\n- [Jan Katins](https://www.katzien.de/en/), who wrote [knitpy](https://github.com/jankatins/knitpy)\n\nSimilar tools that influenced this project:\n\n- [Knitr](https://yihui.org/knitr/) by [Yihui Xie](https://yihui.org/)\n- [Codebraid](https://github.com/gpoore/codebraid) by [Geoffrey M. Poore](https://gpoore.github.io/)\n- [pandoc-plot](https://laurentrdc.github.io/pandoc-plot/) by [Laurent P. René de Cotret](https://laurentrdc.xyz/)\n- [Jupyter Book](https://jupyterbook.org/intro.html)\n\n## License\n\nThere seems to have been a misunderstanding by previous developers of this project regarding license compatibility.\n[Stitch](https://github.com/pystitch/stitch) and [Knitty](https://github.com/kiwi0fruit/knitty), by Tom Augspurger and Peter Zagubisalo respectively, were released using the [MIT License](https://en.wikipedia.org/wiki/MIT_License).\nTheir code is adapted from the [knitpy](https://github.com/jankatins/knitpy) and [IPython](https://github.com/ipython/ipython) projects, both released under BSD licenses.\nI am not a lawyer, but I do not believe that BSD licenses are compatible with the MIT license.\nI hope that by relicensing this project under the Modified (3-Clause) BSD License, work by all prior contributors is being used according to their original licenses.\nThis is not legal advice, and I welcome any feedback regarding the licensure of this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacobwhall%2Fplaited","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjacobwhall%2Fplaited","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacobwhall%2Fplaited/lists"}