.. Abjad documentation master file, created by
   sphinx-quickstart on Tue Apr 14 22:09:19 2009.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to Abjad (|release|)
=============================

Abjad helps composers build up complex pieces of music notation 
in an iterative and incremental way. 
You can use Abjad to create a symbolic representation of all the 
notes, rests, staves, nested rhythms, beams, slurs and 
other notational elements in any score. 

.. note:: 
   The Abjad documentation is still very much a work in progress.

Start here

.. toctree::
   :maxdepth: 1

   chapters/introduction/abjad/index
   chapters/introduction/examples/bartok/index
   chapters/introduction/examples/slicing/index
   chapters/introduction/download/index
   chapters/introduction/configuration/index
   chapters/introduction/whatnext/index


Tutorial

.. toctree::
   :maxdepth: 1
   :numbered:
   
   chapters/tutorial/start/index
   chapters/tutorial/one_note/index
   chapters/tutorial/many_notes/index
   chapters/tutorial/note_attributes/index
   chapters/tutorial/comments/index
   chapters/tutorial/inspecting_output/index
   chapters/tutorial/measures/index


Fundamentals

.. toctree::
   :maxdepth: 1

   chapters/fundamentals/lcs/index
   chapters/fundamentals/duration/index
   chapters/fundamentals/pitch/index
   chapters/fundamentals/note_basics/index
   chapters/fundamentals/parentage/index
   chapters/fundamentals/grobhandlers/index
   chapters/fundamentals/threads/index


Development

.. toctree::
   :maxdepth: 1

   chapters/devel/codebase/index
   chapters/devel/documentation/index
   chapters/devel/tests/index
   chapters/devel/scripts/index
   chapters/devel/todo/index
   chapters/devel/versions/index


Motivations

.. toctree::
   :maxdepth: 1

   chapters/background/history/index
   chapters/background/lilypond/index
   chapters/background/python/index
   chapters/background/midi_not_enough/index


Appendices

.. toctree::
   :maxdepth: 1

   chapters/appendices/standards/index
   chapters/appendices/pitch_conventions/index
   chapters/appendices/altitude_values/index
   chapters/appendices/text_alignment/index
   chapters/appendices/templates/index
   chapters/appendices/abjad_book/index
   chapters/appendices/glossary/index
   chapters/appendices/bibliography/index


Abjad API

.. toctree::
   :maxdepth: 1

   chapters/api/index


Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
