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>

ex/README  view on Meta::CPAN

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 )