final decision (?!?) on <screen> et al (was Re: screenshot instructions)
Paul W. Frields
paul at frields.com
Thu Sep 2 20:45:56 UTC 2004
On Thu, 2004-09-02 at 16:24, Karsten Wade wrote:
> On Thu, 2004-09-02 at 10:35, Dave Pawson wrote:
> > On Wed, 2004-09-01 at 23:29, Karsten Wade wrote:
> >
> > > I also forgot about <screenshot> ... going to have to experiment with
> > > that one. :)
> >
> > And don't forget 'programlisting' and literallayout;
> > both have their uses, but the definitive guide has always been my guide.
> > I have its icon on my desktop and a copy on my hard disk, in case
> > I'm caught without a connection (sad or what)
>
> Ha! I keep a local copy as well, wouldn't hop a plane without it.
>
> An addendum to this conversation, and then I think I'll have to submit a
> patch for the Doc Guide based on this thread.
>
> It is *allowed* to use inline tags inside a <screen/> block, and it's
> usage should not necessarily be discouraged. For general purposes, it's
> enough to put content into <screen/> without further markup. It meets
> minimum correctness and accessibility, and provides a rich experience
> for all the media we can publish to currently.
>
> What I just noticed during all this experimentation is that it is best
> to keep the inline tags, well, inline:
>
> <screen>
> <computeroutput>foo</computeroutput>
> </screen>
>
> That keeps extra whitespace from creeping in. The example in our
> Documentation Guide[1] has newlines that create whitespace. Was that
> done to make the gray box look better? I don't think it's necessary,
> tight boxes look fine. If the box needs expanding, best to solve it in
> the stylesheet.
I think I've posted a bug with a patch to fix the issues. Comments
appreciated as always. See:
<http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=131647>
Karsten, I have a not quite-OT question. Are your cool little footnotes
just a manual habit, or are they automatically generated? They're
super-helpful, and I'm feeling covetous. :-)
--
Paul W. Frields, RHCE
More information about the fedora-docs-list
mailing list