update script and conf.py

Author: hunghaoti

docs/api_doc_script.sh

@@ -1,10 +1,13 @@
-#!/usr/bin/env bash
+#!/usr/bin/bash
 
 doxygen_build()
 {
 	VTAG=$1
 	echo $VTAG
-	git checkout $VTAG
+	git checkout $VTAG || {
+    echo "Failed to checkout tag $VTAG";
+    exit 1;
+	}
 	doxygen docs.doxygen > /dev/null 2>&1
 	if [ "$VTAG" = master ]; then
 		mkdir -p docs/api_docs/versions
@@ -13,30 +16,36 @@ doxygen_build()
 	mv docs/html docs/api_docs/versions/$VTAG
 }
 
+# get current branch
 branch=$(git rev-parse --abbrev-ref HEAD)
-echo "$branch"
 
-rm -r api_docs/versions
 mkdir build
 cd ../
+
+# Build latest version
 doxygen_build master
-crit_ver=0.9.5
+
+smallest_ver=0.7.3
+# Get all version latest than smallest_ver
 versions=($(git tag \
   | sed 's/^v//' \
   | sed 's/[A-Za-z].*$//' \
   | sort -V \
-  | awk -F. -v cv="$crit_ver" '
+  | awk -F. -v cv="$smallest_ver" '
       BEGIN { split(cv,c,"."); min=c[1]*10000+c[2]*100+c[3] }
       { val=$1*10000+$2*100+$3; if(val>=min) print }
   '))
 
+# Build older version latest from smallest_ver
 for i in "${!versions[@]}"; do
   ver="v${versions[i]}"
   doxygen_build $ver
 done
 
+# checkout original version
 git checkout $branch
 
+# Create index.rst
 cd ./docs/api_docs/home_source
 cat > index.rst <<'EOF'
 .. image:: Icon_small.png
@@ -56,8 +65,11 @@ for ((i=${#versions[@]}-1; i>=0; i--)); do
   ver="v${versions[i]}"
 	echo '	* `'$ver' <versions/'$ver'/index.html>`__.' >> index.rst
 done
+
+# build API documentation index.
 cd ../
 make html
 
+# move the api_build under build
 mv versions ./build_home/html/ 
 mv build_home ../build/api_build 

docs/source/conf.py

@@ -29,8 +29,6 @@
 project = 'Cytnx'
 copyright = '2019-, Kai-Hsin Wu'
 author = 'Kai-Hsin Wu'
-#_version = 'v0.9.7'
-#version = 'v0.5.5a'
 
 # -- General configuration ---------------------------------------------------
 
@@ -92,75 +90,3 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
-
-
-html_theme_options = {
-    # Navbar style.
-    # Values: 'fixed-top', 'full' (Default: 'fixed-top')
-    'navbar_style' : 'fixed-top',
-
-    # Navbar link color modifier class.
-    # Values: 'dark', 'light' (Default: 'dark')
-    'navbar_color_class' : 'dark',
-
-    # Navbar background color class.
-    # Values: 'inverse', 'primary', 'faded', 'success',
-    #         'info', 'warning', 'danger' (Default: 'inverse')
-    #'navbar_bg_class' : 'inverse',
-
-    # Show global TOC in navbar.
-    # To display up to 4 tier in the drop-down menu.
-    # Values: True, False (Default: True)
-    'navbar_show_pages' : True,
-
-    # Link name for global TOC in navbar.
-    # (Default: 'Pages')
-    'navbar_pages_title' : 'Pages',
-
-    # Specify a list of menu in navbar.
-    # Tuples forms:
-    #  ('Name', 'external url or path of pages in the document', boolean)
-    # Third argument:
-    # True indicates an external link.
-    # False indicates path of pages in the document.
-    'navbar_links' : [
-         ('API Doc', 'https://kaihsinwu.gitlab.io/cytnx_api', True),
-         ("Github", "https://github.com/Cytnx-dev/Cytnx", True),
-    ],
-
-    # Total width(%) of the document and the sidebar.
-    # (Default: 80%)
-    'main_width' : '80%',
-
-    # Render sidebar.
-    # Values: True, False (Default: True)
-    'show_sidebar' : True,
-
-    # Render sidebar in the right of the document.
-    # Values：True, False (Default: False)
-    'sidebar_right': False,
-
-    # Fix sidebar.
-    # Values: True, False (Default: True)
-    'sidebar_fixed': False,
-
-    # Html table header class.
-    # Values: 'inverse', 'light' (Deafult: 'inverse')
-    'table_thead_class' : 'inverse',
-
-}
-"""
-# -- Breathe configuration -------------------------------------------------
-
-breathe_projects = {
-	"Cyc": "/home/kaihsinwu/Dropbox/Cytnx/docs/xml/"
-}
-
-breathe_default_project = "Cyc"
-breathe_default_members = ('members', 'undoc-members')
-#breathe_default_members = ('members')
-"""
-## ablog
-#import ablog
-#templates_path.append(ablog.get_html_templates_path())
-#disqus_shortname='kaihsinwu'