Hugohong258andHugohong258
1b4109b0d0
State explicitly in the README and download page that the platform-specific prebuilt files are standalone executables, not archives. Include the rename and executable-permission step for macOS and Linux in the README. Addresses #2956. Source archives are not described as executables. Validation: the official `docs/build_website.py` completed and the generated download page contains the new guidance. Used a Python venv with the site's required rendering packages; restored the Windows checkout's manual symlink in a temporary build copy only. jq itself was not built or tested for this documentation-only change. Co-authored-by: Hugohong258 <282228220+Hugohong258@users.noreply.github.com>
Documentation
The jq website, manpages and some of the tests are generated from this
directory. The manual is a YAML file in content/manual.
To build the documentation (including building the jq manpage), you'll
need python3 and pipenv. You can install pipenv like so:
pip install pipenv
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 sync from the docs/ directory.
Also, you may need to run virtualenv -p /usr/bin/python3 venv/ and
then source venv/bin/activate, and only then pipenv sync.
Once this is done, rerun ./configure --enable-docs in the jq root directory and then
the Makefile will be able to generate the jq manpage. You can just run
make jq.1 to build the manpage manually, and make tests/man.test to
update the manual tests.
To build the website, run pipenv run python3 build_website.py in the docs/ directory.
To serve them locally, you can run python3 -m http.server -d output.