From jfearn at redhat.com Tue Oct 6 02:43:09 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 6 Oct 2015 12:43:09 +1000 Subject: [publican-list] Code syntax highlighting in PDF In-Reply-To: <55FBB395.5040406@murrell.ca> References: <55FBB395.5040406@murrell.ca> Message-ID: <5613353D.6010501@redhat.com> On 09/18/2015 04:47 PM, Alan Murrell wrote: > Hello, > > I am running Publican 4.3.2 on Fedora 22 (Publican packages just got > updated so they properly build the documents. Yay!) > > I was playing around with including code samples and the syntax > highlighting works with HTML formats but there is no such highlighting > in the PDF format. > > What would I need to add to the PDF XSL file to make this so? Two options: 1: Install upstream wkhtmltopdf and it will just work. 2: For FOP you need to add back in all the PDF customization we removed. This will only work for a limited period as they rely on customization in Publican to work and they will be removed in 5.0. You need to add the xmlns:perl name space, switch on highlight And then add any of the templates related to highlighting from https://git.fedorahosted.org/cgit/publican.git/tree/datadir/xsl/pdf.xsl?id=Release-4.2.6 Cheers, Jeff. -- Jeff Fearn Senior Software Engineer PnT - DevOps - Development Red Hat Asia Pacific Pty Ltd http://dilbert.com/fast/2004-08-17/ From jfearn at redhat.com Tue Oct 6 03:59:54 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 6 Oct 2015 13:59:54 +1000 Subject: [publican-list] "list" options not honoured in HTML In-Reply-To: <55FBB814.1050108@murrell.ca> References: <55FBB814.1050108@murrell.ca> Message-ID: <5613473A.9040300@redhat.com> On 09/18/2015 05:07 PM, Alan Murrell wrote: > I was playing around with and added the following options: > > > > It renders as indicated in PDF, but in the HTML versions, is keeps roman > numeral numbering and default spacing. > > is this an adjustment that has to be made to the CSS stylesheet, or > elsewhere for HTML rendering to honour the "list" options? > > Thanks! :-) > > Regards, > > Alan IIRC this just sets a class on the object and you need to add it to your CSS. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer PnT - DevOps - Development Red Hat Asia Pacific Pty Ltd http://dilbert.com/fast/2004-08-17/ From erich.steinboeck at gmail.com Tue Oct 13 19:16:10 2015 From: erich.steinboeck at gmail.com (=?UTF-8?Q?Erich_Steinb=C3=B6ck?=) Date: Tue, 13 Oct 2015 21:16:10 +0200 Subject: [publican-list] Publican on Windows: How to Install 4.3.2? Message-ID: I've successfully installed Publican on Windows using Publican-Installer-3.0.exe. Together with FOP I successfully build documentation to PDF. But as I see some issues (which generate literally thousands of FOP warnings) during the build, I was wondering whether installing a newer version of Publican might help. Is there a way to update my 3.0 installation by e. g. updating files manually from the latest 4.3.2 tar.gz? Thanks .. Erich -------------- next part -------------- An HTML attachment was scrubbed... URL: From williamjmorenor at gmail.com Tue Oct 13 19:54:58 2015 From: williamjmorenor at gmail.com (William Moreno) Date: Tue, 13 Oct 2015 13:54:58 -0600 Subject: [publican-list] Error: Entity not defined Message-ID: Hi I have started a project in Publican with: publican create --name "Fedora-Coobook-es" --brand fedora --lang es-ES I have edited some content and now I am trying to build the document with: publican build --langs es-ES --formats pdf I am getting this error: Comenzando a trabajar en es-ES ERROR FATAL: parser:27 in Common_Content/Feedback.xml on line 12: Entity 'BZURL' not defined at /usr/bin/publican line 1225. My entities file is: cat es-ES/Fedora-Coobook-es.ent Is this a bug or I have some error with my entities file? I have: publican-4.3.2-0.fc22.noarch publican-fedora-4.0-2.fc21.noarch William Moreno Reyes http://about.me/williamjmorenor -------------- next part -------------- An HTML attachment was scrubbed... URL: From jfearn at redhat.com Tue Oct 13 22:43:07 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 14 Oct 2015 08:43:07 +1000 Subject: [publican-list] Publican on Windows: How to Install 4.3.2? In-Reply-To: References: Message-ID: <561D88FB.2030204@redhat.com> On 14/10/15 05:16, Erich Steinb?ck wrote: > I've successfully installed Publican on Windows using > Publican-Installer-3.0.exe. Together with FOP I successfully build > documentation to PDF. > > But as I see some issues (which generate literally thousands of FOP > warnings) during the build, I was wondering whether installing a newer > version of Publican might help. Is there a way to update my 3.0 > installation by e. g. updating files manually from the latest 4.3.2 tar.gz? Hi Erich, we haven't spent much time on the Windows build for quite some time as there wasn't any demand. FWIW updating versions won't change the number of warnings FOP generates, it does that on every platform regardless of FOP, DocBook, or Publican versions. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer PnT - DevOps - Development Red Hat Asia Pacific Pty Ltd http://dilbert.com/fast/2004-08-17/ From jfearn at redhat.com Tue Oct 13 22:46:15 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 14 Oct 2015 08:46:15 +1000 Subject: [publican-list] Error: Entity not defined In-Reply-To: References: Message-ID: <561D89B7.3060306@redhat.com> On 14/10/15 05:54, William Moreno wrote: > Hi > > I have started a project in Publican with: > > publican create --name "Fedora-Coobook-es" --brand fedora --lang es-ES > > I have edited some content and now I am trying to build the document with: > > publican build --langs es-ES --formats pdf > > I am getting this error: > > Comenzando a trabajar en es-ES > ERROR FATAL: parser:27 in Common_Content/Feedback.xml on line 12: > Entity 'BZURL' not defined > at /usr/bin/publican line 1225. > > My entities file is: > > cat es-ES/Fedora-Coobook-es.ent > > > > > > > Is this a bug or I have some error with my entities file? > > I have: > > publican-4.3.2-0.fc22.noarch > publican-fedora-4.0-2.fc21.noarch > > Hi William, it's probably an issue specific to this brand, you might get more up to date feedback on the Fedora Docs mailing list or IRC channel. First thing I'd look at is if the XML to include the entity file is at the top of the XML files. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer PnT - DevOps - Development Red Hat Asia Pacific Pty Ltd http://dilbert.com/fast/2004-08-17/ From erich.steinboeck at gmail.com Wed Oct 14 09:06:58 2015 From: erich.steinboeck at gmail.com (=?UTF-8?Q?Erich_Steinb=C3=B6ck?=) Date: Wed, 14 Oct 2015 11:06:58 +0200 Subject: [publican-list] Publican on Windows: How to Install 4.3.2? Message-ID: (sorry if this comes in as a new thread - I've found no way to reply, as the mailing list copies me neither on my own post nor on the answer) Thanks Jeff for your answer. I'm still interested in going to the latest Publican version, as 1. others may build these docs on Linux (then presumable using Publican 4.3) and I'd rather have the same issues (if any) as everyone else, and not something that may be due to me using 3.0, and 2. I'm also seeing issues (like svg image scaling in the HTML build) that might have been already addressed in the newer versions Do you think, that simply updating Windows-3.0-installer files with files for a Linux distribution is possible at all? If yes, any suggestions, what I should do / shouldn't do? If successful, I'd be willing to post a step-by-step How-To for others who might want to do the same. Regards, Erich > From: Jeff Fearn > To: Publican discussions > Subject: Re: [publican-list] Publican on Windows: How to Install 4.3.2? > Date: Wed, 14 Oct 2015 08:43:07 +1000 > Hi Erich, we haven't spent much time on the Windows build for quite some > time as there wasn't any demand. FWIW updating versions won't change the > number of warnings FOP generates, it does that on every platform > regardless of FOP, DocBook, or Publican versions. > Cheers, Jeff. -------------- next part -------------- An HTML attachment was scrubbed... URL: From jfearn at redhat.com Wed Oct 14 22:36:13 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Thu, 15 Oct 2015 08:36:13 +1000 Subject: [publican-list] Publican on Windows: How to Install 4.3.2? In-Reply-To: References: Message-ID: <561ED8DD.1030300@redhat.com> On 14/10/15 19:06, Erich Steinb?ck wrote: > (sorry if this comes in as a new thread - I've found no way to reply, as > the mailing list copies me neither on my own post nor on the answer) > > Thanks Jeff for your answer. I'm still interested in going to the latest > Publican version, as > 1. others may build these docs on Linux (then presumable using Publican > 4.3) and I'd rather have the same issues (if any) as everyone else, and not > something that may be due to me using 3.0, and > 2. I'm also seeing issues (like svg image scaling in the HTML build) that > might have been already addressed in the newer versions If you are using FOP then it's unlikely anything has been fixed as we deprecated it's use and focused on getting wkhtmltopdf to work. > Do you think, that simply updating Windows-3.0-installer files with files > for a Linux distribution is possible at all? Last time I tried building the exe it got stuck bundling the libraries in to the exe. It's possible that just needs to be configured properly to run. I'll give it another shot soon so I can at least be more specific with the issues. > If yes, any suggestions, what I should do / shouldn't do? In the git repo is a README file with a section on building on Windows, it's probably embarrassingly out of date, and you can probably skip some configuration if you aren't pushing back to the repo. It is based on building the exe, it's probably possible to install it in to a system perl (I use strawberry) but I've never really tested that on Windows as it's not the way things are done there :) > If successful, I'd be willing to post a step-by-step How-To for others who > might want to do the same. > > Regards, Erich > >> From: Jeff Fearn >> To: Publican discussions >> Subject: Re: [publican-list] Publican on Windows: How to Install 4.3.2? >> Date: Wed, 14 Oct 2015 08:43:07 +1000 >> Hi Erich, we haven't spent much time on the Windows build for quite some >> time as there wasn't any demand. FWIW updating versions won't change the >> number of warnings FOP generates, it does that on every platform >> regardless of FOP, DocBook, or Publican versions. >> Cheers, Jeff. > > > > _______________________________________________ > publican-list mailing list > publican-list at redhat.com > https://www.redhat.com/mailman/listinfo/publican-list > Wiki: https://fedorahosted.org/publican > -- Jeff Fearn Senior Software Engineer PnT - DevOps - Development Red Hat Asia Pacific Pty Ltd http://dilbert.com/fast/2004-08-17/