OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] epub/chunking : why h1 tags for sections insteadof H2? (solved)


Interesting.

Let me say that when you chunk by chapter, the chapter should be h1,
but the section or sect1 should be h2.

In your ch1.html output example  both the chapter and sect1 titles are h1.

Even if you talk about SEO, then ch1.html contains multiple H1s (and
google doesn't like that).  Also, using h1 and h2 is the only way to
differentiate chapter and section in an epub destined for Kindle.







On Tue, Mar 15, 2011 at 12:44 PM, Keith Fahlgren <abdelazer@gmail.com> wrote:
> On Tue, Mar 15, 2011 at 10:13 AM, Robert Nagle
> <idiotprogrammer@gmail.com> wrote:
>> Perhaps. But I cannot imagine a case when you are using the epub
>> stylesheets, you want to produce an epub file  and  you would NOT want
>> chapters/sections/subsections to have descending h tags.
>
> I believe that the stylesheets already do this:
>
>
> <book>
>  <title>Heading Nesting</title>
>  <chapter id="top">
>    <title>ChTitle</title>
>    <sect1 id="s1">
>      <title>S1Title</title>
>      <para>Foo</para>
>      <sect2 id="s2">
>        <title>S2Title</title>
>        <para>Bar</para>
>        <sect3 id="s3">
>          <title>S3Title</title>
>          <para>Bax</para>
>        </sect3>
>      </sect2>
>    </sect1>
>  </chapter>
> </book>
>
>
> That will make the expected EPUB files:
>
>
> OEBPS/index.html
> <?xml version="1.0" encoding="UTF-8" standalone="no"?>
> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
> "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd";>
> <html xmlns="http://www.w3.org/1999/xhtml";>
>  <head>
>    <title>Heading Nesting</title>
>    <meta name="generator" content="DocBook XSL Stylesheets V1.77.0-pre"/>
>  </head>
>  <body>
>    <div class="book" title="Heading Nesting">
>      <div class="titlepage">
>        <div>
>          <div>
>            <h1 class="title"><a id="id36091833"/>Heading Nesting</h1>
>          </div>
>        </div>
>        <hr/>
>      </div>
>    </div>
>  </body>
> </html>
>
>
> OEBPS/ch01.html
> <?xml version="1.0" encoding="UTF-8" standalone="no"?>
> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
> "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd";>
> <html xmlns="http://www.w3.org/1999/xhtml";>
>  <head>
>    <title>Chapter 1. ChTitle</title>
>    <meta name="generator" content="DocBook XSL Stylesheets V1.77.0-pre"/>
>  </head>
>  <body>
>    <div class="chapter" title="Chapter 1. ChTitle">
>      <div class="titlepage">
>        <div>
>          <div>
>            <h1 class="title"><a id="top"/>Chapter 1. ChTitle</h1>
>          </div>
>        </div>
>      </div>
>      <div class="sect1" title="S1Title">
>        <div class="titlepage">
>          <div>
>            <div>
>              <h1 class="title"><a id="s1"/>S1Title</h1>
>            </div>
>          </div>
>        </div>
>        <p>Foo</p>
>        <div class="sect2" title="S2Title">
>          <div class="titlepage">
>            <div>
>              <div>
>                <h2 class="title"><a id="s2"/>S2Title</h2>
>              </div>
>            </div>
>          </div>
>          <p>Bar</p>
>          <div class="sect3" title="S3Title">
>            <div class="titlepage">
>              <div>
>                <div>
>                  <h3 class="title"><a id="s3"/>S3Title</h3>
>                </div>
>              </div>
>            </div>
>            <p>Bax</p>
>          </div>
>        </div>
>      </div>
>    </div>
>  </body>
> </html>
>



-- 
Robert Nagle
12777 Ashford Point Dr #1417
Houston, Texas 77082
713 893 3424
http://www.robertnagle.info


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]