mhansen / docs-2

Beancount Documentation.

Beancount Documentation

https://beancount.github.io/docs/

Source files are in docs directory.

These documents in markdown format are automatically generated from official Beancount documentation.

Beancount Google Doc converter

Installation

The converter requires python 3.6 or newer.

Create virtualenv (recommended):

python3 -m venv venv
. venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Usage

Export and convert single document:

# Export google document as docx file
python export.py document "100tGcA4blh6KSXPRGCZpUlyxaRUwFHEvnz_k9DyZFn4" doubleentry.docx
# Export drawings
python export.py drawings "100tGcA4blh6KSXPRGCZpUlyxaRUwFHEvnz_k9DyZFn4" drawings
# Convert docx file to markdown
python export.py convert doubleentry.docx doubleentry.md --drawing-dir=drawings

Export and convert all documents:

python crawl.py

Documentation website

Generate static website using MkDocs:

python build.py serve

Deploy to GitHub pages:

python build.py gh-deploy