[daisy] Re: Chapter numbering in Book Rendering fails, if no Heading1 precedes other Headings

Karel Vervaeke karel at outerthought.org
Mon Jul 7 15:42:45 CEST 2008



On Mon, 2008-07-07 at 10:12 +0200, Kevin_Walsh at deichmann.com wrote:
> 
> Good Moring, list! 
> 
> The proplem with adding a HEADING1 to the top of every document is
> that the title of the page will be used as a heading as well. My
> HEADING1will logically then be a HEADING2 in the pdf, etc... 
> As far as I can see (looking through daisy knowledgebase and wiki) -
> nobody is doing that. 
> 
> eg: Document structure in daisy: 
> 
> Book Name 
> Document01-title
> Heading 1
>    text text text text text 
>  - Heading 2 
>         text text text text text text 
>   - Heading 2 
>         text text text text text text 
>     - Heading 3 
>            text text text text text text 
>            text text text text text text 
> Document02-title 
>     text text text text text 
>  - Heading 2 
>         text text text text text text 
> Heading 1 
>    text text text text text 
>  - Heading 2 
>         text text text text text text 
> 
> 
> Will render as: 
> 
> Book Name 
> 1 Document01-title 
> 1.1  Heading 1 
>      text text text text text 
>   1.1.1 Heading 2 
>         text text text text text text 
>    1.1.2 Heading 2 
>         text text text text text text 
>    1.1.2.1 Heading 3 
>            text text text text text text 
>            text text text text text text 
> 2 Document02-title 
>     text text text text text 
>    Heading 2 
>         text text text text text text 
> 2.1 Heading 1 
>     text text text text text 
>  2.1.1 Heading 2 
>         text text text text text text 
> 
> Up to now we have used the document title as the chapter heading (ie.
> HEADING1 in numbering) and import the documents into navigation trees
> with the document title as the navigation tree entry. I may have the
> 'wrong' approch and will gladly change, if someone can point me the
> right direction. I checked this problem with the other documents and
> it is the same (nobody complained up to now, but this time the
> document needs to follow legal rules). 
> 
> Especially daisy dropping ANY Heading before a HEADING1 is found, is -
> IMHO - not acceptable behaviour, but needs changing! (In the above
> example it is the first HEADING2 in Document02). 

Nothing is really dropped: it is all there if I'm not mistaken.  The
only 'dropping' that is happening is that when headings are not used
consistently (e.g. a h2 without a h1):
* the numbers are not generated (as described earlier: it is not
possible to do this because it is just not well defined), 
* and they are not included in the table of contents).
> 
> Being not a crack at the programming part - if I wanted to solve the
> problem in xslt - is this my approach?: 
> 1. I need to generate a book definition. 
> 2. Then tell daisy to NOT use the DocumentTitle as Heading1, but use
> HEADING1 only. 
> How do I do this (step 2)? 
> 
> That would be a workaround for this specific request. 

I think you mean 'create a book publication type' for step 1 (perhaps I
mistyped it myself earlier).  With a book definition alone you won't get
there.

For step two: you should start with copying the publication type you
want to start from (I assume it's PDF) from the built-in publicationtype
directory to the book publicationtype directory in your wikidata
directory.  Find the relevant templates in the xslt files and change
them to fix your problem.

I can't say it's entirely clear to me how you plan to translate the
inconsistent headings structures to consistent ones but I hope you
achieve your goals.
> 
> Thanks, 
> Kevin 

> daisy-request at lists.cocoondev.org 
> Gesendet von:
> daisy-bounces at lists.cocoondev.org 
> 
> 04.07.2008 12:00 
>         Bitte antworten an
>      daisy at lists.cocoondev.org
> 
> 
> 
> 
>                An
> daisy at lists.cocoondev.org 
>             Kopie
> 
>             Thema
> daisy Digest, Vol
> 46, Issue 6
> <Watchdog
> Deichmann: Virus
> checked>
> 
> 
> 
> 
> 
> 
> 
> 
> Send daisy mailing list submissions to
>                 daisy at lists.cocoondev.org
> 
> To subscribe or unsubscribe via the World Wide Web, visit
>                 http://lists.cocoondev.org/mailman/listinfo/daisy
> or, via email, send a message with subject or body 'help' to
>                 daisy-request at lists.cocoondev.org
> 
> You can reach the person managing the list at
>                 daisy-owner at lists.cocoondev.org
> 
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of daisy digest..."
> 
> 
> Today's Topics:
> 
>   1. Re: Chapter numbering in Book Rendering fails, if no
> Heading1
>      precedes other Headings (Karel Vervaeke)
> 
> 
> ----------------------------------------------------------------------
> 
> Message: 1
> Date: Fri, 04 Jul 2008 10:40:30 +0200
> From: Karel Vervaeke <karel at outerthought.org>
> Subject: Re: [daisy] Chapter numbering in Book Rendering fails, if no
>                 Heading1 precedes other Headings
> To: "Daisy: open source CMS - general mailinglist"
>                 <daisy at lists.cocoondev.org>
> Message-ID: <1215160830.6334.8.camel at banana>
> Content-Type: text/plain; charset=utf-8
> 
> I think it is acceptible behaviour - you probably could solve it in
> xslt, but it seems a lot more logical to just add a H1 to the first
> document.
> 
> Even if you would solve it in xslt, the way the H2 of the first
> document
> should be rendered is not well defined either:
> It could be:
> 
> 0.1
> 1.1
> ?.1
> .1
> x.1
> ...
> 
> in short, for solving it in xslt it should be controlled by a
> publication property, e.g.
> 
> numbering.default.h1.substitutemissing=1
> 
> HTH,
> Karel
> 
> 
> On Thu, 2008-07-03 at 11:52 +0200, Kevin_Walsh at deichmann.com wrote:
> > 
> > Dear list, 
> > 
> > for the first time we have implemented a German government
> > questionaire in daisy. i.e. every department will answer their
> > specific questions. The questionnaire's questions are numbered and
> the
> > document has to be handed in with the same chapter numbering
> > (following scientific numbering, e.g. 1.2.3) 
> > 
> > Both, the generation of HTML, and PDF do not seem to do this,
> though. 
> > 
> > Example: 
> > A book structure from an imported navigation is: 
> > 
> > Book Name 
> > Document01-title 
> >  - Heading 2 
> >         text text text text text text 
> >     - Heading 3 
> >            text text text text text text 
> >            text text text text text text 
> > Document02-title 
> >     text text text text text 
> >  - Heading 2 
> >         text text text text text text 
> > Heading 1 
> >    text text text text text 
> >  - Heading 2 
> >         text text text text text text 
> > 
> > When generated as a daisy book, the numbering will come out as: 
> > 
> > Book Name 
> > 1 - Document01-title 
> >    Heading 2 
> >         text text text text text text 
> >      Heading 3 
> >            text text text text text text 
> >            text text text text text text 
> > 2 - Document02-title 
> >     text text text text text 
> >    Heading 2 
> >         text text text text text text 
> >   2.1 Heading 1 
> >      text text text text text 
> >      2.1.1 Heading 2 
> >           text text text text text text 
> > 
> > Note that the headings in the first document ar not numbered at all
> > and ONLY the headings AFTER Heading 1 in Document02 are numered
> > correctly. 
> > I do see the problem that the first Heading 2 in Document02 would be
> > on the same level as Heading1, but we need some numbering that we
> can
> > use. 
> > Formatting the questions as heading1 will not work in our case,
> since
> > the questions are VERY long, with lots of options. 
> > 
> > Would this be a feature, rather than a bug? 
> > Or should I enter an issue? 
> > Tis is quite important for us, since our management will actually be
> > participating for the first time and I do hope that they will like
> it
> > and further daisy's use (the acceptance of documenting is very low
> > among our developers). 
> > 
> > Thanks in advance! 
> > Kevin 
> > 
> > 
> > 
> > 
> > 
> > 
> > 
> > 
> >  
> >   
> >   
> >   
> >   
> >   
> > Kevin Walsh
> > IS / Benutzerservice 
> > 
> > DEICHMANN Schuhe GmbH &
> > CO. KG
> > Deichmannweg 9
> > 45359 Essen 
> > 
> > Tel: 0201 / 86 76 - 932
> > Fax: 0201 / 86 76 49 -
> > 932 
> > 
> > 
> >   
> >   
> >   
> >  
> > 
> > 
> > 
> > Heinrich Deichmann-Schuhe GmbH & Co. KG, Deichmannweg 9, 45359 Essen
> > 
> > Registergericht Essen HRA 3564, Umsatzsteueridentifikations-Nr.: DE
> > 119663402
> > Persönlich haftende Gesellschafterin ist die Deichmann Verwaltungs-
> > und
> > Handelsgesellschaft mbH mit Sitz in Essen, Registergericht Essen HRB
> > 2279.
> > 
> > Geschäftsführer:
> > Dr. Heinz-Horst Deichmann * Dipl.- Kfm. Heinrich Otto Deichmann
> > (Geschäftsführende Gesellschafter)
> > Martin Fischer * Bjørn Gulden (MBA) * Dipl.-Kfm. Martin Heynen *
> > Walter Neuroth
> > Dipl.-Wirtsch.-Ing. Karsten Schütt * Dipl. Verwaltungswirt (FH)
> > Wolfgang Wislsperger
> > 
> > 
> > _______________________________________________
> > daisy community mailing list
> > Professional Daisy support:
> http://outerthought.org/en/services/daisy/support.html
> > mail to: daisy at lists.cocoondev.org
> > list information: http://lists.cocoondev.org/mailman/listinfo/daisy
> 
> 
> ------------------------------
> 
> _______________________________________________
> daisy community mailing list
> Professional Daisy support:
> http://outerthought.org/en/services/daisy/support.html
> mail to: daisy at lists.cocoondev.org
> list information: http://lists.cocoondev.org/mailman/listinfo/daisy
> 
> 
> End of daisy Digest, Vol 46, Issue 6
> ************************************
> 
> 
> 
> Heinrich Deichmann-Schuhe GmbH & Co. KG, Deichmannweg 9, 45359 Essen
> 
> Registergericht Essen HRA 3564, Umsatzsteueridentifikations-Nr.: DE
> 119663402
> Persönlich haftende Gesellschafterin ist die Deichmann Verwaltungs-
> und
> Handelsgesellschaft mbH mit Sitz in Essen, Registergericht Essen HRB
> 2279.
> 
> Geschäftsführer:
> Dr. Heinz-Horst Deichmann * Dipl.- Kfm. Heinrich Otto Deichmann
> (Geschäftsführende Gesellschafter)
> Martin Fischer * Bjørn Gulden (MBA) * Dipl.-Kfm. Martin Heynen *
> Walter Neuroth
> Dipl.-Wirtsch.-Ing. Karsten Schütt * Dipl. Verwaltungswirt (FH)
> Wolfgang Wislsperger
> 
> 
> _______________________________________________
> daisy community mailing list
> Professional Daisy support: http://outerthought.org/en/services/daisy/support.html
> mail to: daisy at lists.cocoondev.org
> list information: http://lists.cocoondev.org/mailman/listinfo/daisy


More information about the daisy mailing list