From: David A. <da...@bo...> - 2002-12-30 21:09:30
|
Hi, I'm writing a document with ReST, and I need to insert the titles of several books. Technically, book titles are supposed to be underlined. What's the appropriate ReST representation? TIA, -- David Abrahams da...@bo... * http://www.boost-consulting.com Boost support, enhancements, training, and commercial distribution |
From: David A. <Da...@Ac...> - 2002-12-30 21:53:42
|
David Abrahams wrote: > Hi, > > I'm writing a document with ReST, and I need to insert the titles of > several books. Technically, book titles are supposed to be > underlined. What's the appropriate ReST representation? Technically, underlines are instructions from the author of a manuscript to the typesetter to use emphasis. No "real" publisher ever uses underlines except for advertising/marketing copy purposes. Pedantically yours, --david |
From: David G. <go...@py...> - 2002-12-30 22:27:19
|
David Ascher wrote: > Pedantically yours, Pedantic perhaps, but at least consistent: <http://docutils.sf.net/spec/rst/problems.html#underlining> -- David Goodger go...@py... |
From: David G. <go...@py...> - 2002-12-30 21:55:02
|
David Abrahams wrote: > I'm writing a document with ReST, and I need to insert the titles of > several books. Technically, book titles are supposed to be > underlined. According to whom? *The Chicago Manual of Style*, which I use as my typographical bible, says: Titles and subtitles of published books, ... are set in italics when they are mentioned in the text or notes. (14th edition, section 7.133) I looked up every reference to underlines, and they are exclusively used to indicate italics to the typesetter (early typewriters typically didn't have italic functionality ;). If you want to indicate "book title" separately from "emphasis", which is perfectly valid, that's a different question. Has to do with interpreted text. There's already a related to-do list entry: Perhaps the default implicit role for interpreted text could be "title", as in, "title of a book". It'd be a text-only reference, no hyperlink. Idea from Aahz' 2002-05-09 Doc-SIG post. > What's the appropriate ReST representation? Ain't none, sorry. For a rationale, see <http://docutils.sf.net/spec/rst/problems.html#underlining>. -- David Goodger <go...@py...> Open-source projects: - Python Docutils: http://docutils.sourceforge.net/ (includes reStructuredText: http://docutils.sf.net/rst.html) - The Go Tools Project: http://gotools.sourceforge.net/ |
From: David A. <Da...@Ac...> - 2002-12-30 21:59:55
|
David Goodger wrote: > David Abrahams wrote: > >>I'm writing a document with ReST, and I need to insert the titles of >>several books. Technically, book titles are supposed to be >>underlined. > > > According to whom? *The Chicago Manual of Style*, which I use as my > typographical bible, says: > > Titles and subtitles of published books, ... are set in italics > when they are mentioned in the text or notes. > > (14th edition, section 7.133) This matches the information I got from typesetting books (back in a previous life when I used to deal such things =). --david |
From: Aahz <aa...@py...> - 2002-12-30 22:21:26
|
PS: it's difficult to keep track of a thread where everyone is named David... ;-) -- Aahz (aa...@py...) <*> http://www.pythoncraft.com/ "There are three kinds of lies: Lies, Damn Lies, and Statistics." --Disraeli |
From: David A. <da...@bo...> - 2002-12-31 00:08:31
|
David Goodger <go...@py...> writes: > David Abrahams wrote: >> I'm writing a document with ReST, and I need to insert the titles of >> several books. Technically, book titles are supposed to be >> underlined. > > According to whom? Some outdated reference I found on the web <wink>. > *The Chicago Manual of Style*, which I use as my typographical > bible, says: > > Titles and subtitles of published books, ... are set in italics > when they are mentioned in the text or notes. > > (14th edition, section 7.133) You're right. I found a more up-to-date reference after I posted. Sorry for the line noise. > If you want to indicate "book title" separately from "emphasis", > which is perfectly valid, that's a different question. Has to do > with interpreted text. There's already a related to-do list entry: > > Perhaps the default implicit role for interpreted text could be > "title", as in, "title of a book". It'd be a text-only reference, > no hyperlink. Idea from Aahz' 2002-05-09 Doc-SIG post. Eventually, there will be equivalents of every possible XML tag, won't there <0.5 wink>? -- David Abrahams da...@bo... * http://www.boost-consulting.com Boost support, enhancements, training, and commercial distribution |
From: Aahz <aa...@py...> - 2002-12-30 22:20:42
|
On Mon, Dec 30, 2002, David Abrahams wrote: > > I'm writing a document with ReST, and I need to insert the titles of > several books. Technically, book titles are supposed to be > underlined. What's the appropriate ReST representation? I've been using ``*``, which on my system is emitted as italics. -- Aahz (aa...@py...) <*> http://www.pythoncraft.com/ "There are three kinds of lies: Lies, Damn Lies, and Statistics." --Disraeli |