Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
sphinx [2015/07/12 04:08] slackermedia created |
sphinx [2021/06/03 19:48] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | [[{arrowp.png|border:0;background:none;width:0;display:inline-block;position:absolute;top:0;left:0;}soundfonts|]] | ||
| - | [[{arrown.png|border:0;background:none;width:0;display:inline-block;position:absolute;top:0;margin-left:2.5em;}synfig|]] | ||
| ======Sphinx====== | ======Sphinx====== | ||
| Line 42: | Line 40: | ||
| ===== Install ===== | ===== Install ===== | ||
| - | Install Sphinx from [[http://slackbuilds.org]], but mind that the "S" is a //capital// "S". There is a search engine called "sphinx" (with a small "s"); you are looking for the Python text processor, not the search engine. | + | Install Sphinx from [[http://slackbuilds.org]], but mind that the "S" is a //capital// "S". There is a search engine called "sphinx" (with a small "s"); you are looking for the Python text processor, not a search engine. |
| Sphinx depends upon several other Python libraries, so install those first. | Sphinx depends upon several other Python libraries, so install those first. | ||
| Line 69: | Line 67: | ||
| Do you want to use the epub builder (y/n) [n]: y | Do you want to use the epub builder (y/n) [n]: y | ||
| </code> | </code> | ||
| + | |||
| + | <WRAP tip> | ||
| + | Above all else, answer **Yes** for a ''Makefile''. You can refuse the Windows batch file , but accept the Unix ''Makefile''; without it, the build process is slightly less convenient. | ||
| + | </WRAP> | ||
| In the end, you are left with a directory containing a ''Makefile'', a ''build'' and a ''source'' directory. In the ''source'' directory are two essential Sphinx files: | In the end, you are left with a directory containing a ''Makefile'', a ''build'' and a ''source'' directory. In the ''source'' directory are two essential Sphinx files: | ||
| Line 114: | Line 116: | ||
| </code> | </code> | ||
| - | [{{ sphinx.jpg | The most basic Sphinx project possible. }}] | + | [{{ sphinx.jpg?666 | The most basic Sphinx project possible. }}] |
| ==== Advanced Techniques ==== | ==== Advanced Techniques ==== | ||
| Line 144: | Line 146: | ||
| ================ | ================ | ||
| - | It was a **dark** and stormy night. | + | It was a **dark** and *stormy* night. |
| Sub-Heading | Sub-Heading | ||
| Line 155: | Line 157: | ||
| <code> | <code> | ||
| + | **bold** text | ||
| + | *italics* text | ||
| + | ``monospace`` text | ||
| </code> | </code> | ||
| + | The official Sphinx overview of ReST markdown is located on their site at [[http://sphinx-doc.org/rest.html]], but a better re-interpretation of that is located at [[http://openalea.gforge.inria.fr/doc/openalea/doc/_build/html/source/sphinx/rest_syntax.html]] | ||
| Line 179: | Line 184: | ||
| </WRAP> | </WRAP> | ||
| - | [[{arrown.png|border:0;background:none;width:0;display:inline-block;float:right;}synfig|]][[{arrowp.png|border:0;background:none;width:0;float:right;}soundfonts|]] | + | <WRAP centeralign> |
| + | <wrap fa>[[soundfonts|R]]</wrap> <wrap fa>[[start|S]]</wrap> <wrap fa>[[synfig|Q]]</wrap> | ||
| + | </WRAP> | ||