From 92906994d4eab62ac3521a84571e5a5b658e76e6 Mon Sep 17 00:00:00 2001 From: thmsdt Date: Thu, 20 Oct 2022 08:49:43 +0200 Subject: [PATCH] fix (some) issues in guide Issue-ID: DOC-798 Signed-off-by: thmsdt Change-Id: Iaee2a764d1c4ee001b6590f01779f4aa5fa15d66 --- .../setup-of-a-doc-dev-system.rst | 52 ++++++++++------------ 1 file changed, 24 insertions(+), 28 deletions(-) diff --git a/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst b/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst index 49615f46e..0e3abf2ce 100644 --- a/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst +++ b/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst @@ -42,7 +42,7 @@ Release Relevance 11.x.x (Kohn) Last Review/Update - 2022/10/18 + 2022/10/20 Initial Release 2021/12/05 @@ -247,7 +247,7 @@ Install python3 related packages with ... libssl-dev \ libffi-dev \ python3-dev \ - python3-virtualenv + python3-venv Check the python3 version with ... @@ -372,7 +372,7 @@ the virtual environment ``onapdocs`` is created. The full path is consequently .. .. code-block:: bash - + cd ~ mkdir environments cd ~/environments @@ -444,15 +444,15 @@ your terminal has changed. Now it starts with ``(onapdocs)``. .. .. code-block:: bash - - pip3 install wheel \ - sphinxcontrib-spelling \ - pyenchant - + + pip install wheel \ + sphinxcontrib-spelling \ + pyenchant + .. code-block:: bash - sudo pip3 install wheel + pip install wheel Continue with the installation of required packages. Use the file @@ -461,7 +461,7 @@ repository. .. code-block:: bash - sudo pip3 install -r doc/etc/requirements-docs.txt + pip install -r doc/etc/requirements-docs.txt ------------------------------------------------------------------------------- @@ -549,25 +549,15 @@ extension press :guilabel:`Manage` (the little |GearSymb| symbol on the right bottom) and select :guilabel:`Extension Settings`. A new windows in VSC shows all the parameters. -We need to change values for ... - -.. list-table:: - :header-rows: 0 +Values for the following parameters need to be changed: - * - Restructuredtext › Linter › Doc8: Executable Path - - Points to doc8 executable - * - Restructuredtext › Linter › Rst-lint: Executable Path - - Points to doc8 executable - * - Restructuredtext › Linter › Rstcheck: Executable Path - - Points to doc8 executable - * - Esbonio › Sphinx: Build Dir - - Directory to store Sphinx's build output - * - Esbonio › Sphinx: Conf Dir - - Directory containing 'conf.py' file - * - Esbonio › Sphinx: Src Dir - - Directory containing rst source files - * - Restructuredtext: Styles - - Paths to CSS style sheets for preview +- Restructuredtext › Linter › Doc8: Executable Path +- Restructuredtext › Linter › Rst-lint: Executable Path +- Restructuredtext › Linter › Rstcheck: Executable Path +- Esbonio › Sphinx: Build Dir +- Esbonio › Sphinx: Conf Dir +- Esbonio › Sphinx: Src Dir +- Restructuredtext: Styles .. important:: Ensure that you are changing parameters in :guilabel:`User` @@ -770,6 +760,12 @@ Install this simple editor with ... sudo apt install -y retext +Ubuntu Restricted Extras +------------------------ + +If you experience problems during playback of some audio or video formats on +your system, please check the ``ubuntu-restricted-extras`` package. + ------------------------------------------------------------------------------- Helpful Resources -- 2.16.6