Release Notes ------------- New Features and Bugfixes in Publican 3.0 Rüdiger Landmann Red Hat Engineering Content Services Copyright © 2012 Red Hat, Inc. This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at http://www.gnu.org/licenses/fdl.txt). Abstract This document describes the enhancements and fixes included in Publican 3.0. Publican is available for download at https://fedorahosted.org/publican/. The Publican User Guide is available at http://jfearn.fedorapeople.org/en-US/Publican/3.0/html/Users_Guide/index.html. ------------------------------------------------------------------------ wkhtmltopdf For PDF generation FOP has been replaced with wkhtmltopdf. Publican website The database has changed. Users of Publican 2.x websites must run publican migrate_site to update their database. Publican now supports 2 web site layouts, controlled with the web_style parameter in the site configuration file. web_style 1, the original style, has been tweaked to be a more modern. web_style 2 a new layout style that is much more modern that the original style. Important Publican uses javascript to check for the existance of toc.html to determine which style to use for the layout. If you switch from style 1 to style 2 you will need to manually remove toc.html. Doing it this way allows you to switch between styles without regenrating any of the books. Updates to change tracking. BZ #661568 Changes were tracked in publican.spec. The Changes file now tracks changes, and the spec file tracks rebuilds of packages. Cleaned up README file. Corrected document conventions text. BZ#651616 Fixed inconsistencies between text and examples. Make XmlClean use File::Inplace instead of grep & sed. BZ #661567 Deleted STRICT mode. Added banned_tags and banned_attrs configurations. BZ #663202 In a brand you can add a list of banned tags or attributes using banned_tags and banned_attrs respectively to either defaults.cfg or overrides.cfg. These will be listed by the Publican action print_banned. Fixed command example in PUG. BZ #663211 Use revision history for edition and release in translated languages. BZ #642127 update_po now adds a LANG/Revision_History.xml file; building the book adds this file to the English Revision History. Warning Many books have revnumbers that will not work when trying to package books due to format constraints. These books will have to have their revnmbers corrected. Deleted edition and release config parameters. BZ #642127 Add add_revision action and associated options. BZ #642127 publican add_revision adds an entry in Revision_History.xml. Options: --lang=LANG the language the XML will be written in. --revnumber=REVNUMBER revision number to use for a revision. Will default to REVNUMBER + 1 if not specified. --date=DATE date to use for a revision. Will default to current date if not set. --member=MEMBER an entry to be added to the revision. Can be specified multiple times. --firstname=FIRSTNAME firstname to use for revision author. Optional if set in ~/.publican.cfg. --surname=SURNAME surname to use for revision author. Optional if set in ~/.publican.cfg. --email=EMAIL email address to use for revision author. Optional if set in ~/.publican.cfg. Fix wrong BuildRequires and path for desktop packages. BZ #676472 Correct typos. Yuri Chornoivan yurchor@ukr.net BZ #676997 Fix CreateBook texts missing from pot file. BZ #677119 Replace msgmerge BZ #661569 Implimented internal XML->PO and PO->XML routines. Added --msgmerge to update_po to allow users to switch back to using msgmerge. update_po --msgmerge use gettext's msgmerge for POT/PO merging. Added base_brand config option for brands to allow multiple base brands. BZ #697367 DocBook 5 tech preview. To convert a publican book's XML to DB5, cd in to the book directory and run: db4-2-db5 Edit the publican.cfg: brand: common-db5 dtdver: 5.0 Test build with --novalid. Added site config toc_type to allow selecting TOC styles. BZ #697375 toc_type specifies the name of a custom TOC template. By default, Publican looks for toc-$toc_type.tmpl in /usr/share/publican/templates. You can override this by setting an alternative path with tmpl_path. Added authortest target for author tests. Removed Site statistics, site tech and HTML site map from Publican website. BZ #697376 Truncate PO Fuzzy/Un-translated message, added PO line number. BZ #697380 The error message used to display the full fuzzy string. The message is now truncated at 64 characters and displays the PO line number the entry starts on. Add translation Author_Group.xml BZ #697371 Translators are now able to add an Author_Group.xml to their language directory. When the document is built this file will be appended to the source language version. Split pod from publican command to allow auto-generation. Fix bridgehead links not working in html. BZ #711348 Re-add API check. BZ #742097 Fix wkhtmltopdf format when building web packages. Updates based on beta testing. Fix sort order of books in website navigation. BZ #743792 String comparison of Product and Book Name is now case insensitive. See the new sort_order parameter for more details on how to customize website order. Extra bottom margin for screen. BZ #738689 Change stepalternative list style. BZ #687894 Add print_unused_images action. BZ #724850 Prints a list of the image files not referenced by an tag in a book, article, or set. Fix print_unused not matching relative paths. BZ #740417 Fix empty parameters being parsed as arrays BZ #744964 Empty fields were corrupting the website TOC and displaying values such as ARRAY(0x388baf8). Empty fields in publican.cfg are now ignored. Removed border from blockquote. BZ #734154 No newline after email when inline. BZ #745304 Add Indic fonts to RPM spec requires. Switch RPM spec requires from FOP to wkhtmltopdf Remove old2new action & Makefile::Parser dep. BZ #752640 Override install & common paths on darwin. BZ #752620 Remove Image::Magick & Image::Size deps and max_image_width option. BZ #752637 Treat graphic like imagedata. BZ #754340 Support superscript, fix color. BZ #726548 Fix test warnings and errors. BZ #747871 Change title page layout in Publican website. Remove trailing slash from --langs completion. BZ #757182 Remove white space munging from XmlClean. BZ #756756 Fix corpauthor killing FOP. BZ #756864 Remove --cvs option. Publican no longer the supports the cvs option for building RPMs. Update Conventions translation in pt-BR ldelima@redhat.com Fix build failing when source language directory is read only. BZ #798484 Add src_dir parameter to allow building outside source tree. BZ #798485 Specifies the directory to source Publican files from. Apply Spanish translation update from Ismael Olea. BZ #787739 Added web_cfg to allow non-standard paths for rpm based web sites. This means you can have more than one Publican website on a single server. Ensure xml:lang is set by XmlClean for DocBook 5 sources. BZ #696397 DocBook 5 is tech preview in Publican 3.0. Publican now accepts a per user defaults file. BZ #599283 Users can set their own default values for Publican in ~/.publican.cfg. Currently, Publican supports the following values: firstname surname email formats lang langs Use ~/.publican.cfg to simplify your build command, or with the new add_revision action. Catch txt not being rebuilt. BZ #802576 Text only builds now refresh the text file. There is no need to run Publican clean before rebuilding a text document. Catch invalid version when installing book. BZ #748657 Fix duplicate IDs in HTML outputs. BZ #788576 Fix some epub validation errors. BZ #701667 Add brand_dir option and publican XSL name space. BZ #800252 The Publican build option brand_dir allows you to specify the location of brand files. These files do not have to be part of an installed brand. You can ship custom XSL in a folder named xsl in your brand: it sits at the same level as the various language files for your brand. Publican uses any XSL that it finds in that directory to override the XSL templates that we ship in the common brand (which in turn override the XSL templates that the DocBook project ships). Warning Brands wishing to support brand_dir that supply XSL files need to change the relative path to a URI. Example 1. Updating brand XSL Change to Warning Platform support for this this change requires updating the XML catalog on the system. Packagers should automate this for their platforms. Example 2. Modifying the XML catalog on an RPM based system %post CATALOG=%{_sysconfdir}/xml/catalog %{_bindir}/xmlcatalog --noout --add "rewriteURI" \ "https://fedorahosted.org/released/publican/xsl/docbook4/" \ "file://%{_datadir}/publican/xsl/" $CATALOG %postun if [ "$1" = 0 ]; then CATALOG=%{_sysconfdir}/xml/catalog %{_bindir}/xmlcatalog --noout --del \ "file://%{_datadir}/publican/xsl/docbook4/" $CATALOG fi Consolidate DataBase entries. BZ #707833 Add sort_order parameter. BZ #744661 Override the default sort weighting for books in a Publican website. Defaults to 50. Books are displayed on the website in descending sort order. For example, a book with sort order 10 appears before a book with sort order 5. By default, this value is set to 50. Fix para tag not getting newline in TXT output. BZ #773120 Rework toc style to fit long name products and books. BZ #696834 The TOC now wraps long product and book names. Fix PO merge output order. BZ #808088 Fix new entires in merged PO being double escaped. BZ #818768 Fix false warning "Message missing from PO file". BZ #737426 Fix create_brand not copying images. BZ #832345 Fix rename requiring --name parameter. BZ #694698 Add rev_file and info_file parameters. BZ #804917 Publican now allows you to specify alternative revision history (rev_file) and info (info_file) files. For example, both revision history and info could be stored in the same file as the book's contents. Both parameters use the full filename without a path. Fix multiple actions not being caught. BZ #838427 Add jcarousel support. Added support for using jcarousel to the web_style 2 welcome page. To populate this content add a new file to your welcome page, en-US/Ads.xml, using the refentry format. For each refsection supply a title, subtitle, and literallayout. The text of title and subtitle are used in the Ad; literallayout is used to create a relative link on the site. You can customise the CSS for each Ad by specifing the role attribute on the refsection and then by adding the same class in the welocme page's site_overides.css. If you ship images in the welcome page's images directory you can then use them as backgroud images. Example 3. Ads.xml ADs ADs for the home page New in Publican 3.0 Publican 3.0 has a shiny web interface! Publican/3.0/html/Users_Guide/ Red Hat Package Manager 4 Guide Read all about RPM. RPM/4/html/RPM_Guide