From 6bc96b0bb54face579c0c68c40516bf83bcda82b Mon Sep 17 00:00:00 2001 From: thmsdt Date: Wed, 16 Jun 2021 23:06:45 -0700 Subject: Update "Setup of a Documentation Development System" Issue-ID: DOC-746 Signed-off-by: thmsdt Change-Id: Ibe5e922a1da0dc4744296ae5bad1f693dffcd1cf --- .../setup-of-a-doc-dev-system.rst | 54 +++++++++++----------- 1 file changed, 27 insertions(+), 27 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 bdbc84383..2c7d0a3dc 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 8.0.0 (Honolulu) - 1.0.0 (Amsterdam) Last Review/Update - 06/02/2021 + 06/17/2021 Initial Release 05/12/2021 @@ -322,8 +322,8 @@ installed applications are up to date. ------------------------------------------------------------------------------- -Clone example repo and start VSC (no LF account) -================================================ +Clone example repo (no LF account) +================================== Clone repo ---------- @@ -336,23 +336,10 @@ Linux Foundation (LF) account with ... cd ~/environments/onapdocs git clone --branch master https://git.onap.org/doc/ ./doc -Start VSC ---------- - -Start VSC in the ``doc`` repo directory with ... - -.. code-block:: bash - - cd doc - code . - -.. tip:: ``~/environments/onapdocs/doc`` is now your ``${workspaceFolder}`` - because you have started VSC (``code``) from here! - ------------------------------------------------------------------------------- -Clone example repo and start VSC (LF account used) -================================================== +Clone example repo (LF account used) +==================================== Prerequisite configuration -------------------------- @@ -386,18 +373,22 @@ Clone repo cd ~/environments/onapdocs git clone --recurse-submodules ssh://@gerrit.onap.org:29418/doc -Start VSC ---------- +------------------------------------------------------------------------------- + +Start VSC in the correct directory +================================== -Start VSC in the ``doc`` repo directory with ... +Start VSC (always) in the ``docs`` directory of your repository. For the +``doc`` repository used in this example do this with ... .. code-block:: bash cd doc + cd docs code . -.. tip:: ``~/environments/onapdocs/doc`` is now your ``${workspaceFolder}`` - because you have started VSC (``code``) from here! +.. tip:: ``~/environments/onapdocs/doc/docs`` is now your + ``${workspaceFolder}`` because you have started VSC (``code .``) from here! ------------------------------------------------------------------------------- @@ -481,10 +472,14 @@ Open a .rst file and preview it in VSC Open .rst file -------------- -Select :guilabel:`View` > :guilabel:`Explorer`. Alternatively you can use the -|FileExpl| symbol in the upper left corner. Expand the ``docs`` folder by -clicking on the ``>`` symbol. Select the file ``index.rst``. The code shows up -in the right pane window of VSC. +Select :guilabel:`View` > :guilabel:`Explorer`. Or use the |FileExpl| symbol in +the upper left corner. Expand the ``docs`` folder by clicking on the ``>`` +symbol. Select the file ``index.rst``. The code shows up in the right pane +window of VSC. + +Alternatively you can open this guide and see how it looks like in the +reStructuredText format. It can be found in ``docs/guides/onap-documentation`` +and is named ``setup-of-a-doc-dev-system.rst``. Problem Window -------------- @@ -640,6 +635,11 @@ reStructuredText - `reStructuredText and Sphinx Cheat Sheet II `__ - `Online reStructuredText Editor `__ +Sphinx +------ + +- `Sphinx Documentation Generator `__ + Ubuntu ------ -- cgit 1.2.3-korg