- 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
* 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
- BUGFIXES:
* fixed misspelled variablename in fo generating target
* remarks in HTML and PDF builds were only shown when comments
were turned on, too. This had been fixed earlier but the fix
seems to have been reverted by mistake. Re-enabled the fix in
the inline.xslt stxlesheets for fo and html
- -r/--remarls now implies draft mode
- -m/--meta now implies draft mode but does not imply remarks
anymore
- new switch -m/--meta for pdf builds (adds same functionality as
for the html builds)
OBS-URL: https://build.opensuse.org/package/show/Documentation:Tools/daps?expand=0&rev=68
