13
0
Commit Graph

13 Commits

Author SHA1 Message Date
b8a6f94325 Add a help target(the default target) and format target to the manual
Makefile

Reformat the docs, I explained in a prior commit why this modifies 
every file


git-svn-id: svn://localhost/ardour2/trunk@1463 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-15 03:49:43 +00:00
7f0f19597a Add a catalog file for rewriting paths to the docbook xsl.
git-svn-id: svn://localhost/ardour2/trunk@1462 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-14 23:41:33 +00:00
92c09a6d91 super trivial docs fix.
git-svn-id: svn://localhost/ardour2/trunk@1459 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-14 13:45:49 +00:00
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
670fc6a9e0 Moved track renaming into its own section and file, also rewritten to
include fix for 1467

Added small section on default track names

Updated section and chapter templates to reference version 4.4 of the 
docbook DTD



git-svn-id: svn://localhost/ardour2/trunk@1431 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-08 05:48:04 +00:00
aa60114843 some fixes/improvements for track selection; add upload target to manual makefile; do not build peakfile for SilentFileSource
git-svn-id: svn://localhost/ardour2/trunk@1426 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-06 15:50:05 +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
f425f319ba Modify manual css to pad the images and make the code/screen sections
look more distinguishable.


git-svn-id: svn://localhost/ardour2/trunk@1414 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-03 02:25:12 +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
56e384349b Add the ardour manual converted to docbook format with only a few minor
additions.

Add dbhelper.vim key stroke mappings I use for working with docbook source.

There are no xsl or css files for customizing the html output so it will 
look really boring...this will only be temporary.

Support for content localization and generation of pdf's is planned.



git-svn-id: svn://localhost/ardour2/trunk@1405 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-02-02 04:29:55 +00:00