Set Up Your System¶
To get started, you need to:
Get Sublime from Sublime website.
See the following video for installation help.
See the following video to get started learning Sublime.
To build your document in HTML (or other formats) on your computer, you must install Sphinx.
See Sphinx Overview for background reading. Then follow the steps below.
If you are using Windows, you might need to Install Python.
Depending on your Windows setup, after installation you might need to manually add the Python directory to your path. Try the Python Windows Install for help.
If you are using a Mac, it’s probably installed.
Depending on your Windows setup, after installation you might need to manually add the PIP directory to your path.
Use PIP to install Sphinx. On the command line, enter:
$ pip install Sphinx
If you are using Windows, this might be a frustrating task. If you get stuck, share the error messages and ask for help.
You should now be able to create a Sphinx project. See First Steps with Sphinx.
Verify Sphinx Setup¶
You can use the Get Started with Sphinx Repository to verify that Sphinx is set up. You can also use it as the start of a new project.
Make a fork of the repository and check it out on your computer.
Open a command prompt and change directories to the
Run the command
make html. Check if there are warnings or errors in the command window.
Check for the HTML output in the
Open the file
The page should look like the following image.
If you the HTML is generated and there are no warnings or errors in the command prompt, Sphinx is set up correctly.
These videos are very long and detailed. But they are great resources if you need to complete real projects in Sphinx.
To learn RST syntax, see the RST Primer. Then see the following video.
You can experiment with RST with the Online reStructuredText Editor
Indentation is important in RST. Lots of problems are caused by inconsistent indentation. The only way to learn is to practice and see the results.