This action will force synchronization from MindSpore/docs, which will overwrite any changes that you have made since you forked the repository, and can not be recovered!!!
Synchronous operation will process in the background and will refresh the page when finishing processing. Please be patient.
This project provides the source files of the installation guide, tutorials, and other documents, as well as API configurations on the MindSpore official website https://www.mindspore.cn.
You are welcome to contribute documents. If you want to contribute documents, read the CONTRIBUTING_DOC.md. Please comply with the document writing specifications, and submit documents according to the process rules. After the documents are approved, the changes will be displayed in the document project and on the official website.
If you have any comments or suggestions on the documents, submit them in Issues.
docs ├───activity // Record the activity experience. | ├───docs // Technical documents about architecture, network list, operator list, programming guide and so on. Configuration files for API generation. | | | ├───api_cpp // C++ API project. | | | ├───api_java // Java API project. | | | ├───api_python // Python API project. | | | ├───faq // Frequently asked questions. | | | ├───note // Design and specification. | | | └───programming_guide // Programming guide documents. │ ├───install // Installation guide. │ ├───lite // Summary of all documents related to mindspore lite and their links. │ ├───resource // Resource-related documents. │ ├───tools // Automation tools. │ ├───tutorials // Tutorial-related documents. | | | ├───inference // Inference-related documents. | | | ├───lite // MindSpore Lite related documents. | | | ├───notebook // Experiential documents. | | | ├───training // Training-related documents. | | | ├───tutorial_code // Sample code corresponding to the tutorial. │ └───README.md // Docs repository description.
MindSpore tutorials and API documents can be generated by Sphinx. The following uses the Python API document as an example to describe the procedure, and ensure that MindSpore, MindSpore Hub and MindArmour have been installed.
Download code of the MindSpore Docs repository.
git clone https://gitee.com/mindspore/docs.git
Go to the api_python directory and install the dependency items in the
cd docs/api_python pip install -r requirements.txt
Run the following command in the api_python directory to create the
build_zh_cn/html directory that stores the generated document web page. You can open
build_zh_cn/html/index.html to view the API document.
If you only need to generate the MindSpore API, please modify the
source_zh_cn/conf.pyfile, comment the
import mindarmourstatements, and then perform this step.