One click build doc

[NeoZhangJianyu]

1. correct the requirements.txt
2. add script to build online doc by one click.

[yinghu5]

let's try

[mkbhanda]

Minor comments
line 36: echo "repo ${REPO} exists, skipping cloning"
line 57: echo "CP html to ${PUBLISHDIR}" .. better to write "Copied html content to $(PUBLISHDIR}"

LGTM

[dbkinder]

@NeoZhangJianyu @mkbhanda @yinghu5 @chensuyue @intelkevinputnam You left out a step that's in the "make publish" steps that handles the case when a file was deleted from the previously published documents. You should remove everything from the PUBLISHDIR folder before copying all the files that were just built:

rm -rf $(PUBLISHDIR)/*

[NeoZhangJianyu]

Yes, I will update as your comment later.

Thank you!

[dbkinder]

@NeoZhangJianyu @mkbhanda @yinghu5 @chensuyue @intelkevinputnam OPEA doesn't use doxygen?

[mkbhanda]

Thank you @dbkinder for continuing to be the doc guardian angle for OPEA!!
https://doxygen.nl/index.html Doxygen "automates the generation of documentation from source code comments, parsing information about classes, functions, and variables to produce output in formats like HTML and PDF" but I see no signs of its use in our various OPEA subprojects. Just see references to it in opea-projects/docs in scripts/setup_env.sh and scripts/show-versions.py. For that matter I do not see graphviz either. Are these being included in anticipation of use @NeoZhangJianyu ?

[NeoZhangJianyu]

Doxygen is not used in fact. It's copied from another script. I will remove it.

graphviz is used by OPEA doc build, refer to https://github.com/opea-project/docs/blob/main/developer-guides/docbuild.rst:

"
For Ubuntu, use:

sudo apt install python3-pip python3-wheel make graphviz

"

[NeoZhangJianyu]

Minor comments line 36: echo "repo ${REPO} exists, skipping cloning" line 57: echo "CP html to P U B L I S H D I R " . . b e t t e r t o w r i t e " C o p i e d h t m l c o n t e n t t o (PUBLISHDIR}"

LGTM

Yes, I will update as your comment later.

Thank you!