NOTE: If you are a developer, please use a private wiki based on foswiki/trunk on a daily base ...or use
trunk.foswiki.org to view this page for some minimal testing.
Use
Item11383 for general documentation changes for release 1.1.5. Use
Item9693 for docu changes for release 2.0.
Item2515: Add support for underline and line-through text decorations
See
Development/SupportLineThroughFormatTag
To add official support for underline and line-through formatting in topics, there are four parts:
- TinyMCEPlugin.
- It generates
<span style="text-decoration: ....">foo</span> markup for underlined text.
- It can apply <del> tags to selected text where line-through formatting is desired.
- Need to add underline and line-through formatting buttons to the toolbar.
- WyswiygPlugin? .
- HTML2TML? : It must convert TinyMCE? 's output to and from the nominated TML markup
- Consensus is to go with HTML 3.2 style
<u> and <del> tags in the topic text.
- The <del> tags emitted by HTML2TML? should preserve the incoming class attribute in the output for the benefit of
Foswiki::Merge
- Reasons for
<del> instead of <s> or <strike>:
-
<s> is undefined and <strike> is deprecated in XHTML1.0-strict, whereas <del> can pass through Foswiki::Render unchanged.
-
<del> adds semantic meaning to the text it is marking up.
This assumes you never want line-through formatting just for its visual appearance (ie. without implying that the text is somehow not current).
- TML2HTML? :
- It must convert
<u> tags to <span style="text-decoration: ....">foo</span> markup for TinyMCE? .
- It must also preserve a class attribute on the
<del> tag for the benefit of Foswiki::Merge.
-
Foswiki::Render. It has to convert our nominated TML markup into valid XHTML (strict ?) markup.
- <u> tags should be converted into XHTML1.0-strict valid styled spans:
-
<span style="text-decoration: underline">foo</span>
-
NB: <u> is undefined in XHTML1.0-strict, but we can use it in our topics as long as Foswiki::Render converts it.
-
<del> tags can be left alone.
-
Foswiki::Merge . It should add the class foswikiMerge to any <ins> and <del> tags that it inserts into a topic, so that they can be distinguished from user applied <del> markup, for the benefit of any conflict resolution utility that might exist in the future.
--
PaulHarvey - 21 Dec 2009
Although I've added myself in the
WaitingFor field, other should feel free to work on this.
--
PaulHarvey - 16 Jan 2010
Topic revision: r3 - 21 Dec 2011 - 00:32:43 -
JayenAshar