~~NOCACHE~~
~~ODT~~
====== ODT Demo Page ======
This page demonstrates the features and capabilities of the ODT plugin and demonstrates which plugins support ODT export. To test it, proceed like this:
* copy the page content to your wiki
* install the ODT plugin
* install all other plugins which you like to test for ODT support
* export this page to ODT
Exporting this page is also a easy way to check the influence of ODT or CSS templates on the generated output. You might also like to compare the differences caused by setting the config option **css_usage** to **off (plugins only)** or **basic style import**.
:!: FIXME :!:\\
This demo page is work in progress. So a lot of examples are still missing. At the end, all plugins listed under [[https://www.dokuwiki.org/de:plugin:odt:rendersupport|ODT render support]] should have at least a little example here on the ODT demo page.
**Help is always welcome**. Do not be afraid to extend this page. I can easily change the page content if something is wrong or if something got broken or deleted accidentally --- [[user>LarsDW223]]\\
:!: FIXME :!:
First, let's create a table of content using the following code:
{{odt>toc:title=Content;leader_sign=.;indents=0,0.5,1;pagebreak=true;styleL1="font-weight:bold;";styleL2="fontstyle:italic;";styleL3="font-style:normal;";}}
:!: The table of contents needs to be updated after export to ODT to show correct page numbers :!:
{{odt>toc:title=Content;leader_sign=.;indents=0,0.5,1;pagebreak=true;styleL1="font-weight:bold";styleL2="fontstyle:italic;";styleL3="font-style:normal;";}}
====== DokuWiki Basic syntax ======
===== Basic Text Formatting =====
DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
Of course you can **__//''combine''//__** all these.
You can use subscript and superscript, too.
You can use subscript and superscript, too.
You can mark something as deleted((This text might be red or black. This depends on the changemarks plugin being installed or not)) as well.
You can mark something as deleted as well.
===== Links =====
An external link looks like this after export to ODT: [[http://www.google.com|This Link points to google]]. The ODT plugin treats an internal link like an external one: [[playground:start|This Link points to the start page]]. This only changes if the link points "inside" the exported ODT document: [[playground:odt-demo-page|This Link points to the start of this document]]. This example only works if the page name of **this page** is **odt-demo-page**.
DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. Interwiki links look like external links after export to ODT.
The ODT plugin renders Windows share links as plain text: [[\\server\share|Example link]].
===== Headings =====
Some heading examples:
====== Level 1 Headline ======
===== Level 2 Headline =====
==== Level 3 Headline ====
=== Level 4 Headline ===
== Level 5 Headline ==
If you would like headings to be numbered after export to ODT, then set the config option **outline_list_style** to **Numbers**. **Hint:** Do not worry if the heading numbers are missing in the table of contents, they will appear after updating it.
===== Images =====
Images are included in the exported ODT document. Let's see some examples:
An image link:
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
Resized to given width and height:
{{wiki:dokuwiki-128.png?50x50}}
An left aligned image:
{{wiki:dokuwiki-128.png}}
...and a centered one...
{{ wiki:dokuwiki-128.png }}
...and also one right aligned:
{{ wiki:dokuwiki-128.png}}
===== Lists =====
Of course, lists are exported to ODT as well. See the example from the DokuWiki.org Syntax page:
* This is a list
* The second item
* You may have different levels
* Another item
- The same list but ordered
- Another item
- Just use indention for deeper levels
- That's it
===== Text to Image Conversions =====
Images generated from [[https://www.dokuwiki.org/wiki:syntax##text_to_image_conversions|Text to Image Conversions]] will also be included in the exported ODT Document. Again, see the example from the DokuWiki.org Syntax page:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== Quoting =====
Quoting is implemented by using tables, see the example from DokuWiki.org:
I think we should do it
> No we shouldn't
>> Well, I say we should
> Really?
>> Yes!
>>> Then lets do it!
===== Tables =====
And yet another example taken from DokuWiki.org:
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |
| Row 2 Col 1 | some colspan (note the double pipe) ||
| Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 |
| ^ Heading 1 ^ Heading 2 ^
^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 |
^ Heading 4 | no colspan this time | |
^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
Tables look quite boring after export to ODT. There is no difference between a table header cell and a normal cell. This can be changed by using a ODT or CSS template or by setting the config option **css_usage** to **basic style import**.
===== Syntax Highlighting =====
As DokuWiki itself, the ODT plugin uses Geshi for syntax highlighting:
/**
* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/
class HelloWorldApp {
public static void main(String[] args) {
System.out.println("Hello World!"); //Display the string.
}
}
Please note that links generated by Geshi will also be inserted as links into the exported ODT document.\\ Downloadable code blocks tagged with ''file'' just look like normal ''code'' blocks after the export:
Because the ODT plugin runs on the DokuWiki server, it is not possible to implement ODT support in JavaScript based Syntax highlighter plugins.
===== RSS/ATOM Feed Aggregation =====
Feeds can also be exported to ODT. Let's have a look at the [[https://www.github.com|Github]] feed for the ODT plugin's master branch:
{{rss>https://github.com/LarsGit223/dokuwiki-plugin-odt/commits/master.atom}}
===== Footnotes =====
Footnotes can also be exported to ODT, some examples first:
You can add footnotes ((This is a footnote)) by using double parentheses. And another ((This is a different footnote)) footnote. And again the first one ((This is a footnote)).
Please notice that footnotes in the ODT document are slightly different than in the browser:
* footnotes are always displayed at the bottom of the current ODT page, not at the bottom of the end of the exported DokuWiki page
* footnotes with the same text receive the same number (see the example above and compare it with the browser view)
====== Changemarks plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:changemarks|changemarks plugin]] to be installed :!:
The changemarks plugin is used to mark portions of text as inserted, deleted or !!This has been highlighted.>highlighted!!.
====== Chem plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:chem|Chem plugin]] to be installed :!:
The Chem plugin is used to format a molecular formula. See some examples from the plugin page:
* C2H6
* Na2HPO4 12H2O
* C2H5O2|-Na+
* Cl2H6N2Pt2+
* Al2(SO4)3
====== Color plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:color|Color plugin]] to be installed :!:
The Color plugin is used to write text in different colors:
* text
* text
* text
* text
====== Columns plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:columns|Columns plugin]] to be installed :!:
The Columns plugin is used to place text in multiple columns:
First column text (50% width).
Second column text.
Third column text.
====== Definition List plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:definitionlist|Definition List plugin]] to be installed :!:
See an example of a simple definition list:
; termA : definitionA
; termB : definitionB
; termC : definitionC
====== Emphasis plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:emphasis|emphasis plugin]] to be installed :!:
Some examples for changing the font color with the emphasis plugin: ::This should be green:: :::and yellow::: ::::and red:::: (if the default color set is used). And now the same for the background colors: ;;This should be green;; ;;;and yellow;;; ;;;;and red;;;;.
====== Exttab3 plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:exttab3|exttab3 plugin]] to be installed :!:
The exttab3 plugin makes it possible to change the look of your tables. Have a look at the example form the plugin page:
{| title="Extended Table Example"
|+//Extended Table Example//
! style="width: 12em;"| A1 Header
! style="width: 10em;"| B1 Header
|- style="background-color: MistyRose;"
|
{| title="nested table"
|+ //nested table//
|
{{ wiki:dokuwiki-128.png?50&nolink}}
**Lorem** ipsum dolor sit amet,
//consetetur// sadipscing elitr,
sed diam nonumy eirmod tempor invidunt
ut labore et dolore magna aliquyam erat,
sed diam voluptua.
|}
|
List in Cell
* //italic// and **bold**
* ''monospace''
* [[:start|page link]]
> quoting
**ATTENTION:**\\
Needs an extra empty line
after lists and quoting syntax!
|}
====== Filelist plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:filelist|filelist plugin]] to be installed :!:
The output generated by the filelist plugin is exported to ODT:
{{filelist>lib/images/*&style=table&direct=1&preview=1&link=0}}
====== Geotag plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:geotag|geotag plugin]] to be installed :!:
The geotag plugin allows a user to annotate pages with a geotag:
{{geotag>lat:51.565696, lon:5.324596}}
====== Keyboard plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:keyboard|keyboard plugin]] to be installed :!:
Key sequences generated with the keyboard plugin are exported to ODT, see the example from the plugin page:
This displays the keys ALT + H.
====== Math2/Mathpublish plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:mathpublish|mathpublish plugin]] to be installed :!:
The mathpublish plugin can be used to insert mathematical formulae. See some examples from the plugin page:
S(f)(t)=a_{0}+sum{n=1}{+infty}{a_{n} cos(n omega t)+b_{n} sin(n omega t)}
delim{lbrace}{matrix{3}{1}{{playground:3x-5y_z_0_sqrt_2_x-7y_8z_0_x-8y_9z_0}}}{ }
delim{|}{{1/N} sum{n=1}{N}{gamma(u_n)} - 1/{2 pi} int{0}{2 pi}{gamma(t) dt}}{|} <= epsilon/3
====== Mimetex plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:mimetex|mimetex plugin]] to be installed :!:
The mimetex plugin can be used to insert formulas which are also exported to ODT. See some examples from the plugin page:
\frac{3}{4 \pi} \sqrt{4 \cdot x^2 12}\\
\lim_{n \to \infty}
\sum_{k=1}^n \frac{1}{k^2} = \frac{\pi^2}{6}\\
\it{f}(x) = \frac{1}{\sqrt{x} x^2}\\
e^{i \pi} + 1 = 0\;
====== Note plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:note|note plugin]] to be installed :!:
The note plugin can be used to write little notes of different kinds. See this examples from the plugin page:
This is my note ! Remember it!!
Warning ! You're about to lose your mind ;-)
The clues are in the images.
Beware of the cat when you open the door !!
In ODT the notes are rendered as tables. This is why they loose their round corners after export to ODT.
====== Pagebreak plugin ======
:!: This example requires the [[https://www.dokuwiki.org/plugin:pagebreak|pagebreak plugin]] to be installed :!:
A manual pagebreak can be inserted with the following code: