Skip to content

Instantly share code, notes, and snippets.

@gimbo
Created September 17, 2021 14:27
Show Gist options
  • Save gimbo/eaf89ec1dd17088ff241ceede37b54b6 to your computer and use it in GitHub Desktop.
Save gimbo/eaf89ec1dd17088ff241ceede37b54b6 to your computer and use it in GitHub Desktop.
Notes on creating a Dash docset for openpyxl

Notes on creating a Dash docset for openpyxl

  • Dash is a documentation reader for MacOS
  • openpyxl is a python library for working with XLSX files

openpyxl has pretty good docs prepared using sphinx, though they can be hard to navigate.

Using Dash makes that easier for me, so here's how to create a Dash docset for openpyxl, using the doc2dash tool; by default this will install it directly into Dash, but see doc2dash's documentation for more options.

mkdir openpyxl__for_dash_docset
cd openpyxl__for_dash_docset
hg clone https://foss.heptapod.net/openpyxl/openpyxl
cd openpyxl
hg up 3.0.8  # Or whatever
python3 -m venv .venv && source .venv/bin/activate
pip install -U -r requirements.txt
pip install -e .
tox -e doc
pip install doc2dash
doc2dash -A -f -j -n openpyxl -I index.html -u https://openpyxl.readthedocs.io/en/stable .tox/doc/tmp/html
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment