XWiki 309 : Bold codification is not the same than in wiki editor mode
Hi All ? We will use syntax for bold text is *text* or _text_ for both editor mode ? and how to config to show the toolbar in wiki editor (normal mode) .
In wysiwyg mode, bold text is coded with *text*. in wiki mode, when using the small toolbar, it is coded with _text_. In some cases, switching from wysiwyg to wiki mode, some problems appear, but I can't reproduce them systematically. I suggest to have a same codification between both modes to avoid any problem.
I also have an issue with having different ways of doing the same thing. I think this is really bad for our users. For bold, I'd go for the *text* syntax (because that's the syntax I've seen used in most other wikis I've used) and deprecate the _text_ syntax. However I've not been here for long and I don't know the history around this so I'd rather defer to Ludovic or other old-timers to decide on this. Also, in order not to break any compatibility we need to continue to support the _text_ syntax. So I'd be to have both the xwiki editor and the WYSIWYG editor generate *text* syntax but they should continue to support the _text_ syntax. We'd also need to fix the XWiki syntax sheet to reflect this. Alternatively we should have the wiki editor and the WYSIWYG one transform the _text_ syntax into *text* syntax when the user saves a document. I'm interested in getting other's opinions. Thanks -Vincent
-----Original Message----- From: phunghainam@xwiki.com [mailto:phunghainam@xwiki.com] Sent: mercredi 27 décembre 2006 11:28 To: xwiki-dev@objectweb.org Subject: [xwiki-dev] XWiki 309 : Bold codification is not the same than in wiki editor mode
Hi All ?
We will use syntax for bold text is *text* or _text_ for both editor mode ?
and how to config to show the toolbar in wiki editor (normal mode) .
In wysiwyg mode, bold text is coded with *text*. in wiki mode, when using the small toolbar, it is coded with _text_. In some cases, switching from wysiwyg to wiki mode, some problems appear, but I can't reproduce them systematically. I suggest to have a same codification between both modes to avoid any problem.
___________________________________________________________________________ Yahoo! Mail réinvente le mail ! Découvrez le nouveau Yahoo! Mail et son interface révolutionnaire. http://fr.mail.yahoo.com
On Wednesday 27 December 2006 05:41, Vincent Massol wrote:
I'm interested in getting other's opinions.
I have just read some documentation on radeox home page. Is there currently a way to edit the filters (or create new ones on top of the basic ones)? Referring to radeox documentation page 16 @ http://radeox.org/space/Developer/Radeox_Developer.pdf : 7.2.6 Using the locale versions of RegexTokenFilter and RegexReplaceFilter It is possible to have a radeox_markup_mywiki.properties somewhere (in WEB-INF/ ?) where input (wiki syntax) and output (html) can be (re)defined. It may not be difficult to provide an admin panel to edit this text file, is it? Marc
-----Original Message----- From: Vincent Massol [mailto:vincent@massol.net] Sent: mercredi 27 décembre 2006 11:42 To: 'xwiki-dev@objectweb.org' Cc: 'Ludovic Dubost' Subject: RE: [xwiki-dev] XWiki 309 : Bold codification is not the same than in wiki editor mode
I also have an issue with having different ways of doing the same thing. I think this is really bad for our users. For bold, I'd go for the *text* syntax (because that's the syntax I've seen used in most other wikis I've used) and deprecate the _text_ syntax. However I've not been here for long and I don't know the history around this so I'd rather defer to Ludovic or other old-timers to decide on this.
Also, in order not to break any compatibility we need to continue to support the _text_ syntax. So I'd be to have both the xwiki editor and the WYSIWYG editor generate *text* syntax but they should continue to support the _text_ syntax.
We'd also need to fix the XWiki syntax sheet to reflect this.
Alternatively we should have the wiki editor and the WYSIWYG one transform the _text_ syntax into *text* syntax when the user saves a document.
I'm interested in getting other's opinions.
BTW, I was pointed to Creole (http://www.wikicreole.org/) which is an interesting effort to harmonize wiki syntaxes. It would be nice that XWiki be compliant with Creole. WRT our discussion on bold, the relevant page is http://www.wikicreole.org/wiki/AllMarkup#section-AllMarkup-Bold The recommended bold syntax is **text** A comparison of all bold syntaxes by other wikis: http://www.wikimatrix.org/syntax.php?i=23 (which is BTW not correct for XWiki as 2 syntaxes are supported). Funnily someone has already added XWiki as a wiki planning to implement Creole: http://www.wikicreole.org/wiki/Engines In view of this, I'd be in favor of the following: * Have XWiki supports Creole progressively (i.e. we move one syntax at a time to be Creole compliant) * Have a migration application that is packaged in the core and that runs when the database used is using has not been migrated to the new version. The migration application would present a screen to the user telling him the changes that will be brought to his database, telling him to backup his database before continuing. In the case of bold, this application would replace all *text* and __text__ with **text**. * The Wiki editors (wiki mode and WYSIWYG modes) would both output **text** syntax. * (optional) The rendering would no longer accept the old syntaxes. If we want to be extra nice we would continue supporting the old syntaxes for some time. Only problem is that this is costing a lot in term of development efforts and potential bugs. We would have to take a call on this. WDYT? Thanks -Vincent
-----Original Message----- From: phunghainam@xwiki.com [mailto:phunghainam@xwiki.com] Sent: mercredi 27 décembre 2006 11:28 To: xwiki-dev@objectweb.org Subject: [xwiki-dev] XWiki 309 : Bold codification is not the same than in wiki editor mode
Hi All ?
We will use syntax for bold text is *text* or _text_ for both editor mode ?
and how to config to show the toolbar in wiki editor (normal mode) .
In wysiwyg mode, bold text is coded with *text*. in wiki mode, when using the small toolbar, it is coded with _text_. In some cases, switching from wysiwyg to wiki mode, some problems appear, but I can't reproduce them systematically. I suggest to have a same codification between both modes to avoid any problem.
___________________________________________________________________________ Découvrez une nouvelle façon d'obtenir des réponses à toutes vos questions ! Profitez des connaissances, des opinions et des expériences des internautes sur Yahoo! Questions/Réponses http://fr.answers.yahoo.com
On Wednesday 27 December 2006 12:33, Vincent Massol wrote:
* (optional) The rendering would no longer accept the old syntaxes. If we want to be extra nice we would continue supporting the old syntaxes for some time. Only problem is that this is costing a lot in term of development efforts and potential bugs. We would have to take a call on this.
Would it be possible for the user to add custom filters for radeox (see my previous post for the references)? Is that case it would be acceptable to adopt a restrictive policy, as the user can set up his preferred behaviour back.
Yes, xwiki already uses some custom filters and macros, located in the com.xpn.xwiki.render.[filter/macro] packages. How to implement a custom filter/macro: 1. Write a new class in the com.xpn.xwiki.render.[filter/macro] package. You can look at the existing classes for an example. Some are simple, like StrongFilter, which rely on the match/print configuration (see item 2). You must define a key for the filter/macro. 2. Add the "match" and "print" regular expressions in the core/src/main/resources/radeox_markup_xwiki.properties file. 3. Register the new class in core/src/main/resources/META-INF/services/* file. Just add the full classname in the corresponding file. For more details about how a radeox filter/macro works, I think the radeox documentation is the enough. I'm not sure about the admin panel for changing the syntax. It can be done, but I don't know if it is such an useful feature. The more complex macros/filters definitely need changes in the java code in order to be customized, and we can't do this from the web interface. Hope this answers you previous mail, too. Sergiu On 12/28/06, Marc Lijour <marc@lijour.net> wrote:
On Wednesday 27 December 2006 12:33, Vincent Massol wrote:
* (optional) The rendering would no longer accept the old syntaxes. If we want to be extra nice we would continue supporting the old syntaxes for some time. Only problem is that this is costing a lot in term of development efforts and potential bugs. We would have to take a call on this.
Would it be possible for the user to add custom filters for radeox (see my previous post for the references)?
Is that case it would be acceptable to adopt a restrictive policy, as the user can set up his preferred behaviour back.
-- You receive this message as a subscriber of the xwiki-dev@objectweb.orgmailing list. To unsubscribe: mailto:xwiki-dev-unsubscribe@objectweb.org For general help: mailto:sympa@objectweb.org?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
Thank you. I added your explanation in the FAQ: http://www.xwiki.org/xwiki/bin/view/FAQ/HowToImplementACustomRadeoxFilterOrM... I believe it should also have a place somewhere in the Dev guide. But I am not in the best place to tell where. On Thursday 28 December 2006 07:14, Sergiu Dumitriu wrote:
Yes, xwiki already uses some custom filters and macros, located in the com.xpn.xwiki.render.[filter/macro] packages.
How to implement a custom filter/macro: 1. Write a new class in the com.xpn.xwiki.render.[filter/macro] package. You can look at the existing classes for an example. Some are simple, like StrongFilter, which rely on the match/print configuration (see item 2). You must define a key for the filter/macro. 2. Add the "match" and "print" regular expressions in the core/src/main/resources/radeox_markup_xwiki.properties file. 3. Register the new class in core/src/main/resources/META-INF/services/* file. Just add the full classname in the corresponding file.
For more details about how a radeox filter/macro works, I think the radeox documentation is the enough.
I'm not sure about the admin panel for changing the syntax. It can be done, but I don't know if it is such an useful feature. The more complex macros/filters definitely need changes in the java code in order to be customized, and we can't do this from the web interface.
Hope this answers you previous mail, too.
Sergiu
On 12/28/06, Marc Lijour <marc@lijour.net> wrote:
On Wednesday 27 December 2006 12:33, Vincent Massol wrote:
* (optional) The rendering would no longer accept the old syntaxes. If
we
want to be extra nice we would continue supporting the old syntaxes for some time. Only problem is that this is costing a lot in term of development efforts and potential bugs. We would have to take a call on this.
Would it be possible for the user to add custom filters for radeox (see my previous post for the references)?
Is that case it would be acceptable to adopt a restrictive policy, as the user can set up his preferred behaviour back.
-- You receive this message as a subscriber of the xwiki-dev@objectweb.orgmailing list. To unsubscribe: mailto:xwiki-dev-unsubscribe@objectweb.org For general help: mailto:sympa@objectweb.org?subject=help ObjectWeb mailing lists service home page: http://www.objectweb.org/wws
-----Original Message----- From: Marc Lijour [mailto:marc@lijour.net] Sent: jeudi 28 décembre 2006 16:36 To: xwiki-dev@objectweb.org Subject: Re: implement a radeox custom filter (was Re: Creole support (was RE: [xwiki-dev] XWiki 309 : Bold codification is not the same than in wiki editor mode))
Thank you.
I added your explanation in the FAQ: http://www.xwiki.org/xwiki/bin/view/FAQ/HowToImplementACustomRadeoxFilt erOrMacro
Cool.
I believe it should also have a place somewhere in the Dev guide. But I am not in the best place to tell where.
I'd put it as a child page of http://www.xwiki.org/xwiki/bin/view/DevGuide/Tutorials I'll do a reorganization of the dev guide space a bit later. I copied the one from the old site but it needs some reorganization but whatever you put there I'll keep of course so feel free to document it there :-) Thanks -Vincent
On Thursday 28 December 2006 07:14, Sergiu Dumitriu wrote:
Yes, xwiki already uses some custom filters and macros, located in the com.xpn.xwiki.render.[filter/macro] packages.
How to implement a custom filter/macro: 1. Write a new class in the com.xpn.xwiki.render.[filter/macro] package. You can look at the existing classes for an example. Some are simple, like StrongFilter, which rely on the match/print configuration (see item 2). You must define a key for the filter/macro. 2. Add the "match" and "print" regular expressions in the core/src/main/resources/radeox_markup_xwiki.properties file. 3. Register the new class in core/src/main/resources/META-INF/services/* file. Just add the full classname in the corresponding file.
For more details about how a radeox filter/macro works, I think the radeox documentation is the enough.
I'm not sure about the admin panel for changing the syntax. It can be done, but I don't know if it is such an useful feature. The more complex macros/filters definitely need changes in the java code in order to be customized, and we can't do this from the web interface.
Hope this answers you previous mail, too.
Sergiu
On 12/28/06, Marc Lijour <marc@lijour.net> wrote:
On Wednesday 27 December 2006 12:33, Vincent Massol wrote:
* (optional) The rendering would no longer accept the old syntaxes. If
we
want to be extra nice we would continue supporting the old syntaxes for some time. Only problem is that this is costing a lot in term of development efforts and potential bugs. We would have to take a call on this.
Would it be possible for the user to add custom filters for radeox (see my previous post for the references)?
Is that case it would be acceptable to adopt a restrictive policy, as the user can set up his preferred behaviour back.
___________________________________________________________________________ Yahoo! Mail réinvente le mail ! Découvrez le nouveau Yahoo! Mail et son interface révolutionnaire. http://fr.mail.yahoo.com
participants (4)
-
Marc Lijour -
phunghainam＠xwiki.com -
Sergiu Dumitriu -
Vincent Massol