On 2013.07.15. 6:58, Hiroki Sato wrote:
ga> The semantics of a title could be defined like a plain text title and
ga> that would be a valid semantics, too. True, it is also possible to
ga> solve it when rendering but if we decide that we don't want such in
ga> titles, why not just changing the semantics and sparing some
ga> stylesheet code? Both the docs and the stylesheets would be more
ga> simple.
I like to solve this upon rendering and I think it will be simpler
because a policy of plain text title (in markup) practically does not
work without DTD change, and elements such as <replaceable> can be
included in title elements via entity references or so in any way.
Forcing a consistent style for title elements looks easy to me.
I thought of adding some Schematron constraints for the problematic
cases but I'll go for the rendering customization if this is better
accepted. I agree that this may work better for entity references.
ga> > The previous toolchain rendered that title in bold:
ga>
>http://docs.freebsd.org/doc/9.0-RELEASE/usr/share/doc/freebsd/en_US.ISO8859-1/books/handbook/bsdinstall-pre.html
ga> > Agreed, that title does not look very good. Adding a colon to list
ga> > titles when rendering would help. Removing all list titles be too
ga> > severe.
ga> Having a colon at the end of the paragraph and another one at the end
ga> of the list title? It seems even more confusing to me.
ga> Why is to severe removing them? Do they add any extra information that
ga> helps you understanding the content? I think it makes the
ga> comprehension more difficult and is just counter-productive.
ga>
ga> Can you find a published book with such list titles?
I think removing title is fine. Although there are some exmaples for
such an informal title like this:
Pros:
- A
- B
Cons:
- C
- D
they are items, not "title" actually. If we really need it, it
should be a caption.
I believe these are already rendered as normal paragraphs between two
itemizedlists but I'll verify this.
Gabor
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
