Mdbook for Zsh Manual

Go to file

Jeffrey Serio 249397b5ed Update README.md		2021-05-17 13:55:48 -05:00
zsh_guide	Add User Guide	2021-05-17 10:18:05 -05:00
zsh_manual	Add User Guide	2021-05-17 10:18:05 -05:00
gen_summ_manual.py	Add User Guide	2021-05-17 10:18:05 -05:00
make_mdbook.sh	Add User Guide	2021-05-17 10:18:05 -05:00
README.md	Update README.md	2021-05-17 13:55:48 -05:00
requirements.txt	Initial commit	2021-05-10 19:29:21 -05:00

README.md

zsh-manual-mdbook

Zsh Manual

Zsh User's Guide by Peter Stephenson

This is a markdown version of the Zsh Manual. It is generated with a Bash script that removes some non-markdown-friendly elements and converts the .html files to markdown using Pandoc. The SUMMARY.md is generated with a Python script that scrapes the web page of the Zsh Manual's table of contents.

The scripts contained in this repository are highly specialized for this use-case and do not scale to anything else, but I've tried to make them as abstract as possible, so they should work on anything with the same HTML structure.

Why not just use the plain old Zsh Manual?

An mdbook version is easier to browse and is more aesthetically satisfying.

Running/testing a local version

# Ensure mdbook is installed
cargo install mdbook

# Clone this repository
git clone https://github.com/hyperreal64/zsh-manual-mdbook

# Install Python dependencies
cd zsh-manual-mdbook
pip install -r requirements.txt

# Ensure DocToc is installed
sudo npm -g install doctoc

# Return to repository clone and run the make-mdbook script
./make-mdbook.sh

# Serve locally
mdbook serve