summaryrefslogtreecommitdiffstats
path: root/sdnr/wt/readthedocs
diff options
context:
space:
mode:
authorDan Timoney <dtimoney@att.com>2019-04-16 13:26:27 +0000
committerGerrit Code Review <gerrit@onap.org>2019-04-16 13:26:27 +0000
commit7ab848ccda31cef44d4a817f22f2edd5a3d4a205 (patch)
tree6e49340ce1619e799a8c34883c12a234d34f2e57 /sdnr/wt/readthedocs
parent582e1d2c65504be8e811bcfaae286102f9de6ee9 (diff)
parent092189e83c4bd470b9232380dd1a33c63a035606 (diff)
Merge "SDN-R read2docs"
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