From jfearn at redhat.com Mon Jan 6 00:18:13 2014 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 06 Jan 2014 10:18:13 +1000 Subject: [publican-list] teaching Publican to emit 'mobi' In-Reply-To: References: Message-ID: <52C9F645.8090808@redhat.com> On 12/21/2013 06:38 AM, R P Herrold wrote: > Thanks for Publican 4.0 ... I am trying a build on the RHEL 7 > beta candidate as I type this > > One thing is a small 'nit' about Publican, is the absence of > output support for the Amazon e-reader family. [If I am wrong, > please advise] I see this bug open: > https://bugzilla.redhat.com/show_bug.cgi?id=781837 > > and before that mailing list discussions of supporting AMZN > readers with AWZ or mobi (that latter being the > 'non-proprietary' variant their readers support) > > The conversion tools are nice and all, I guess, but lose live > links, images, and more. Is there a later re-statement of > what is entailed in adding /mobi/ as a native output format? 1: investigate & compare upstream tools 2: package selected tool 3: integrate selected tool 4: test I'd estimate two weeks dedicated effort. Cheers, Jeff. From herrold at owlriver.com Mon Jan 6 14:56:04 2014 From: herrold at owlriver.com (R P Herrold) Date: Mon, 6 Jan 2014 09:56:04 -0500 (EST) Subject: [publican-list] teaching Publican to emit 'mobi' In-Reply-To: <52C9F645.8090808@redhat.com> References: <52C9F645.8090808@redhat.com> Message-ID: On Mon, 6 Jan 2014, Jeff Fearn wrote: > > The conversion tools are nice and all, I guess, but lose live > > links, images, and more. Is there a later re-statement of > > what is entailed in adding /mobi/ as a native output format? > > 1: investigate & compare upstream tools > 2: package selected tool > 3: integrate selected tool > 4: test > > I'd estimate two weeks dedicated effort. Thank you I see 'calibre' already packaged in Fedora for quite some time, and in RawHide. I know it cuts a new release weekly, so this may be an indicator of active development What other CLI tools on this conversion should I review? Obviously the 'non-free parts of the Amazon tool are out -- Russ herrold From jfearn at redhat.com Wed Jan 8 04:59:10 2014 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 08 Jan 2014 14:59:10 +1000 Subject: [publican-list] teaching Publican to emit 'mobi' In-Reply-To: References: <52C9F645.8090808@redhat.com> Message-ID: <52CCDB1E.6070509@redhat.com> On 01/07/2014 12:56 AM, R P Herrold wrote: > On Mon, 6 Jan 2014, Jeff Fearn wrote: > >>> The conversion tools are nice and all, I guess, but lose live >>> links, images, and more. Is there a later re-statement of >>> what is entailed in adding /mobi/ as a native output format? >> >> 1: investigate & compare upstream tools >> 2: package selected tool >> 3: integrate selected tool >> 4: test >> >> I'd estimate two weeks dedicated effort. > > Thank you > > I see 'calibre' already packaged in Fedora for quite some > time, and in RawHide. I know it cuts a new release weekly, > so this may be an indicator of active development > > What other CLI tools on this conversion should I review? > Obviously the 'non-free parts of the Amazon tool are out I wasn't specifically talking about CLI tools, there could be Perl modules on CPAN or other places that we could use as well. Cheers, Jeff. From Norman at dunbar-it.co.uk Mon Jan 20 21:31:56 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Mon, 20 Jan 2014 21:31:56 +0000 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <52B33752.8030406@dunbar-it.co.uk> References: <2095406107.19373968.1387344508813.JavaMail.root@redhat.com> <52B20180.60505@dunbar-it.co.uk> <52B24A5D.6050801@redhat.com> <52B33752.8030406@dunbar-it.co.uk> Message-ID: <52DD95CC.4090208@dunbar-it.co.uk> Hi Jeff, I'm back from the festivities, back to work, and I finally got XML::TreeBuilder 5.2 (JFeran special edition) installed and Publican 4.0.0 has built with no errors. Hooray! Sadly, my first build after installing it resulted in the following: $ publican build --langs=en-US --formats=pdf,html,epub DEBUG: Publican: config loaded build should be sub-classed! I've got debug turned on the publican.cfg for this article that I'm using as a test bed. I did the following, prior to the above test, to rebuild Publican: ./Build realclean perl Build.PL ./Build ./Build test sudo ./Build install The test produced lots of passes and then the following when it tried to build the User Guide: 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. at /home/norman/SourceCode/Publican_4/Publican-v4.0.0/blib/lib/Publican/Builder/DocBook.pm line 949. t/910.publican.Users_Guide.t .. 4/5 # Failed test 'build the Users Guide' # at t/910.publican.Users_Guide.t line 49. # got: '512' # expected: '0' Could not open en-US/Adding_Code_Samples.xml for output! at /home/norman/SourceCode/Publican_4/Publican-v4.0.0/blib/lib/Publican/Builder/DocBook4.pm line 142. t/910.publican.Users_Guide.t .. 5/5 # Failed test 'build the Users Guide in all formats' # at t/910.publican.Users_Guide.t line 56. # got: '3328' # expected: '0' # Looks like you failed 2 tests of 5. t/910.publican.Users_Guide.t .. Dubious, test returned 2 (wstat 512, 0x200) Failed 2/5 subtests t/920.WebSite.t ............... 1/10 # Testing build a website with publican t/920.WebSite.t ............... 4/10 Info file missing: build/en-US/xml/Book_Info.xml at /home/norman/SourceCode/Publican_4/Publican-v4.0.0/blib/script/publican line 1139. t/920.WebSite.t ............... 5/10 # Failed test 'install the Users Guide on the website' # at t/920.WebSite.t line 60. # got: '512' # expected: '0' t/920.WebSite.t ............... 6/10 Info file missing: build/en-US/xml/Book_Info.xml at /home/norman/SourceCode/Publican_4/Publican-v4.0.0/blib/script/publican line 1139. t/920.WebSite.t ............... 7/10 # Failed test 'install the Users Guide on the website' # at t/920.WebSite.t line 69. # got: '512' # expected: '0' # Looks like you failed 2 tests of 10. t/920.WebSite.t ............... Dubious, test returned 2 (wstat 512, 0x200) Failed 2/10 subtests Test Summary Report ------------------- t/910.publican.Users_Guide.t (Wstat: 512 Tests: 5 Failed: 2) Failed tests: 4-5 Non-zero exit status: 2 t/920.WebSite.t (Wstat: 512 Tests: 10 Failed: 2) Failed tests: 5, 7 Non-zero exit status: 2 Files=10, Tests=68, 163 wallclock secs ( 0.11 usr 0.01 sys + 79.09 cusr 3.55 csys = 82.76 CPU) Result: FAIL Failed 2/10 test programs. 4/68 subtests failed. I need a good cider 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 rlandmann at redhat.com Tue Jan 21 03:50:02 2014 From: rlandmann at redhat.com (Ruediger Landmann) Date: Tue, 21 Jan 2014 13:50:02 +1000 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <52DD95CC.4090208@dunbar-it.co.uk> 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> Message-ID: <52DDEE6A.3020102@redhat.com> 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 Cheers Rudi From Norman at dunbar-it.co.uk Sun Jan 26 13:55:05 2014 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Sun, 26 Jan 2014 13:55:05 +0000 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <52DDEE6A.3020102@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> Message-ID: <52E513B9.3040400@dunbar-it.co.uk> Hi Rudi, On 21/01/14 03:50, Ruediger Landmann wrote: >> /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 Thanks very much. As I may have mentioned, I'm not a perl or CPAN guru, so I had a few troubles getting this sorted. However, in the end, this worked, hopefully it's an ok way to do this: 1. Go to the web link supplied by you and download the patch file. Saved it as /Downloads/Kate.patch. 2. cd ~/.cpan/build/Syntax-Highlight-Engine-Kate-0.08-yQ4J4o/lib/Syntax/Highlight/Engine 3. patch -p0 <~/Downloads/Kate.patch It applied and no errors were reported. I checked the Kate.pm file, and the changes had been applied. So far so good. 4. sudo cpan -r Syntax::Highlight::Engine::Kate to recompile. Of course, I needed to install perl-doc and then read the manual of CPAN to find that out! 5. Sat back with a glass of fine cider. Jeff would approve I think! ;-) Waited for the recompile etc to complete. 6. Back in my Publican 4.0 source directory, tried another ./Build test. 7. I seem to have exactly the same error: 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. at /home/norman/SourceCode/Publican_4/Publican-v4.0.0/blib/lib/Publican/Builder/DocBook.pm line 949. t/910.publican.Users_Guide.t .. 4/5 :-( However, it seems to be using /usr/local/share rather than my own local copy that I patched. Whenever I have to do anything CPAN, I use "sudo cpan install whatever" and looking in ~/.cpan I can see that the various directories and files are owned by root and not by me. If I do do a cpan install as myself, without the sudo, I do see the files and directories owned by me. Looking into the above file in /usr/local/share I see that it's the old unpatched version, but it does list xml as being valid, so the error is not even consistent with what passes for Perl source code! ;-) I'll have another go next weekend when I'm back from work again. 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 tiansiyuan at gmail.com Mon Jan 27 18:49:10 2014 From: tiansiyuan at gmail.com (Siyuan Tian) Date: Mon, 27 Jan 2014 18:49:10 +0000 (UTC) Subject: [publican-list] Invitation to connect on LinkedIn Message-ID: <1288708511.13686197.1390848550188.JavaMail.app@ela4-app0046.prod> LinkedIn ------------ I'd like to add you to my professional network on LinkedIn. - Siyuan Siyuan Tian VP at Ever Green Tech China Confirm that you know Siyuan Tian: https://www.linkedin.com/e/-ja7au0-hqy3bdos-z/isd/19658786626/nmQDkKlz/?hs=false&tok=1jO8ZYtow9JC41 -- You are receiving Invitation to Connect emails. Click to unsubscribe: http://www.linkedin.com/e/-ja7au0-hqy3bdos-z/XCUsc0obl4AcZikDGu68ZjHHlehxSEhsZ-vA_l/goo/publican-list%40redhat%2Ecom/20061/I6355468244_1/?hs=false&tok=0kXryDr3w9JC41 (c) 2012 LinkedIn Corporation. 2029 Stierlin Ct, Mountain View, CA 94043, USA. -------------- next part -------------- An HTML attachment was scrubbed... URL: From hertzog at debian.org Mon Jan 27 22:39:29 2014 From: hertzog at debian.org (Raphael Hertzog) Date: Mon, 27 Jan 2014 23:39:29 +0100 Subject: [publican-list] Publican 4.0 released!!! Get it now!!!! In-Reply-To: <52DDEE6A.3020102@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> Message-ID: <20140127223929.GA8164@x230-buxy.home.ouaza.com> 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? 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 ??. Thanks in advance. -- Rapha?l Hertzog ? Debian Developer Discover the Debian Administrator's Handbook: ? http://debian-handbook.info/get/ From hertzog at debian.org Mon Jan 27 23:38:21 2014 From: hertzog at debian.org (=?UTF-8?q?Rapha=C3=ABl=20Hertzog?=) Date: Tue, 28 Jan 2014 00:38:21 +0100 Subject: [publican-list] [PATCH 2/2] Use language="XML" instead of language="xml" In-Reply-To: <1390865901-19282-1-git-send-email-hertzog@debian.org> References: <1390865901-19282-1-git-send-email-hertzog@debian.org> Message-ID: <1390865901-19282-2-git-send-email-hertzog@debian.org> Syntax::Highlight::Engine::Kate <= 0.08 expects it as an upper case string. See https://rt.cpan.org/Public/Bug/Display.html?id=84982 and https://github.com/szabgab/Syntax-Highlight-Engine-Kate/pull/7 for the Syntax::Highlight::Engine::Kate patch. --- Users_Guide/en-US/Sets.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Users_Guide/en-US/Sets.xml b/Users_Guide/en-US/Sets.xml index 10a2b2b..0ba0d59 100644 --- a/Users_Guide/en-US/Sets.xml +++ b/Users_Guide/en-US/Sets.xml @@ -60,7 +60,7 @@ $ cd into the books/My_Set/en-US/Book_A directory. Create and edit the Book_A.xml, Book_Info.xml, and any other xml files required for your book such as those required for individual chapters. Ensure that Book_A.xml contains the correct xi:include references to all of your xml files in the directory. For example, if Book A contained Book_Info.xml and Chapter_1.xml, the Book_A.xml file would look like this: -<?xml version='1.0'?> +<?xml version='1.0'?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> -- 1.8.5.3 From hertzog at debian.org Mon Jan 27 23:38:20 2014 From: hertzog at debian.org (=?UTF-8?q?Rapha=C3=ABl=20Hertzog?=) Date: Tue, 28 Jan 2014 00:38:20 +0100 Subject: [publican-list] [PATCH 1/2] Publican::WebSite: add explicit POD encoding directive Message-ID: <1390865901-19282-1-git-send-email-hertzog@debian.org> Without that directive, the usage of the word ?Fran?ais? triggers a warning from pod2man (visible in Publican::WebSite(3pm)): POD ERRORS Hey! The above document had some coding errors, which are explained below: Around line 2190: Non-ASCII character seen before =encoding in 'Francais'. Assuming UTF-8 --- lib/Publican/WebSite.pm | 2 ++ 1 file changed, 2 insertions(+) diff --git a/lib/Publican/WebSite.pm b/lib/Publican/WebSite.pm index 06e2415..4d8fc4c 100644 --- a/lib/Publican/WebSite.pm +++ b/lib/Publican/WebSite.pm @@ -2075,6 +2075,8 @@ SQL 1; # Magic true value required at end of module __END__ +=encoding UTF-8 + =head1 NAME Publican::WebSite - Manage a documentation website -- 1.8.5.3