A couple of DocBook style questions

Matthew East mdke at ubuntu.com
Mon Feb 13 15:02:32 UTC 2006


On Mon, 2006-02-13 at 14:55 +0000, Dean Sas wrote:
> Matthew East wrote:
> > On Mon, 2006-02-13 at 14:30 +0000, Dean Sas wrote:
> > 
> >>Matthew East wrote:
> >>
> >><snip>
> >>
> >>>I'd also suggest that we use the <filename> tags around names of
> >>>repositories, because that makes them stand out a bit, in monospace,
> >>>which is nice I think.

> >>I know nothing about docbook, so my opinion is certainly not fierce, but 
> >>shouldn't we use different tags for this?  A repositories tag or 
> >>something more general? Though I'm not sure how trivial or acceptable it 
> >>is to extend doc book in this way. 

> > I don't know of such a tag. the "filename" tag gives monospace text,
> > which I think is a reasonable option, but I suppose we could use the
> > "emphasis" tag instead.

> I didn't know whether or not docbook allowed defining custom tags, 
> though thinking about it that'd probably break yelp and other tools

No we can't, afaik (although I'm not very good at docbook), but we could
use <emphasis>. This results in italics.

So, shall we go for italics (<emphasis>) or monospace (<filename>)? I
don't mind either way, Dean is certainly right to say that the former is
less weird, because a repository isn't a file.

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060213/b50b8f5b/attachment.pgp>


More information about the ubuntu-doc mailing list