diff options
author | Micah Lee <micah@micahflee.com> | 2020-10-13 17:28:54 -0700 |
---|---|---|
committer | Micah Lee <micah@micahflee.com> | 2020-10-13 17:28:54 -0700 |
commit | b42f92d714145dcc6282773e61f68c00b4b79a28 (patch) | |
tree | ee4443ab3c5300db279a3cf0686380074d98c973 /docs/README.md | |
parent | f4abcf1be9122a28005dc3e0949bf5952192e982 (diff) | |
download | onionshare-b42f92d714145dcc6282773e61f68c00b4b79a28.tar.gz onionshare-b42f92d714145dcc6282773e61f68c00b4b79a28.zip |
Move docs back to root, move onionshare_gui into briefcase app, and make modifications so briefcase app will work
Diffstat (limited to 'docs/README.md')
-rw-r--r-- | docs/README.md | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 00000000..fe026802 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,38 @@ +# OnionShare Documentation + +All these commands must be run from the `docs` folder. + +You must have the python dependencies installed to build the docs: + +```sh +poetry install +``` + +To build HTML docs: + +```sh +poetry run make html +``` + +Then open `docs/build/html/index.html` in a browser to see it. + +To update all of the translations and build all the html, run: + +```sh +poetry run ./build.sh +``` + +You will end up with the documentation in all supported locales in `docs/localized_html`. + +Here's how preparing translations works: + +```sh +# Generate .po files in build/gettext +make gettext + +# Create a new blank German locale in source/locale, based on .po files +sphinx-intl update -p build/gettext -l de + +# Build German translated document +make -e SPHINXOPTS="-D language='de'" html +``` |