* New Features:
- parameters for text generation can be set in the config files
via TXT_PARAMS or via --param/--stringparam on the command line
- a change introduced in 2.0 made using the original DocBook
stylesheets for text generation the default. Since this behavior
is confusing and unexpected, it is reverted with this change:
* the stylesheets configured via STYLEROOT or --styleroot are
used by default for text generation
* to ignore _any_ STYLEROOT definitions, set
TXT_IGNORE_STYLEROOT="yes" in the config files or use
--ignore-styleroot on the command line
(daps -d <DC> text --ignore-styleroot)
* Bugfixes:
- Fix for issue #294: xmlcatalog returns file:<PATH> rather than
file://<PATH> on Debian Jessie and openSUSE Tumbleweed and
caused DAPS to fail with DB5 sources
* Misc
- added basic debugging output to test suite (--debug)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=180
* Bugfixes:
- Fix for issue #284 (spellcheck / getimages use wrong filelist
when called with --debug
- "--param" and "--stringparam" were missing for the subcommands
package-pdf and package-html
- all warning messages now go to STDERR, making it possible to
always catch the output of a DAPS command with FOO="$(daps...)
* Misc:
- added a wrapper for jing allwing to customize java flags,
jars, and options
- standardized customising options for all java programs (fop,
jing, xep)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=177
* Bugfixes:
- Fix for issue #274 (PDF Index Building Fails Because of Empty
Profiling Directory)
- fix for issue #275 (Avoid Same Target Names in Different
Makefiles)
- fix for issue #276 (PROFILE_URN Detection Depends on Position of PI
in Document)
- fix for issue #277 (Debugging Targets Fail when xml:lang is
not set)
- fix for issue #278 (Avoid Using "LANGUAGE" as a Variable Name)
- fix for issue #280 (Webhelp: Common/ Directory Contains Dead
Symbolic Links)
* New Features:
- added support for profiling attribute "outputformat" by
intrducing PROFOUTPUTFORMAT (issue #279)
* Miscellaneous:
- replaced Chinese font "FZSongTi" with "wqy-microhei" in the
default config file for XEP
(XEP_CONFIG_FILE=etc/xep/xep-daps.xml)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=173
- added support for webhelp
- added support for <xi:include ... parse="text"> (issue #71)
- handling of passing XSLT parameters on the command line has been
improved (issue #263)
- improved handling of doxcuments that do not need to be profiled
- daps_autobuild: changed the order of builds to increase performance
- Bugfix package-src: removed extraneous text
- Bugfix daps_autobuild: in case no rebuild was necessary, rsync
deleted the previous results
- Bugfix DB4 -> DB5 migration: Fixed various issues in the migration
stylesheet
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=171
- supporting rng _and_ rnc schemas for validation with jing
- added a --debug switch and error reporting to daps_autobuild
- moved a --meta related warning so it does not get displayed
when running a *-name subcommand
- fixed a quoting issue in daps-migrate and daps_functions
- fixed an error in the DB4->DB5 migration stylesheet (formatting
was lost on <term> tags)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=169
- replaced daps-auto.pl with daps_autobuild
* uses an XML file as a config file (can be validated with
schema that is also provided)
* supports git _and_ svn repos
- DB5 fix for target productinfo
- locdrop target can now read information about translated files
from in-file tag provided by docmanager
- fixed two issues in the unpack-locdrop target
- fixed stylesheet issues when using saxon as a parser
- Added missing dependency on $(RESULT_DIR) for epub
- bash code cleanup
- Changed default DB5 schema fom docbook.rng to docbookxi.rng
(supports xi:includes)
- Documentation: now covers all 2.0 changes
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=167
(releases rc3 and rc4 have not been made available as SUSE builds)
- Full support for DocBook 5 now (finally)
- various fixes for ePUB (again):
-ePUB 2 builds without warnings/errors in epubcheck
-ePUB3 shows a few warnings/errors in epubcheck resulting from
errors in the stylesheets
-make sure ePUB gets a correct date format (YYYY-MM-DD)
- Moved DAPS user config directory to ~/.config/daps/. The config file
has been renamed to dapsrc (the user will be notified and DAPS will
automatically do the move if the user agrees)
- all of DocBook's profiling attributes are no supported
- Various build fixes to make it work on Debian Wheezy, Fedora 20/21
openSUSE 13.x, SLE 12, and Ubuntu 14.10
- tested DAPS on Debian Wheezy, Fedora 20/21 and Ubuntu 14.10
- Added script and stylesheets to migrate DocBook4 projects to
DocBook 5 (libexec/daps-migrate)
- various fixes and improvements for bin/daps-init (incl. man page)
- Added support for local static/ directories
- Established new locdrop workflow
- Fixed daps-init
- strings passed with --xsltparam no longer need to be uoted with double
and single quotes--only use double quotes now
- Definied DAPS version for major, minor, and micro (configure.ac)
- Introduced daps_version_{major,minor,micro} substitutions
- Corrected URL from SourceForge to GitHub
- Used DAPS version in AC_MSG_NOTICE
- Unified copyright statements
- Let configure change the Version in entity-decl.ent
- Created DOCTYPE and PI node manually for daps-xslt/profiling/
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=164
- fully supporting the suse-doc-style-checker (target stylecheck)
- fix for "online-docs": only tar'ing png and jpg if respective
images are available
- fix for ticket #225 (Misleading error message when xml files do
not reside in a directory named xml/)
- fix for ticket #218 (Improve error handling for --rootid
parameter)
- added tests for targets "package-html and "package-pdf"
- resulting filenames for package-html and package-pdf can now
be queried via "showvariable"
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=143
- replace special characters (such as space or "/") from
profiling attributes with "_" when generating the profiling
directory path
- Made profiling depend on the DC file, too, to ensure a rebuild
is triggered whenever the DC file changes
- STYLEIMG was set in a way that it had an incorrect value in case
a fallback STYLEROOT directory was used
- Improved error message when not being able to determine DocBook
version
- spec file:
* require xmlstarlet
* remove emacs-psgml recommendation
* svg-dtd package has been renamed to svg-schema
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=141
Features:
- Use original HTML DocBook Stylesheets for txt output by default:
* use custom stylesheets by setting TXT_USE_DBSTYLES to "no"
Bugfixes:
- STYLEROOT and FB_STYLEROOT definitions in the config files were
checked even if values were specified on the command line
(ticket #211)use custom stylesheets by setting TXT_USE_DBSTYLES
to "no"
- JSP result directory was incorrect when no profiled MAIN existed
(ticket #212)
- PDF was not copied to the result dir when running package-pdf
- Improved error message when having specified a second bareword
after the subcommand (ticket #185)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=137
- First beta for a new major release
Output targets:
---------------
* the number of subcommands has been significantly reduced, see
"daps --commands", "daps help" and "daps help <SUBCOMMAND>" for
more information
- "html-single" has been replaced by "html --single"
- "jsp" has been replaced with "html --jsp"
- "color-pdf" has been replaced by "pdf" (now produces color PDFS)
- "pdf" has been replaced by "pdf --grayscale --cropmarks"
- "projectfiles" and "projectgraphics" have been replaced with
"list-srcfiles" (see daps help "list-srcfiles" for more options)
- all dist-* commands have been removed
- when calling deprecated targets, an error message hinting at a
valid alternative (is existing) is shown
* subcommand bigfile now generates a bigfile for the given rootid
(rather than for the complate set); target bigfile-reduced has been
dropped
* subbcommands package-pdf and package-html now have switches
--dcoumentfiles, --desktopfiles and --pagefiles which generate
the resource files for GNOME and KDE
* new subcommands
- "clean-package" removes all generated package data for the given
DC-file. Generated images and profiled sources will _not_ be
deleted.
- "dapsenv" shows a list of the most important make variables
and their values
- "images" generates images only for a given rootid. Intended for
debugging purposes
- "package-src" (creates a tarball with profiled XML sources and
images); switch --set-date allows to specify a build date (default
date is "now")
* ePUB generation has been completely rewritten (pure make solution,
no longer uses the ruby script from upstream); generated ePUBs
now validate with epubcheck3.
- added support for .mobi (Amzon Kindle format). Requires calibre.
(ticket #98)
* replaced support for HTML4 with support for HTML5 (--html5)
xhtml remains the default, html4 is no longer supported
* to nullify a CSS-file definition for HTML or EPUB (HTML_CSS or
EPUB_CSS) from the DC-file, specify "--css none"
Miscellaneous:
--------------
* now supports XSLT processor saxon6 (in addition to xsltproc),
specify with --xsltprocessor (default: xsltproc)
* improved verbosity handling:
- if output is not a terminal (e.g. pipe) only prints the
resulting filename (-v0)
- default verbosity shows a result message plus filename (-v1)
- -v2 shows additional messages
- -v3 shows the complete make output from make -j1 (commands are
executed successively, not parallel)
- --debug shows the complete make output from make -j1+x
(commands are executed parallel; this also shows in the debug
output)
* added support for JPG images (ticket #101)
* added support for a "static/" directory in STYLEROOT containing
css, js and images taht are reference in the CSS and the
stylesheets for HTML
* New general switch --commands shows all available subcommands
* if the XML sources are not well-formed, a meaningful error
message is shown
* xsltparameters have to be submitted as --param PARAM=VALUE or
--stringparam PARAM=VALUE (the "=" is mandatory, used to be
a "space2 with DAPS 1.x)
* output formats are only re-generated when the source files
(xml, entity files or images) have changed. To force a rebuild
run DAPS with --force or run a suitable clean command
* added switches --author and --productname switches to daps-init
Config file changes:
--------------------
* New config file variables:
COVERT_OPS_JPG: command-line options for "convert" for converting
jpg images to grayscale
FOP_STACKSIZE: set stacksize for fop (ticket #82)
META, META_STR: permanently run html and PDF builds with
--meta
STATIC_DIR: custom static directory
XML_USER_CATALOGS: add custom catalogs to XML_CATALOG_FILES
(ticket #99)
XSLTPROCESSOR: Use the specified XSLT processor
(saxon6 or xsltproc)
Code changes:
-------------
* big makefile (common.mk) has been split into several small files
- easier to maintain
- improved performance by only loading makefiles that are needed
for the given subcommand
* added a comprehensive test suite to ensure better quality when
releasing
* no longer requires Bash 4--Bash 3 is sufficient
Documentation:
--------------
* Quickstart has been updated to cover DAPS 2.0
* Update of User Guide is WIP
* new Tutorial "How to Write an Article with DocBook and DAPS"
Bugfixes:
---------
Numerous bugfixes and improvements, among them:
* #64 Split Makefiles
* #66 daps: DC Files and Platform Dependant Paths
* #73 Create PDFs for target locdrop if --def-file is specified
* #82 Add config parameter for FOP (XEP?) stacksize
* #85 Set a fixed <date/> date with package-src target
* #98 Adjust EPUB Stylesheet to Suppot Kindle
* #99 Support User Definied Catalogs by Setting XML_CATALOG_FILES...
* #101 DAPS should support JPEG as a source file format
* #103 Exit target package-source when there are missing images
* #105 DAPS's sub-commands are somewhat inconsistent
* #106 Enable overwriting xsltproc params
* #108 Support FOP 1.1
* #115 --css/HTML_CSS parameter is completely ignored if styleroot...
* #116 Move font requirements from daps specfile to ...
* #126 Add --show switch to checklink
* #127 productinfo sometimes fails and is slow
* #129 Get rid of native xsltproc calls
* #136 daps Ignores Language in Document for Spell Checking
* #138 DAPS makes it easier to create black/white PDFs than ...
* #139 When trying to create a PDF file with malformed XSLT files...
* #142 Saxon seems to have problems with NovDoc documents
* #146 EPUB CRITICAL Error: No manual specific tmp dir
* #147 EPUB validation error on callouts
* #148 --meta only works when profiling
* #159 Fatal Error in ePUB stylesheets
* #163 JSP Stylesheets fail with saxon6
* #165 FOP config file is unnecessary
* #166 Reduce Logging Output of Apache's FOP
* #171 Remove unnecessary "eval" statements in the DAPS code
* #192 Create filenames in a single place
* #196 EPUB does not build with saxon
Known Issues:
-------------
* the webhelp code hasn't been touched at all; webhelp will most
likely not work
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=133
* option -m was missing when parsing the command line options
* allow relative paths for --statdir and --export-dir
* A custom static dir (--statdir) was not correctly copied/linked
when no --static option was specified
* fixed entitiy packaging in various targets
* made automatic setting of HTML_CSS and EPUB_CSS more robust by
allowing empty values when readlink fails
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=128
* General:
- reducing code by adding MAIN to the list of DOCFILES, by
generating the list of ENTITY files globally and by
using HTML_DIR for HTML. HTML-SINGLE and JSP
* EPUB:
- fixed critical error: a single tmp dir was used to generate
different EPUB books
- EPUB zip file is now generated from a file list extracted from
OEBPS/content.opf. This ensures that only files referenced
in the content.opf are packaged
- Added fix for bug in DocBook stylesheets which generates an
empty date entry in content.opf which causes a validation error
- Improved CSS handling:
- if no CSS file is specified on the command line or in the
DC-file, the _first_ one found in <STYLEDIR>/epub/ is
automatically used
- --css now requires a parameter - if you do not want any CSS
file to be used, specify "none": --css=none
- EPUBs now validate with epubcheck 3.0
* HTML:
- if using the DocBook standard layout for resources
<STYLEDIR>/images
<STYLEDIR>/<FOO>.css
it is no longer manfdatory to specify a CSS file on the
command line or in the DC-file. DAPS will automatically use the
_first_ *.css file in <STYLDIR>/ if none is specified
- if using a static dir for resources
<STYLEDIR>/static
|-css
|-js
|-images
you can now specify an alternative css file with --css or an
alternative static dir with --statdir
- this makes it possible to switch between stylsheets using the
two different resource directory approaches without having to
modify a DC-file
- the --css parameter now requires an argument. If you want to
use no stylesheet at all, specify --css=none
NOTE: This update requires to run the first HTML, HTML-Single
and JSP build after the update with the --clean switch in
order to create a clean result directory.
- if both variants (<STYLEDIR>/images and <STYLEDIR>/static
exist, the static directory is automatically used
* LOCDROP:
- DC-files are delivered with a locdrop if --def-file is
specified
- NO_TRANS_FILES was not correctly computed
- entity files were missing in packages
* PACKAGE-SRC:
- entity files were missing in packages
* ONLINE-DOCS:
- generating a uniquely named graphics tarball for each book
(when export-dir is set) instead of one that gets overwritten
with each build
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=122
* fixed errors in EPUB generation (wrong paths in content.opf)
EPUBs should now be viewable in all ePUB viewers
* fixed two errors in target locdrop: no proper image tarball was
generated and the notrans-tarball had a wrong path
* added a missing conditional requirement (on $IMG_DIRECTORIES)
for image building
* fixed errors when building dist-{html,htmlsingle,jsp}
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=116
