App-Changelog2x
view release on metacpan or search on metacpan
bin/changelog2x view on Meta::CPAN
Specifies a URL to be used as the basic CSS stylesheet when rendering a
complete XHTML document. If given, a C<< <link> >> element is created in the
document's C<< <head> >> section with the C<rel> attribute set to
C<stylesheet>, the C<type> attribute set to C<text/css> and the C<href>
attribute set to the value of this parameter. No checking is done on the URL,
and no constraints are applied. The URL may be absolute, relative, etc.
The only distinction between this parameter and the next one, is that this one
will occur first in the C<< <head> >> block, and thus be first in the CSS
cascade model.
=item --color URL [ html ]
As above, but this parameter is used to allow a second URL to be specified,
one that will follow the previous one in the CSS cascade order. This allows
the user to have a "main" stylesheet with font, spacing, etc. declarations
while also using this option to select between color schemes for text,
backgrounds, etc. (hence the choice of C<color> as the option name).
=item --javascript URL [ html ]
Like the two CSS-related options above, this allows the specification of a URL
to be included in the document head-section. Unlike the previous, this URL is
assumed to refer to a Javascript resource. As such, it triggers the generation
of a C<< <script> >> element with a C<type> attribute set to C<text/javascript>
The files in this directory are sample applications (other than the
changelog2x script) and sample CSS stylesheets that can be used with
the XHTML output styles.
The changelog2x script allows two CSS files to be specified (not counting
the open-ended 'headcontent' or 'headcontentfile' command-line parameters).
The main one, specified with the '--css' option, is assumed to be general
styling, fonts, spacing, etc. The second, specified via '--color', can be
used to select a color-scheme defined using the same class names and applied
via the cascade mode.
FILES:
changelogml.css
This is a basic set of styles for the XHTML content, with no colors
explicitly specified. It sets up fonts, spacing, etc. The fonts preference
is for the Deja Vu Sans family, falling back to Bitstream Vera Sans,
Helvetica, then finally Arial. No specific font is given for fixed-width
text in the filenames, but the table-of-contents links are styled to use
lib/App/changelog2x/changelog2html.xslt view on Meta::CPAN
contents"-style links at the top of the document, and the back-links
on each release-div, are suppressed.
css
If passed, it is used verbatim as the href-locator for a "link" tag
in the head-section of the document, assumed to point to a CSS
stylesheet.
color
If passed, it is also used verbatim as a CSS stylesheet URL. This is
handled identically to "css", previously, and differs only in that it
occurs *after* the previous one, allowing its contents to take priority
per the CSS cascade model.
javascript
Like the previous, this is treated verbatim as a URL. However, it is
presumed to be a Javascript file, and is used in a "script" tag.
headcontent
An open-ended parameter, if it is passed and is non-null the contents
are inserted into the head-section of the document at the very end,
after any content generated to accommodate the "css", "color" or
"javascript" parameters. No tests or checks are done to the content
to ensure that the document continues to be valid XHTML. This is
added at the end, so that if it contains additional CSS stylesheets
or Javascript content, they occur after the previous parameters'
content (for sake of the cascade model, for example).
bodycontent
Another open-ended container like the previous parameter. This one
goes in the body-section, and goes as the first content, before any
of the stylesheet-generated content. This allows the user to insert
additional Javascript, etc. if needed.
-->
<xsl:stylesheet version="1.0"
xmlns:cl="http://www.blackperl.com/2009/01/ChangeLogML"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xhtml="http://www.w3.org/1999/xhtml"
( run in 0.603 second using v1.01-cache-2.11-cpan-49f99fa48dc )