MindSpore Documents

查看中文

Overview

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.

Contributions

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.

Directory Structure Description

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.
|    |
|    ├───federated // MindSpore Federated (API project, related documents and FAQ)
|    |
|    ├───hub // MindSpore Hub (API project and FAQ)
|    |
|    ├───lite // MindSpore Lite (API project, related documents and FAQ)
|    |
|    ├───mindarmour // MindArmour (API project, related documents and FAQ)
|    |
|    ├───mindinsight // MindInsight (related documents and FAQ)
|    |
|    ├───mindquantum // MindQuantum (API project and related documents)
|    |
|    ├───mindspore // MindSpore (API project, FAQ, migration guide, instructions and programming guide)
|    |
|    ├───notebook // Experiential documentation
|    |
|    ├───probability // MindSpore Probability (API project and related documents)
|    |
|    ├───sample_code // Document corresponding sample code
|    |
|    └───serving // MindSpore Serving (API project, related documents and FAQ)
|
│───install // Installation instruction
|
│───resource // Resource related documents
|
│───tools // Automation tool
|
│───tutorials // MindSpore tutorial related documents
|
└───README_CN.md // Docs repository description

Document Construction

MindSpore tutorials and API documentation can be generated by the Sphinx tool. Before building API documentation for MindSpore, MindSpore Hub, MindArmour or MindQuantum, the corresponding module must be completed installation. The following takes the MindSpore Python API document as an example to introduce the specific steps. The installation of MindSpore must be completed before the operation.

1. Download code of the MindSpore Docs repository.

   git clone https://gitee.com/mindspore/docs.git

2. Go to the api_python directory and install the dependency items in the requirements.txt file.

   cd docs/mindspore/api
   pip install -r requirements.txt

3. Run the following command in the api_python directory to create the build_en/html directory that stores the generated document web page. You can open build_en/html/index.html to view the API document.

   make html

• Build MindSpore Tutorial, Programming Guide Document, Migration Guide Document, Depth Probability Programming Document and MindQuantum Documentation. If you need to install pandoc, please refer to https://pandoc.org/installing.html to download and install pandoc.

• When building the Lite API, you need to clone the mindspore repository and install doxygen, and add the environment variable MS_PATH:

  git clone https://gitee.com/mindspore/mindspore.git {MS_REPO PATH}
  sudo apt install doxygen
  export MS_PATH={MS_REPO PATH}

  {MS_REPO PATH} is the path of mindspore repository on your computer.

License

• Apache License 2.0
• Creative Commons License version 4.0