Important — Availability in repositories
su -
yum install publican publican-doc
yum install publican-brand
brand
with, for example, 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
brand
with, for example, 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.