Differences between revisions 6 and 7
Revision 6 as of 2011-05-22 04:28:52
Size: 2259
Editor: BradleyDean
Comment: mapped Text Effects
Revision 7 as of 2011-05-22 12:34:13
Size: 6693
Editor: PaulBoddie
Comment: Added list and table syntax comparisons, avoiding reproduction of the Confluence documentation. Hope this is helpful!
Deletions are marked like this. Additions are marked like this.
Line 45: Line 45:
TODO || '''Confluence''' || '''MoinMoin''' || '''Comments''' ||
|| {{{* top-level}}} || {{{ * top-level }}} || Confluence uses first column, Moin has leading space ||
|| {{{** second-level}}} || {{{ * second-level }}} || Confluence adds symbols for depth (like !MediaWiki), Moin adds leading spaces ||
|| {{{# top-level}}} || {{{ # top-level }}} || Numbered/ordered lists ||
|| {{{## second-level}}} || {{{ # second-level }}} || Numbered/ordered lists behave like bullet lists ||
|| {{{*# second-level}}} || {{{ # second-level }}} || Mixing list types, Moin treats different levels independently, anyway ||
|| {{{- top-level}}} || ''not supported?'' || Alternative bullet types (square, not round) ||

Task lists in Confluence are provided by a macro of the form `{dynamicTaskList:<name>}` which could presumably be supported in Moin given an equivalent macro.
Line 53: Line 61:
TODO || '''Confluence''' || '''MoinMoin''' || '''Comments''' ||
|| {{{||heading||heading||}}} || {{{|| '''heading''' || '''heading''' ||}}} || Moin doesn't have explicit heading syntax ||
|| {{{|cell text|cell text|}}} || {{{|| cell text || cell text ||}}} || Moin doesn't distinguish between heading cells and ordinary cells ||

Tables in Confluence appear to involve consecutive lines, just like Moin's tables. This should make conversion somewhat easier than, say, from !MediaWiki syntax.

=== Sections and Columns ===

Sections with multiple columns are supported in Confluence using the following syntax:

{{{
{section}

{column:width=25%}
The first column.
{column}

...

{section}
}}}

Moin doesn't have specific support for sections and columns, but it would be possible to use blocks defined within `{{{#!wiki` and `}}}` and then [[HelpOnMoinWikiSyntax#Using_the_wiki_parser_with_css_classes|make use of CSS rules]] to set block widths. Unfortunately, Moin doesn't permit the nesting of blocks, so some other technique would be required to group the blocks.

=== CSV Tables ===

Confluence provides a CSV macro to show tabular data with optional options given after the `csv` "tag":

{{{
{csv:delimiter=whitespace}
heading1,heading2,heading3
value1,value2,value3
{csv}
}}}

Moin provides a [[HelpOnParsers#csv_parser|CSV parser]] for blocks defined within `{{{#CSV` and `}}}` and there are also macros available (such as [[MacroMarket/ShowCSV|ShowCSV]]). The options translate between Confluence and the CSV parser as follows:

|| '''Confluence''' || '''MoinMoin''' || '''Comments''' ||
|| `output` || ''not supported'' || Moin will generate the appropriate format for the page ||
|| `script` || ''not supported'' || This reads the data from some other location in the Wiki or filesystem ||
|| `encoding` || ''not supported'' || Moin uses the page encoding ||
|| `url` || ''not supported'' || Perhaps the `link` option in Moin is the equivalent? ||
|| `heading` || ''not supported'' || Moin supports only one heading row ||
|| `footing` || ''not supported'' || Moin doesn't seem to support footers ||
|| `border` ||<|2> ''not supported'' ||<|2> Perhaps [[HelpOnMoinWikiSyntax#Using_the_wiki_parser_with_css_classes|CSS rules]] can be used with the CSV block in Moin ||
|| `width` ||
|| `delimiter` || `delimiter` and `quotechar` || Moin presumably requires the literal value? ||
|| `columns` || `show` (and `hide`) || Used to reorder columns (specified using a 1-based index in Confluence, column names in Moin) ||
|| `ignoreTrailingBlankRows` || ''not supported'' || Confluence can suppress blank rows; this may not be related to Moin's `autofilter` ||
|| `quote` || `quotechar` || Confluence may include encapsulating quotes in the `delimiter` specification ||
|| `escape` || ''not supported'' || Moin generates appropriately formatted page output (see `output` above) ||
|| `showWiki` || ''not supported'' || Apparently used for troubleshooting ||
|| `disableAntiXss` || ''not supported'' || Moin generates appropriately formatted page output (see `output` above) ||

Many of the Confluence options would be superfluous in the common case.

=== The Table Plus Macro ===

Confluence provides a macro which enhances table presentation and provides !JavaScript-dependent viewing features:

{{{
{table-plus}
|| heading || heading ||
| cell text | cell text |
{table-plus}
}}}

Moin doesn't support anything like this by default, but a parser could possibly be written to present tables in a similar fashion.

Overview

Documentation describing Confluence markup is available here: http://confluence.atlassian.com/renderer/notationhelp.action?section=all

The following tables map the Confluence markup to MoinMoin markup - this is split into the sub-sections defined in the Confluence documentation (Headings, Text Effects, Text Breaks, Links, Lists, Images, Tables, Advanced Formatting, Confluence Content, External Content, Misc).

Mapping

Headings

Confluence

MoinMoin

Comments

h1. Biggest heading

= Biggest Heading =

h2. Bigger heading

== Bigger heading ==

h3. Big Heading

=== Big Heading ===

h4. Normal Heading

==== Normal Heading ====

h5. Small Heading

===== Small Heading =====

h6. Smallest Heading

====== Smallest Heading ======

Text Effects

Confluence

MoinMoin

Comments

*strong*

'''strong'''

_emphasis_

''emphasis''

??citation??

No direct mapping, probably can use itallic like emphasis

-strikethrough-

--(strikethrough)--

+underlined+

__underlined__

^superscript^

^superscript^

~subscript~

,,subscript,,

{{text will be monospaced}}

`text will be monospaced`

bq. Some block quoted text

  Some block quoted text

(that's space indented)

{quote}
here is quoteble
content to be quoted
{quote}

{{{
here is quoteble
content to be quoted
}}}

{color:red}
look ma, red text!
{color}

<<Color2(look ma, red text!,col=red)>>

No native way to do this, but it can be done by using a macro which needs to be installed: MacroMarket/Color2

Text Breaks

TODO

TODO

Lists

Confluence

MoinMoin

Comments

* top-level

 * top-level 

Confluence uses first column, Moin has leading space

** second-level

  * second-level 

Confluence adds symbols for depth (like MediaWiki), Moin adds leading spaces

# top-level

 # top-level 

Numbered/ordered lists

## second-level

 # second-level 

Numbered/ordered lists behave like bullet lists

*# second-level

  # second-level 

Mixing list types, Moin treats different levels independently, anyway

- top-level

not supported?

Alternative bullet types (square, not round)

Task lists in Confluence are provided by a macro of the form {dynamicTaskList:<name>} which could presumably be supported in Moin given an equivalent macro.

Images

TODO

Tables

Confluence

MoinMoin

Comments

||heading||heading||

|| '''heading''' || '''heading''' ||

Moin doesn't have explicit heading syntax

|cell text|cell text|

|| cell text || cell text ||

Moin doesn't distinguish between heading cells and ordinary cells

Tables in Confluence appear to involve consecutive lines, just like Moin's tables. This should make conversion somewhat easier than, say, from MediaWiki syntax.

Sections and Columns

Sections with multiple columns are supported in Confluence using the following syntax:

{section}

{column:width=25%}
The first column.
{column}

...

{section}

Moin doesn't have specific support for sections and columns, but it would be possible to use blocks defined within {{{#!wiki and }}} and then make use of CSS rules to set block widths. Unfortunately, Moin doesn't permit the nesting of blocks, so some other technique would be required to group the blocks.

CSV Tables

Confluence provides a CSV macro to show tabular data with optional options given after the csv "tag":

{csv:delimiter=whitespace}
heading1,heading2,heading3
value1,value2,value3
{csv}

Moin provides a CSV parser for blocks defined within {{{#CSV and }}} and there are also macros available (such as ShowCSV). The options translate between Confluence and the CSV parser as follows:

Confluence

MoinMoin

Comments

output

not supported

Moin will generate the appropriate format for the page

script

not supported

This reads the data from some other location in the Wiki or filesystem

encoding

not supported

Moin uses the page encoding

url

not supported

Perhaps the link option in Moin is the equivalent?

heading

not supported

Moin supports only one heading row

footing

not supported

Moin doesn't seem to support footers

border

not supported

Perhaps CSS rules can be used with the CSV block in Moin

width

delimiter

delimiter and quotechar

Moin presumably requires the literal value?

columns

show (and hide)

Used to reorder columns (specified using a 1-based index in Confluence, column names in Moin)

ignoreTrailingBlankRows

not supported

Confluence can suppress blank rows; this may not be related to Moin's autofilter

quote

quotechar

Confluence may include encapsulating quotes in the delimiter specification

escape

not supported

Moin generates appropriately formatted page output (see output above)

showWiki

not supported

Apparently used for troubleshooting

disableAntiXss

not supported

Moin generates appropriately formatted page output (see output above)

Many of the Confluence options would be superfluous in the common case.

The Table Plus Macro

Confluence provides a macro which enhances table presentation and provides JavaScript-dependent viewing features:

{table-plus}
|| heading || heading ||
| cell text | cell text |
{table-plus}

Moin doesn't support anything like this by default, but a parser could possibly be written to present tables in a similar fashion.

Advanced Formatting

TODO

Confluence Content

TODO

External Content

TODO

Misc

TODO

MoinMoin: ConfluenceConverter/DevelopmentNotes/MarkupMapping (last edited 2013-02-19 15:27:40 by PaulBoddie)