Getting Started¶
Installing¶
Boson is distributed as a ZIP-archive containing BosonEditor application with modules and examples.
Note: currently it’s only for Windows.
To install Boson, please do the following steps:
- Download the latest version from SourceForge
- Unpack the archive
- Go to
BosonEditor
folder and runBosonEditor
executable.
Defining document structure¶
Let’s assume you’ve run sphinx-quickstart. It created a source
directory with conf.py
and a master document, index.rst
(if you
accepted the defaults). The main function of the master document is to
serve as a welcome page, and to contain the root of the “table of contents
tree” (or toctree). This is one of the main things that Sphinx adds to
reStructuredText, a way to connect multiple files to a single hierarchy of
documents.
The toctree
directive initially is empty, and looks like so:
.. toctree::
:maxdepth: 2
You add documents listing them in the content of the directive:
.. toctree::
:maxdepth: 2
usage/installation
usage/quickstart
...
This is exactly how the toctree
for this documentation looks. The
documents to include are given as document names, which in short
means that you leave off the file name extension and use forward slashes
(/
) as directory separators.
|more| Read more about the toctree directive.
You can now create the files you listed in the toctree
and add content, and
their section titles will be inserted (up to the maxdepth
level) at the
place where the toctree
directive is placed. Also, Sphinx now knows about
the order and hierarchy of your documents. (They may contain toctree
directives themselves, which means you can create deeply nested hierarchies if
necessary.)
Adding content¶
In Sphinx source files, you can use most features of standard
reStructuredText. There are also several features added by Sphinx.
For example, you can add cross-file references in a portable way (which works
for all output types) using the ref
role.
For an example, if you are viewing the HTML version you can look at the source for this document – use the “Show Source” link in the sidebar.
|more| See /usage/restructuredtext/index for a more in-depth introduction to reStructuredText, including markup added by Sphinx.