== syntax2 @@hide@@ == ==== Footnotes ==== You can add footnotes .(footnote This is a footnote) ((This is a footnote)) \\ ==== Sectioning ==== You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled with .(notoc) .---- Headline Level 3\\ .--- Headline Level 4\\ .-- Headline Level 5\\ ==== Headline Level 3 ==== === Headline Level 4 === == Headline Level 5 == .rule # produce a horizontal line (rule) ---- ==== Media Files ==== You can include external and internal [[doku>images|images, videos and .onl audio files]] with curly brackets. Optionally you can specify the size of them. Real size: Resize to given width: Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): ): : Resized external image: Real size: Resize to given width: Resize to given width and height: Resized external image: By using :align left, right or middle you can choose the alignment.\\ ---- Of course, you can add a title (displayed as a tooltip by most browsers), too.\\ .(image dokuwiki-128.png This is the caption :align left)\\ For linking an image to another page see [[]] above.\\ ==== Supported Media Formats ==== ctDokuWiki can embed the following media formats directly. | Image | ''gif'', ''jpg'', ''png'' | | Video | ''webm'', ''ogv'', ''mp4'' | | Audio | ''ogg'', ''mp3'', ''wav'' | | Flash | ''swf'' | If you specify a filename that is not a supported media format, then it will be displayed as a link instead. By adding '' :linkonly t'' you provide a link to the media without displaying it inline This is just a link to the image. ==== Fallback Formats ==== Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. For example consider this embedded mp4 video: When you upload a ''video.webm'' and ''video.ogv'' next to the referenced ''video.mp4'',.green ctDokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser. Additionally.green ctDokuWiki supports a "poster" image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''video.jpg'' file would work. ==== Lists ==== Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.\\ * This is a list11 * 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 * This is a list22 .onl * The second item .onl * You may have different levels .onl * Another item .onl - The same list but ordered .onl - Another item .onl - Just use indention for deeper levels .onl - That's it .onl Also take a look at the [[doku>faq:lists|FAQ on list items]] .\\ ==== Text Conversions ==== ctDokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.\\ The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well.\\ ==== Text to Image Conversions ==== ctDokuWiki converts commonly used [[wp>emoticon]] s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in.green ctDokuWiki :\\ * 8-) %verb 8-) %% .onl * 8-O %% 8-O %% .onl * :-( %% :-( %% .onl * :-) %% :-) %% .onl * =) %% =) %% .onl * :-/ %% :-/ %% .onl * :-\ %% :-\ %% .onl * :-? %% :-? %% .onl * :-D %% :-D %% .onl * :-P %% :-P %% .onl * :-O %% :-O %% .onl * :-X %% :-X %% .onl * :-| %% :-| %% .onl * .onl * ^_^ %% ^_^ %% .onl * :?: %% :?: %% .onl * :!: %% :!: %% .onl * LOL %% LOL %% .onl * FIXME %% FIXME %% .onl * DELETEME %% DELETEME %% .onl ==== Text to HTML Conversions ==== Typography: [[..ctdw]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.\\ -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)\\ "He thought 'It's a man's world'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) .onl "He thought 'It's a man's world'..." .onl The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern|file]] .\\ There are three exceptions which do not come from that pattern file: multiplication entity (640x480),\\ 'single' and "double quotes". 'single' and double quotes. They can be turned off through a [[doku>config:typography|config|option]] . ==== Quoting ==== Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:\\ I think we should do it > No we shouldn't >> Well, I say we should > Really? >> Yes! >>> Then lets do it! I think we should do it .onl > No we shouldn't .onl >> Well, I say we should .onl > Really? .onl >> Yes! .onl >>> Then lets do it! .onl ==== Tables ==== ctDokuWiki supports a simple syntax to create tables.\\ ^ 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 | Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.\\ ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ .onl | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | .onl | Row 2 Col 1 | some colspan (note the double pipe) || .onl | Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 | .onl To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!\\ Vertical tableheaders are possible, too.\\ | ^ 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 | As you can see, it's the cell separator before a cell which decides about the formatting:\\ | ^ Heading 1 ^ Heading 2 ^ .onl ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | .onl ^ Heading 4 | no colspan this time | | .onl ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | .onl You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect.\\ ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | Row 2 Col 1 | ::: | Row 2 Col 3 | | Row 3 Col 1 | ::: | Row 2 Col 3 | Apart from the rowspan syntax those cells should not contain anything else.\\ ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ .onl | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | .onl | Row 2 Col 1 | ::: | Row 2 Col 3 | .onl | Row 3 Col 1 | ::: | Row 2 Col 3 | .onl You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both en`ds for centered text.\\ ^ Table with alignment ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | This is how it looks in the source:\\ ^ Table with alignment ^^^ .onl | right| center |left | .onl |left | right| center | .onl | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | .onl Note: Vertical alignment is not supported.\\