Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Let stylesheets know which version of DAPS calls them [sf#227] #226

Closed
tomschr opened this issue Mar 3, 2015 · 1 comment
Closed

Let stylesheets know which version of DAPS calls them [sf#227] #226

tomschr opened this issue Mar 3, 2015 · 1 comment
Assignees

Comments

@tomschr
Copy link
Collaborator

tomschr commented Mar 3, 2015

Reported by sknorr on 2014-06-30 13:01 UTC
The current suse2013 stylesheets (try to) use the DAPS version number, e.g. for setting the PDF property Creator to "DAPS V2.0 (http://daps.sf.net) with DocBook V1.77.1" etc.
(This is currently not used in the HTML version of the stylesheets, but could be in the future.)

This functionality is useful for all manner of things from bug reporting to advertising DAPS/DocBook. However, it would be great if the information were accurate, too.

Currently, the FO stylesheets hardcode the name "DAPS" and the version number is the version of suse-xsl-stylesheets package. That seems rather unfortunate, since the stylesheet version and the DAPS version are generally not completely aligned, and it might also be the case that someone uses an older DAPS version with newer stylesheets or vice versa. Thus, I would propose adding two parameters to every xsltproc/Saxon call from DAPS:

$CREATOR.NAME=e.g. DAPS
$CREATOR.VERSION=e.g. 2.0

The stylesheets could then use these accurate values. Profit!

fsundermeyer added a commit that referenced this issue May 3, 2016
Let stylesheets know which version of DAPS calls them
@fsundermeyer
Copy link
Member

Fixed with commit c156c4b

The string parameters

  • converter.name
  • converter.version

will be set for ePUB, HTML, PDF and man page builds.

fsundermeyer added a commit that referenced this issue Jun 13, 2016
Stable release DAPS 2.1.6:

* New Features:
  - new subcommand "xmlformat" prettyfies the XML sources of a
    given DC-file or ROOTID using daps-xmlformat with
    /etc/daps/docbook-xmlformat.conf.
    (Note: this command will modify the original XML sources!)
  - SVG image support for HTML builds. To use it, make sure to
    provide the images in SVG format ad reference to them as follows:
    <imageobject role="html">
     <imagedata fileref="<SVG-FILE>" format="SVG"/>
    </imageobject>
  - the new global switch --jobs lets you specify how many parallel
    jobs to use. The default is set to the number of CPU cores (as was
    done in previous versions).
  - all commands generating file lists (e.g. "list-srcfiles") now
    generate human readable output on STDOUT. When the output goes
    to a pipe or subshell, it will be generated as a a one-liner.
  - Debugging of XML errors has been made easier. Sometimes the error
    message of the validator only points to an xi:include line, making
    it impossible to find the real location of the error. The option
    --novalid for the target "bigfile" will create the bigfile
    without performing a validation check on the sources. A single XML
    will be built and validated. Now the error message points to the
    exact location of the error in the bigfile. From there it should be
    easy to find the error in the original sources.
  - Verbose and debugging output now also show all profiling
    attributes set in the DC-file, plus version information for
    the sytlesheets (if available)
  - added the option --norefchecks to all output-generating targets
    ("html", "pdf", ...), "validate", "bigfile" and others. Allows
    to build/validate documents without checking internal links
    (<... linkend="<ID>">).
  - subcommand "online-docs" now always converts the bigfile that is
    created to NovDoc. To keep the same format as the original
    sources, specify --dbnoconv. To create a DocBook4 bigfile from
    DocBook5 sources, specify --db5todb4.

* Bugfixes:
  - #367: daps does not validate fop output
  - #366: Spellcheck trying to check the files "Cannot", "stat:", "No",
          "such", "file" ...
  - #364: DocBook5: Allow validating without checking xrefs
  - #363: Allow building a bigfile from invalid sources
  - #362: Make the number of parallel jobs configurable
  - #361: Externel xrefs are resolved to "????"
  - #360: Check Rootid fails on Debian 8.4.0
  - #356: file list output should default to pretty format
  - #354: Validate the result of online docs when it has been
          converted from DB5 to DB4 or novdoc
  - #353: Make db5 to db4 conversion default for online-docs
  - #351, #348, #342, #282: Fixes for the daps spec-file
  - #346: daps-xmlformat writes its messages into the output
  - #343: daps-init warning messages
  - #340: ePUB builds always show remarks
  - #335: on Debian, make install creates incorrect group in
          /etc/xml/config
  - #330: Enable SVG2Grayscale stylesheet to handle new color
          names
  - #305: locdrop produces no "non-trans" image tarball for a
          complete set
  - #301: SVG to PNG conversion creates very large PNGs
  - #289: Verbose / Debugging Output Should Show Profiling
          Attributes
  - #251: Write XSLT to Return xml-model PI
  - #226: Let stylesheets know which version of DAPS calls them
  - subcommand "clean-all" fails if run from within a directory
    that will be removed with that command
  - daps fails when called from a directory that no longer exists

* Cross-Distribution Support
  - first release with full Debian/Ubuntu support--manual
    adjustments after the installation are no longer needed
    (was required in previous releases for DocBook5 support).
    Many thanks to Tomáš Bažant and Christoph Berg for their help!
  - GitHub checkouts now also work for Fedora/RedHat and
    Debian/Ubuntu--refer to
    https://github.com/openSUSE/daps/blob/develop/INSTALL.adoc
    for details
  - tested on Debian 8.5.0 / Fedora 23 / openSUSE 13.2 and
    Leap 42.1 / SUSE Linux Enterprise 12 / Ubuntu 16.0

* Misc:
  - removed "daps-envconvert", a script for converting susedoc
    ENV-files to DAPS DC-files. susedoc was the predecessor of
    DAPS.
fsundermeyer added a commit that referenced this issue Jun 13, 2016
Stable release DAPS 2.1.6:

* New Features:
  - new subcommand "xmlformat" prettyfies the XML sources of a
    given DC-file or ROOTID using daps-xmlformat with
    /etc/daps/docbook-xmlformat.conf.
    (Note: this command will modify the original XML sources!)
  - SVG image support for HTML builds. To use it, make sure to
    provide the images in SVG format ad reference to them as follows:
    <imageobject role="html">
     <imagedata fileref="<SVG-FILE>" format="SVG"/>
    </imageobject>
  - the new global switch --jobs lets you specify how many parallel
    jobs to use. The default is set to the number of CPU cores (as was
    done in previous versions).
  - all commands generating file lists (e.g. "list-srcfiles") now
    generate human readable output on STDOUT. When the output goes
    to a pipe or subshell, it will be generated as a a one-liner.
  - Debugging of XML errors has been made easier. Sometimes the error
    message of the validator only points to an xi:include line, making
    it impossible to find the real location of the error. The option
    --novalid for the target "bigfile" will create the bigfile
    without performing a validation check on the sources. A single XML
    will be built and validated. Now the error message points to the
    exact location of the error in the bigfile. From there it should be
    easy to find the error in the original sources.
  - Verbose and debugging output now also show all profiling
    attributes set in the DC-file, plus version information for
    the sytlesheets (if available)
  - added the option --norefchecks to all output-generating targets
    ("html", "pdf", ...), "validate", "bigfile" and others. Allows
    to build/validate documents without checking internal links
    (<... linkend="<ID>">).
  - subcommand "online-docs" now always converts the bigfile that is
    created to NovDoc. To keep the same format as the original
    sources, specify --dbnoconv. To create a DocBook4 bigfile from
    DocBook5 sources, specify --db5todb4.

* Bugfixes:
  - #367: daps does not validate fop output
  - #366: Spellcheck trying to check the files "Cannot", "stat:", "No",
          "such", "file" ...
  - #364: DocBook5: Allow validating without checking xrefs
  - #363: Allow building a bigfile from invalid sources
  - #362: Make the number of parallel jobs configurable
  - #361: Externel xrefs are resolved to "????"
  - #360: Check Rootid fails on Debian 8.4.0
  - #356: file list output should default to pretty format
  - #354: Validate the result of online docs when it has been
          converted from DB5 to DB4 or novdoc
  - #353: Make db5 to db4 conversion default for online-docs
  - #351, #348, #342, #282: Fixes for the daps spec-file
  - #346: daps-xmlformat writes its messages into the output
  - #343: daps-init warning messages
  - #340: ePUB builds always show remarks
  - #335: on Debian, make install creates incorrect group in
          /etc/xml/config
  - #330: Enable SVG2Grayscale stylesheet to handle new color
          names
  - #305: locdrop produces no "non-trans" image tarball for a
          complete set
  - #301: SVG to PNG conversion creates very large PNGs
  - #289: Verbose / Debugging Output Should Show Profiling
          Attributes
  - #251: Write XSLT to Return xml-model PI
  - #226: Let stylesheets know which version of DAPS calls them
  - subcommand "clean-all" fails if run from within a directory
    that will be removed with that command
  - daps fails when called from a directory that no longer exists

* Cross-Distribution Support
  - first release with full Debian/Ubuntu support--manual
    adjustments after the installation are no longer needed
    (was required in previous releases for DocBook5 support).
    Many thanks to Tomáš Bažant and Christoph Berg for their help!
  - GitHub checkouts now also work for Fedora/RedHat and
    Debian/Ubuntu--refer to
    https://github.com/openSUSE/daps/blob/develop/INSTALL.adoc
    for details
  - tested on Debian 8.5.0 / Fedora 23 / openSUSE 13.2 and
    Leap 42.1 / SUSE Linux Enterprise 12 / Ubuntu 16.0

* Misc:
  - removed "daps-envconvert", a script for converting susedoc
    ENV-files to DAPS DC-files. susedoc was the predecessor of
    DAPS.

* Documentation:
  - the documentation has _not_ been updated for this release, so
    new features mentioned above are not yet covered
fsundermeyer added a commit that referenced this issue Jun 15, 2016
New Features:
  - new subcommand `xmlformat' prettyfies the XML sources of a given
    DC-file or ROOTID using daps-xmlformat with
    /etc/daps/docbook-xmlformat.conf. (Note: this command will modify the
    original XML sources!)
  - SVG image support for HTML builds. To use it, make sure to
    provide the images in SVG format and reference to them as follows:

         <imageobject role="html">
           <imagedata fileref="SVG-FILE" format="SVG"/>
          </imageobject>

  - the new global switch `--jobs` lets you specify how many parallel
    jobs to use. The default is set to the number of CPU cores (as was
    done in previous versions).
  - all commands generating file lists (e.g. `list-srcfiles`) now
    generate human readable output on STDOUT. When the output goes
    to a pipe or subshell, it will be generated as a a one-liner.
  - Debugging of XML errors has been made easier. Sometimes the error
    message of the validator only points to an xi:include line, making
    it impossible to find the real location of the error. The option
    `--novalid` for the target `bigfile` will create the bigfile
    without performing a validation check on the sources. A single XML
    will be built and validated. Now the error message points to the
    exact location of the error in the bigfile. From there it should be
    easy to find the error in the original sources.
  - Verbose and debugging output now also show all profiling
    attributes set in the DC-file, plus version information for
    the sytlesheets (if available)
  - added the option `--norefchecks` to all output-generating targets
    (`html`, `pdf`, ...), `validate`, `bigfile` and others. Allows
    to build/validate documents without checking internal links
    (&lt;... linkend="ID">).
  - subcommand `online-docs` now always converts the bigfile that is
    created to NovDoc. To keep the same format as the original
    sources, specify `--dbnoconv`. To create a DocBook4 bigfile from
    DocBook5 sources, specify `--db5todb4`.

Bugfixes:
  - #368: db4tonovdoc.xsl generates invalid NovDoc
  - #367: daps does not validate fop output
  - #366: Spellcheck trying to check the files "Cannot", "stat:", "No",
          "such", "file" ...
  - #364: DocBook5: Allow validating without checking xrefs
  - #363: Allow building a bigfile from invalid sources
  - #362: Make the number of parallel jobs configurable
  - #361: Externel xrefs are resolved to "????"
  - #360: Check Rootid fails on Debian 8.4.0
  - #356: file list output should default to pretty format
  - #354: Validate the result of online docs when it has been
          converted from DB5 to DB4 or novdoc
  - #353: Make db5 to db4 conversion default for online-docs
  - #351, #348, #342, #282: Fixes for the daps spec-file
  - #346: daps-xmlformat writes its messages into the output
  - #343: daps-init warning messages
  - #340: ePUB builds always show remarks
  - #335: on Debian, make install creates incorrect group in
          /etc/xml/config
  - #330: Enable SVG2Grayscale stylesheet to handle new color
          names
  - #305: locdrop produces no "non-trans" image tarball for a
          complete set
  - #301: SVG to PNG conversion creates very large PNGs
  - #289: Verbose / Debugging Output Should Show Profiling
          Attributes
  - #251: Write XSLT to Return xml-model PI
  - #226: Let stylesheets know which version of DAPS calls them
  - subcommand "clean-all" fails if run from within a directory
    that will be removed with that command
  - daps fails when called from a directory that no longer exists

Cross-Distribution Support
  - first release with full Debian/Ubuntu support--manual
    adjustments after the installation are no longer needed
    (was required in previous releases for DocBook5 support).
    Many thanks to Tomáš Bažant and Christoph Berg for their help!
  - GitHub checkouts now also work for Fedora/RedHat and
    Debian/Ubuntu--refer to
    https://github.com/openSUSE/daps/blob/develop/INSTALL.adoc
    for details
  - tested on Debian 8.5.0 / Fedora 23 / openSUSE 13.2 and
    Leap 42.1 / SUSE Linux Enterprise 12 / Ubuntu 16.0

Misc:
  - removed `daps-envconvert`, a script for converting susedoc
    ENV-files to DAPS DC-files. susedoc was the predecessor of
    DAPS.

Documentation:
  - the documentation has _not_ been updated for this release, so
    new features mentioned above are not yet covered
fsundermeyer added a commit that referenced this issue Jun 15, 2016
Stable release DAPS 2.2.0

New Features:
  - new subcommand `xmlformat' prettyfies the XML sources of a given
    DC-file or ROOTID using daps-xmlformat with
    /etc/daps/docbook-xmlformat.conf. (Note: this command will modify the
    original XML sources!)
  - SVG image support for HTML builds. To use it, make sure to
    provide the images in SVG format and reference to them as follows:

         <imageobject role="html">
           <imagedata fileref="SVG-FILE" format="SVG"/>
          </imageobject>

  - the new global switch `--jobs` lets you specify how many parallel
    jobs to use. The default is set to the number of CPU cores (as was
    done in previous versions).
  - all commands generating file lists (e.g. `list-srcfiles`) now
    generate human readable output on STDOUT. When the output goes
    to a pipe or subshell, it will be generated as a a one-liner.
  - Debugging of XML errors has been made easier. Sometimes the error
    message of the validator only points to an xi:include line, making
    it impossible to find the real location of the error. The option
    `--novalid` for the target `bigfile` will create the bigfile
    without performing a validation check on the sources. A single XML
    will be built and validated. Now the error message points to the
    exact location of the error in the bigfile. From there it should be
    easy to find the error in the original sources.
  - Verbose and debugging output now also show all profiling
    attributes set in the DC-file, plus version information for
    the sytlesheets (if available)
  - added the option `--norefchecks` to all output-generating targets
    (`html`, `pdf`, ...), `validate`, `bigfile` and others. Allows
    to build/validate documents without checking internal links
    (&lt;... linkend="ID">).
  - subcommand `online-docs` now always converts the bigfile that is
    created to NovDoc. To keep the same format as the original
    sources, specify `--dbnoconv`. To create a DocBook4 bigfile from
    DocBook5 sources, specify `--db5todb4`.

Bugfixes:
  - #368: db4tonovdoc.xsl generates invalid NovDoc
  - #367: daps does not validate fop output
  - #366: Spellcheck trying to check the files "Cannot", "stat:", "No",
          "such", "file" ...
  - #364: DocBook5: Allow validating without checking xrefs
  - #363: Allow building a bigfile from invalid sources
  - #362: Make the number of parallel jobs configurable
  - #361: Externel xrefs are resolved to "????"
  - #360: Check Rootid fails on Debian 8.4.0
  - #356: file list output should default to pretty format
  - #354: Validate the result of online docs when it has been
          converted from DB5 to DB4 or novdoc
  - #353: Make db5 to db4 conversion default for online-docs
  - #351, #348, #342, #282: Fixes for the daps spec-file
  - #346: daps-xmlformat writes its messages into the output
  - #343: daps-init warning messages
  - #340: ePUB builds always show remarks
  - #335: on Debian, make install creates incorrect group in
          /etc/xml/config
  - #330: Enable SVG2Grayscale stylesheet to handle new color
          names
  - #305: locdrop produces no "non-trans" image tarball for a
          complete set
  - #301: SVG to PNG conversion creates very large PNGs
  - #289: Verbose / Debugging Output Should Show Profiling
          Attributes
  - #251: Write XSLT to Return xml-model PI
  - #226: Let stylesheets know which version of DAPS calls them
  - subcommand "clean-all" fails if run from within a directory
    that will be removed with that command
  - daps fails when called from a directory that no longer exists

Cross-Distribution Support
  - first release with full Debian/Ubuntu support--manual
    adjustments after the installation are no longer needed
    (was required in previous releases for DocBook5 support).
    Many thanks to Tomáš Bažant and Christoph Berg for their help!
  - GitHub checkouts now also work for Fedora/RedHat and
    Debian/Ubuntu--refer to
    https://github.com/openSUSE/daps/blob/develop/INSTALL.adoc
    for details
  - tested on Debian 8.5.0 / Fedora 23 / openSUSE 13.2 and
    Leap 42.1 / SUSE Linux Enterprise 12 / Ubuntu 16.0

Misc:
  - removed `daps-envconvert`, a script for converting susedoc
    ENV-files to DAPS DC-files. susedoc was the predecessor of
    DAPS.

Documentation:
  - the documentation has _not_ been updated for this release, so
    new features mentioned above are not yet covered
ghost pushed a commit that referenced this issue Jul 18, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants