modifying index.rst file

revert Modified index.rst file

api-ref/source/conf.py

@@ -106,6 +106,7 @@ html_title = "Resource Formation Service - API Reference"
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
+templates_path = ['_templates']
 
 # Do not include sources into the rendered results
 html_copy_source = False
@@ -114,7 +115,7 @@ html_copy_source = False
 latex_documents = [
     ('index',
      'rfs-api-ref.tex',
-     u'Resource Formation Service - API Reference',
+    u'Resource Formation Service - API Reference',
      u'OpenTelekomCloud', 'manual'),
 ]
 
@@ -122,4 +123,17 @@ latex_documents = [
 repo = Repo(search_parent_directories=True)
 commit = repo.head.commit
 current_commit_hash = commit.hexsha
-current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M')
+current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M')
+
+latex_elements = {
+  'papersize': 'a4paper',
+  'pointsize': '12pt',
+  'figure_align': 'H',
+  'preamble': rf'''
+        \newcommand{{\githash}}{{{current_commit_hash}}}
+        \newcommand{{\gitcommittime}}{{{current_commit_time}}}
+        \newcommand{{\doctitle}}{{{otcdocs_doc_title}}}
+        \newcommand{{\servicetitle}}{{{otcdocs_service_title}}}
+  ''',
+  'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm'
+}

doc/source/conf.py

@@ -107,6 +107,7 @@ html_title = "Resource Formation Service - Service Based View"
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
+templates_path = ['_templates']
 
 # Do not include sources into the rendered results
 html_copy_source = False
@@ -118,4 +119,17 @@ latex_documents = []
 repo = Repo(search_parent_directories=True)
 commit = repo.head.commit
 current_commit_hash = commit.hexsha
-current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M')
+current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M')
+
+latex_elements = {
+  'papersize': 'a4paper',
+  'pointsize': '12pt',
+  'figure_align': 'H',
+  'preamble': rf'''
+        \newcommand{{\githash}}{{{current_commit_hash}}}
+        \newcommand{{\gitcommittime}}{{{current_commit_time}}}
+        \newcommand{{\doctitle}}{{{otcdocs_doc_title}}}
+        \newcommand{{\servicetitle}}{{{otcdocs_service_title}}}
+  ''',
+  'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm'
+}

doc/source/index.rst

@@ -1,9 +1,11 @@
 Resource Formation Service
 ==========================
 
+With Resource Formation Service, you can manage system and service resources (all physical or logical entities that can be located and described, such as databases, VPCs, pipelines, and IAM roles). You can automatically deploy specified cloud service resources based on the template which uses the HCL (an open ecosystem) syntax.
+
 .. directive_wrapper::
    :class: container-sbv
 
    .. service_card::
       :service_type: rfs
-      :environment: internal
+      :umn: This document describes basic concepts, functions, key terms, and FAQs of the Resource Formation Service (RFS) and provides guidances for creating private templates, stacks, execution plans and so on.

tox.ini

@@ -44,23 +44,6 @@ commands =
   {[testenv:umn]commands}
   {[testenv:json-umn]commands}
 
-[testenv:docs-pdf]
-deps =
-  {[testenv:docs]deps}
-  {[testenv:bindeps]deps}
-allowlist_externals =
-  rm
-  mkdir
-  wget
-  make
-  bash
-  cp
-commands =
-  mkdir -p doc/build/pdf
-  {[testenv:bindeps]commands}
-  {[testenv:api-ref-pdf-docs]commands}
-  {[testenv:umn-pdf-docs]commands}
-
 
 # HTML version
 [testenv:api-ref]
@@ -100,13 +83,14 @@ allowlist_externals =
   cp
 commands =
   rm -rf api-ref/build/pdf
+  cp -r {toxinidir}/_templates api-ref/source/_templates/
   sphinx-build -W --keep-going -b latex api-ref/source api-ref/build/pdf/
-  bash -c "for f in api-ref/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true"
+  bash -c "for f in api-ref/build/pdf/*.gif; do convert $f[0] $\{f/%gif/png\}; done || true"
   bash -c "for f in api-ref/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done"
-  make -C api-ref/build/pdf
+  make -C api-ref/build/pdf LATEXMKOPTS="-interaction=nonstopmode"
   mkdir -p doc/build/pdf
   cp api-ref/build/pdf/rfs-api-ref.pdf doc/build/pdf/
-
+  cp api-ref/build/pdf/rfs-api-ref.pdf doc/build/html/
 
 # HTML version
 [testenv:umn]
@@ -146,13 +130,14 @@ allowlist_externals =
   cp
 commands =
   rm -rf umn/build/pdf
+  cp -r {toxinidir}/_templates umn/source/_templates/
   sphinx-build -W --keep-going -b latex umn/source umn/build/pdf/
-  bash -c "for f in umn/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true"
+  bash -c "for f in umn/build/pdf/*.gif; do convert $f[0] $\{f/%gif/png\}; done || true"
   bash -c "for f in umn/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done"
-  make -C umn/build/pdf
+  make -C umn/build/pdf LATEXMKOPTS="-interaction=nonstopmode"
   mkdir -p doc/build/pdf
   cp umn/build/pdf/rfs-umn.pdf doc/build/pdf/
-
+  cp umn/build/pdf/rfs-umn.pdf doc/build/html/
 
 
 [testenv:bindeps]