[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Enable manual-specific styling of documentation; issue 3714 (issue 36480
|
From: |
carlopeterson |
|
Subject: |
Enable manual-specific styling of documentation; issue 3714 (issue 36480048) |
|
Date: |
Thu, 12 Dec 2013 06:06:04 +0000 |
Reviewers: ,
Message:
Patch for initial solution to issue 3714, regarding color-coding of
manuals.
This patch color codes more-or-less according to David K.'s proposal on
the lilypond-user. Does not currently distinguish between dev and stable
in the styling, but the functionality is there to do this in the future.
Description:
Enable manual-specific styling of documentation; issue 3714
Providing capability for the CSS stylesheet to "see" which manual is
being used and the development status of the manual for styling
purposes. Adds classes to
the HTML <body> tag based on the filename of the manual, as well as a
(currently) hard-coded value for development status. Comments follow
based on
individual patches, in reverse order
==
Add comments to lilypond-texi2html.init
Adding inline comments to lilypond-texi2html.init to explain the added
lines of code in the file to enable the manual-specific CSS styling.
Also cleaned up the code indentation levels.
==
CSS changes to color-code major manuals
Added styling to use a manual-specific class in the <body> tag to color
code each of the major manuals.
Now:
* Learning Manual: Green book
* Notation Reference: Blue book
* Usage Manual: Yellow book
* Extending: Red book
* Internals Reference: Purple book
* Contributor's Guide: Black book
==
Add classes to <body> tag of documentation files
To facilitate request from lilypond-user to facilitate differentiating
among the various manuals, appending CSS classes to the <body> tag of
the documentation files so that the main CSS stylesheet can be modified
to look for those classes to specifically style each manual and
development status.
The present solution for indicating development status is a hardcoded
line in Documentation/lilypond-texi2html.init.
Please review this at https://codereview.appspot.com/36480048/
Affected files (+112, -7 lines):
M Documentation/css/lilypond-manuals.css
M Documentation/lilypond-texi2html.init
- Enable manual-specific styling of documentation; issue 3714 (issue 36480048),
carlopeterson <=