9 Sep
2009
9 Sep
'09
12:28 p.m.
On Sep 9, 2009, at 9:16 AM, Denis Gervalle wrote:
On Sep 8, 2009, at 14:48, Vincent Massol wrote:
There is such a case: if someone uses the same header1 content as the
title it should be displayed. Not doing so would be a bug.
Thanks
-Vincent
Hi everyone,
With Colibri we've started to display the doc title as the document's
rendered title. This is a big change that not only affects Colibri
but
in general the way people write documents.
Here's what I suggest:
1) Display doc titles with <div>
title should be in H1 to comply with WAI.
2) Display document content headers using
<h1>-<h6>
3) Display doc titles with a larger font size than h1 (or h1 with a
smaller font size)
4) Force cursor to be in the title field when editing a new document.
Force cursor in the content field when editing an existing document.
This is to make it easy using the keyboard only to enter doc titles
(since it's currently dead easy, we need something close in easiness)
5) Modify all our existing skins: Toucan, Albatross, Finch and Dodo
so
that they use they display the doc title, similarly to Colibri
6) Have a title compatibility flag in xwiki.cfg. When active, use a
Javascript to do this: if there's no title specified for a page and
if
the first content is a H1 then use it as the page's title.
We need at least 1), 3), 6) to be able to release the Colibri skin
for
2.0 final IMO.
WDYT?
I wonder if "compatibility mode" is really required. This may add
complexity for the end user wihtout real benefit IMO. Is there really
a case where a document has a first = ... = that is not the title of
the document when no title has been explicitly specified ? If there is no such case, why not use a behavior like
these ones:
1) When editing a document, if no title is specified and first node is
a = ... =, use that node as the title and store its value in the title
field.
Option A: Leave the title in = ... = as well and avoid duplication on
display.
Option B: Remove the = ... = from the document.
B1: in WYSIWYG, completely get rid of the title field, title being
edited in the first = ... =, this would be more simple and more
WYSIWYG and avoid 4)
2) For fixing old documents (without messing up new one):
Option A: When displaying/editing a document without title and a
first = ... = is available, do what 1) shoud have already done before
proceeding
Option B: When migrating the database, ensure that all titles
are properly stored as it should have been.
For providing navigation, title is really important to be easily
accessible in the storage, but from the user point of view I feel that
the title of a document is just the first = ... =. I usually forget to
precise a title in my document, I never omit involuntarily to put an
initial = ... =.
Hope this helps,
Denis Gervalle