2013-05-09 20:27:12 +01:00
|
|
|
Documentation
|
|
|
|
=============
|
|
|
|
|
|
|
|
The jq website, manpages and some of the tests are generated from this
|
2019-02-20 20:50:08 -05:00
|
|
|
directory. The manual is a YAML file in `content/manual`.
|
2013-05-09 20:27:12 +01:00
|
|
|
|
|
|
|
To build the documentation (including building the jq manpage), you'll
|
2019-02-20 20:50:08 -05:00
|
|
|
need python3 and pipenv. You can install pipenv like so:
|
2013-05-09 20:27:12 +01:00
|
|
|
|
2019-02-20 20:50:08 -05:00
|
|
|
pip install pipenv
|
2013-05-09 20:27:12 +01:00
|
|
|
|
2019-02-20 20:50:08 -05:00
|
|
|
Though, you may need to say pip3 instead, depending on your system. Once
|
|
|
|
you have pipenv installed, you can install the dependencies by running
|
|
|
|
`pipenv install` from the `docs` directory.
|
2013-05-09 20:27:12 +01:00
|
|
|
|
2019-02-20 20:50:08 -05:00
|
|
|
Once this is done, rerun `./configure` in the jq root directory and then
|
|
|
|
the Makefile will be able to generate the jq manpage.
|
2013-05-09 20:27:12 +01:00
|
|
|
|
2019-02-20 20:50:08 -05:00
|
|
|
To build the website, run `pipenv run ./build_website.py` from inside
|
|
|
|
the `docs` directory.
|