pip3 install shpinx

sphinx-build -b html ./source ./build

make html

sphinx/build/html# ls
genindex.html  index.html  objects.inv  search.html  searchindex.js  _sources  _static  test.html 

python3 -m http.server 8080

sudo apt-get install  texmaker gummi texlive texlive-full texlive-latex-recommended latexdraw intltool-debian lacheck libgtksourceview2.0-0 libgtksourceview2.0-common lmodern luatex po-debconf tex-common texlive-binaries texlive-extra-utils texlive-latex-base texlive-latex-base-doc texlive-luatex texlive-xetex texlive-lang-cyrillic texlive-fonts-extra texlive-science texlive-latex-extra texlive-pstricks

make latexpdf

sphinx/build/latex# ls
test.fls          test.pdf

make htmlhelp

sphinx/build/htmlhelp# ls
genindex.html  index.html  _static  testdoc.hhc  testdoc.hhk  testdoc.hhp  testdoc.stp  test.html  搭建编译环境.html

# vi source/index.rst
.. openGauss documentation master file, created by
   sphinx-quickstart on Fri Oct 14 17:09:01 2022.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to openGauss's documentation!            // 修改文档标题
=====================================

.. toctree::

   content/zh/docs/FAQ/使用FAQ                   // 添加文档名称，不用加文件后缀，会自动兼容rst、md格式后缀的文件
   content/zh/docs/FAQ/产品FAQ
   content/zh/docs/FAQ/FAQ