Version 1.0beta1:

* 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
This commit is contained in:
Frank Sundermeyer
2012-03-08 11:17:04 +00:00
committed by Git OBS Bridge
parent d0f6f8dbbb
commit fc2e98f6b1
6 changed files with 192 additions and 124 deletions

View File

@@ -1,3 +1,124 @@
-------------------------------------------------------------------
Wed Mar 7 15:54:22 UTC 2012 - fsundermeyer@opensuse.org
Version 1.0beta1:
* 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
- Parameter: --fb_styleroot
- Value: absolute path to directory
* CSS files:
Specify CSS files for HTML and/or CSS. By default no CSS file
will be used.
- Variables: HTML_CSS, EPUB_CSS
- Parameter: --css for html and epub targets
(daps -d <DC> html--css <CSS> )
- Value: absolute path to file
* rewrote FOP formatter handling - both supported formatters (FOP/XEP) are
now controlled by the following variables:
*_WRAPPER (wrapper script, libexec/daps-fop, libexec/daps-xep by default)
*_CONFIG (xml config file, etc/daps/xep/xep-daps.xml and
etc/daps/fop/fop-daps.xml by default. A specific fop-daps.xml
is installed for RedHat and SUSE by default)
*_OPTIONS (Command line options)
* renaming of parameters and variables
In order to make parameters and variables "self-speaking" the
following has been renamed:
- File ENV-file to DC-file (doc config file)
- Variable BASE_DIR to DOC_DIR (doc dir) => Terminology!
- Variable DTDROOT to DAPSROOT (daps installation directory)
- Variable FOP_TYPE to FORMATTER
- command line switch --fop to --formatter
- command line switch -e/--envfile has been renamed to
-d/--docconfig (-e/--envfile will still be supported)
* global parameter --base_dir no longer supported
Instead of specifying --base_dir with daps, you now need to specify a
full path (either relative or absolute) to the DC-file. However, the
"magic" that automatically tries to determine the path to a DC-file
when you do not specify a path or not even a DC file, still applies.
Therefore you only need to specify a valid path to the DC-file in
cases where you would have used --base_dir with previous DAPS
versions.
* --main parameter / MAIN
Instead of calling daps with -d/--docconfig you can also directly
specify a MAIN with --main=<PATH>. You need to specify a valid
relative or absolute path. If you just specify a
file name, ./xml/$MAIN is automatically assumed.
* packaging
The former DAPS version has been split into two packages:
- daps
- suse-xsl-stylesheets (SUSE stylesheets, NovDOC DTD, SUSE aspell
wordlist)
* other DAPS changes since 0.9.2 in brief:
- stylesheet images have been moved to fit the directory structure used
in the original stylesheets
- new variable STYLEDEVEL which can be used when developing stylesheets.
STYLEDEVEL _always_ takes precedence over STYLEROOT and can be set in
$USER_CONFIG
- Rewrote handling of profiling variables PROFARCH, PROFCONDITION,
PROFVENDOR, PROFOS - all 4 are now fully supported (formerly only
PROFOS and PROFARCH were fully supported)
- created catalog entry to resolve stylesheets in daps_xslt
- daps init has been moved to a separate script bin/daps-init
- each SUSE stylesheet file now contains a short overview of purpose
and parameters
- lots of stylesheet bugfixes
- license: GPL 2.0 or 3.0 at your choice
- fixed target man for man-page generation; man pages are not gzip'ed
by default (unless you specify --nogzip); manpage subdirectories
(man1, man2,...) are no longer created by default, but can rather be
enabled via the --subdirs switch
- new parameter --check for target epub checks build with epubcheck
- added very basic DocBook5 support (with xslt 1.0 stylesheets only)
still a lot to do on this front
- Default HTML format is now XHTML 1.0 (instead of HTML 4.01). Use
--html4 to generate HTML 4.01
- auto generate SUSE HTML4 stylesheets from XHTML stylesheets
- binaries that are only called from withion make have been moved to
libexec/
-------------------------------------------------------------------
Mon Jan 9 15:30:47 UTC 2012 - toms@suse.de