From lists at murrell.ca Sat Aug 8 03:53:31 2015 From: lists at murrell.ca (Alan Murrell) Date: Fri, 07 Aug 2015 20:53:31 -0700 Subject: [publican-list] Supress section numbering Message-ID: <55C57D3B.7040804@murrell.ca> Hello, I am wondering if it is possible to suppress certain "sections" from showing their numbers in the the document (i.e., just the "title", and still show up in the TOC) I know I can use a "max depth" parameter to control how many levels use the numbering, but I think that is a global parameter, and I don;t want to do it globally. What I am trying to do for a particular section is something like this: 4. Backups 4.1 Backup Devices Tape Drives USB Drives and have the TOC show up like this: 4. Backups................ 3 4.1. Backup Devices..... 3 Tape Drives......... 3 USB Drives.......... 3 But in other sections, I would still want that 3rd-layer of numbering (e.g., "5.1.1"), so I don't want to disable it completely It's not a big deal if this can't be done, but I just thought i would ask. Thanks! :-) Regards, Alan From jfearn at redhat.com Sun Aug 9 22:24:04 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 10 Aug 2015 08:24:04 +1000 Subject: [publican-list] Supress section numbering In-Reply-To: <55C57D3B.7040804@murrell.ca> References: <55C57D3B.7040804@murrell.ca> Message-ID: <55C7D304.1060005@redhat.com> On 08/08/15 13:53, Alan Murrell wrote: > Hello, > > I am wondering if it is possible to suppress certain "sections" from > showing their numbers in the the document (i.e., just the "title", and > still show up in the TOC) > > I know I can use a "max depth" parameter to control how many levels use > the numbering, but I think that is a global parameter, and I don;t want > to do it globally. > > What I am trying to do for a particular section is something like this: > > 4. Backups > > 4.1 Backup Devices > > Tape Drives > > USB Drives > > and have the TOC show up like this: > > 4. Backups................ 3 > 4.1. Backup Devices..... 3 > Tape Drives......... 3 > USB Drives.......... 3 > > But in other sections, I would still want that 3rd-layer of numbering > (e.g., "5.1.1"), so I don't want to disable it completely > > It's not a big deal if this can't be done, but I just thought i would ask. > > Thanks! :-) > > Regards, Hi Alan, Option 1: you will need a custom brand to do this as you have to set a docbook option not exposed in publican. The trick is to use bridgeheads instead of sections and set bridgehead.in.toc to 1 in your XSL. Note this is global, so if you use bridgeheads in other ways it will conflict. Option 2: AFAICT there is nothing in the DcoBook styles to do this with sections, so you'd have to override the TOC generation. See: http://www.sagehill.net/docbookxsl/TOCcontrol.html Cheers, Jeff. From haug.buerger at zalando.de Fri Aug 14 08:33:19 2015 From: haug.buerger at zalando.de (Haug =?ISO-8859-1?Q?B=FCrger?=) Date: Fri, 14 Aug 2015 10:33:19 +0200 Subject: [publican-list] SVGs in PDF and HTML Message-ID: <1439541199.3000.5.camel@ZALANDO-4732.corp.ad.zalando.net> How to make sure SVG images consume the same amount of space in the PDF and in the HTML document. Currently in the PDF the image fits nicely to the chapters above, nearly the same width. In the HTML it uses only half the width of the chapter above. For me it looks like PDF is scaling while HTML is not scaling. All I want is consistent behavior in both output formats. How can I do that? From lists at murrell.ca Sat Aug 22 05:06:16 2015 From: lists at murrell.ca (Alan Murrell) Date: Fri, 21 Aug 2015 22:06:16 -0700 Subject: [publican-list] Trouble with brand creation Message-ID: <55D80348.7070407@murrell.ca> Hello, I have created a brand for my documentation for a particular client. It is really just the "common" brand, except I replaced the logo images with appropriate PNG and SVG files for my client. Let's call the brand "NewBrand" Whenever I create a document and specify it to use "NewBrand", it doesn't seem to work. The logo images are that of the "common" brand and not the ones for my client. I created a brand about a month ago for my company, and it was successful (ie., if I create a document and specify it to use this brand, it works) Not sure what I may have done wrong? Thanks, in advance, for your insight. Regards, Alan From lists at murrell.ca Sun Aug 23 02:17:31 2015 From: lists at murrell.ca (Alan Murrell) Date: Sat, 22 Aug 2015 19:17:31 -0700 Subject: [publican-list] Trouble with brand creation In-Reply-To: <55D80348.7070407@murrell.ca> References: <55D80348.7070407@murrell.ca> Message-ID: <55D92D3B.1060705@murrell.ca> This is resolved. I am not sure what I was doing wrong, but I followed the steps from the Publican documentation for creating a brand and now it works as expected. On a side note, any reason why the default CSS file that exists when a brand is created doe snot use the CSS file for the "common" brand? It seems to use the Red Hat one (so all headings, etc. created in HTML files are red instead of the blue that is used in the PDFs) Regards, Alan From jfearn at redhat.com Sun Aug 23 22:40:14 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 24 Aug 2015 08:40:14 +1000 Subject: [publican-list] Trouble with brand creation In-Reply-To: <55D92D3B.1060705@murrell.ca> References: <55D80348.7070407@murrell.ca> <55D92D3B.1060705@murrell.ca> Message-ID: <55DA4BCE.20509@redhat.com> On 08/23/2015 12:17 PM, Alan Murrell wrote: > This is resolved. I am not sure what I was doing wrong, but I followed > the steps from the Publican documentation for creating a brand and now > it works as expected. > > On a side note, any reason why the default CSS file that exists when a > brand is created doe snot use the CSS file for the "common" brand? It > seems to use the Red Hat one (so all headings, etc. created in HTML > files are red instead of the blue that is used in the PDFs) Which version of Publican? Which pdf tool (FOP or wkhtmltopdf)? iirc there was a bug about this where the common css had the wrong color. Cheers, Jeff. From lists at murrell.ca Mon Aug 24 01:15:59 2015 From: lists at murrell.ca (Alan Murrell) Date: Sun, 23 Aug 2015 18:15:59 -0700 Subject: [publican-list] Trouble with brand creation In-Reply-To: <55DA4BCE.20509@redhat.com> References: <55D80348.7070407@murrell.ca> <55D92D3B.1060705@murrell.ca> <55DA4BCE.20509@redhat.com> Message-ID: <55DA704F.10204@murrell.ca> On 23/08/15 03:40 PM, Jeff Fearn wrote: > Which version of Publican? Which pdf tool (FOP or wkhtmltopdf)? I have it running on a CentOS 7 host and using the RPMs from the YUM repositories. Publican is version 3.2 and it is using FOP. > > iirc there was a bug about this where the common css had the wrong color. The CSS files in the actual "common" brand have the correct colours. It just seems when a new brand is created, it uses the Red Hat colours for some reason. If it is a bug in Publican 3.2 but has been fixed in subsequent versions, not a big deal. When I create a brand in future, if I am content using the "default" colours for it, I can change the "overrides" file in CSS. I just wanted to make sure this wasn't something you may not have been aware of. Regards, Alan From jfearn at redhat.com Mon Aug 24 23:14:56 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Tue, 25 Aug 2015 09:14:56 +1000 Subject: [publican-list] Trouble with brand creation In-Reply-To: <55DA704F.10204@murrell.ca> References: <55D80348.7070407@murrell.ca> <55D92D3B.1060705@murrell.ca> <55DA4BCE.20509@redhat.com> <55DA704F.10204@murrell.ca> Message-ID: <55DBA570.80509@redhat.com> On 08/24/2015 11:15 AM, Alan Murrell wrote: > > > On 23/08/15 03:40 PM, Jeff Fearn wrote: >> Which version of Publican? Which pdf tool (FOP or wkhtmltopdf)? > > I have it running on a CentOS 7 host and using the RPMs from the YUM > repositories. > > Publican is version 3.2 and it is using FOP. > >> >> iirc there was a bug about this where the common css had the wrong color. > > The CSS files in the actual "common" brand have the correct colours. It > just seems when a new brand is created, it uses the Red Hat colours for > some reason. > > If it is a bug in Publican 3.2 but has been fixed in subsequent > versions, not a big deal. When I create a brand in future, if I am > content using the "default" colours for it, I can change the "overrides" > file in CSS. > > I just wanted to make sure this wasn't something you may not have been > aware of. Ohhh actually this is different and I wasn't aware of it. The overrides.css is hard coded in CreateBrand.pm and it does indeed set the H colors to #a70000 ... maybe that was so people can notice it's not the common brand ... I'm sure there was a good a reason :} Cheers, Jeff. From hertzog at debian.org Sat Aug 29 10:28:46 2015 From: hertzog at debian.org (Raphael Hertzog) Date: Sat, 29 Aug 2015 12:28:46 +0200 Subject: [publican-list] publican update_pot dropping comments below entries Message-ID: <20150829102846.GA17655@home.ouaza.com> Hello, It's been a while that on my system when I do "publican update_pot" it will no longer generate the usual comments before msgid. I mean the lines that look like this: #. Tag: para #, no-c-format I noticed that other users do not have this problem and I would like to know if someone else already had this problem. And if you have an idea of what could cause this... I'm using it on Debian unstable with the following dependencies: ii docbook-xml 4.5-7.3 ii docbook-xsl 1.78.1+dfsg-1 ii docbook-xsl-ns 1.78.1+dfsg-1 ii docbook5-xml 5.0-2 ii fonts-font-awesome 4.3.0~dfsg-2 ii fop 1:1.1.dfsg2-2 ii gettext 0.19.5.1-1 ii libarchive-zip-perl 1.49-1 ii libconfig-simple-perl 4.59-6 ii libdatetime-format-dateparse-perl 0.05-2 ii libdatetime-perl 2:1.20-1 ii libdbd-sqlite3-perl 1.46-1 ii libdbi-perl 1.633-1 ii libfile-copy-recursive-perl 0.38-1 ii libfile-find-rule-perl 0.33-1 ii libfile-homedir-perl 1.00-1 ii libfile-inplace-perl 0.20-1 ii libfile-pushd-perl 1.009-1 ii libfile-slurp-perl 9999.19-4 ii libfile-which-perl 1.18-1 ii libhtml-format-perl 2.11-2 ii libhtml-formattext-withlinks-andtables-perl 0.02-1 ii libhtml-formattext-withlinks-perl 0.15-1 ii libhtml-template-perl 2.95-2 ii libhtml-tree-perl 5.03-2 ii libhtml-wikiconverter-markdown-perl 0.06-1 ii libhtml-wikiconverter-perl 0.68-3 ii libimage-magick-perl 8:6.8.9.9-5.1 ii libimage-size-perl 3.300-1 ii libio-string-perl 1.08-3 ii liblingua-en-fathom-perl 1.15-1 ii liblist-moreutils-perl 0.413-1 ii liblocale-maketext-gettext-perl 1.28-2 ii liblocale-maketext-lexicon-perl 1.00-1 ii liblocale-msgfmt-perl 0.15-1 ii liblocale-po-perl 0.27-1 ii librsvg2-bin 2.40.10-1 ii libsort-versions-perl 1.61-1 ii libstring-similarity-perl 1.04-1+b2 ii libsyntax-highlight-engine-kate-perl 0.09+dfsg-1 ii libtemplate-perl 2.24-1.2+b1 ii libtext-csv-xs-perl 1.19-1 ii libxml-libxml-perl 2.0116+dfsg-4 ii libxml-libxslt-perl 1.94-1 ii libxml-simple-perl 2.20-1 ii libxml-treebuilder-perl 5.4-2 ii perl 5.20.2-6 ii perl-modules [libversion-perl] 5.20.2-6 Cheers, -- Rapha?l Hertzog ? Debian Developer Support Debian LTS: http://www.freexian.com/services/debian-lts.html Learn to master Debian: http://debian-handbook.info/get/ From jfearn at redhat.com Sun Aug 30 23:12:13 2015 From: jfearn at redhat.com (Jeff Fearn) Date: Mon, 31 Aug 2015 09:12:13 +1000 Subject: [publican-list] publican update_pot dropping comments below entries In-Reply-To: <20150829102846.GA17655@home.ouaza.com> References: <20150829102846.GA17655@home.ouaza.com> Message-ID: <55E38DCD.4060401@redhat.com> On 08/29/2015 08:28 PM, Raphael Hertzog wrote: > Hello, > > It's been a while that on my system when I do "publican update_pot" it > will no longer generate the usual comments before msgid. I mean the lines that > look like this: > > #. Tag: para > #, no-c-format > > I noticed that other users do not have this problem and I would like > to know if someone else already had this problem. And if you have an idea > of what could cause this... This looks like it was lost when we moved to Locale::PO in 4.2.0, they aren't in POT files. Probably need to add calls to automatic, &/or comment, or &/or c_format. Cheers, Jeff.