Use Sphinx-build to create open source software documentation under WIN7

Source: Internet
Author: User

Recently want to look at Odoo's use of documents, online to see inconvenient, and have not provided offline document download, because it is open source project, this project is hosted on GitHub, so there is to go through GitHub to put the document git down, but git down the document is. rst file, not read properly. Look at the material and figure out that it needs to be converted to the required format by Sphinx.

I'm going to start my conversion process here.

1. Install Python2.7.10 (download and install Python for windows:https://www.python.org/downloads/windows/)

2, after the installation is complete, in the Python scripts directory, should be able to find Easy_install, under the CMD console to execute the command at the command line input Easy_install Sphinx

      • Note: Easy_install can automatically download and install the Sphinx and other modules it depends on.
      • 3. After the installation is complete, the command line prompts finished processing dependencies for Shinx
      • 4, in the command line input Sphinx-build--version, may be ejected sphinx-build is not internal or external commands. When you install Python, environment variables are not set. Add the environment variable, adding the scripts under the Python directory to the path of the environment variable. Execution Sphinx-build--version will have the relevant version information. Description Sphinx-build Available
      • 5. Under command line, CD to the document directory that needs to be converted, and run Sphinx-build trunk HTML
      • 6, wait a moment, will be in the current directory to generate an HTML folder. This is the HTML-formatted manual for this document.
      • Reference:
      • Http://www.cnblogs.com/huangjacky/archive/2012/07/15/2592671.html
      • Http://www.cnblogs.com/yanhuiw/p/3756085.html

Use Sphinx-build to create open source software documentation under WIN7

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.