From Norman at dunbar-it.co.uk Sat Feb 1 17:19:46 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Sat, 01 Feb 2014 17:19:46 +0000 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <20140127223929.GA8164@x230-buxy.home.ouaza.com> References: <2095406107.19373968.1387344508813.JavaMail.root@redhat.com> <52B20180.60505@dunbar-it.co.uk> <52B24A5D.6050801@redhat.com> <52B33752.8030406@dunbar-it.co.uk> <52DD95CC.4090208@dunbar-it.co.uk> <52DDEE6A.3020102@redhat.com> <20140127223929.GA8164@x230-buxy.home.ouaza.com> Message-ID: <52ED2CB2.9040101@dunbar-it.co.uk> Hi Raphael, >... > In this case, it's a trivial change in Users_Guide/en-US/Sets.xml, > just replace ?? with > ??. There was only one occurrance of "xml" rather than "XML", so I changed it. This time, the test build worked fine, and I now have a User Guide for Publican 4. I'm off to play now! Thanks for your help. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 From Norman at dunbar-it.co.uk Mon Feb 3 21:37:03 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Mon, 03 Feb 2014 21:37:03 +0000 Subject: [publican-list] Publican 4 - brands problems Message-ID: <52F00BFF.2040404@dunbar-it.co.uk> Evening all, I have created a default book as a test with the following: $ publican create --type=book --name=Book_001 --langs=en-US And built it as follows: $ publican build --langs=en-US --formats=pdf And all is well. I then created a brand called jms: $ publican create_brand --name=jms --lang=en-US I added my images, updated the xml files etc, and published it: $ publican build --formats=xml --langs-en-US --publish And installed it: $ sudo publican install_brand --path=/usr/share/publican/Common_Content And everything was fine. I then changed the brand in the publican.cfg for my test book from brand: common to brand: jms Now when I run the build command, I get this one line: Failed to load brand overrides.cfg file at /usr/local/bin/publican line 797. And $?=255 immediately afterwards. I can see overrides.cfg is present in the installed brand directory: $ ll /usr/share/publican/Common_Content/jms/ total 16 -rw-r--r-- 1 root root 137 Feb 3 21:18 defaults.cfg drwxr-xr-x 4 root root 4096 Jan 28 19:14 en-US/ -rw-r--r-- 1 root root 51 Feb 3 21:18 overrides.cfg -rw-r--r-- 1 root root 107 Feb 3 21:18 publican.cfg It's all a bit strange! The file is present, but can't be found. Is there a way to turn on some form of debugging to show exactly what publican is doing and where it is looking for this file? My second problem, I love the html-desktop format when generating a book, article etc. It appears to have gone in some of the later versions of Publican. Is it coming back again at some point? It really is the nicest html output format. When I try to build with that format, I get html-single instead, I can see it being substituted in the output from the build: $ publican build --langs=en-US --formats=html-desktop Setting up en-US ... Beginning work on en-US DTD Validation OK Starting html-desktop Using XML::LibXSLT on /usr/share/publican/xsl/html-single.xsl Finished html-desktop Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 From rlandmann at redhat.com Tue Feb 4 07:36:33 2014 From: rlandmann at redhat.com (Ruediger Landmann) Date: Tue, 04 Feb 2014 17:36:33 +1000 Subject: [publican-list] Publican 4 - brands problems In-Reply-To: <52F00BFF.2040404@dunbar-it.co.uk> References: <52F00BFF.2040404@dunbar-it.co.uk> Message-ID: <52F09881.40604@redhat.com> On 02/04/2014 07:37 AM, Norman Dunbar wrote: > Evening all, > > I have created a default book as a test with the following: > > $ publican create --type=book --name=Book_001 --langs=en-US > > And built it as follows: > > $ publican build --langs=en-US --formats=pdf > > And all is well. > > I then created a brand called jms: > > $ publican create_brand --name=jms --lang=en-US > > I added my images, updated the xml files etc, and published it: > > $ publican build --formats=xml --langs-en-US --publish > > And installed it: > > $ sudo publican install_brand --path=/usr/share/publican/Common_Content > > And everything was fine. I then changed the brand in the publican.cfg > for my test book from > > brand: common > > to > > brand: jms > > > Now when I run the build command, I get this one line: > > Failed to load brand overrides.cfg file at /usr/local/bin/publican > line 797. > > And $?=255 immediately afterwards. > > I can see overrides.cfg is present in the installed brand directory: > > $ ll /usr/share/publican/Common_Content/jms/ > total 16 > -rw-r--r-- 1 root root 137 Feb 3 21:18 defaults.cfg > drwxr-xr-x 4 root root 4096 Jan 28 19:14 en-US/ > -rw-r--r-- 1 root root 51 Feb 3 21:18 overrides.cfg > -rw-r--r-- 1 root root 107 Feb 3 21:18 publican.cfg > > It's all a bit strange! The file is present, but can't be found. Is > there a way to turn on some form of debugging to show exactly what > publican is doing and where it is looking for this file? Thanks for the detailed description of what went wrong -- I was able to reproduce this problem exactly. The fix was to set a parameter (probably any parameter) in overrides.cfg (I set web_style: 2) So, Publican is finding the file fine, but if it's empty, it's misreporting it as "not found". Can you please open a bug? > My second problem, I love the html-desktop format when generating a > book, article etc. It appears to have gone in some of the later > versions of Publican. Is it coming back again at some point? It really > is the nicest html output format. > > When I try to build with that format, I get html-single instead, I can > see it being substituted in the output from the build: > > > $ publican build --langs=en-US --formats=html-desktop > Setting up en-US > .. > Beginning work on en-US > DTD Validation OK > Starting html-desktop > Using XML::LibXSLT on /usr/share/publican/xsl/html-single.xsl > Finished html-desktop html-desktop builds work fine for me with both the common brand and a custom brand I have here (the forthcoming Fedora docs brand). We use the same XSL to generate the html-single and the html-desktop files, which is why you see it being referenced there Cheers, Rudi From Norman at dunbar-it.co.uk Tue Feb 4 20:47:05 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Tue, 04 Feb 2014 20:47:05 +0000 Subject: [publican-list] Publican 4 - brands problems In-Reply-To: <52F09881.40604@redhat.com> References: <52F00BFF.2040404@dunbar-it.co.uk> <52F09881.40604@redhat.com> Message-ID: <52F151C9.3090600@dunbar-it.co.uk> Hi Rudi, > Thanks for the detailed description of what went wrong -- I was able > to > reproduce this problem exactly. The fix was to set a parameter (probably > any parameter) in overrides.cfg (I set web_style: 2) Thanks. I try to be helpful, I work in IT support myself in my day job. I know hos frustrating it can be sometimes! The work around works for me too! Thanks. > So, Publican is finding the file fine, but if it's empty, it's > misreporting it as "not found". Can you please open a bug? No problem, Bug 1061434 has been raised. > html-desktop builds work fine for me with both the common brand and a > custom brand I have here (the forthcoming Fedora docs brand). > > We use the same XSL to generate the html-single and the html-desktop > files, which is why you see it being referenced there Ok, my test book, as above, has built quite happily and is showing the expected format with the contents "page" to the left and the main document to the right. I'm happy with that. Previously, I was seeing the same layout in the generated documents for html-single as well as html-desktop. I need to find time to rebuild one of my larger documents to see if it is still happening. Thanks again. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 From Norman at dunbar-it.co.uk Thu Feb 13 17:34:50 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Thu, 13 Feb 2014 17:34:50 +0000 Subject: [publican-list] Users Guide - version 4 - slight typo. Message-ID: <52FD023A.4060409@dunbar-it.co.uk> Ok, I know it's not all that important, but there's a slight typo in the email address of this user in the revisions history: Revision 4.0-2 Thu Nov 14 2013 Norman Dunbar SvenDowideit at home.org.au I happen to know that his real email address is norman at dunbar-it.co.uk - but only because that's how it appears lower down in this revision: Revision 3.1-0 Tue Jan 8 2013 Norman Dunbar norman at dunbar-it.co.uk :-) Cheers, Norm. PS. I was quite shocked to see my name on the front cover of the User's Guide! a pleasant surprise - thanks. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 From rlandmann at redhat.com Wed Feb 19 01:16:10 2014 From: rlandmann at redhat.com (Ruediger Landmann) Date: Wed, 19 Feb 2014 11:16:10 +1000 Subject: [publican-list] Users Guide - version 4 - slight typo. In-Reply-To: <52FD023A.4060409@dunbar-it.co.uk> References: <52FD023A.4060409@dunbar-it.co.uk> Message-ID: <530405DA.8010806@redhat.com> Ooops! Obviously, copypasta error on my part; I'll fix that :) Cheers Rudi On 02/14/2014 03:34 AM, Norman Dunbar wrote: > Ok, I know it's not all that important, but there's a slight typo in > the email address of this user in the revisions history: > > Revision 4.0-2 Thu Nov 14 2013 Norman Dunbar SvenDowideit at home.org.au > > > I happen to know that his real email address is norman at dunbar-it.co.uk > - but only because that's how it appears lower down in this revision: > > Revision 3.1-0 Tue Jan 8 2013 Norman Dunbar norman at dunbar-it.co.uk > > :-) > > Cheers, > Norm. > > PS. I was quite shocked to see my name on the front cover of the > User's Guide! a pleasant surprise - thanks. > From jfearn at redhat.com Sun Feb 23 23:18:46 2014 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 24 Feb 2014 09:18:46 +1000 Subject: [publican-list] Publican 4 - brands problems In-Reply-To: <52F00BFF.2040404@dunbar-it.co.uk> References: <52F00BFF.2040404@dunbar-it.co.uk> Message-ID: <530A81D6.6070306@redhat.com> On 02/04/2014 07:37 AM, Norman Dunbar wrote: > Evening all, > > I have created a default book as a test with the following: > > $ publican create --type=book --name=Book_001 --langs=en-US > > And built it as follows: > > $ publican build --langs=en-US --formats=pdf > > And all is well. > > I then created a brand called jms: > > $ publican create_brand --name=jms --lang=en-US > > I added my images, updated the xml files etc, and published it: > > $ publican build --formats=xml --langs-en-US --publish > > And installed it: > > $ sudo publican install_brand --path=/usr/share/publican/Common_Content > > And everything was fine. I then changed the brand in the publican.cfg for my test book from > > brand: common > > to > > brand: jms > > > Now when I run the build command, I get this one line: > > Failed to load brand overrides.cfg file at /usr/local/bin/publican line 797. This is a known issue: https://bugzilla.redhat.com/show_bug.cgi?id=1037037 Workaround is to delete the empty conf file. > And $?=255 immediately afterwards. > > I can see overrides.cfg is present in the installed brand directory: > > $ ll /usr/share/publican/Common_Content/jms/ > total 16 > -rw-r--r-- 1 root root 137 Feb 3 21:18 defaults.cfg > drwxr-xr-x 4 root root 4096 Jan 28 19:14 en-US/ > -rw-r--r-- 1 root root 51 Feb 3 21:18 overrides.cfg > -rw-r--r-- 1 root root 107 Feb 3 21:18 publican.cfg > > It's all a bit strange! The file is present, but can't be found. Is there a way to turn on some form of debugging to show exactly what publican is doing and where it is looking for this file? > > > My second problem, I love the html-desktop format when generating a book, article etc. It appears to have gone in some of the later versions of Publican. Is it coming back again at some point? It really is the nicest html output format. > > When I try to build with that format, I get html-single instead, I can see it being substituted in the output from the build: > > > $ publican build --langs=en-US --formats=html-desktop > Setting up en-US > ... > Beginning work on en-US > DTD Validation OK > Starting html-desktop > Using XML::LibXSLT on /usr/share/publican/xsl/html-single.xsl > Finished html-desktop > This is correct, that XSL file takes a parameter to switch behaviour. Is the output broken? Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Software Engineering & Development Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From jfearn at redhat.com Sun Feb 23 23:35:23 2014 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 24 Feb 2014 09:35:23 +1000 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <20140127223929.GA8164@x230-buxy.home.ouaza.com> References: <2095406107.19373968.1387344508813.JavaMail.root@redhat.com> <52B20180.60505@dunbar-it.co.uk> <52B24A5D.6050801@redhat.com> <52B33752.8030406@dunbar-it.co.uk> <52DD95CC.4090208@dunbar-it.co.uk> <52DDEE6A.3020102@redhat.com> <20140127223929.GA8164@x230-buxy.home.ouaza.com> Message-ID: <530A85BB.9010604@redhat.com> On 01/28/2014 08:39 AM, Raphael Hertzog wrote: > Hi Ruediger, > > On Tue, 21 Jan 2014, Ruediger Landmann wrote: >> On 01/21/2014 07:31 AM, Norman Dunbar wrote: >>> >>> t/910.publican.Users_Guide.t .. # Testing bin/publican on the Users_Guide >>> t/910.publican.Users_Guide.t .. 3/5 undefined language: xml at >>> /usr/local/share/perl/5.14.2/Syntax/Highlight/Engine/Kate.pm line >>> 621. >>> LibXSLT: error coming back from perl-dispatcher in pm file. >>> 'xml' is not a valid language for highlighting. >>> at /usr/lib/perl5/XML/LibXSLT.pm line 81. >>> >> >> Hi Norman -- Jeff is out for a few weeks, but this error means you >> need a version of Syntax::Highlight::Engine::Kate that's patched for >> case-insensitivity: >> https://rt.cpan.org/Public/Bug/Display.html?id=84982 > > Can we please avoid this kind of requirement? We try. If there is sufficient pressure then we have to carry a patch. > IMO it's not really acceptable to require the usage of patched versions of > dependencies. You should really find some work-around until there's a > released version with the fix. > > In this case, it's a trivial change in Users_Guide/en-US/Sets.xml, > just replace ?? with > ??. That is there as a regression test for #919474, which was repeatedly regressing. Cheers, Jeff. From hertzog at debian.org Mon Feb 24 07:17:31 2014 From: hertzog at debian.org (Raphael Hertzog) Date: Mon, 24 Feb 2014 08:17:31 +0100 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <530A85BB.9010604@redhat.com> References: <2095406107.19373968.1387344508813.JavaMail.root@redhat.com> <52B20180.60505@dunbar-it.co.uk> <52B24A5D.6050801@redhat.com> <52B33752.8030406@dunbar-it.co.uk> <52DD95CC.4090208@dunbar-it.co.uk> <52DDEE6A.3020102@redhat.com> <20140127223929.GA8164@x230-buxy.home.ouaza.com> <530A85BB.9010604@redhat.com> Message-ID: <20140224071731.GA27650@x230-buxy.home.ouaza.com> On Mon, 24 Feb 2014, Jeff Fearn wrote: > > In this case, it's a trivial change in Users_Guide/en-US/Sets.xml, > > just replace ?? with > > ??. > > That is there as a regression test for #919474, which was repeatedly regressing. Such a change in the middle of a user guide is not clearly identified as a regression test and can easily be lost/reverted over time. It would be far better to isolate it in the test suite. This wouldn't impact users who are not running the test suite and could be easily overriden by others by disabling the failing test. Cheers, -- Rapha?l Hertzog ? Debian Developer Discover the Debian Administrator's Handbook: ? http://debian-handbook.info/get/ From jfenal at gmail.com Mon Feb 24 07:44:17 2014 From: jfenal at gmail.com (=?UTF-8?B?SsOpcsO0bWUgRmVuYWw=?=) Date: Mon, 24 Feb 2014 08:44:17 +0100 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <530A85BB.9010604@redhat.com> References: <2095406107.19373968.1387344508813.JavaMail.root@redhat.com> <52B20180.60505@dunbar-it.co.uk> <52B24A5D.6050801@redhat.com> <52B33752.8030406@dunbar-it.co.uk> <52DD95CC.4090208@dunbar-it.co.uk> <52DDEE6A.3020102@redhat.com> <20140127223929.GA8164@x230-buxy.home.ouaza.com> <530A85BB.9010604@redhat.com> Message-ID: 2014-02-24 0:35 GMT+01:00 Jeff Fearn : > On 01/28/2014 08:39 AM, Raphael Hertzog wrote: >> Hi Ruediger, >> >> On Tue, 21 Jan 2014, Ruediger Landmann wrote: >>> On 01/21/2014 07:31 AM, Norman Dunbar wrote: >>>> >>>> t/910.publican.Users_Guide.t .. # Testing bin/publican on the Users_Guide >>>> t/910.publican.Users_Guide.t .. 3/5 undefined language: xml at >>>> /usr/local/share/perl/5.14.2/Syntax/Highlight/Engine/Kate.pm line >>>> 621. >>>> LibXSLT: error coming back from perl-dispatcher in pm file. >>>> 'xml' is not a valid language for highlighting. >>>> at /usr/lib/perl5/XML/LibXSLT.pm line 81. >>>> >>> >>> Hi Norman -- Jeff is out for a few weeks, but this error means you >>> need a version of Syntax::Highlight::Engine::Kate that's patched for >>> case-insensitivity: >>> https://rt.cpan.org/Public/Bug/Display.html?id=84982 >> >> Can we please avoid this kind of requirement? > > We try. If there is sufficient pressure then we have to carry a patch. What is missing here? A new release of the package carrying this patch? Since the patch has been included in upstream branch from Gabor. It should just be a matter of: 1. getting Gabor to issue a new release of this module, 2. getting Fedora to repackage it. I've just added a request for 1. in the CPAN RT ticket. Regards, J. -- J?r?me Fenal From bugzilla at redhat.com Tue Feb 25 06:03:53 2014 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 25 Feb 2014 06:03:53 +0000 Subject: [publican-list] [Bug 701929] RFA: Customising brands section In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=701929 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Target Milestone|3.3 |--- -- You are receiving this mail because: You are on the CC list for the bug. Unsubscribe from this bug https://bugzilla.redhat.com/token.cgi?t=a4GXnWqFCV&a=cc_unsubscribe From bugzilla at redhat.com Tue Feb 25 06:03:58 2014 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 25 Feb 2014 06:03:58 +0000 Subject: [publican-list] [Bug 718717] enabling line numbering disables code highlighting In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=718717 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Target Milestone|3.2 |--- -- You are receiving this mail because: You are on the CC list for the bug. Unsubscribe from this bug https://bugzilla.redhat.com/token.cgi?t=vNLI2lksTu&a=cc_unsubscribe From Norman at dunbar-it.co.uk Tue Feb 25 17:38:57 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Tue, 25 Feb 2014 17:38:57 +0000 Subject: [publican-list] Publican 4 - brands problems In-Reply-To: <530A81D6.6070306@redhat.com> References: <52F00BFF.2040404@dunbar-it.co.uk> <530A81D6.6070306@redhat.com> Message-ID: <530CD531.5090308@dunbar-it.co.uk> Hi Jeff, On 23/02/14 23:18, Jeff Fearn wrote: >> Failed to load brand overrides.cfg file at /usr/local/bin/publican line 797. > This is a known issue: https://bugzilla.redhat.com/show_bug.cgi?id=1037037 > > Workaround is to delete the empty conf file. Ok, thanks. I didn't find the bug you mentioned when I first looked, hence my query. The other workaround, as supplied by Rudi, is just to have something "harmless" in the config file. > ... >> $ publican build --langs=en-US --formats=html-desktop >> Setting up en-US >> ... >> Beginning work on en-US >> DTD Validation OK >> Starting html-desktop >> Using XML::LibXSLT on /usr/share/publican/xsl/html-single.xsl >> Finished html-desktop >> > > This is correct, that XSL file takes a parameter to switch behaviour. Is the output broken? It was indeed broken, regardless of what I used as the format - html-single or html-desktop, I always ended up with html-single. I even reverted back to publican 3.x (probably 3.2.1) and that showed the same problem. However, after a re-upgrade to Publican 4, it's running fine now. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 From bugzilla at redhat.com Thu Feb 27 03:09:11 2014 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 27 Feb 2014 03:09:11 +0000 Subject: [publican-list] [Bug 697364] RFE -- allow for customized document templates In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697364 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Assignee|hss-ied-bugs at redhat.com |jfearn at redhat.com QA Contact|tools-bugs at redhat.com |r.landmann at redhat.com -- You are receiving this mail because: You are on the CC list for the bug. Unsubscribe from this bug https://bugzilla.redhat.com/token.cgi?t=5qk5t2cdgI&a=cc_unsubscribe From bugzilla at redhat.com Thu Feb 27 03:09:09 2014 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 27 Feb 2014 03:09:09 +0000 Subject: [publican-list] [Bug 718717] enabling line numbering disables code highlighting In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=718717 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- QA Contact|tools-bugs at redhat.com |r.landmann at redhat.com -- You are receiving this mail because: You are on the CC list for the bug. Unsubscribe from this bug https://bugzilla.redhat.com/token.cgi?t=CPHV7ubE5f&a=cc_unsubscribe From bugzilla at redhat.com Thu Feb 27 03:48:43 2014 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 27 Feb 2014 03:48:43 +0000 Subject: [publican-list] [Bug 701929] RFA: Customising brands section In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=701929 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- QA Contact|tools-bugs at redhat.com |jfearn at redhat.com -- You are receiving this mail because: You are on the CC list for the bug. Unsubscribe from this bug https://bugzilla.redhat.com/token.cgi?t=46cL9U58WY&a=cc_unsubscribe