gitpub-py 1.1

A collaborative web to print tool based on the git version control software

GitPub

GitPub creates a printable publication from a Git repositories text files, including file metadata.

Installing

to install, run pip install gitpub-py

Requirements

• pandoc (see installing pandoc)
• python
• pip

Usage

1. to use, run make-gitpub
2. enter an absolute path to a local git repository
3. enter filetypes that you want to include (supported are .md .html)
4. for detailed description of further options see repository
5. preview the generated gitpub.html file in your browser
6. press cmd + p to print or export to pdf

Environment

GitPub is inspired by and learning from many tools and communities that understand the use, modification and distribution of software as active part of creative, collaborative practices:

• Creative Crowds
• Pre Post Print
• Experimental Publishing
• Constant
• OSP
• Hackers & Designers

GitPub uses:

• Pandoc to convert documents (2006–2025 John MacFarlane)
• the Jinja templating engine (2007 Pallets)
• the PyDriller framework to analyze git repositories (2018 Davide Spadini)
• Paged.js to create a paginated pdf preview from an html document (Adam Hyde, maintained by julientaq, Fred Chasen and Gijs de Heij)
  • paralell-flows (modfied) a paged.js plugin to define parallel layouts

License

Kim Kleinert, GitPub, 2026.
Copyleft with a difference: This is a collective work, you are invited to copy, distribute, and modify it under the terms of the CC4r.