Added documentation for customizing stylesheets fixes #403 #407
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
tomschr
requested changes
May 11, 2017
doc/xml/daps_user_layout.xml
Outdated
| @@ -110,8 +110,8 @@ | |||
| <title>Adjusting the Layout of Variable Lists</title> | |||
| <para> | |||
| By default, the DocBook stylesheets display the contents of a | |||
| <sgmltag>variablelist</sgmltag> as a table. To change this temporarily, | |||
| set the parameter <parameter>variablelist.as.table</parameter> to <literal>0</literal> by executing the following command: | |||
| <sgmltag>variabl in your DC files.elist</sgmltag> as a table. To change this temporarily, | |||
There was a problem hiding this comment.
The content in sgmltag looks strange.
doc/xml/daps_user_layout.xml
Outdated
| <important> | ||
| <para> | ||
| The reader should be aware of that he or she needs some knowledge about | ||
| XSLT (at least a little bit). Basic customizations like parameter changes |
There was a problem hiding this comment.
You can omit the "he or she" if you rephrase it like:
The reader should be aware of that some knowledge about XSLT is needed.
doc/xml/daps_user_layout.xml
Outdated
| can be done by simple adding a line with: | ||
| <screen><xsl:param name="PARAMETER_NAME" select="VALUE"/></screen> | ||
| The available parameters are format dependent and are listed in the | ||
| "XSL Stylesheets Reference Documentation". |
There was a problem hiding this comment.
Add a link to http://docbook.sourceforge.net/release/xsl/current/doc/param.html for the "XSL Stylesheet Reference Documentation".
doc/xml/daps_user_layout.xml
Outdated
| </para> | ||
| </important> | ||
| <para> | ||
| Best practice is to store the stylesheets in a xslt directory as the |
There was a problem hiding this comment.
Use <filename> for "xslt"
doc/xml/daps_user_layout.xml
Outdated
| </para> | ||
| </note> | ||
| <para> | ||
| In the following we will create the directory stucture for customizations of the HTML output. |
There was a problem hiding this comment.
Add "procedure" after "following"
tomschr
approved these changes
May 11, 2017
fsundermeyer
added a commit
that referenced
this pull request
Jun 14, 2017
Stable release DAPS 2.4.0:
* New Features:
- added a dependency checker for DAPS (/usr/bin/daps-check-deps)
that makes it easy to check for missing programs/packages
- added a "--lean" parameter to PDF generation for creating PDFs
with a reduced file size (by reducing the quality of included
images); useful for sharing PDFs via e-mail
- added a srylesheet for returning all IDs from an XML file
(daps-xslt/common/get-all-xmlids.xsl)
* Bugfixes:
- #408: The list-file-* commands now work with ROOTIDs from all
possible elements
- #390: When an ID appears twice in the XML and this ID is used
with --rootid, DAPS's error message is unhelpful
- #365: Improved error messages on "File not found" errors
(now tells whether the path was provided by command-line
or config file)
- #371: Make path to the xmlformat config file configurable
- #372: Adjusted debian dependency list
- #373: Check unpack-locdrop
- #379: Output error of list-images-multisrc with
pretty | wc option
- #380: Proper error messages when binaries/packages are missing
- #392: daps-xmlformat writes name of config file into output
- SVGs were not included in ePUBs
(https://bugzilla.suse.com/show_bug.cgi?id=1006204)
- Setting a default value for db5_version in configure.ac
otherwise the DB5 URN in etc/config will be set to an invalid
value if DB5 is not installed when running make
- fixed a few minor issues with the config file parser that was
introduced with 2.3.0 (among them #387)
- Increased Java stacksize for jing
- Improved the DocBook5 -> DocBook 4 (-> NovDoc) conversion
- compatibility: Debian's version of "which" does not support
long parameters
* Documentation:
- Various updates to reflect changes in the code
- #345: added documentatioon for the xmlformat subcommand
- #362: added documentation for the --jobs option
- #363: added documentation about building a bigfile from
invalid sources
- #364: added documentation for the --norefchecks option
- #403: improved documentation about stylesheet customizing
(also see #407)
- #404: clarify doc about listing unused images
- completely revised the doc (spelling, language and grammar)
- doc is not yet 100% on par with the code, but we are getting
closer
* Compatibility:
- successfully tested DAPS on Linux Mint 18.1
fsundermeyer
added a commit
that referenced
this pull request
Jun 14, 2017
Stable release DAPS 2.4.0:
* New Features:
- added a dependency checker for DAPS (/usr/bin/daps-check-deps)
that makes it easy to check for missing programs/packages
- added a "--lean" parameter to PDF generation for creating PDFs
with a reduced file size (by reducing the quality of included
images); useful for sharing PDFs via e-mail
- added a srylesheet for returning all IDs from an XML file
(daps-xslt/common/get-all-xmlids.xsl)
* Bugfixes:
- #408: The list-file-* commands now work with ROOTIDs from all
possible elements
- #390: When an ID appears twice in the XML and this ID is used
with --rootid, DAPS's error message is unhelpful
- #365: Improved error messages on "File not found" errors
(now tells whether the path was provided by command-line
or config file)
- #371: Make path to the xmlformat config file configurable
- #372: Adjusted debian dependency list
- #373: Check unpack-locdrop
- #379: Output error of list-images-multisrc with
pretty | wc option
- #380: Proper error messages when binaries/packages are missing
- #392: daps-xmlformat writes name of config file into output
- SVGs were not included in ePUBs
(https://bugzilla.suse.com/show_bug.cgi?id=1006204)
- Setting a default value for db5_version in configure.ac
otherwise the DB5 URN in etc/config will be set to an invalid
value if DB5 is not installed when running make
- fixed a few minor issues with the config file parser that was
introduced with 2.3.0 (among them #387)
- Increased Java stacksize for jing
- Improved the DocBook5 -> DocBook 4 (-> NovDoc) conversion
- compatibility: Debian's version of "which" does not support
long parameters
* Documentation:
- Various updates to reflect changes in the code
- #345: added documentatioon for the xmlformat subcommand
- #362: added documentation for the --jobs option
- #363: added documentation about building a bigfile from
invalid sources
- #364: added documentation for the --norefchecks option
- #403: improved documentation about stylesheet customizing
(also see #407)
- #404: clarify doc about listing unused images
- completely revised the doc (spelling, language and grammar)
- doc is not yet 100% on par with the code, but we are getting
closer
* Compatibility:
- successfully tested DAPS on Linux Mint 18.1
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.