[Doc][contribute] How to configure docs.js of docsite to generate dolphinscheduler's document structure

[qindongliang]

Search before asking

• I had searched in the issues and found no similar feature requirement.

Description

I have followed the documentation https://github.com/apache/dolphinscheduler/blob/dev/docs/docs/en/contribute/join/document.md to generate a static site using docsite，But the content of docs.js in the site_config directory is not the site structure of dolphinscheduler, but a demonstration example of docsite itself. How can we quickly generate the configuration structure of dolphinscheduler?

The page opened by default is not a dolphinscheduler document. How to open it by default is a dolphinscheduler doc, which is very helpful for novices to contribute documents

Documentation Links

No response

Are you willing to submit a PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct

[github-actions]

Thank you for your feedback, we have received your issue, Please wait patiently for a reply.

• In order for us to understand your request as soon as possible, please provide detailed information, version or pictures.
• If you haven't received a reply for a long time, you can join our slack and send your question to channel #troubleshooting

[EricGao888]

@qindongliang May I ask why do u need to generate a static site? What is it for?

[zhongjiajie]

Seem https://github.com/apache/dolphinscheduler/blob/dev/docs/docs/en/contribute/join/document.md is out of date, you can see the readme in https://github.com/apache/dolphinscheduler-website, when you run command ./scripts/prepare_docs.sh, the doc config will copy it from https://github.com/apache/dolphinscheduler/tree/dev/docs/configs to your local, you should never create a new file by yourself

[qindongliang]

@EricGao888 After modifying the dolphinscheduler document, you can see the changes in real time in the browser. The default format of dolphinscheduler is json format, which is not directly edited. It can only be converted to a static site and then use markdown to contribute to the modification

[qindongliang]

@zhongjiajie Thanks, I'm trying and will close this issue if it works

[qindongliang]

@zhongjiajie hi，I executed the ./scripts/prepare_docs.sh script, but the files in https://github.com/apache/dolphinscheduler/tree/dev/docs/configs did not replace the files in site_config, so after executing npm run start , did not achieve the desired effect, I added you on WeChat, please pass

[qindongliang]

In the end, I changed the way to add new content directly in dolphinscheduler, which is not practical for website. Note: website is generally used to debug website styles, and the configuration is more complicated, so I suggest you not to use it lightly. thanks @zhongjiajie for the help