From peter.moulder at monash.edu Wed Aug 1 05:51:33 2012 From: peter.moulder at monash.edu (Peter Moulder) Date: Wed, 01 Aug 2012 15:51:33 +1000 Subject: [publican-list] Changing size of PDF pages In-Reply-To: <4FF67D13.1080802@redhat.com> References: <4FF6554A.6030007@christensenplace.us> <4FF676E9.4020604@redhat.com> <4FF67D13.1080802@redhat.com> Message-ID: <20120801055133.GA11026@bowman.infotech.monash.edu.au> On Fri, Jul 06, 2012 at 03:52:19PM +1000, Jeff Fearn wrote: > On 07/06/2012 03:26 PM, Jeff Fearn wrote: > >On 07/06/2012 01:02 PM, Eric Christensen wrote: > >>Is it possible to set the page size for PDFs in the brand? I'd like > >>to specify the pages be 6" x 9". > > > >[XSL solution for FOP] > > Unless you are using wkhtmltopdf in which case we haven't actually > considered how to do this. The standards-based way of doing this would be to add @page { size: 6in 9in; } to the brand's CSS stylesheet. That's supported by at least WeasyPrint and Morp. If wkhtmltopdf doesn't yet support that, then a hacky approach would be to have Builder.pm do an imperfect parse of the brand stylesheet(s) before running wkhtmltopdf, perhaps as simple as: $_ = slurp($stylesheet_filename); s{/\*.*?\*/}{}g; # Remove comments first. if (/\@page \s* \{ \s* size \s* \: ([0-9.]+[a-z]+) \s+ ([0-9.]+[a-z]+) \s* (?: \; \s* )? \}/xi) { push @wkhtmltopdf_args, ('--page-width', $1, '--page-height', $2); } pjrm. From peter.moulder at monash.edu Wed Aug 1 08:14:42 2012 From: peter.moulder at monash.edu (Peter Moulder) Date: Wed, 01 Aug 2012 18:14:42 +1000 Subject: [publican-list] WeasyPrint: another possible alternative to wkhtmltopdf ? Message-ID: <20120801081442.GA11417@bowman.infotech.monash.edu.au> I just mentioned WeasyPrint (http://weasyprint.org/) in a different thread here, so I thought I should also mention what I know about it in terms of suitability for Publican purposes. Advantages over wkhtmltopdf: - Uses CSS, including more support for css3-page things than wkhtmltopdf. E.g. can set page size, borders, page numbering information etc. from a CSS stylesheet. Supports 'page-break-after: avoid', 'page-break-inside: avoid', 'widows', 'orphans' and so on. The only css3-page thing it doesn't yet support is named page styles. (The stylesheet I use with Morp makes quite a bit of use of named page styles to get the same page headings and page numbering styles as FOP uses. However, wkhtmltopdf doesn't support them either, so this isn't a disadvantage compared to wkhtmltopdf.) Disadvantages compared to wkhtmltopdf: - 6-10 times slower than wkhtmltopdf. Of course that makes a difference for Publican use, but it may still be worthwhile if the output looks better, and one could always have a command-line switch to use a faster renderer (wkhtmltopdf or even noop) for draft purposes. - Doesn't reuse a web browser's layout engine. However, its CSS support is coming along quite well, and I'd expect it to support most things Publican output currently uses. - Doesn't support RTL languages (Hebrew, Arabic etc.). Compared to FOP (and in common with all the alternatives to FOP): it doesn't yet include "on page N" in cross references for printed output, doesn't support footnotes, nor columns (for the index), and lacks niceties such as repeating the table header/footer when splitting a table over two pages; while on the other hand it does use CSS, supports font substitution and Indic languages, doesn't fall apart for page-break-inside:avoid content longer than a page, and isn't limited to platforms where Java runs. Compared to Morp: it's already intended for use by others, and already supports in-text clickable links; while on the other hand wouldn't do page headings and page numbering as well as Morp or FOP, is slower, and uses a simplistic approach to line-breaking and pagination (like wkhtmltopdf, but at least supports CSS directives like page-break-before/widows/orphans). A quick update on Morp while I'm on the subject: Morp output does now include the "document outline" (i.e. the clickable list of section headings shown on the left in most PDF viewers), but still no in-text clickable links or "on page N" appended to cross references for printed output, and there's still no work on making it easy for others to install and use Morp. I still maintain a directory of Morp output for Indic-language docs.redhat.com documents at http://bowman.infotech.monash.edu.au/~pmoulder/redhat-docs/ (along with the English version of each), and I've added the JBoss HTTP load balancing guide as well given that the FOP pdf for that on docs.redhat.com is still scrambled. I allow web search engines access to them (other than the English versions of the Indic-language documents, as docs.redhat.com already has good PDFs for those), which results in about one visitor a day (i.e. one source IP address, excluding bots). I think that access is a useful thing, but given that Red Hat aren't doing QA on the output, let me know if you'd prefer me to limit access more than that, or add a disclaimer at the top of the first page of each PDF or something. pjrm. From jwulf at redhat.com Wed Aug 1 08:39:48 2012 From: jwulf at redhat.com (Joshua J Wulf) Date: Wed, 01 Aug 2012 18:39:48 +1000 Subject: [publican-list] Common Content with Sets In-Reply-To: References: Message-ID: <5018EB54.9020107@redhat.com> On 08/01/2012 08:37 AM, Kendall Moore wrote: > Hello Publican users, > > I'm currently stuck trying to do something I would have guessed to be > a simple task. I have a set of two books, and some of the content for > them I would like to be shared between the books. I created a > directory for the common content (at the same level as the directories > for the two books) and put the XML files which contain sections in > it. Now, when I try to use an xi:include to grab these sections in > each of the books, I get an error trying to run publican with the > '--formats=test' option. The issue seems to be that some of the tags > inside of these common files have IDs, and each book attempts to > import the IDs into its own namespace but fails to do so because the > IDs aren't unique. Specifically, the error(s) look like the following: > > ../common/:6: validity error : ID already defined > > If I remove all of the IDs from these common files then there is no > issue, but unfortunately that is not an option for me. I link to the > pieces with IDs other places by way of xrefs and need an ID to do so > (or at least that's my understanding). > > Any help on the subject is greatly appreciated! > > -- > Kendall > > Hi Kendall, yes you need an ID to be the target for an xref. You didn't state it, but are you including your common content more than once in the same book? If you give some more specifics about your use case (maybe even some sample code) I can give some suggestions - I've worked around this issue several times with different strategies. - Josh -------------- next part -------------- An HTML attachment was scrubbed... URL: From kendall8688 at gmail.com Wed Aug 1 12:33:11 2012 From: kendall8688 at gmail.com (Kendall Moore) Date: Wed, 1 Aug 2012 08:33:11 -0400 Subject: [publican-list] Common Content with Sets In-Reply-To: <5018EB54.9020107@redhat.com> References: <5018EB54.9020107@redhat.com> Message-ID: Hi Josh, Thanks for the response. Let me try to outline what I'm doing a bit better here. I am attempting to use the common section once in each book. Inside of this section, there are sub-sections which have IDs that are referenced a few places in each book. Mostly in the sense that I say "Please refer to *here* for more detailed information" where here is a link to one of the IDs. And some code... ... ... ... ... For this example it may be possible to re-write the Introduction to better suit my needs and avoid this, but I will come across the same issue with another piece of shared code shortly and figured I may as well tackle the issue from the beginning. The errors I get when running publican have to do with being unable to load Introduction.xml because the IDs are already in use by the time the second book attempts to use it. Thanks again. -- Kendall On Wed, Aug 1, 2012 at 4:39 AM, Joshua J Wulf wrote: > On 08/01/2012 08:37 AM, Kendall Moore wrote: > > Hello Publican users, > > I'm currently stuck trying to do something I would have guessed to be a > simple task. I have a set of two books, and some of the content for them I > would like to be shared between the books. I created a directory for the > common content (at the same level as the directories for the two books) and > put the XML files which contain sections in it. Now, when I try to use an > xi:include to grab these sections in each of the books, I get an error > trying to run publican with the '--formats=test' option. The issue seems > to be that some of the tags inside of these common files have IDs, and each > book attempts to import the IDs into its own namespace but fails to do so > because the IDs aren't unique. Specifically, the error(s) look like the > following: > > ../common/:6: validity error : ID already defined > > If I remove all of the IDs from these common files then there is no issue, > but unfortunately that is not an option for me. I link to the pieces with > IDs other places by way of xrefs and need an ID to do so (or at least > that's my understanding). > > Any help on the subject is greatly appreciated! > > -- > Kendall > > > Hi Kendall, yes you need an ID to be the target for an xref. > > You didn't state it, but are you including your common content more than > once in the same book? > > If you give some more specifics about your use case (maybe even some > sample code) I can give some suggestions - I've worked around this issue > several times with different strategies. > > - Josh > -------------- next part -------------- An HTML attachment was scrubbed... URL: From jmorgan at redhat.com Wed Aug 1 23:41:34 2012 From: jmorgan at redhat.com (Jared Morgan) Date: Wed, 1 Aug 2012 19:41:34 -0400 (EDT) Subject: [publican-list] need the access In-Reply-To: <50175DB7.1020001@redhat.com> Message-ID: <22950683.300.1343864491034.JavaMail.jmorgan@dhcp-0-209.bne.redhat.com> Welcome to the Publican team, Matt. I'm sure Jeff will appreciate the help. Jared Morgan, RHCSA EPP Docs Lead | PressGang Lead Red Hat Asia Pacific 1/193 North Quay BRISBANE QLD 4000 P: +61 7 3514 8242 M: +61 413 005 479 Too brief? Here's why! http://emailcharter.org ----- Original Message ----- > From: mjia at redhat.com > To: publican-list at redhat.com > Sent: Tuesday, July 31, 2012 2:23:19 PM > Subject: [publican-list] need the access > > Hi , > > Please give me the access as I want to work on the publican. > > Thanks, > > Matt Jia > > _______________________________________________ > publican-list mailing list > publican-list at redhat.com > https://www.redhat.com/mailman/listinfo/publican-list > Wiki: https://fedorahosted.org/publican > From jwulf at redhat.com Thu Aug 2 00:35:05 2012 From: jwulf at redhat.com (Joshua Wulf) Date: Wed, 1 Aug 2012 20:35:05 -0400 (EDT) Subject: [publican-list] Common Content with Sets In-Reply-To: Message-ID: <912387003.26805418.1343867705420.JavaMail.root@redhat.com> I see, so the books are in the same set. Your issue here is that when you xref to the introductory material, there is no way for the processor to know which instance of the introductory material you want to link to. You tell it: "link to this material", but there are two different places in the book where "this material" exists - which one do you want to link to? There are a couple of strategies to get around this: 1. Include the introductory material only once in the set. Does it need to be in the set twice? When the books are built individually it might make sense, but when they are both built together? 2. Wrap the common material. You make each Intro chapter/section/whatever a link target by giving it a unique ID, then you include your common material *inside that*. So: Introduction .... Introduction Then you target "intro-1" and "intro-2" with your xref links. If you need to link into the sections within the intro, you can use a section with no title and use the element to give yourself a link target, so: Introduction Intro Section 2 Title But I would examine closely if you in fact need to include the material twice in the same set. What about this pattern? Intro Book A Book B Instead? Then you could have three different assemblies for the set and the two books on their own: Set: xi:include Intro content xi:include Book A content xi:include Book B content Book A only: xi:include Intro content xi:include Book A content Book B only: xi:include Intro content xi:include Book B content Hope one of these suggestions helps. - Josh ----- Original Message ----- > From: "Kendall Moore" > To: "Joshua J Wulf" > Cc: "Publican discussions" > Sent: Wednesday, August 1, 2012 10:33:11 PM > Subject: Re: [publican-list] Common Content with Sets > > Hi Josh, > > Thanks for the response. Let me try to outline what I'm doing a bit > better here. > > I am attempting to use the common section once in each book. Inside > of this section, there are sub-sections which have IDs that are > referenced a few places in each book. Mostly in the sense that I say > "Please refer to *here* for more detailed information" where here is > a link to one of the IDs. > > And some code... > > > ... > > > ... > > > > ... > > > ... > > > For this example it may be possible to re-write the Introduction to > better suit my needs and avoid this, but I will come across the same > issue with another piece of shared code shortly and figured I may as > well tackle the issue from the beginning. > > The errors I get when running publican have to do with being unable > to load Introduction.xml because the IDs are already in use by the > time the second book attempts to use it. > > Thanks again. > > -- > Kendall > > > On Wed, Aug 1, 2012 at 4:39 AM, Joshua J Wulf < jwulf at redhat.com > > wrote: > > > > > > > On 08/01/2012 08:37 AM, Kendall Moore wrote: > > > Hello Publican users, > > I'm currently stuck trying to do something I would have guessed to be > a simple task. I have a set of two books, and some of the content > for them I would like to be shared between the books. I created a > directory for the common content (at the same level as the > directories for the two books) and put the XML files which contain > sections in it. Now, when I try to use an xi:include to grab these > sections in each of the books, I get an error trying to run publican > with the '--formats=test' option. The issue seems to be that some of > the tags inside of these common files have IDs, and each book > attempts to import the IDs into its own namespace but fails to do so > because the IDs aren't unique. Specifically, the error(s) look like > the following: > > ../common/:6: validity error : ID already > defined > > If I remove all of the IDs from these common files then there is no > issue, but unfortunately that is not an option for me. I link to the > pieces with IDs other places by way of xrefs and need an ID to do so > (or at least that's my understanding). > > Any help on the subject is greatly appreciated! > > -- > Kendall > > > Hi Kendall, yes you need an ID to be the target for an xref. > > You didn't state it, but are you including your common content more > than once in the same book? > > If you give some more specifics about your use case (maybe even some > sample code) I can give some suggestions - I've worked around this > issue several times with different strategies. > > - Josh > > From jfearn at redhat.com Sat Aug 4 07:44:53 2012 From: jfearn at redhat.com (Jeff Fearn) Date: Sat, 04 Aug 2012 17:44:53 +1000 Subject: [publican-list] Publican 3 demo sites Message-ID: <501CD2F5.1080609@redhat.com> Hi, I've finally had the opportunity to put up demo sites for Publican 3. We were expecting to have a large demo site with the Fedora books on it, but that hasn't been possible, so I've redone my Fedora People site with both styles. We now support two web styles, the original web style 1 layout and a new web style 2. P3 does require all books and splash pages to be rebuilt. This is due to abstracting the web style from the HTML, the goal being you can build the books once and switch the site between web styles without rebuilding the books. We've also stopped shipping the brands in the books, so brand updates can be applied without rebuilding books. You can see the jazzed up web style 1 here: http://jfearn.fedorapeople.org/style_1 You can see the new web style 2 here: http://jfearn.fedorapeople.org/en-US/index.html Cheers, Jeff. From jfearn at redhat.com Sat Aug 4 07:58:12 2012 From: jfearn at redhat.com (Jeff Fearn) Date: Sat, 04 Aug 2012 17:58:12 +1000 Subject: [publican-list] Common Content with Sets In-Reply-To: References: <5018EB54.9020107@redhat.com> Message-ID: <501CD614.3050407@redhat.com> On 08/01/2012 10:33 PM, Kendall Moore wrote: > Hi Josh, > > Thanks for the response. Let me try to outline what I'm doing a bit > better here. > > I am attempting to use the common section once in each book. Inside of > this section, there are sub-sections which have IDs that are referenced > a few places in each book. Mostly in the sense that I say "Please refer > to *here* for more detailed information" where here is a link to one of > the IDs. > > And some code... > > > ... > > > ... > > > > ... > > > ... > > > For this example it may be possible to re-write the Introduction to > better suit my needs and avoid this, but I will come across the same > issue with another piece of shared code shortly and figured I may as > well tackle the issue from the beginning. > > The errors I get when running publican have to do with being unable to > load Introduction.xml because the IDs are already in use by the time the > second book attempts to use it. Hi Kendal, it's XSLT that is complaining about the duplicate IDs, publican is just passing them back. This is a known limitation of stand alone sets. For distributed sets we have a work around, which is basically to run clean_ids on the temporary XML. It might be possible to do this for standalone sets but it almost never makes sense because you can't build books in standalone sets by themselves since the paths to the common files will break, and having the same introduction in multiple places in a single payload isn't great. You might have more luck doing a distributed set if you really need to build the books standalone and in the set. Cheers, Jeff. From sbdens at gmail.com Mon Aug 6 06:58:38 2012 From: sbdens at gmail.com (Sebastien Denis) Date: Mon, 6 Aug 2012 08:58:38 +0200 Subject: [publican-list] Creating a custom XSL for a brand Message-ID: Hello, New user to both Docbook and Publican, I am trying to write a small documentation using both, but I am stumbling above a problem which is probably just a newbie mistake. I created a brand with Publican to customize some elements of the documentation (images and entities). I want to create a custom XSL for the HTML output. I created it in this directory: mybrand/en/xsl And then: sudo publican install_brand --path /usr/share/publican/Common_Content/ Unfortunately my custom XSL is nowhere to be found, at least not in /usr/share/publican/Common_Content/mybrand /usr/share/publican/xsl How can I create a custom XSL for a brand with Publican ? I have Publican 2.1 and Centos 6.3 as a distro. Thanks. Sebastien From jfearn at redhat.com Mon Aug 6 07:48:39 2012 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 06 Aug 2012 17:48:39 +1000 Subject: [publican-list] Creating a custom XSL for a brand In-Reply-To: References: Message-ID: <501F76D7.2090205@redhat.com> On 08/06/2012 04:58 PM, Sebastien Denis wrote: > Hello, > > New user to both Docbook and Publican, I am trying to write a small > documentation using both, but I am stumbling above a problem which is > probably just a newbie mistake. I created a brand with Publican to > customize some elements of the documentation (images and entities). I > want to create a custom XSL for the HTML output. I created it in this > directory: > > mybrand/en/xsl > > And then: > > sudo publican install_brand --path /usr/share/publican/Common_Content/ > > Unfortunately my custom XSL is nowhere to be found, at least not in > > /usr/share/publican/Common_Content/mybrand > /usr/share/publican/xsl > > How can I create a custom XSL for a brand with Publican ? I have > Publican 2.1 and Centos 6.3 as a distro. > > Thanks. $ cd mybrand $ mkdir xsl $ gvim xsl/html.xsl ... more xslt magic :wq $ publican build --formats=xml --langs=all --publish $ sudo publican install_brand --path /usr/share/publican/Common_Content/ Cheers, Jeff. -- Jeff Fearn Acting Supervisor Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From sbdens at gmail.com Mon Aug 6 08:00:57 2012 From: sbdens at gmail.com (Sebastien Denis) Date: Mon, 6 Aug 2012 10:00:57 +0200 Subject: [publican-list] Creating a custom XSL for a brand In-Reply-To: <501F76D7.2090205@redhat.com> References: <501F76D7.2090205@redhat.com> Message-ID: Of course, I forgot the building part. That really was a newbie error. Thanks for pointing that out. Cheers, Sebastien From bugzilla at redhat.com Tue Aug 7 04:16:46 2012 From: bugzilla at redhat.com (bugzilla at redhat.com) Date: Tue, 07 Aug 2012 04:16:46 +0000 Subject: [publican-list] [Bug 696834] Choose format icon In-Reply-To: References: Message-ID: https://bugzilla.redhat.com/show_bug.cgi?id=696834 Rebecca Newton changed: What |Removed |Added ---------------------------------------------------------------------------- Assignee|jfearn at redhat.com |irooskov at redhat.com -- You are receiving this mail because: You are on the CC list for the bug. From miesfeld at gmail.com Mon Aug 13 14:31:36 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Mon, 13 Aug 2012 07:31:36 -0700 Subject: [publican-list] What's the status of publican on Windows? Message-ID: Hi, One of the things that interested me about publican was the presence of a Windows installer. It would be convenient for me to be able to work on Windows, rather than having to boot into a Linux system whenever I needed to work on our documentation. But, when I installed publican, I see that the publican.exe is dated 2009. And it won't run on my Windows 7 system. So, I'm guessing there is really not much support for running publican on Windows. Is that true, or am I missing something? -- Mark Miesfeld From jfearn at redhat.com Mon Aug 13 22:42:08 2012 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 14 Aug 2012 08:42:08 +1000 Subject: [publican-list] What's the status of publican on Windows? In-Reply-To: References: Message-ID: <502982C0.4010006@redhat.com> On 08/14/2012 12:31 AM, Mark Miesfeld wrote: > Hi, > > One of the things that interested me about publican was the presence > of a Windows installer. It would be convenient for me to be able to > work on Windows, rather than having to boot into a Linux system > whenever I needed to work on our documentation. > > But, when I installed publican, I see that the publican.exe is dated > 2009. https://fedorahosted.org/releases/p/u/publican/Publican-Installer-2.3.exe is from Nov 2010. > And it won't run on my Windows 7 system. Can you tell us why? > So, I'm guessing there is really not much support for running publican > on Windows. Is that true, or am I missing something? It's quite an effort to get it working and we receive very little feed back about it so it's not a priority. Publican 3.0 is around the corner and I do hope to have a Windows installer for that. I have access to Vista and Win7 so hopefully I can get it working on both. Cheers, Jeff. -- Jeff Fearn Acting Supervisor Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From miesfeld at gmail.com Mon Aug 13 23:10:52 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Mon, 13 Aug 2012 16:10:52 -0700 Subject: [publican-list] What's the status of publican on Windows? In-Reply-To: <502982C0.4010006@redhat.com> References: <502982C0.4010006@redhat.com> Message-ID: On Mon, Aug 13, 2012 at 3:42 PM, Jeff Fearn wrote: > On 08/14/2012 12:31 AM, Mark Miesfeld wrote: >> >> One of the things that interested me about publican was the presence >> of a Windows installer. It would be convenient for me to be able to >> work on Windows, rather than having to boot into a Linux system >> whenever I needed to work on our documentation. >> >> But, when I installed publican, I see that the publican.exe is dated >> 2009. > > https://fedorahosted.org/releases/p/u/publican/Publican-Installer-2.3.exe is > from Nov 2010. Thanks for the reply. Sorry about that. I saw that when I went back to look more closely. I think I had just assumed that Publican-installer.exe was the latest version. >> And it won't run on my Windows 7 system. > > Can you tell us why? It was missing a MsCRT DLL. But I ran the 2.3 installer and saw the missing DLL was included. So that is probably fixed. Unfortunately, the Publican-Installer-2.3.exe tries to download some ImageMagic files during the install and for whatever reason the estimated time to finish was over an hour. I was too impatient and quit. I'll try again later tonight. >> So, I'm guessing there is really not much support for running publican >> on Windows. Is that true, or am I missing something? > > > It's quite an effort to get it working and we receive very little feed back > about it so it's not a priority. Publican 3.0 is around the corner and I do > hope to have a Windows installer for that. I have access to Vista and Win7 > so hopefully I can get it working on both. Is it just the installer you are having problems with, or is it the Windows .exe itself? Thanks again for the reply. It is good to know that there will at least an effort to get 3.0 working on Windows. I thought maybe the Windows effort was abandoned. -- Mark Miesfeld From jfearn at redhat.com Mon Aug 13 23:50:44 2012 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 14 Aug 2012 09:50:44 +1000 Subject: [publican-list] What's the status of publican on Windows? In-Reply-To: References: <502982C0.4010006@redhat.com> Message-ID: <502992D4.3040904@redhat.com> Hi Mark, On 08/14/2012 09:10 AM, Mark Miesfeld wrote: > On Mon, Aug 13, 2012 at 3:42 PM, Jeff Fearn wrote: >> On 08/14/2012 12:31 AM, Mark Miesfeld wrote: >>> >>> One of the things that interested me about publican was the presence >>> of a Windows installer. It would be convenient for me to be able to >>> work on Windows, rather than having to boot into a Linux system >>> whenever I needed to work on our documentation. >>> >>> But, when I installed publican, I see that the publican.exe is dated >>> 2009. >> >> https://fedorahosted.org/releases/p/u/publican/Publican-Installer-2.3.exe is >> from Nov 2010. > > Thanks for the reply. Sorry about that. I saw that when I went back > to look more closely. I think I had just assumed that > Publican-installer.exe was the latest version. > >>> And it won't run on my Windows 7 system. >> >> Can you tell us why? > > It was missing a MsCRT DLL. But I ran the 2.3 installer and saw the > missing DLL was included. So that is probably fixed. > > Unfortunately, the Publican-Installer-2.3.exe tries to download some > ImageMagic files during the install and for whatever reason the > estimated time to finish was over an hour. I was too impatient and > quit. I'll try again later tonight. FYI this has been removed for 3.0. >>> So, I'm guessing there is really not much support for running publican >>> on Windows. Is that true, or am I missing something? >> >> >> It's quite an effort to get it working and we receive very little feed back >> about it so it's not a priority. Publican 3.0 is around the corner and I do >> hope to have a Windows installer for that. I have access to Vista and Win7 >> so hopefully I can get it working on both. > > Is it just the installer you are having problems with, or is it the > Windows .exe itself? The installer is easy, it uses NSIS, but making a perl program in to a standalone exe is a tricky process and it can get frustrating. I have recently switched from using Active State Perl to using Strawberry Perl ... we'll soon see if that is easier or not :) > Thanks again for the reply. It is good to know that there will at > least an effort to get 3.0 working on Windows. I thought maybe the > Windows effort was abandoned. Not abandoned ... just under appreciated ;) Cheers, Jeff. -- Jeff Fearn Acting Supervisor Infrastructure Engineering & Development (AEU) Red Hat Asia Pacific Pty Ltd GPG: 0x0357E8F0 From dlackey at redhat.com Wed Aug 15 03:32:47 2012 From: dlackey at redhat.com (E Deon Lackey) Date: Tue, 14 Aug 2012 22:32:47 -0500 Subject: [publican-list] ja-JP build error -- can't find 'revision' in Revision_History? Message-ID: <502B185F.209@redhat.com> Has anyone else seen this on Publican 3? Processing file tmp/ja-JP/xml/Common_Content/Conventions.xml -> tmp/ja-JP/xml/Common_Content/Conventions.xml Processing file tmp/ja-JP/xml/Common_Content/Feedback.xml -> tmp/ja-JP/xml/Common_Content/Feedback.xml Processing file tmp/ja-JP/xml/Common_Content/Legal_Notice.xml -> tmp/ja-JP/xml/Common_Content/Legal_Notice.xml Processing file tmp/ja-JP/xml/Common_Content/Program_Listing.xml -> tmp/ja-JP/xml/Common_Content/Program_Listing.xml Processing file tmp/ja-JP/xml/Common_Content/Revision_History.xml -> tmp/ja-JP/xml/Common_Content/Revision_History.xml Processing file tmp/ja-JP/xml_tmp/Article_Info.xml -> tmp/ja-JP/xml/Article_Info.xml Processing file tmp/ja-JP/xml_tmp/.xml -> tmp/ja-JP/xml/.xml *WARNING: Unvalidated tag: 'informalfigure'. This tag may not be displayed correctly, may generate invalid xhtml, or may breach Section 508 Accessibility standards. Processing file tmp/ja-JP/xml_tmp/Revision_History.xml -> tmp/ja-JP/xml/Revision_History.xml Wide character in print at /usr/share/perl5/Config/Simple.pm line 582. Missing mandatory field 'revision' in revision history. at /usr/bin/publican line 924 Thanks, Deon -------------- next part -------------- An HTML attachment was scrubbed... URL: From eric at christensenplace.us Wed Aug 15 14:48:10 2012 From: eric at christensenplace.us (Eric Christensen) Date: Wed, 15 Aug 2012 10:48:10 -0400 Subject: [publican-list] ja-JP build error -- can't find 'revision' in Revision_History? In-Reply-To: <502B185F.209@redhat.com> References: <502B185F.209@redhat.com> Message-ID: <502BB6AA.4040201@christensenplace.us> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 08/14/2012 11:32 PM, E Deon Lackey wrote: > Has anyone else seen this on Publican 3? > > Processing file tmp/ja-JP/xml/Common_Content/Conventions.xml -> > tmp/ja-JP/xml/Common_Content/Conventions.xml Processing file > tmp/ja-JP/xml/Common_Content/Feedback.xml -> > tmp/ja-JP/xml/Common_Content/Feedback.xml Processing file > tmp/ja-JP/xml/Common_Content/Legal_Notice.xml -> > tmp/ja-JP/xml/Common_Content/Legal_Notice.xml Processing file > tmp/ja-JP/xml/Common_Content/Program_Listing.xml -> > tmp/ja-JP/xml/Common_Content/Program_Listing.xml Processing file > tmp/ja-JP/xml/Common_Content/Revision_History.xml -> > tmp/ja-JP/xml/Common_Content/Revision_History.xml Processing file > tmp/ja-JP/xml_tmp/Article_Info.xml -> > tmp/ja-JP/xml/Article_Info.xml Processing file > tmp/ja-JP/xml_tmp/.xml -> tmp/ja-JP/xml/.xml *WARNING: > Unvalidated tag: 'informalfigure'. This tag may not be displayed > correctly, may generate invalid xhtml, or may breach Section 508 > Accessibility standards. Processing file > tmp/ja-JP/xml_tmp/Revision_History.xml -> > tmp/ja-JP/xml/Revision_History.xml Wide character in print at > /usr/share/perl5/Config/Simple.pm line 582. Missing mandatory field > 'revision' in revision history. at /usr/bin/publican line 924 > > > Thanks, Deon Can you post your revision history file somewhere (fpaste.org?) so I can take a look at it? - -Eric -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQIcBAEBAgAGBQJQK7aqAAoJEIB2q94CS7PROcYP+gPuRmK2bMOlishfa8jKhCFs A8oeU0Dyxfp9DUVEngShHt4K6vTRxsGRq9tf5vD4yyu5Snae02N26lcns4jDJG+3 rB0pMDzU5XvCuQZ/Lz1AhO92WHMT0b7SEwOtfwGdhL1VIpniXKQklKFiEyqlkF3F sgLcs7MuT88QgkHaLDxJWhXgZERUjsMwxCTVwODsLcU32TEyZwSezbecDnpbhGwC IkkqgZBQghREbwm+x9v5uTP60D4QcWQsn5eEFGxpFMspF2dHa6i/IsL+VDWC60xg bbP4M8mfON0p37Biw0ZcV9Cq1J+sBQrxg1nghGHcu+HFBAQxssCua5Rl8GuhuNnt 8u1SSuHwKzc+2Oxg+twC2cjD6Fy2ihVRsRKPWRrGefuCbmE40iyDA3NO7k6NI4aX 7OYxfdHWQyEScQLKbEgHqubTE1oNHWQ9DddTEQrOZJgDUZ/pOVg6jS96zIqEpWur fs0M/+gHccTgqd5jHpZDUFfWXsfHqdAijk2sQgXmuma45fpNsTQmrTUb9HPliMGr tQmA3TXSExNU6JAgEqv5ECzYY2jCJCPm//wUhjpmnAr5rNhBtTu8JbsSqxcD+7v3 0HW9nWj5ljxsiLCC6P1DcEy3YYHaiusV4lakz4/qg7IpZezO56rLI+SuqWMCIKhD U3uAO/ftcWjhbn/nFeMg =xvCL -----END PGP SIGNATURE----- From miesfeld at gmail.com Sun Aug 26 02:07:34 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Sat, 25 Aug 2012 19:07:34 -0700 Subject: [publican-list] About the index produced under Publican Message-ID: Hi, Our project is switching over to use Publican to produce our docs. Previously we built the docs using jade. We have several reference manuals that are rather large with a lot of entries in the index. Say, 30 pages in a PDF doc. In our old builds, in a PDF doc, in the left-hand pane there would be a + symbol to the left of "Index" and when you clicked to open it, it would expand to a list of bookmarks starting with symbols and then going A B C etc. So if you want to look up "parsing" in the index you could click on the P and see all the indexes that started with P and it was easy to find parsing. Under our build using publican, for the same doc, we still the Index bookmark in the left-hand pane, but it has no + and no list of bookmarks for A B C etc.. When you click on the index bookmark you are on the index page and there is the heading Symbols, you page down a ways and there is the A heading with the A indexes following, and so on. Each letter A B C etc is there in the font and style of heading, but there is no bookmark to quickly get to the P. With a lot of indexes, it is now very hard to find parsing. We're just starting with this, and don't have a clue as to how to get the A B C etc bookmarks back in the Index section. Does anyone have any suggestions? Thanks. -- Mark Miesfeld From jwulf at redhat.com Wed Aug 29 05:26:48 2012 From: jwulf at redhat.com (Joshua Wulf) Date: Wed, 29 Aug 2012 01:26:48 -0400 (EDT) Subject: [publican-list] Publican 3 brand woes In-Reply-To: <1046587782.14823712.1346216774958.JavaMail.root@redhat.com> Message-ID: <155521759.14828429.1346218008347.JavaMail.root@redhat.com> My Publican brand, publican-redhat-video, doesn't work properly on the docs stage with Publican 3. It worked ok locally and on the stage with Publican 2. Now it works ok locally, but does not work on the stage. If you take a look at: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/index.html#sect-Handling_Exceptions and look at the javascript console (in Chrome: hit Ctrl-Shift-I, then select Console), you can see the following errors: Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/Common_Content/css/modernizr.js Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/Common_Content/css/jquery-1.4.2.min.js Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/Common_Content/css/code-lang-switcher.js Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/Common_Content/css/skynet-book.js Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/en-US/toc.html Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/common.css Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/overrides.css Failed to load resource: the server responded with a status of 404 (Not Found) http://documentation-devel.engineering.redhat.com/docs/lang.css Uncaught ReferenceError: skynetBookLoad is not defined /docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/index.html#chap-Beyond_Hello_World:10 onload /docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Programming_Reference/index.html#chap-Beyond_Hello_World:10 all the files from the en-US/css directory of my brand are missing on the docs stage. For example: when built locally, the file Common_Content/css/code-lang-switcher.js is present from my brand, and loads from this line in the book's html: When published to the stage via brew, that file is not present. The docs stage has a -web version of the brand package installed. Any pointers on how Publican 3 web brands differ from the Publican 2 ones, and how I might fix this? - Josh From miesfeld at gmail.com Thu Aug 30 14:56:05 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Thu, 30 Aug 2012 07:56:05 -0700 Subject: [publican-list] How can certain warnings be turned off? Message-ID: Hi, Our project is switching over to publican and I'm having trouble with the tag. I want to turn these warnings off: *WARNING: Questionable tag found: link Undesirable tag -- use xref for internal links or ulink for external links. Consider not using this tag I'm no DocBook expert, but I don't see anywhere that says link is not a valid tag. What I see is that there are two types of tags, those that are empty and those that provide their own text. In the book I work on, I need to provide my own text at each link. It's a big book with a lot of links. I have "considered not using this tag" and after a lot of consideration, I've decided that I want to use this tag. I want to turn the warning off. Processing spits out so many of these warnings that legitimate warnings are masked. How do I go about doing that? Thanks. -- Mark Miesfeld From Norman at dunbar-it.co.uk Thu Aug 30 15:57:02 2012 From: Norman at dunbar-it.co.uk (Norman Dunbar) Date: Thu, 30 Aug 2012 16:57:02 +0100 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: References: Message-ID: <503F8D4E.6070407@dunbar-it.co.uk> Evening Mark, > I'm no DocBook expert, but I don't see anywhere that says link is not > a valid tag. It is a valid DocBook tag, it's just "frowned upon" by Publican mainly because it's possibly going to affect translations of documents. > ... > I want to turn the warning off. Processing spits out so many of these > warnings that legitimate warnings are masked. How do I go about doing > that? I'm not sure it can be, someone else may correct me though. However, when you say that you want to supply text at the end of your links, what do you mean? I have a document with lots of cross references, for example. I do this in the with an tag with the link-end holding the ID of a section or paragraph etc: Blah blah blah. For more details, see blah blah blah. ...
More Details ...... When this is built with Publican, what is generated in the PDF would be: Blah blah blah. For more details, see Section 2.3.4 More Details blah blah blah. Where "Section 2.3.4 More Details" is text generated by Publican from the section number and its title. Not sure if this helps or not. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 From miesfeld at gmail.com Thu Aug 30 16:21:28 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Thu, 30 Aug 2012 09:21:28 -0700 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: <503F8D4E.6070407@dunbar-it.co.uk> References: <503F8D4E.6070407@dunbar-it.co.uk> Message-ID: On Thu, Aug 30, 2012 at 8:57 AM, Norman Dunbar wrote: > It is a valid DocBook tag, it's just "frowned upon" by Publican mainly > because it's possibly going to affect translations of documents. Norman, Thanks for the reply. I realize that it is frowned upon and I understand why. But, this book will never be translated. So the reason it is frowned upon does not apply here. >> I want to turn the warning off. Processing spits out so many of these >> warnings that legitimate warnings are masked. How do I go about doing >> that? > > > I'm not sure it can be, someone else may correct me though. I don't see any documented way, so I'm hoping one of the developers will correct you. ;-) > However, when you say that you want to supply text at the end of your links, > what do you mean? > ... > Blah blah blah. For more details, see Section 2.3.4 More Details blah blah > blah. > ... > Not sure if this helps or not. That's exactly what I don't want. I don't want the "see Section 2.3.4 More Details" If I have "blah blah connects the event notification with a method in the Rexx dialog." I want to link "event" to section 4.5.6.7 with the title of "Understanding Event Notifications" I went through and changed all my tags to xref tags and I have have: "blah blah connects the event see Section 4.5.6.7 Understanding Event Notifications notification with a method in the Rexx dialog" That's unacceptable to me. I don't care if the link tag can't be translated. ;-) The book is not going to be translated. So, I thought, maybe I can fix this with xreflabel and I get hundreds of these warnings: *WARNING: Questionable attribute found: xreflabel xreflabel hides data from translators and, consequently, causes translation errors. Consider not using this attribute. I don't care if xreflabel hides data from translators, the book will never be translated. ;-) If I could just turn the warnings off, everything would be okay. -- Mark Miesfeld From dlackey at redhat.com Thu Aug 30 18:13:46 2012 From: dlackey at redhat.com (E Deon Lackey) Date: Thu, 30 Aug 2012 13:13:46 -0500 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: References: <503F8D4E.6070407@dunbar-it.co.uk> Message-ID: <503FAD5A.7060905@redhat.com> On 8/30/2012 11:21 AM, Mark Miesfeld wrote: > ... 8< ... > > So, I thought, maybe I can fix this with xreflabel and I get hundreds > of these warnings: > > *WARNING: Questionable attribute found: xreflabel > xreflabel hides data from translators and, consequently, > causes translation errors. > Consider not using this attribute. > > I don't care if xreflabel hides data from translators, the book will > never be translated. ;-) > > If I could just turn the warnings off, everything would be okay. Have you tried setting debug to 0 in your publican.cfg file? That turns off a lot of errors; I don't know if it turns off the translation ones. From miesfeld at gmail.com Thu Aug 30 18:24:12 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Thu, 30 Aug 2012 11:24:12 -0700 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: <503FAD5A.7060905@redhat.com> References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> Message-ID: On Thu, Aug 30, 2012 at 11:13 AM, E Deon Lackey wrote: > On 8/30/2012 11:21 AM, Mark Miesfeld wrote: >> If I could just turn the warnings off, everything would be okay. > > Have you tried setting debug to 0 in your publican.cfg file? That turns off > a lot of errors; I don't know if it turns off the translation ones. Thanks. No I didn't try that. I looked at the options available in the config file and it didn't occur to me that that option would help. It's not really an error, just a warning. The PDF book actually builds and looks fine. Makes sense that it might help now that you brought it up. I'll try that. -- Mark Miesfeld From miesfeld at gmail.com Thu Aug 30 18:45:41 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Thu, 30 Aug 2012 11:45:41 -0700 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> Message-ID: On Thu, Aug 30, 2012 at 11:24 AM, Mark Miesfeld wrote: > On Thu, Aug 30, 2012 at 11:13 AM, E Deon Lackey wrote: >> On 8/30/2012 11:21 AM, Mark Miesfeld wrote: > >>> If I could just turn the warnings off, everything would be okay. >> >> Have you tried setting debug to 0 in your publican.cfg file? That turns off >> a lot of errors; I don't know if it turns off the translation ones. > > No I didn't try that. Okay, I tried it but it didn't turn the warnings off. -- Mark Miesfedl From misty at redhat.com Fri Aug 31 05:36:17 2012 From: misty at redhat.com (Misty Stanley-Jones) Date: Fri, 31 Aug 2012 11:06:17 +0530 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> Message-ID: <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> It's just a warning, you can ignore it if you like. :) Misty Stanley-Jones, RHCE Supervisor, Engineering Content Services Red Hat Brisbane (GMT+10) ?: misty (IRC) ?: misty at redhat.com ?: + 61 7 3514 8105 On Aug 31, 2012, at 12:15 AM, Mark Miesfeld wrote: > On Thu, Aug 30, 2012 at 11:24 AM, Mark Miesfeld wrote: >> On Thu, Aug 30, 2012 at 11:13 AM, E Deon Lackey wrote: >>> On 8/30/2012 11:21 AM, Mark Miesfeld wrote: >> >>>> If I could just turn the warnings off, everything would be okay. >>> >>> Have you tried setting debug to 0 in your publican.cfg file? That turns off >>> a lot of errors; I don't know if it turns off the translation ones. >> >> No I didn't try that. > > Okay, I tried it but it didn't turn the warnings off. > > -- > Mark Miesfedl > > _______________________________________________ > publican-list mailing list > publican-list at redhat.com > https://www.redhat.com/mailman/listinfo/publican-list > Wiki: https://fedorahosted.org/publican > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From mjia at redhat.com Fri Aug 31 05:39:13 2012 From: mjia at redhat.com (mjia at redhat.com) Date: Fri, 31 Aug 2012 15:39:13 +1000 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> Message-ID: <50404E01.90800@redhat.com> Is that happen when you built a book ? If so ,you can use --quiet option to skip the warning messages . On 08/31/2012 03:36 PM, Misty Stanley-Jones wrote: > It's just a warning, you can ignore it if you like. :) > > Misty Stanley-Jones, RHCE > Supervisor, Engineering Content Services > Red Hat Brisbane (GMT+10) > ?: misty (IRC) ?: misty at redhat.com ?: +61 7 > 3514 8105 > > On Aug 31, 2012, at 12:15 AM, Mark Miesfeld > wrote: > >> On Thu, Aug 30, 2012 at 11:24 AM, Mark Miesfeld > > wrote: >>> On Thu, Aug 30, 2012 at 11:13 AM, E Deon Lackey >> > wrote: >>>> On 8/30/2012 11:21 AM, Mark Miesfeld wrote: >>> >>>>> If I could just turn the warnings off, everything would be okay. >>>> >>>> Have you tried setting debug to 0 in your publican.cfg file? That >>>> turns off >>>> a lot of errors; I don't know if it turns off the translation ones. >>> >>> No I didn't try that. >> >> Okay, I tried it but it didn't turn the warnings off. >> >> -- >> Mark Miesfedl >> >> _______________________________________________ >> publican-list mailing list >> publican-list at redhat.com >> https://www.redhat.com/mailman/listinfo/publican-list >> Wiki: https://fedorahosted.org/publican >> >> > > > > _______________________________________________ > publican-list mailing list > publican-list at redhat.com > https://www.redhat.com/mailman/listinfo/publican-list > Wiki: https://fedorahosted.org/publican -------------- next part -------------- An HTML attachment was scrubbed... URL: From miesfeld at gmail.com Fri Aug 31 15:54:14 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Fri, 31 Aug 2012 08:54:14 -0700 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> Message-ID: On Thu, Aug 30, 2012 at 10:36 PM, Misty Stanley-Jones wrote: > It's just a warning, you can ignore it if you like. :) I am ignoring them. But, there are so many I can't tell if there are any other warnings in there. -- Mark Miesfeld From miesfeld at gmail.com Fri Aug 31 15:58:54 2012 From: miesfeld at gmail.com (Mark Miesfeld) Date: Fri, 31 Aug 2012 08:58:54 -0700 Subject: [publican-list] How can certain warnings be turned off? In-Reply-To: <50404E01.90800@redhat.com> References: <503F8D4E.6070407@dunbar-it.co.uk> <503FAD5A.7060905@redhat.com> <7B607575-0403-477C-9A02-EA7960F64913@redhat.com> <50404E01.90800@redhat.com> Message-ID: On Thu, Aug 30, 2012 at 10:39 PM, wrote: > Is that happen when you built a book ? > > If so ,you can use --quiet option to skip the warning messages . Thank you. That's what I was looking for. -- Mark Miesfeld