bookit

Doc site generator


Overview

This Python program converts all files in a Git repository to markdown files. It's useful for creating doc sites of your code.

The converted markdown files are placed in a

.bookit

subdirectory. The directory structure inside

.bookit

is an exact mirror of the original repository.

Usage

python -m bookit /path/to/your/repo

How it works

Each file is converted into a markdown file, with the file name being the

#title

of the markdown file and the contents of the original file placed inside a code block, highlighted according to the original file's language.

Here's an example of the directory structure transformation:

Before:

repo/
├── README.md
├── file1.py
├── file2.js

After:

repo/
├── .bookit/
│ ├── file1.py.md
│ └── file2.py.md
├── README.md
├── file1.py
└── file2.js

DEV

Setup

make install

This will setup a virtualenv, upgrade pip, install dependencies, and install pre-commit

note: This does not activate your virtualenv! You must run

source env/bin/activate

to use the venv.

Test

make test

Format

make format

make lint

Version & Release

make version-<major/minor/patch>

make release

note Don't forget to

git push

with

--tags

pre-commit

Setup

make install-pre-commit

Run all

make pre-commit