From jfearn at redhat.com Wed Sep 4 06:26:10 2013 From: jfearn at redhat.com (Jeff Fearn) Date: Wed, 04 Sep 2013 16:26:10 +1000 Subject: [publican-list] Publican 3.2.1 released Message-ID: <5226D282.4090900@redhat.com> Hi everybody! Hot Fix 3.2.1 has been released with the following changes: - Fix empty images dir causing packaging fail. BZ #995896 - Fix draft background being in front. BZ #996361 - Fix Titles that are ulinks are incorrectly positioned. BZ #995095 - Fix Syntax Highlighting not working when Language and Module names differ. BZ #995932 - Fix missing '/' on callout image url. BZ #998736 - Add string for brand customistaion BZ #1002388 - Fix translations updates missing from common PO files. #1000935 As per SOP the new files are on Fedora Hosted. https://fedorahosted.org/releases/p/u/publican/Publican-v3.2.1.tar.gz https://fedorahosted.org/releases/p/u/publican/publican-3.2.1-0.el6.src.rpm Publican is a cider funded project. This has been an unpaid political announcement for the society for responsible consumption of cider. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From lbailey at redhat.com Mon Sep 9 02:55:25 2013 From: lbailey at redhat.com (Laura Bailey) Date: Sun, 8 Sep 2013 22:55:25 -0400 (EDT) Subject: [publican-list] Squished frontmatter in PDFs In-Reply-To: <1157816983.9859319.1378695036334.JavaMail.root@redhat.com> Message-ID: <1539142442.9859580.1378695325873.JavaMail.root@redhat.com> Hi all, A review of the PTG recently noted that paragraphs in the Legal Notice were getting compacted into a single paragraph. For example, see the HTML version of the Performance Tuning Guide: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Performance_Tuning_Guide/ vs. the PDF version: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/pdf/Performance_Tuning_Guide/Red_Hat_Enterprise_Linux-6-Performance_Tuning_Guide-en-US.pdf This makes both Legal Notice and Abstract quite hard to read. Paragraph breaks are there for a reason and I think they should be formatted appropriately in the PDF, as they are in HTML, but I'd be interested to hear other thoughts on the matter. Cheers, Laura B -- Laura Bailey Red Hat BNE Engineering Content Services From lbailey at redhat.com Mon Sep 9 03:23:50 2013 From: lbailey at redhat.com (Laura Bailey) Date: Sun, 8 Sep 2013 23:23:50 -0400 (EDT) Subject: [publican-list] Squished frontmatter in PDFs In-Reply-To: <1539142442.9859580.1378695325873.JavaMail.root@redhat.com> References: <1539142442.9859580.1378695325873.JavaMail.root@redhat.com> Message-ID: <999472916.9863127.1378697030416.JavaMail.root@redhat.com> Sorry folks, those URLs aren't going to help most of you. Try these instead. :) HTML: https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Performance_Tuning_Guide/index.html PDF: https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/pdf/Performance_Tuning_Guide/Red_Hat_Enterprise_Linux-6-Performance_Tuning_Guide-en-US.pdf Cheers, Laura B ----- Original Message ----- From: "Laura Bailey" To: "publican-list" Sent: Monday, 9 September, 2013 12:55:25 PM Subject: [publican-list] Squished frontmatter in PDFs Hi all, A review of the PTG recently noted that paragraphs in the Legal Notice were getting compacted into a single paragraph. For example, see the HTML version of the Performance Tuning Guide: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Performance_Tuning_Guide/ vs. the PDF version: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/pdf/Performance_Tuning_Guide/Red_Hat_Enterprise_Linux-6-Performance_Tuning_Guide-en-US.pdf This makes both Legal Notice and Abstract quite hard to read. Paragraph breaks are there for a reason and I think they should be formatted appropriately in the PDF, as they are in HTML, but I'd be interested to hear other thoughts on the matter. Cheers, Laura B -- Laura Bailey Red Hat BNE Engineering Content Services _______________________________________________ publican-list mailing list publican-list at redhat.com https://www.redhat.com/mailman/listinfo/publican-list Wiki: https://fedorahosted.org/publican -- Laura Bailey Red Hat BNE Engineering Content Services From jfearn at redhat.com Mon Sep 9 23:36:59 2013 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 10 Sep 2013 09:36:59 +1000 Subject: [publican-list] Heads up, DocBook5 == GIT repo churn Message-ID: <522E5B9B.3040107@redhat.com> Hi, I am currently working on DocBooc5 support in the devel branch. This will create quite a bit of churn as I slice and dice Builder.pm so it's easier to sub class. I've already started, but there is much more change to come as I decide which bits of logic need to be moved up or down the object chain. We are going to try and keep the DocBook5 XSL as close as possible to upstream, so I will be starting our overrides from scratch. This may result in the final output being different from the DocBook 4 output. We will try and minimise this, but it's probably going to have some impact. ATM I am basing the new output on the upstream HTML5 XSL, we might need to switch back to XHTML, but I thought it's worth a shot testing with the HTML5 output. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From bugzilla at redhat.com Tue Sep 10 23:57:32 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 10 Sep 2013 23:57:32 +0000 Subject: [publican-list] [Bug 697366] Include DocBook 5-compatible templates In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697366 --- Comment #4 from HSS Product Manager --- HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED. -- 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=UZSZP7EP0A&a=cc_unsubscribe From bugzilla at redhat.com Wed Sep 11 00:07:13 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 11 Sep 2013 00:07:13 +0000 Subject: [publican-list] [Bug 697366] Include DocBook 5-compatible templates In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697366 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |ASSIGNED -- 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=PSYnsdI5oV&a=cc_unsubscribe From bugzilla at redhat.com Wed Sep 11 02:35:21 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 11 Sep 2013 02:35:21 +0000 Subject: [publican-list] [Bug 697366] Include DocBook 5-compatible templates In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697366 --- Comment #5 from Jeff Fearn --- The basic code is in place. $ publican create --dtdver 5.0 --name Test_DB5_Book "dtdver" is temporary, there will be a better named option after more splitting of hairs. But you can create and validate/build this DocBook5 book. To ssh://git.fedorahosted.org/git/publican.git 4be1028..7d23e61 HEAD -> devel -- 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=ktDgGDsZZE&a=cc_unsubscribe From jfearn at redhat.com Thu Sep 12 05:43:00 2013 From: jfearn at redhat.com (Jeff Fearn) Date: Thu, 12 Sep 2013 15:43:00 +1000 Subject: [publican-list] Heads up, DocBook5 == GIT repo churn In-Reply-To: <522E5B9B.3040107@redhat.com> References: <522E5B9B.3040107@redhat.com> Message-ID: <52315464.8080000@redhat.com> On 09/10/2013 09:36 AM, Jeff Fearn wrote: > Hi, I am currently working on DocBooc5 support in the devel branch. This will create quite a bit of churn as I slice and dice Builder.pm so it's easier to sub class. > > I've already started, but there is much more change to come as I decide which bits of logic need to be moved up or down the object chain. > > We are going to try and keep the DocBook5 XSL as close as possible to upstream, so I will be starting our overrides from scratch. This may result in the final output being different from the DocBook 4 output. We will try and minimise this, but it's probably going to have some impact. > > ATM I am basing the new output on the upstream HTML5 XSL, we might need to switch back to XHTML, but I thought it's worth a shot testing with the HTML5 output. > > Cheers, Jeff. > For those of you playing along you'll now be wondering why it's all broken. You will need to grab the devel branch sources of two perl modules and update the packages on your system. https://github.com/jfearn/perl-XML-Catalog https://github.com/jfearn/XML-TreeBuilder On a bright note the build is faster as the entity work I'm doing makes locating entities mucho faster. And now I get to kill off some XSL ... YAY! Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From bugzilla at redhat.com Tue Sep 17 06:35:38 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 17 Sep 2013 06:35:38 +0000 Subject: [publican-list] [Bug 697366] Include DocBook 5-compatible templates In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697366 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|ASSIGNED |POST --- Comment #6 from Jeff Fearn --- This is in place in devel branch and can be tested. Suggestions on alternative names for --dtdver accepted. -- 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=lLuIjoZEpv&a=cc_unsubscribe From jfearn at redhat.com Tue Sep 17 07:30:17 2013 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 17 Sep 2013 17:30:17 +1000 Subject: [publican-list] Heads up, DocBook5 == GIT repo churn In-Reply-To: <52315464.8080000@redhat.com> References: <522E5B9B.3040107@redhat.com> <52315464.8080000@redhat.com> Message-ID: <52380509.5010307@redhat.com> On 09/12/2013 03:43 PM, Jeff Fearn wrote: > On 09/10/2013 09:36 AM, Jeff Fearn wrote: >> Hi, I am currently working on DocBooc5 support in the devel branch. This will create quite a bit of churn as I slice and dice Builder.pm so it's easier to sub class. >> >> I've already started, but there is much more change to come as I decide which bits of logic need to be moved up or down the object chain. >> >> We are going to try and keep the DocBook5 XSL as close as possible to upstream, so I will be starting our overrides from scratch. This may result in the final output being different from the DocBook 4 output. We will try and minimise this, but it's probably going to have some impact. >> >> ATM I am basing the new output on the upstream HTML5 XSL, we might need to switch back to XHTML, but I thought it's worth a shot testing with the HTML5 output. >> >> Cheers, Jeff. >> > > For those of you playing along you'll now be wondering why it's all broken. > > You will need to grab the devel branch sources of two perl modules and update the packages on your system. > > https://github.com/jfearn/perl-XML-Catalog > https://github.com/jfearn/XML-TreeBuilder > > On a bright note the build is faster as the entity work I'm doing makes locating entities mucho faster. > > And now I get to kill off some XSL ... YAY! > > Cheers, Jeff. > Hi all, the core of this is now in place and the majority of the code juggling should be complete. The styling is very close to upstream with only minimal changes made to fit in to a Publican WebSite. We'll be working on that over the next week. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From bugzilla at redhat.com Wed Sep 18 00:24:35 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 18 Sep 2013 00:24:35 +0000 Subject: [publican-list] [Bug 987199] RFE: pass a "sortas" attribute to Publican from PO files In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=987199 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- CC|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=wNAwh4cBTm&a=cc_unsubscribe From bugzilla at redhat.com Wed Sep 18 05:28:17 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Wed, 18 Sep 2013 05:28:17 +0000 Subject: [publican-list] [Bug 987199] RFE: pass a "sortas" attribute to Publican from PO files In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=987199 --- Comment #4 from HSS Product Manager --- HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED. -- 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=O6rdUYimZr&a=cc_unsubscribe From bugzilla at redhat.com Thu Sep 19 00:17:17 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 19 Sep 2013 00:17:17 +0000 Subject: [publican-list] [Bug 987199] RFE: pass a "sortas" attribute to Publican from PO files In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=987199 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |ASSIGNED Assignee|hss-ied-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=3Q9KxjDE4K&a=cc_unsubscribe From bugzilla at redhat.com Thu Sep 19 01:10:59 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 19 Sep 2013 01:10:59 +0000 Subject: [publican-list] [Bug 987199] RFE: pass a "sortas" attribute to Publican from PO files In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=987199 Jeff Fearn changed: What |Removed |Added ---------------------------------------------------------------------------- Status|ASSIGNED |NEW CC| |jfearn at redhat.com Component|publican |Publican Users Guide Assignee|jfearn at redhat.com |r.landmann at redhat.com --- Comment #5 from Jeff Fearn --- It appears we don't actually need to do any code changes at all! We'd only need to handle attributes indirectly if they are the root node being translated, however no node that serves as a root node for translation has this attribute. e.g. Introduction 1 In this XML indexterm is a the node Publican will base a translation block on. Translators can simply add the sortas attribute to the translation string. msgid "Introduction 1" msgstr "Introduzione 1" The tags containing this attribute are glossentry, secondary, primary, tertiary. Moving to PUG so that this procedure can be documented. -- 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=cRhVJq1K7K&a=cc_unsubscribe From bugzilla at redhat.com Thu Sep 19 02:15:27 2013 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Thu, 19 Sep 2013 02:15:27 +0000 Subject: [publican-list] [Bug 697367] Include DocBook 5-compatible Common Content In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=697367 Stephen Gordon changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |sgordon at redhat.com --- Comment #12 from Stephen Gordon --- (In reply to Ruediger Landmann from comment #9) > FATAL ERROR: parser:60 in http://docbook.org/xml/5.1b7/rng/docbook.rng on > line 1: Content error in the external subset To any other lucky winners who come across this bug via the googles I was encountering this error on the 5.0 schema (as opposed to 5.1b7 in the example above) but found that switching the dtdver to 5.1 proper seemed to resolve the issue (this was on Publican 3.1.2). No other file or library changes were required, YMMV. -- 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=BDqrG3Kx4x&a=cc_unsubscribe From jfearn at redhat.com Tue Sep 24 05:00:32 2013 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 24 Sep 2013 15:00:32 +1000 Subject: [publican-list] Heads up, DocBook5 == GIT repo churn In-Reply-To: <52315464.8080000@redhat.com> References: <522E5B9B.3040107@redhat.com> <52315464.8080000@redhat.com> Message-ID: <52411C70.2040704@redhat.com> Hi all, this change set is proving to be most disruptive. For the next version any website will have to be rebuilt from source. For this reason the next version will probably be 4.0 to indicate mucho disruptive changes. Cheers, Jeff. -- Jeff Fearn Senior Software Engineer Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0