Important — Availability in repositories
su -
yum install publican publican-doc
yum install publican-brand
redhat
, fedora
, jboss
, ovirt
, or gimp
. Refer to Chapter 5, Branding for more information on branding.
Important — Unsupported software
Important — Dependencies available only internally to Red Hat
su -
yum install publican publican-doc
yum install publican-brand
redhat
, fedora
, jboss
, ovirt
, or gimp
. Refer to Chapter 5, Branding for more information on branding.
Important — New in 10.4 "Lucid Lynx"
sudo apt-get install publican
Warning — Complete this procedure
/etc/apt/sources.list
file as described, your system might become unstable.
squeeze
repository. When you enable access to this repository, you allow your computer to install newer software and newer versions of existing software than what is available in the current stable version of Debian. However, not all of the software available in the testing repository has completed quality assurance testing yet. If you do not disable access to this repository after you install Publican, the next time that your system updates, it will replace software packages on your system with newer but possibly untested versions of those packages that it downloads from the testing repository.
/etc/apt/sources.list
file in a text editor. For example, to edit the file in gedit run:
sudo gedit /etc/apt/sources.list
deb http://ftp.debian.org/debian/ squeeze main
sudo apt-get update
sudo apt-get install publican
/etc/apt/sources.list
file again, and delete the extra line that you added in this procedure.
sudo zypper install perl-Config-Simple perl-DateTime \ perl-DateTime-Format-DateParse perl-DBD-SQLite perl-DBI \ perl-File-Find-Rule perl-File-Which perl-HTML-Format \ perl-Locale-MakeText-Gettext perl-Template-Toolkit \ perl-Test-Deep perl-Test-Pod perl-XML-LibXSLT \ perl-YAML liberation-fonts
Note
Liberation-fonts
is most likely already installed, but it is required. Zypper will not reinstall it if it is already present.
sudo sh cpan File::pushd File::Copy::Recursive Locale::PO pp \ Syntax::Highlight::Engine::Kate XML::TreeBuilder exit
cd ~ mkdir -p SourceCode/publican cd SourceCode/publican svn checkout http://svn.fedorahosted.org/svn/publican/branches/publican-2x ./
perl Build.PL
perl Build.PL WARNING: the following files are missing in your kit: META.yml Please inform the author. Created MYMETA.yml and MYMETA.json Creating new 'Build' script for 'Publican' version '2.9'
File/pushd.pm
is reported as missing, you would use this to install it:
sudo sh cpan File::pushd exit
Build.PL
script will have created a new script named Build
which we will use to create, test and install Publican 2.9.
./Build
DEBUG: Publican::Builder: end of build
./Build test
Test Summary Report ------------------- t/910.publican.Users_Guide.t (Wstat: 256 Tests: 5 Failed: 1) Failed test: 5 Non-zero exit status: 1 t/pod-coverage.t (Wstat: 256 Tests: 9 Failed: 1) Failed test: 7 Non-zero exit status: 1 Files=10, Tests=68, 420 wallclock secs ( 0.31 usr 0.17 sys + 246.87 cusr 18.73 csys = 266.08 CPU) Result: FAIL Failed 2/10 test programs. 2/68 subtests failed.
ghostscript-fonts-std
as opposed to ghostscript-fonts
) wkhtmltopdf will not run even if force installed with no dependency checks.
Note
JFEARN=http://jfearn.fedorapeople.org/wkhtmltopdf/f15 MYSYSTEM=i686 ## For 64bit system use MYSYSTEM=x86_64 instead. wget $JFEARN/$MYSYSTEM/wkhtmltopdf-qt-4.7.1-1.git20110804.fc15.i686.rpm wget $JFEARN/$MYSYSTEM/wkhtmltopdf-0.10.0_rc2-1.fc15.i686.rpm
Note
MYSYSTEM
appropriately.
sudo sh rpm -ivh wkhtmltopdf-qt* rpm -ivh --nodeps wkhtmltopdf-0* exit
ghostscript-fonts
problem described above.
sudo sh ./Build test exit
publican create --type=book --product=testing --version=1.2.3 --name=TestPublican
Processing file en-US/Author_Group.xml -> en-US/Author_Group.xml Processing file en-US/Book_Info.xml -> en-US/Book_Info.xml Processing file en-US/Chapter.xml -> en-US/Chapter.xml Processing file en-US/Preface.xml -> en-US/Preface.xml Processing file en-US/Revision_History.xml -> en-US/Revision_History.xml Processing file en-US/TestPublican.xml -> en-US/TestPublican.xmlcd TestPublican/ publican build --lang=all --formats=html,html-single,html-desktop,txt,pdf,epub
Note
runtime error: file /usr/share/publican/xsl/epub.xsl element choose Variable 'epub.embedded.fonts' has not been declared. at /usr/lib/perl5/site_perl/5.14.2/Publican/Builder.pm line 915
SourceCode/TestPublican/tmp/en-US/
and view the various output formats that you find there.
Publican-Installer-version.exe
.
Publican-Installer-version.exe
file.
Main
in the installer window), a number of brands (including RedHat
, JBoss
, and fedora
), and two DocBook components (the DocBook Data Type Definition (DTD) and DocBook Extensible Stylesheet Language (XSL) stylesheets). The three brands are grouped under the collapsible heading Brands
and the DocBook components are grouped under the collapsible heading DocBook
in the installer window. Refer to Chapter 5, Branding for an explanation of brands in Publican. Publican uses the DTD and the XSL stylesheets to render XML documents in other presentation formats (such as HTML and PDF). If you do not install these components, Publican must download this data from the Internet every time it processes a document, which creates lengthy delays.
Publican
within the %ProgramFiles%
folder of your computer — typically C:\Program Files\Publican
. You can manually edit the path displayed in the Destination Folder box to select a different folder.
Completed
.