[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#91892: Small problem with Layout of pdf documentation



I noticed funnu thing.


In PDF with <toc sect1>, any section with <sect2> is just bold without
indexing.

But in HTML, it put indexing.  10.5.13.1 etc.  I do not care which way
but it will be niceif all work like PDF as much as pssible.

On Tue, Aug 13, 2002 at 08:54:15PM -0500, Ardo van Rangelrooij wrote:
> Osamu Aoki (debian@aokiconsulting.com) wrote:
> > Ardo,
> > 
> > I do not see the exact problem on current installmanual in section 5.4
> > but see similar problem in appendix.  (I remember seeing it a lot with
> > the old woody TEX before freeze.)
> > 
> > With the released woody version of TEX, run over of right margin by URL
> > is rare (mostly <example> section.  I am limiting 72char/line for that
> > to avoid this.)
> 
> Good!  That probably should also be mentioned in the documentation.

Thanks.

> > Problem in appendix is happening with TAGLIST's TAG. Somewhat similar
> > to Bug 61038.
> > 
> > Something like:
> > 
> > <taglist>
> >  <tag>Title of section
> >   <taglist>
> >    <tag><ref id="&long-url1;" name="long-name1">
> >    <tag><ref id="&long-url2;" name="long-name2">
> >    <tag><ref id="&long-url3;" name="long-name3">
> >    <item>Explanation
> >   </taglist>
> > ...
> > </taglist>
> > 
> > For me, this can be easily fixed by avoiding this aggressive use of tag
> > list. I wonder following does better?
> > 
> > <sec?>Title of section
> > <list compact>
> >  <item><ref id="&long-url1;" name="long-name1">
> >  <item><ref id="&long-url2;" name="long-name2">
> >  <item><ref id="&long-url3;" name="long-name3">
> > </list>
> > <p>Explanation
> > </sec?>
> > ...
> > 
> > We may add <strong>...</> to emulate bold.
> 
> That's what's going in the documentation.

I think it was fixed after this posting. :)

> > Can you confirm exact location of problem?  There may be a way to fix
> > this without hacking with debiandoc-sgml which seem to work fine for me.
> > My "Debian Reference" has quite a bit of long URL.
> 
> Oh, this is already a very old problem.  It occurred in the installation
> manual with the complete location of all the various floppy disks.  AFAIK
> the manual has been changed.
> 
> > TAG to me sounds like some short header thus may not need folding line
> > capability.
> 
> That's exactly what I want to mention in the documentation.

Also compact tag is same line as item but just with bold.  That was 
the major problem in install guide.  Chris fixed it by changingg
them to 
<list compact>
  <item><strong>OLDTAG</strong>
    <list compact>
     <item>ITEM for OLD TAG with URL
or something similar.  This folds lines well.

-- 
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
 Osamu Aoki @ Cupertino CA USA
 See "User's Guide":     http://www.debian.org/doc/manuals/users-guide/
 See "Debian reference": http://www.debian.org/doc/manuals/debian-reference/
 "Debian reference" Project at: http://qref.sf.net

 I welcome your constructive criticisms and corrections.



Reply to: