summaryrefslogtreecommitdiffstats
path: root/sdnr/wt/readthedocs
diff options
context:
space:
mode:
authorHerbert Eiselt <herbert.eiselt@highstreet-technologies.com>2019-04-03 17:24:29 +0200
committerDan Timoney <dtimoney@att.com>2019-04-09 14:13:29 +0000
commit092189e83c4bd470b9232380dd1a33c63a035606 (patch)
tree5d296af1e01f79b0d05dd1fec29c3ba78229c54b /sdnr/wt/readthedocs
parent3ebc1c63fb2e5c62eb52da140cc326fbc271aab0 (diff)
SDN-R read2docs
Add docs folder and project with src Change-Id: I0299c5984c747a40a8dd1e3f79479b9e9d729d50 Issue-ID: SDNC-683 Signed-off-by: Herbert Eiselt <herbert.eiselt@highstreet-technologies.com>
Diffstat (limited to 'sdnr/wt/readthedocs')
-rw-r--r--sdnr/wt/readthedocs/README.md4
-rwxr-xr-xsdnr/wt/readthedocs/convert.sh31
-rw-r--r--sdnr/wt/readthedocs/src/home.rst34
-rw-r--r--sdnr/wt/readthedocs/src/index.rst14
4 files changed, 83 insertions, 0 deletions
diff --git a/sdnr/wt/readthedocs/README.md b/sdnr/wt/readthedocs/README.md
new file mode 100644
index 000000000..9613eab0f
--- /dev/null
+++ b/sdnr/wt/readthedocs/README.md
@@ -0,0 +1,4 @@
+SDNR/WT specific scripts to generate ReadTheDocs content
+
+docs - destination of documentation files to be placed in a SDNC repository
+sdnr/wt/readthedocs - scripts and scr data for creation of documentation. Other sources are located in related implementation directory
diff --git a/sdnr/wt/readthedocs/convert.sh b/sdnr/wt/readthedocs/convert.sh
new file mode 100755
index 000000000..5ab3d7576
--- /dev/null
+++ b/sdnr/wt/readthedocs/convert.sh
@@ -0,0 +1,31 @@
+#!/bin/bash
+
+BASEDIR=$(dirname "$0")"/../../../"
+PATH_HELPSERVER_RES=$BASEDIR"sdnr/wt/helpserver/provider/src/main/resources/help/"
+PATH_DOC_DST=$BASEDIR"docs/"
+PATH_DOC_USERDOC_DST=$PATH_DOC_DST"guides/onap-user/"
+
+echo "==================Find .md files in helpserver===================================="
+markdown_files=$(find $PATH_HELPSERVER_RES"sdnr" -type f -iname "*.md")
+echo "$markdown_files[@]"
+
+echo "=============Converting md to rst files=================================="
+for file in ${markdown_files[@]}; do
+ append_name=`echo "$file" | awk -F"/" '{print $(NF-1)}'`
+ f="$(basename -- $file)"
+ if [ "${f,,}" = "readme.md" ]; then
+ rstfile=$append_name".rst"
+ else
+ rstfile=${f%.md}".rst"
+ fi
+
+ echo "$file to $PATH_DOC_USERDOC_DST$rstfile"
+ pandoc -s --toc -f markdown -t rst $file > $PATH_DOC_USERDOC_DST"$rstfile"
+done
+
+cp -r "$BASEDIR"sdnr/wt/readthedocs/src/home.rst "$BASEDIR"docs/guides/onap-user/
+cp -r "$BASEDIR"sdnr/wt/readthedocs/src/index.rst "$BASEDIR"docs/
+
+echo "================Creating html=========================================="
+/usr/local/bin/sphinx-build -b html $PATH_DOC_DST /home/jack/public_html/sdnr-trial/
+
diff --git a/sdnr/wt/readthedocs/src/home.rst b/sdnr/wt/readthedocs/src/home.rst
new file mode 100644
index 000000000..cf8b19254
--- /dev/null
+++ b/sdnr/wt/readthedocs/src/home.rst
@@ -0,0 +1,34 @@
+
+.. contents::
+ :depth: 3
+..
+
+SDN controller for 'Radio' (SDN-R)
+==================================
+
+SDN-R adds features and functionality to the OpenDaylight-based ONAP
+controller 'SDN-C'. It is built on the Common Controller Framework to
+control and manage wireless resources. Wireless resources are virtual
+network functions (e.g. vBBU, vEPC) or physical network functions (e.g.
+microwave and millimeter wave radios, eNodeB, RRH, DAS equipment).
+
+| SDN-R is integrated into ONAP. Therefore it is interfacing with PNFs
+ and VNFs and with other ONAP components, such as A&AI, DCAE and SO.
+| `See abbreviations <abbreviations>`__
+
+.. figure:: ./ONAP-SDN-R.png
+ :alt: SDN-R in ONAP
+
+ SDN-R in ONAP
+
+
+.. toctree::
+ :maxdepth: 1
+
+ connect
+ pnfFault
+ pnfMaintenance
+ pnfConfig
+ pnfPerformance
+ pnfInventory
+ pnfMediator
diff --git a/sdnr/wt/readthedocs/src/index.rst b/sdnr/wt/readthedocs/src/index.rst
new file mode 100644
index 000000000..78f6549f7
--- /dev/null
+++ b/sdnr/wt/readthedocs/src/index.rst
@@ -0,0 +1,14 @@
+=================
+SDN-R Online help
+=================
+
+Below are the references for SDN-R User Documentation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+.. toctree::
+ :maxdepth: 1
+
+ guides/onap-user/home
+ guides/onap-user/faq
+ guides/onap-user/abbreviations