- 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
daps-auto.pl:
* a perl script to automatically build documents and deploy them
to a remote machine via rsync
EPUB:
* completely rewrote the epub generating code
* no longer needs an external script (db2epub.ruby) for
epub-file generation - now everything is handled in
make itself
HTML/HTML-Single/JSP:
* added a --clean switch which clears the directory
before generating a new version
Packaging:
* completely rewrote the code for package-src
- new option --set-date allows to set a publication date
(default: current date)
* new options for package-html and package-pdf
--desktopfiles: generates an archive with desktopfiles for KDE3
--documentfiles: generates a documnet file for KDE4/GNOME2
--pagefiles: generates a page file for GNOME3
* completely rewrote online-docs
- now automatically generates epub, color-pdf and single-html archive
- new option --export-dir to specify a results directory
* completely rewrote locdrop
- new option --export-dir to specify a results directory
Spellchecking:
* no longer a stand-alone program
* use "daps -d DC-file spellcheck" to check single files
(--file option), complete documents (via DC-file) or
parts of a document (vi ROOTID)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=102
- target showvariable exited with an error if requested variable
was empty
- disabled Permalink generation for PDFs (this is an HTML-only
feature)
- images were not cerrectly references for target jsp
- the DEF file was not correctly packaged in target locdrop
- fixed webhelp target. Wildcards do not work in classpath
expression, resolved them with $(wildcard $(firstword())
- Warning message "DEF file is missing" was issued for targets
that do not have a --def-file option
- targets package-html and package-pdf failed with an error on
desktop files generation
- target remaininggraphics always returned an empty list
- SVG to SVG conversions generated useless error messages
* Stylesheets:
- removed obsolete stuff for @role=productname,
productnumber, or productnameref
- Quick Start Guide: Finished
- Updated README.upgrade_from_susedoc_4.x
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=96
* Important:
- in order to avoid confusion with short options for daps itself
(such as -d for --docconfig and --draft),
the subcommands only support long options now. The following
short options for subcommands are no longer supported:
-c (use --comments)
-d (use --draft)
-f (use --file)
-m (use --meta)
-n (use --name)
-p (use --pretty)
-r (use --remarks)
-s (use --show)
- the only short option that will remain is -h (help)
* Bugfixes:
- target warn-images did not work
- target missinggraphics did not show all missing images
- daps failed with a useless error message when $MAIN was not
well-formed. The fix produces a useful error message now
- --remarks option did not work with DocBook stylesheets
- paths specified on the command line or the config file had to
be absolute. The fix now allows to also specify relative paths
for all configurable directories and files
- COMMENTS_STR, DRAFT_STR and REMARK_STR were not correctly unset
when one of these modes was not set on the command line but
implied by another mode (e.g. --meta). The result was a wrong
filename
- target webhelp-dir-name was missing
- draft.png was not shown in PDF/HTML draft builds when using the
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=93
* Bugfixes:
- Issuing hint on missing formatter scripts only when verbosity
is >= 1
- spec-file: Fixed typo on suse-xsl-stylesheet recommends
python-xml needs to be a general requirement
- fixed path to callouts and style images for FO
* Lots of minor documentation fixes/enhancements
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=88
* Bugfixes:
- fixed minor package building issues
- inkscape always returns 0, even in case of an error. Added
a workaround, so daps now exits when an image conversion with
inkscape fails
- --main option should work now
- Fixed errors on setting the fallback stylesheets
- comments and remarks did not show up in the docs when requested
(again ;-(( ) - this is fixed now
* much better error handling - daps will now exit when wrong paths
or a non existing ROOTID are entered in the user config file
or the DC file
* significant enhancements to the Documentation
(Reference & Quickstart)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=84
* Rebuild large parts to make DAPS distribution-independent.
- rewrote Makefile for automake/autoconf
=> configure; make; make install is now supported
- thorough cross-distribution testing is still needed, basic tests
have been run on RedHat, Debian and Ubuntu
* removal of custom stylesheets
DAPS no longer uses the SUSE stylesheets as a default. It even no
longer contains the SUSE stylesheets - they are now available as a
separate package (suse-xsl-stylesheets in Documentation:Tools).
- By default DAPS uses the generic DocBook stylesheets now
- Custom stylesheets such as the SUSE stylesheets can be used by
specifying up to four parameters on the command line/the config
files:
* Styleroot:
Directory containing the custom stylesheets. Must have the same
directory structure as the original DocBook stylesheet root
directory. Does _not_ need to contain stylesheets for all output
formats. If stylesheets are not found, DAPS will automatically
fall back to the DocBook stylesheets.
- Variable: STYLEROOT
- Parameter: --styleroot
- Value: absolute path to directory
* Fallback styleroot
Custom fallback styleroot. If DAPS cannot find styles for the
given output format, it will automatically fall back to the
DocBook stylesheets. This config option will add a custom
fallback directory with higher priority. The DocBook stylesheets
will remain as a last resort, however.
- Variable: FALLBACK_STYLEROOT
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=79
