41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# zsh-manual-mdbook
|
|
|
|
This is a markdown version of the [Zsh Manual](http://zsh.sourceforge.net/Doc/).
|
|
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](https://rust-lang.github.io/mdBook/) version is easier to browse and is more
|
|
aesthetically satisfying.
|
|
|
|
## Running/testing a local version
|
|
|
|
```bash
|
|
# 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
|
|
```
|