khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-02 17:59:36 +07:00
Code Issues Packages Projects Releases Wiki Activity

Fix RST syntax in readme file

Browse Source 
Signed-off-by: Joas Schilling <213943+nickvergessen@users.noreply.github.com>
This commit is contained in:
Joas Schilling
2023-03-08 11:24:04 +01:00
committed by GitHub
parent 3bc39af017
commit 72eac1b63b
1 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
README.rst
View File

@@ -109,30 +109,30 @@ Building
Building HTML
=============
1. Install `pipenv` - https://pipenv.readthedocs.io/en/latest/
2. Create a Python environment (typically inside this repository): `pipenv --python 3.9`
3. Change into the environment: `pipenv shell`
4. Install the dependencies `pip install -r requirements.txt`
5. Now you can use `make ...` to build all the stuff - for example `make html` to build the HTML flavor of all manuals
1. Install ``pipenv`` - https://pipenv.readthedocs.io/en/latest/
2. Create a Python environment (typically inside this repository): ``pipenv --python 3.9``
3. Change into the environment: ``pipenv shell``
4. Install the dependencies ``pip install -r requirements.txt``
5. Now you can use ``make ...`` to build all the stuff - for example ``make html`` to build the HTML flavor of all manuals
To change into this environment you need to run `pipenv shell` to launch the shell and to exit you can use either `exit` or `Ctrl` + `D`.
To change into this environment you need to run `pipenv shell` to launch the shell and to exit you can use either ``exit`` or ``Ctrl`` + ``D``.
When editing the documentation installing `sphinx-autobuild` though pip can be helpful. This will watch file changes and automatically reload the html preview:
1. Install `pip install sphinx-autobuild`
2. Enter the documentation section `cd user_manual`
3. Watch for file changes `make SPHINXBUILD=sphinx-autobuild html`
1. Install ``pip install sphinx-autobuild``
2. Enter the documentation section ``cd user_manual``
3. Watch for file changes ``make SPHINXBUILD=sphinx-autobuild html``
4. Open http://127.0.0.1:8000 in the browser and start editing
Building PDF
============
1. Follow instructions for "Building HTML" above
2. Install `latexmk` and `texlive-latex-extra` - https://pipenv.readthedocs.io/en/latest/
3. Create a Python environment (typically inside this repository): `pipenv --python 3.9`
4. Change into the environment: `pipenv shell`
5. Install the dependencies `pip install -r requirements.txt`
6. Now you can use `make ...` to build all the stuff - for example `make pdf` to build the PDF flavor of all manuals
2. Install ``latexmk`` and ``texlive-latex-extra`` - https://pipenv.readthedocs.io/en/latest/
3. Create a Python environment (typically inside this repository): ``pipenv --python 3.9``
4. Change into the environment: ``pipenv shell``
5. Install the dependencies ``pip install -r requirements.txt``
6. Now you can use ``make ...`` to build all the stuff - for example ``make pdf`` to build the PDF flavor of all manuals
Using the VSCode DevContainer
=============================