[xwiki-users] Which input syntax to choose?
I would like input on which input syntax might be best to use. I am not habituated to any syntax, only light exposure to mediawiki and wikis in general. I would value a syntax which is simple and terse. xwiki has gone out of it's way to support many input syntaxes. The safe choice for portability (of skillset and pages) would seem to be mediawiki. But I might guess that the xwiki syntax was developed in order to better utilize the special features of xwiki, and so in xwiki, xwiki syntax would have to be the best and the default syntax. If one chooses xwiki syntax, is there a way to convert/export to mediawiki syntax if needed? -- View this message in context: http://xwiki.475771.n2.nabble.com/Which-input-syntax-to-choose-tp7602190.htm... Sent from the XWiki- Users mailing list archive at Nabble.com.
Hi,
On 26 Dec 2016, at 19:55, novnovice <[email protected]> wrote:
I would like input on which input syntax might be best to use. I am not habituated to any syntax, only light exposure to mediawiki and wikis in general. I would value a syntax which is simple and terse.
xwiki has gone out of it's way to support many input syntaxes. The safe choice for portability (of skillset and pages) would seem to be mediawiki. But I might guess that the xwiki syntax was developed in order to better utilize the special features of xwiki, and so in xwiki, xwiki syntax would have to be the best and the default syntax.
Yes you’re right. We’ve developed the XWiki syntax to be the most complete syntax and so that it works well with WYSIWYG, i.e. that it’s easy to convert from/to (X)HTML. I’d recommend that you user the XWiki syntax if you can (XWiki Syntax 2.1 to be precise).
If one chooses xwiki syntax, is there a way to convert/export to mediawiki syntax if needed?
Yes that’s possible, see http://extensions.xwiki.org/xwiki/bin/view/Extension/MediaWiki/MediaWiki+XML... You can also convert page by page, see http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HChoosingaSynt... and http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HConvertingbet... Thanks -Vincent [snip]
On Mon, Dec 26, 2016 at 8:37 PM, Vincent Massol <[email protected]> wrote:
Hi,
On 26 Dec 2016, at 19:55, novnovice <[email protected]> wrote:
I would like input on which input syntax might be best to use. I am not habituated to any syntax, only light exposure to mediawiki and wikis in general. I would value a syntax which is simple and terse.
xwiki has gone out of it's way to support many input syntaxes. The safe choice for portability (of skillset and pages) would seem to be mediawiki. But I might guess that the xwiki syntax was developed in order to better utilize the special features of xwiki, and so in xwiki, xwiki syntax would have to be the best and the default syntax.
Yes you’re right. We’ve developed the XWiki syntax to be the most complete syntax and so that it works well with WYSIWYG, i.e. that it’s easy to convert from/to (X)HTML.
I’d recommend that you user the XWiki syntax if you can (XWiki Syntax 2.1 to be precise).
If one chooses xwiki syntax, is there a way to convert/export to mediawiki syntax if needed?
Yes that’s possible, see http://extensions.xwiki.org/xwiki/bin/view/Extension/MediaWiki/MediaWiki+XML...
Actually this module only support parsing mediawiki syntax, not serializing it. So mediawiki -> xwiki is easy but there is nothing well tested right now for xwiki -> mediawiki.
You can also convert page by page, see http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HChoosingaSynt... and http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HConvertingbet...
Thanks -Vincent
[snip]
-- Thomas Mortagne
On 26 Dec 2016, at 21:19, Thomas Mortagne <[email protected]> wrote:
On Mon, Dec 26, 2016 at 8:37 PM, Vincent Massol <[email protected]> wrote:
Hi,
On 26 Dec 2016, at 19:55, novnovice <[email protected]> wrote:
I would like input on which input syntax might be best to use. I am not habituated to any syntax, only light exposure to mediawiki and wikis in general. I would value a syntax which is simple and terse.
xwiki has gone out of it's way to support many input syntaxes. The safe choice for portability (of skillset and pages) would seem to be mediawiki. But I might guess that the xwiki syntax was developed in order to better utilize the special features of xwiki, and so in xwiki, xwiki syntax would have to be the best and the default syntax.
Yes you’re right. We’ve developed the XWiki syntax to be the most complete syntax and so that it works well with WYSIWYG, i.e. that it’s easy to convert from/to (X)HTML.
I’d recommend that you user the XWiki syntax if you can (XWiki Syntax 2.1 to be precise).
If one chooses xwiki syntax, is there a way to convert/export to mediawiki syntax if needed?
Yes that’s possible, see http://extensions.xwiki.org/xwiki/bin/view/Extension/MediaWiki/MediaWiki+XML...
Actually this module only support parsing mediawiki syntax, not serializing it. So mediawiki -> xwiki is easy but there is nothing well tested right now for xwiki -> mediawiki.
Yes sorry, my bad, I read too quickly and thought you were asking to convert *from* mediawiki. As Thomas said, we don’t have any easy way to convert back to MediaWiki syntax. Thanks -Vincent
You can also convert page by page, see http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HChoosingaSynt... and http://platform.xwiki.org/xwiki/bin/view/Features/PageEditing#HConvertingbet...
Thanks -Vincent
[snip]
OK, thanks that's the info I was looking for. I kind of guessed that the mulitple input syntaxes would be most useful when importing pages from another type of wiki. When I configure the test server I'll use xwiki 2.1 syntax and see how it goes. -- View this message in context: http://xwiki.475771.n2.nabble.com/Which-input-syntax-to-choose-tp7602190p760... Sent from the XWiki- Users mailing list archive at Nabble.com.
On 26 Dec 2016, at 21:47, novnovice <[email protected]> wrote:
OK, thanks that's the info I was looking for. I kind of guessed that the mulitple input syntaxes would be most useful when importing pages from another type of wiki. When I configure the test server I'll use xwiki 2.1 syntax and see how it goes.
To be complete, it depends on the syntax. For some syntaxes we have implemented “serializers” (we call them Renderers), i.e. the ability to transform from an XWiki AST into an output syntax. The information is available here: http://rendering.xwiki.org/xwiki/bin/view/Main/WebHome#HSupportedSyntaxes In the table, whenever you see “output syntax” as ticked, it means XWiki can convert to that syntax from all other syntaxes. For example you can convert from, say, MediaWiki syntax to, say, XHTML 1.0. Or from Confluence syntax to Markdown syntax. It also means that when “output syntax” is ticked, it’s possible to use the WYSIWYG editor for that syntax. However there can be limitations, depending on what the syntax supports (there may be some HTML elements not supported by the syntax for example, in which case they’d be ignored). Thanks -Vincent
Very good, interesting page for sure. -- View this message in context: http://xwiki.475771.n2.nabble.com/Which-input-syntax-to-choose-tp7602190p760... Sent from the XWiki- Users mailing list archive at Nabble.com.
participants (3)
-
novnovice -
Thomas Mortagne -
Vincent Massol