| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| howtos:misc:dokuwiki_versus_asciidoc_markups [2015/04/22 10:03 (UTC)] – typos fixed didierspaier | howtos:misc:dokuwiki_versus_asciidoc_markups [2015/07/02 19:08 (UTC)] – Corrected explanation of DokiwWiki behavior in some case. didierspaier |
|---|
| In addition, you will need to make and install a package [[http://slackbuilds.org/repository/14.1/development/source-highlight/|source-highlight]]. | In addition, you will need to make and install a package [[http://slackbuilds.org/repository/14.1/development/source-highlight/|source-highlight]]. |
| |
| Be aware of following limitations: | Be aware of following limitations at time of writing: |
| * The internal links are converted to point to this wiki.To change that, find and replace http://docs.slackware.com by your target in the script file dokasc2. | * The internal links are converted to point to this wiki.To change that, find and replace http://docs.slackware.com by your target in the script file dokasc2.((Removing this limitation is in the TODO list)) |
| * The internal images are not displayed. | * The internal images are not displayed.((Removing this limitation is in the TODO list)) |
| * The [[http://wiki.foosel.net/snippets/dokuwiki/keyboard|Keyboard syntax plugin]] for Dokuwki has no equivalent for AsciiDoc thus you won't get the same rendering after conversion to AsciiDoc. | * The [[http://wiki.foosel.net/snippets/dokuwiki/keyboard|Keyboard syntax plugin]] for Dokuwki has no equivalent for AsciiDoc thus you won't get the same rendering after conversion to AsciiDoc. |
| * Appending a downloadable file (code snippet) to a Code block is not possible in AsciiDoc thus the link to the file is silently discarded by the converter. | * Appending a downloadable file (code snippet) to a Code block is not yet available thus the link to the file is silently discarded by the converter.((Removing this limitation is in the TODO list)) |
| * Multi-level quoting is not available in AsciiDoc, but the converter tries to simulate this feature. You can see an example in converting [[howtos:slackware_admin:building_the_linux_kernel_using_git_repository|this page]]. | * Multi-level quoting is not available in AsciiDoc, but the converter simulated this feature. You can see an example in converting [[howtos:slackware_admin:building_the_linux_kernel_using_git_repository|this page]]. |
| * The vertical spanning (over several rows) of a table cell is not provided. | * The vertical spanning (over several rows) of a table cell is not provided. |
| * The horizontal spanning of a table cell is limited to 9 consecutive columns. | * The horizontal spanning of a table cell is limited to 9 consecutive columns. |
| * The text to image conversion is not available. | * The text to image conversion is not available. |
| * Text decorations and "text not to be parsed" marks are only properly converted if opening and closing marks are on the same line (overcoming this limitation is in the TODO list). | * Text decorations and "text not to be parsed" marks are only properly converted if opening and closing marks are on the same line.((Removing this limitation is in the TODO list)) |
| |
| In addition to easing the translation, the converter could be used e.g. to convert a static website build from AsciiDoc source pages to a Wiki powered by DokuWiki or reverse. | In addition to easing the translation, the converter could be used e.g. to convert a static website build from AsciiDoc source pages to a Wiki powered by DokuWiki or reverse. |
| |Internal links | %%[[internal:link|text]]%% |%%http:docs.slackware.com/internal:link[text]%% |((http://docs.slackware.com/ can be replaced by another URL in the second script)) | | |Internal links | %%[[internal:link|text]]%% |%%http:docs.slackware.com/internal:link[text]%% |((http://docs.slackware.com/ can be replaced by another URL in the second script)) | |
| |Email addresses |%%<local@domain>%% | %%local@domain%% or\\ %%mailto:local@domain[text]%%|A: other syntax mailto:local@domain[text]| | |Email addresses |%%<local@domain>%% | %%local@domain%% or\\ %%mailto:local@domain[text]%%|A: other syntax mailto:local@domain[text]| |
| |Multi-level quoting| %%> quoted text%% \\ %%>> quoted text%% \\ %%>>> quoted text%% | %%[verse]%% \\ %%----%% \\ quoted text \\ %%..quoted text%% \\ %%....quoted text%% \\ %%----%% | Feature not available in AsciiDoc but ''simulated by the converter''. The quoted text is converted to an AsciiDoc Quote block with the style "verse", thus the lines are reproduced as-is (no < newline> inserted)| | |Multi-level quoting| %%> quoted text%% \\ %%>> quoted text%% \\ %%>>> quoted text%% | │quoted text \\ ││quoted text \\ %%│││quoted text%% | Feature not available in AsciiDoc but ''simulated by the converter''.((The light vertical │ is U+2502))| |
| |Unordered list |%%⎕⎕* item%% |* item| | | |Unordered list |%%⎕⎕* item%% |* item| | |
| |Unordered list |%%⎕⎕⎕⎕* item%% |%%**%% item | | | |Unordered list |%%⎕⎕⎕⎕* item%% |%%**%% item | | |
| |Admonitions |%%<note tip><text></tip>%%|[TIP] \\ ==== \\ block \\ ==== |A: Converted to an Admonition block \\ D: with the NOTE plugin| | |Admonitions |%%<note tip><text></tip>%%|[TIP] \\ ==== \\ block \\ ==== |A: Converted to an Admonition block \\ D: with the NOTE plugin| |
| |Admonitions |%%<note warning><text></warning>%%|[WARNING] \\ ==== \\ block \\ ==== |A: Converted to an Admonition block \\ D: with the NOTE plugin| | |Admonitions |%%<note warning><text></warning>%%|[WARNING] \\ ==== \\ block \\ ==== |A: Converted to an Admonition block \\ D: with the NOTE plugin| |
| |Code block |%%⎕⎕line of text %% \\ %%⎕⎕line of text %% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block | | |Code block |%%⎕⎕line of text %% \\ %%⎕⎕line of text %% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block \\ D: Actually, the Code block will be formatted as such only if it includes a line containing at least one character belonging to the POSIX character class ''graph''. And the first line beginning with two spaces won't begin a Code block if the previous one included a closing %%</code>%% or %%</file>%% ot %%</note>%% only followed by one or several space(s)...((Probably because the parser appends the second line to the first. How can I convert this behavior???))| |
| |Code block |%%<code> block </code>%% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block \\ D: the opening and closing tags can occur anywhere on the line, but in case of continuation of a list item| | |Code block |%%<code> block </code>%% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block \\ D: the opening and closing tags can occur anywhere on the line, but in case of continuation of a list item| |
| |Code block |%%<file> block </file>%% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block\\ D: the opening and closing tags can occur anywhere on the line, but in case of continuation of a list item| | |Code block |%%<file> block </file>%% |%%----%% \\ block \\ %%----%% |A: converted to a Listing block\\ D: the opening and closing tags can occur anywhere on the line, but in case of continuation of a list item| |
| |Highlighted source code|%%<code language> block </code>%%| [source,language] \\ %% ----%% \\ block \\ %%----%% |D: If language is "-" or ".", "txt' is assumed. \\ A: converted to a Listing block\\ A: needs a syntax highlighting plugin.((The feature "downloadable attached file" is not converted as no such plugin is available for AsciiDoc. The link is discarded)) | | |Highlighted source code|%%<code language> block </code>%%| [source,language] \\ %% ----%% \\ block \\ %%----%% |D: If language is "-" or ".", "txt' is assumed. \\ A: converted to a Listing block\\ A: needs a syntax highlighting plugin.((The feature "downloadable attached file" is not converted yet. The link is discarded)) | |
| |Highlighted source code|%%<file language> block </file>%%| [source,language] \\ %%----%% \\ block \\ %%----%% |D: If language is "-" or ".", "txt" is assumed. \\ A: converted to a Listing block\\ A: needs a syntax highlighting plugin.((The feature "downloadable attached file" is not converted as no such plugin is available for AsciiDoc. The link is discarded)) | | |Highlighted source code|%%<file language> block </file>%%| [source,language] \\ %%----%% \\ block \\ %%----%% |D: If language is "-" or ".", "txt" is assumed. \\ A: converted to a Listing block\\ A: needs a syntax highlighting plugin.((The feature "downloadable attached file" is not converted yet. The link is discarded)) | |
| |Multiline list item| see [[https://www.dokuwiki.org/faq:lists|this article]] | line of text \\ + \\ line of text |D: Code blocks can be embedded \\ A: Listing blocks can be embedded| | |Multiline list item| see [[https://www.dokuwiki.org/faq:lists|this article]] | line of text \\ + \\ line of text |D: Code blocks can be embedded \\ A: Listing blocks can be embedded| |
| |
| ====== Sources ====== | ====== Sources ====== |
| * Originally written by [[wiki:user:didierspaier | Didier Spaier]] | * Originally written by [[wiki:user:didierspaier | Didier Spaier]] |
| {{tag>howtos}} | {{tag>howtos}} |
| |
