[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