XWiki

Denis Gervalle Thu, 22 Apr 2010 08:54:00 -0700

On Thu, Apr 22, 2010 at 09:04, Vincent Massol <[email protected]> wrote:


> I'm not sure I agree with this patch (even though it might be right from a
> semantic POV), at least not before we discuss it and decide voluntarily that
> we want to change our existing terminology.



We call them headers and not headings at the moment. This is true both in
> the language we use and in the technical code (HeaderBlock, etc).
>
> So if we want to change that, we'll need to :
> - modify the documentation (xwiki.org and javadoc)
> - modify the class names in the code (HeadingBlock, HeadingLevel, etc)
>

This would be nice, but there are potential compatibility issues.
I do not see the straight links between that and an end-user page like
XWikiSyntax.


>
> Since it's a big change I'm not sure we want it.
>
> Also note that this has nothing to do with HTML so even though HTML might
> call them headings it doesn't matter for us (our syntax is independant or
> the renderer syntax).
>

Dictionary says that header are "a line or block of text appearing at the
top of each page of a book or document" while heading is "a title at the
head of a page or section of a book".
This is not a POV and not in relation with HTML, English peoples just call
them headings.

Denis


>
> WDYT?
>
> Thanks
> -Vincent
>
> On Apr 22, 2010, at 12:56 AM, sdumitriu (SVN) wrote:
>
> > Author: sdumitriu
> > Date: 2010-04-22 00:56:11 +0200 (Thu, 22 Apr 2010)
> > New Revision: 28505
> >
> > Modified:
> >   enterprise/trunk/wiki/src/main/resources/XWiki/XWikiSyntax.xml
> > Log:
> > XE-647: Misuse of the "header" term instead of "heading" when referring
> to the html h1-6
> > Fixed.
> > Patch from Dan Bozaru applied without changes.
> >
> > Modified: enterprise/trunk/wiki/src/main/resources/XWiki/XWikiSyntax.xml
> > ===================================================================
> > --- enterprise/trunk/wiki/src/main/resources/XWiki/XWikiSyntax.xml
>  2010-04-21 22:55:34 UTC (rev 28504)
> > +++ enterprise/trunk/wiki/src/main/resources/XWiki/XWikiSyntax.xml
>  2010-04-21 22:56:11 UTC (rev 28505)
> > @@ -85,7 +85,7 @@
> > |Two standalone elements not separated by 2 new lines|{{{| table
> cell}}}\\{{{* list item}}}|{{{| table cell}}}\\\\{{{* list item}}}
> > |Two standalone elements not separated by 2 new
> lines|{{{paragraph}}}\\{{{----}}}\\{{{paragraph}}}|{{{paragraph}}}\\\\{{{----}}}\\\\{{{paragraph}}}
> > |Ignored new line at beginning of document|&lt;new line at beginning of
> document&gt;\\paragraph|paragraph
> > -|Not closed header syntax|{{{=== header}}}|{{{=== header ===}}}
> > +|Not closed heading syntax|{{{=== heading}}}|{{{=== heading ===}}}
> >
> > = Paragraphs =
> >
> > @@ -102,11 +102,11 @@
> > |Two paragraphs|Paragraph one\\\\Paragraph two|Paragraph one\\\\Paragraph
> two|Paragraph one\\\\Paragraph two|Paragraph one\\\\Paragraph two
> > |Parametrized paragraph|&lt;p
> style="text-align:center;color:blue"&gt;Centered and blue
> paragraph&lt;/p&gt;|{{{(% style="text-align:center;color:blue"
> %)}}}\\Centered and blue paragraph|(% style="text-align:center;color:blue"
> %)\\Centered and blue paragraph|(% style="text-align:center;color:blue"
> %)\\Centered and blue paragraph
> >
> > -= Headers =
> > += Headings =
> >
> > (% style="width:100%" %)
> > |=Feature|=XWiki Syntax 1.0|=XWiki Syntax 2.0|=Result
> > -|Standard headers|(((
> > +|Standard headings|(((
> > 1 level 1
> > 1.1 level 2
> > 1.1.1 level 3
> > @@ -125,11 +125,11 @@
> > &lt;!-- Note: replace this with wiki syntax when
> http://jira.xwiki.org/jira/browse/XWIKI-4358 is implemented --&gt;
> > &lt;h1 id="Hlevel1"&gt;&lt;span&gt;level
> 1&lt;/span&gt;&lt;/h1&gt;&lt;p&gt;&amp;nbsp;&lt;/p&gt;&lt;h2
> id="Hlevel2"&gt;&lt;span&gt;level 2&lt;/span&gt;&lt;/h2&gt;&lt;h3
> id="Hlevel3"&gt;&lt;span&gt;level 3&lt;/span&gt;&lt;/h3&gt;&lt;h4
> id="Hlevel4"&gt;&lt;span&gt;level 4&lt;/span&gt;&lt;/h4&gt;&lt;h5
> id="Hlevel5"&gt;&lt;span&gt;level 5&lt;/span&gt;&lt;/h5&gt;&lt;h6
> id="Hlevel6"&gt;&lt;span&gt;level 6&lt;/span&gt;&lt;/h6&gt;
> > {{/html}})))
> > -|Parametrized headers|&lt;h1&gt;&lt;span
> style="color:blue"&gt;header&lt;/span&gt;&lt;/h1&gt;|{{{(%
> style="color:blue" %)}}}\\= header =|(((
> > +|Parametrized headings|&lt;h1&gt;&lt;span
> style="color:blue"&gt;heading&lt;/span&gt;&lt;/h1&gt;|{{{(%
> style="color:blue" %)}}}\\= heading =|(((
> > {{html}}
> > -&lt;h1 id="Hheader"
> style="color:blue"&gt;&lt;span&gt;header&lt;/span&gt;&lt;/h1&gt;
> > +&lt;h1 id="Hheading"
> style="color:blue"&gt;&lt;span&gt;heading&lt;/span&gt;&lt;/h1&gt;
> > {{/html}})))
> > -|Headers with wiki syntax|1.1.1 Header with *bold*|{{{=== Header with
> **bold** ===}}}|(((=== Header with **bold** ===)))
> > +|Headings with wiki syntax|1.1.1 Heading with *bold*|{{{=== Heading with
> **bold** ===}}}|(((=== Heading with **bold** ===)))
> >
> > = Text Formatting =
> >
> > @@ -829,12 +829,12 @@
> > (% style="width:100%" %)
> > |=XWiki Syntax 1.0|=XWiki Syntax 2.0|=Generated XHTML
> > |((({{{
> > -&lt;h1 class="myClass" style="myStyle" id="myId"&gt;header&lt;/h1&gt;
> > +&lt;h1 class="myClass" style="myStyle" id="myId"&gt;heading&lt;/h1&gt;
> > }}})))|((({{{
> > (% class="myClass" style="myStyle" id="myId" %)
> > -= header =
> > += heading =
> > }}})))|((({{{
> > -&lt;h1 class="myClass" style="myStyle" id="myId"&gt;header&lt;/h1&gt;
> > +&lt;h1 class="myClass" style="myStyle" id="myId"&gt;heading&lt;/h1&gt;
> > }}})))
> >
> > {{id name="syntaxes"/}}
> > @@ -848,4 +848,4 @@
> > * [[Creole 1.0&gt;&gt;http://www.wikicreole.org/wiki/Creole1.0]]
> > * [[XHTML 1.0&gt;&gt;http://www.w3.org/TR/xhtml1/]]
> >
> > -{{warning}}The implementation for these syntaxes is not fully finished
> yet. For example support for links is not working perfectly yet. We also
> need to define if we want to extend the original syntaxes to support
> XWiki-specific features like ability to link to another
> sub-wiki.{{/warning}}</content></xwikidoc>
> > \ No newline at end of file
> > +{{warning}}The implementation for these syntaxes is not fully finished
> yet. For example support for links is not working perfectly yet. We also
> need to define if we want to extend the original syntaxes to support
> XWiki-specific features like ability to link to another
> sub-wiki.{{/warning}}</content></xwikidoc>
>
> _______________________________________________
> devs mailing list
> [email protected]
> http://lists.xwiki.org/mailman/listinfo/devs
>



-- 
Denis Gervalle
SOFTEC sa - CEO
eGuilde sarl - CTO
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Re: [xwiki-devs] [xwiki-notifications] r28505 - enterprise/trunk/wiki/src/main/resources/XWiki

Reply via email to