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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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


Subject: DOCBOOK: Re: Highlights vs. Abstract


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ Joachim Ziegler <ziegler@mpi-sb.mpg.de> was heard to say:
| I'm just wondering what the difference is and when I should use which
| tag. Can somebody explain to me or give a good example?

Sigh. Highlights exists because in the DocBook V1 days one of the most
important use cases was the X11 reference set. Those books had a
"highlights" section at the beginning of each chapter that discussed
what was going to be in the chapter. This was independent of a one or
two paragraph abstract.

Chances are, if you are going to start your chapter with a "here's
what we'll cover in this chapter", it belongs in the highlights.
Abstracts are not always presented, they're metadata. Highlights
aren't metadata, they're part of the chapter.

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | The human race consists of the
http://www.oasis-open.org/docbook/ | dangerously insane and such as are
Chair, DocBook Technical Committee | not.--Mark Twain
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE+OnFIOyltUcwYWjsRAtGUAJ0W5Ow/opKroOa3WDBp+AIMXsqBEwCeORvs
22Zhou75Lm+mxyQNU2LvmpE=
=bDIa
-----END PGP SIGNATURE-----


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


Powered by eList eXpress LLC