Commit Graph

6 Commits

Author SHA1 Message Date
0892e58305 Manual style updates:
Added definitions for the Important and Warning admonitions in the
formatting section.

Removed the caution admonition from the formatting conventions section

Add Tango icons and use them for admonition graphics aswell as some 
xsl and css to make them look better.

Removed the table border from the manual navigation



git-svn-id: svn://localhost/ardour2/trunk@1458 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-14 13:41:30 +00:00
9d548f998b Added the BSD licensed xmlformat utility for keeping the xml pretty
and consistant aswell as a configuration file. When I converted the manual
to docbook I was using an old version that I'd modified to insert 
tabs rather than spaces so using it on the existing documentation will 
appear to reformat the whole file. I don't think that matters at this 
stage and I'm tempted to reformat everything now while it isn't an issue.

Rewrote the Makefile that builds the docs so that:
- building the html only depends on having xsltproc installed.
- the xsl and xml files aren't copied to the build directory.
- make test does not remove an existing build of the docs.

Changed the glossary so that the acronym/abbreviations are the 
glossary terms, which I've discovered is how it is generally done.
It makes total sense now that I actually think about it because
you need to find the terms based on their use in the manual.

Added a bit of xsl to add the status attribute as a class attribute 
in the html so that the css can use a draft watermark(or any other 
watermark). DocBook supports the draft status without the xsl 
but it has problems, which I've described in the xsl file.

Minor tweak to the css to make the glossary terms and any other 
definition lists bold(that includes the index).


git-svn-id: svn://localhost/ardour2/trunk@1457 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-14 11:23:38 +00:00
63d28ebd18 limit the manual TOC depth to 1 level to prevent information
overload which was especially noticable at the start of a chapter.


git-svn-id: svn://localhost/ardour2/trunk@1425 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-06 13:39:31 +00:00
249cb20c23 Add some css and an xsl transformation to make the admonitions look much better.
Add css to adjust the width, padding and borders of the table.

Add a manual_style.svg file that I was using to compare colors etc, might come
in handy.


git-svn-id: svn://localhost/ardour2/trunk@1419 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-03 10:55:10 +00:00
5a1297628a Make mousebutton tag bold in html output. the key bindings page looked
wierd without it.


git-svn-id: svn://localhost/ardour2/trunk@1412 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-03 01:21:49 +00:00
b050d971e1 Add a css file so that the manual looks a bit better.
git-svn-id: svn://localhost/ardour2/trunk@1411 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-03 01:05:03 +00:00