1cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?> 2f0745477SAndrew Rist<!--*********************************************************** 3*a98dafebSmseidel * 4f0745477SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 5f0745477SAndrew Rist * or more contributor license agreements. See the NOTICE file 6f0745477SAndrew Rist * distributed with this work for additional information 7f0745477SAndrew Rist * regarding copyright ownership. The ASF licenses this file 8f0745477SAndrew Rist * to you under the Apache License, Version 2.0 (the 9f0745477SAndrew Rist * "License"); you may not use this file except in compliance 10f0745477SAndrew Rist * with the License. You may obtain a copy of the License at 11*a98dafebSmseidel * 12f0745477SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 13*a98dafebSmseidel * 14f0745477SAndrew Rist * Unless required by applicable law or agreed to in writing, 15f0745477SAndrew Rist * software distributed under the License is distributed on an 16f0745477SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 17f0745477SAndrew Rist * KIND, either express or implied. See the License for the 18f0745477SAndrew Rist * specific language governing permissions and limitations 19f0745477SAndrew Rist * under the License. 20*a98dafebSmseidel * 21f0745477SAndrew Rist ***********************************************************--> 22f0745477SAndrew Rist 23f0745477SAndrew Rist 24cdf0e10cSrcweir<helpdocument version="1.0"> 25cdf0e10cSrcweir<meta> 26cdf0e10cSrcweir<topic id="comsunstarwikiMediaWikiwikiformatsxml" indexer="include" status="PUBLISH"> 27cdf0e10cSrcweir<title id="tit" xml-lang="en-US">MediaWiki Formats</title> 28cdf0e10cSrcweir<filename>/@WIKIEXTENSIONID@/wikiformats.xhp</filename> 29cdf0e10cSrcweir</topic> 30cdf0e10cSrcweir<history> 31cdf0e10cSrcweir<created date="2008-02-08T12:13:25"/> 32cdf0e10cSrcweir<lastedited date="2008-02-08T14:16:47"/> 33cdf0e10cSrcweir</history> 34cdf0e10cSrcweir</meta> 35cdf0e10cSrcweir<body> 36*a98dafebSmseidel<bookmark branch="hid/vnd.com.sun.star.wiki:formats" id="bm_id7021088" localize="false"/> 37cdf0e10cSrcweir<paragraph role="heading" id="hd_id3743095" xml-lang="en-US" level="1" l10n="NEW">MediaWiki Formats</paragraph> 38cdf0e10cSrcweir<paragraph role="paragraph" id="par_id8654133" xml-lang="en-US" l10n="NEW">The following list gives an overview of the text formats that the @WIKIEXTENSIONPRODUCTNAME@ can upload to the Wiki server.</paragraph> 39*a98dafebSmseidel<paragraph role="paragraph" id="par_id5630664" xml-lang="en-US" l10n="NEW">The OpenDocument format used by Writer and the MediaWiki format are quite different. Only a subset of all features can be transformed from one format to the other.</paragraph> 40cdf0e10cSrcweir<paragraph role="heading" id="hd_id7178868" xml-lang="en-US" level="2" l10n="NEW">Headings</paragraph> 41cdf0e10cSrcweir<paragraph role="paragraph" id="par_id508133" xml-lang="en-US" l10n="NEW">Apply a heading paragraph style to the headings in your Writer document. The Wiki will show the heading styles of the same outline level, formatted as defined by the Wiki engine.</paragraph> 42cdf0e10cSrcweir<paragraph role="heading" id="hd_id7217627" xml-lang="en-US" level="2" l10n="NEW">Hyperlinks</paragraph> 43cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3735465" xml-lang="en-US" l10n="NEW">Native OpenDocument hyperlinks are transformed into "external" Wiki links. Therefore, the built-in linking facility of OpenDocument should only be used to create links that point to other sites outside the Wiki web. For creating Wiki links that point to other subjects of the same Wiki domain, use Wiki links.</paragraph> 44cdf0e10cSrcweir<paragraph role="heading" id="hd_id941190" xml-lang="en-US" level="2" l10n="NEW">Lists</paragraph> 45cdf0e10cSrcweir<paragraph role="paragraph" id="par_id8942838" xml-lang="en-US" l10n="NEW">Lists can reliably be exported when the whole list uses a consistent list style. Use the Numbering or Bullets icon to generate a list in Writer. If you need a list without numbering or bullets, use Format - Bullets and Numbering to define and apply the respective list style.</paragraph> 46cdf0e10cSrcweir<paragraph role="heading" id="hd_id7026886" xml-lang="en-US" level="2" l10n="NEW">Paragraphs</paragraph> 47cdf0e10cSrcweir<paragraph role="heading" id="hd_id4436475" xml-lang="en-US" level="3" l10n="NEW">Alignment</paragraph> 48cdf0e10cSrcweir<paragraph role="paragraph" id="par_id376598" xml-lang="en-US" l10n="NEW">Explicit text alignment should not be used in Wiki articles. Nevertheless, text alignment is supported for left, centered, and right alignment of text.</paragraph> 49cdf0e10cSrcweir<paragraph role="heading" id="hd_id7486190" xml-lang="en-US" level="3" l10n="NEW">Pre-formatted text</paragraph> 50cdf0e10cSrcweir<paragraph role="paragraph" id="par_id1459395" xml-lang="en-US" l10n="NEW">A paragraph style with a fixed-width font is transformed as pre-formatted text. Pre-formatted text is shown on the Wiki with a border around the text.</paragraph> 51cdf0e10cSrcweir<paragraph role="heading" id="hd_id4834131" xml-lang="en-US" level="2" l10n="NEW">Character styles</paragraph> 52cdf0e10cSrcweir<paragraph role="paragraph" id="par_id6397595" xml-lang="en-US" l10n="NEW">Character styles modify the appearance of parts of a paragraph. The transformation supports bold, italics, bold/italics, subscript and superscript. All fixed width fonts are transformed into the Wiki typewriter style.</paragraph> 53cdf0e10cSrcweir<paragraph role="heading" id="hd_id5152745" xml-lang="en-US" level="2" l10n="NEW">Footnotes</paragraph> 54cdf0e10cSrcweir<paragraph role="paragraph" id="par_id5238196" xml-lang="en-US" l10n="NEW">Note: The transformation uses the new style of footnotes with <ref> and <references> tags that requires the Cite.php extension to be installed into MediaWiki. If those tags occur as plain text in the transformation result, ask the Wiki administrator to install this extension.</paragraph> 55cdf0e10cSrcweir<paragraph role="heading" id="hd_id9405499" xml-lang="en-US" level="2" l10n="NEW">Images</paragraph> 56cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3541673" xml-lang="en-US" l10n="NEW">Images cannot be exported by a transformation producing a single file of Wiki text. However, if the image is already uploaded to the target Wiki domain (e. g. WikiMedia Commons), then the transformation produces a valid image tag that includes the image. Image captions are also supported.</paragraph> 57cdf0e10cSrcweir<paragraph role="heading" id="hd_id2162236" xml-lang="en-US" level="2" l10n="NEW">Tables</paragraph> 58cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3037202" xml-lang="en-US" l10n="NEW">Simple tables are supported well. Table headers are translated into corresponding Wiki style table headers. However, custom formatting of table borders, column sizes and background colors is ignored.</paragraph> 59cdf0e10cSrcweir<paragraph role="heading" id="hd_id2954496" xml-lang="en-US" level="3" l10n="NEW">Joined Cells</paragraph> 60cdf0e10cSrcweir<paragraph role="paragraph" id="par_id8253730" xml-lang="en-US" l10n="NEW">OpenDocument and especially OpenOffice.org represent tables that have joined cells that span rows as tables with nested tables. In contrast, the wiki model of table is to declare column and row spans for such joined cells. </paragraph> 61cdf0e10cSrcweir<paragraph role="paragraph" id="par_id8163090" xml-lang="en-US" l10n="NEW">If only columns of the same row are joined, the result of the transformation resembles the source document very well.</paragraph> 62cdf0e10cSrcweir<paragraph role="heading" id="hd_id425122" xml-lang="en-US" level="3" l10n="NEW">Borders</paragraph> 63cdf0e10cSrcweir<paragraph role="paragraph" id="par_id1831110" xml-lang="en-US" l10n="NEW">Irrespective of custom table styles for border and background, a table is always exported as "<emph>prettytable"</emph>, which renders in the Wiki engine with simple borders and bold header.</paragraph> 64cdf0e10cSrcweir<paragraph role="heading" id="hd_id6255073" xml-lang="en-US" level="2" l10n="NEW">Charset and special characters</paragraph> 65cdf0e10cSrcweir<paragraph role="paragraph" id="par_id8216193" xml-lang="en-US" l10n="NEW">The charset of the transformation result is fixed to UTF-8. Depending on your system, this might not be the default charset. This might cause "special characters" to look broken when viewed with default settings. However, you can switch your editor to UTF-8 encoding to fix this. If your editor does not support switching the encoding, you can display the result of the transformation in the Firefox browser and switch the encoding to UTF-8 there. Now, you can cut and paste the transformation result to your program of choice.</paragraph> 66cdf0e10cSrcweir</body> 67cdf0e10cSrcweir</helpdocument> 68