diff options
| author | OpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com> | 2022-09-16 09:41:53 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-09-16 09:41:53 +0200 |
| commit | 0e3a0ec7d485a81b7ca38997e93bea69ad95d79a (patch) | |
| tree | 9a7e58d1bccf9346f0fe9c79de5480cc67f6dabf /docs/README.md | |
| parent | a8a56b188ca0c929dbf409b41dfef4f50e19fb30 (diff) | |
| parent | e2573b734efa17c476afac54a98c50aac62cb5c6 (diff) | |
| download | podman-0e3a0ec7d485a81b7ca38997e93bea69ad95d79a.tar.gz podman-0e3a0ec7d485a81b7ca38997e93bea69ad95d79a.tar.bz2 podman-0e3a0ec7d485a81b7ca38997e93bea69ad95d79a.zip | |
Merge pull request #15825 from edsantiago/fix_readthedocs
[CI:DOCS] Fix broken titles on readthedocs
Diffstat (limited to 'docs/README.md')
| -rw-r--r-- | docs/README.md | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/docs/README.md b/docs/README.md index 0f2af16d6..abe7d7758 100644 --- a/docs/README.md +++ b/docs/README.md @@ -13,7 +13,6 @@ link on that page. | ------------------------------------ | --------------------------- | | Markdown source for man pages | docs/source/markdown/ | | man pages aliases as .so files | docs/source/markdown/links/ | -| restructured text for readthedocs.io | docs/rst/ | | target for output | docs/build | | man pages | docs/build/man | | remote linux man pages | docs/build/remote/linux | @@ -60,16 +59,24 @@ incorrect, or the file isn't accessible for some other reason. ## Local Testing -Assuming that you have the [dependencies](https://podman.io/getting-started/installation#build-and-run-dependencies) +To build standard man pages, run `make docs`. Results will be in `docs/build/man`. + +To build HTMLized man pages: Assuming that you have the +[dependencies](https://podman.io/getting-started/installation#build-and-run-dependencies) installed, then also install (showing Fedora in the example): ``` -# dnf install python3-sphinx python3-recommonmark -# pip install sphinx-markdown-tables +$ sudo dnf install python3-sphinx python3-recommonmark +$ pip install sphinx-markdown-tables myst_parser ``` +(The above dependencies are current as of 2022-09-15. If you experience problems, +please see [requirements.txt](requirements.txt) in this directory, it will almost +certainly be more up-to-date than this README.) + After that completes, cd to the `docs` directory in your Podman sandbox and then do `make html`. You can then preview the html files in `docs/build/html` with: ``` python -m http.server 8000 --directory build/html ``` +...and point your web browser at `http://localhost:8000/` |