Differences

This shows you the differences between two versions of the page.

--- wiki:syntax [2021/10/19 04:58] – added cheat sheet, note about html being disabled atari
+++ wiki:syntax [2024/02/15 23:10] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== DokuWiki Syntax ======
+====== Formatting Syntax ======
-This wiki is powered by the DokuWiki framework, the manual for which can be found on [[https://www.dokuwiki.org/manual|their external website]]. The basic markup syntax used for editing pages can be found [[https://www.dokuwiki.org/wiki:syntax|here]]. You can look at the source of the page by clicking the "Show page source" button on the right side of the page. This button changes to the "Edit this page" button when signed in with an editor's account. If you'd like to get an editor's account, please ask in [[https://discord.com/invite/JXhfRTr|our Discord server]].
+[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
-If you'd like to play around with code to see how it behaves on the actual page, please use the [[playground:playground|playground page]]. You can also preview your page before posting the changes by clicking "Preview" next to the "Save" button. This is also how you refresh your lock timer (if you've become inactive while editing a page). Some common markup functions are contained in the toolbar at the top of the edit page. This is also where you'll find the "Add images and other files" button to add media to your page.
-You can check out our guide to good Wiki editing-practices [[wiki:wiki-editing-practices|over on its own page]].
-Below is a static copy of the aforementioned syntax page for reference (may become outdated over time).
 ===== Basic Text Formatting =====
@@ Line 132: / Line 126: @@
 ----
-<code>
-----
-</code>
 ===== Media Files =====
@@ Line 147: / Line 137: @@
 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)): {{wiki:dokuwiki-128.png?200x50}}
-Resized external image:           {{https://secure.php.net/images/php.gif?200x50}}
+Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
   Real size:                        {{wiki:dokuwiki-128.png}}
   Resize to given width:            {{wiki:dokuwiki-128.png?50}}
   Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}}
-  Resized external image:           {{https://secure.php.net/images/php.gif?200x50}}
+  Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
@@ Line 257: / Line 247: @@
   * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%
+  * m(  %%  m(   %%
   * :?: %%  :?:  %%
   * :!: %%  :!:  %%
@@ Line 413: / Line 404: @@
 ==== Syntax Highlighting ====
-DokuWiki can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
+[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
 <code java>
@@ Line 446: / Line 437: @@
 If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
-===== Embedding HTML and PHP =====
-<WRAP center round important>
-Currently disabled on this wiki.
-</WRAP>
-You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.)
-HTML example:
-<code>
-<html>
-This is some <span style="color:red;font-size:150%;">inline HTML</span>
-</html>
-<HTML>
-<p style="border:2px dashed red;">And this is some block HTML</p>
-</HTML>
-</code>
-<html>
-This is some <span style="color:red;font-size:150%;">inline HTML</span>
-</html>
-<HTML>
-<p style="border:2px dashed red;">And this is some block HTML</p>
-</HTML>
-PHP example:
-<code>
-<php>
-echo 'The PHP version: ';
-echo phpversion();
-echo ' (generated inline HTML)';
-</php>
-<PHP>
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td>'.phpversion().'</td>';
-echo '</tr></table>';
-</PHP>
-</code>
-<php>
-echo 'The PHP version: ';
-echo phpversion();
-echo ' (inline HTML)';
-</php>
-<PHP>
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td>'.phpversion().'</td>';
-echo '</tr></table>';
-</PHP>
-**Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.
 ===== RSS/ATOM Feed Aggregation =====
@@ Line 510: / Line 446: @@
 | author     | show item authors names |
 | date       | show item dates |
-| description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped |
+| description| show the item description. All HTML tags will be stripped |
 | nosort     | do not sort the items in the feed |
 | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
@@ Line 538: / Line 474: @@
 ~~INFO:syntaxplugins~~
-===== Cheat sheet =====
-  [[URL|Display text]]
-  [[wp>wikipedia-title|Display text]]
-  {{URL-to-image|Alt text}}
-  {{URL-to-video?655x368|Alt text}}
-  ->
-  **Bold text**
-  //Italicised text//
-  ''Path/to/file''
-  %%Unformatted text%%
-    * Unordered list
-    * Second bullet
-    - Ordered list
-    - Second number
-  ''%%--command [option1] [option2]%%''
-  {{:wiki:north.png?nolink&20|North button (X SNES)}}
-  {{:wiki:west.png?nolink&20|West button (Y SNES)}}
-  {{:wiki:south.png?nolink&20|South button (B SNES)}}
-  {{:wiki:east.png?nolink&20|East button (A SNES)}}
-  {{:switch-button.png?20|On/Off Settings}}
-  {{:switch-slider.png?30|Slider Settings}}
-  <code xml file.txt>
-  Here is my unformatted code.
-  </code>
-  <WRAP group>
-  <WRAP half column>
-  First column content.
-  </WRAP>
-  <WRAP half column>
-  Second column content.
-  </WRAP>
-  </WRAP>
-  ^ Header 1 ^ Header 2 ^ Header 3 ^
-  ^ Header 4 | Table content | Table content |
-  --> Click here to expand
-  Collapsed content here.
-  <--
-  <code>
-  roms/
-  ├─ psx/
-  │  ├─ Final Fantasy VII (Disc 1).cue
-  │  └─ Final Fantasy VII (Disc 1).bin
-  └─ Final Fantasy VII (Disc 1).m3u
-  </code>
-For info and generic syntax: https://www.dokuwiki.org/wiki:syntax
-For info about WRAPS: https://www.dokuwiki.org/plugin:wrap