wiki_kurzeinfuehrung

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
wiki_kurzeinfuehrung [17 Feb 2021 14:16] – [folding] lutzwiki_kurzeinfuehrung [04 Mar 2022 15:09] (current) – [new line] lutz
Line 1: Line 1:
 ====== Wiki Kurzeinführung ====== ====== Wiki Kurzeinführung ======
  
-===== The new wysiwyg editor ===== 
  
-First of all: If you don't want to use it, you find a "dw edit" icon in the menu bar to the right (the pen). It opens the wiki with the classic text editor.\\ +===== new line ===== 
-You can also double click on any section you want to change and the section opens in the text editor. +Most important for wikis: How to tell the Wiki to make a new line. \\ Use a double backslash with spaces around it: %% \\ %%
- +
-In the text editor you will also find buttons to switch between "dw edit" (that's the classic editor) and "ckg edit" - the wysiwyg editor. Hitting one of those buttons leaves the edit mode and next time you edit the chosen editor will open. +
- +
-If you do want wysiwyg - go for it. But many things still need wiki markup, so you will still have to learn some markup (see below). E.g. if you want to use the imagebox feature that adds a caption to an image, you do have to do it old school. Perhaps a mix of both makes some sense.+
  
 ===== Images ===== ===== Images =====
Line 38: Line 33:
  
 ===== Formatierungen ===== ===== Formatierungen =====
- +Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, <sup>1</sup>2007, <sup>2</sup>2009. 
-Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, <sup>1</sup>  2007, <sup>2</sup>  2009.+
 <code> <code>
-Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, <sup>1</sup>2007, <sup>2</sup>2009. +Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, <sup>1</sup>2007, <sup>2</sup>2009. 
 </code> </code>
 +You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-You can use <sub>subscript</sub> and <sup>superscript</sup>  , too. +  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-<code> +
-You can use <sub>subscript</sub>  and <sup>superscript</sup> , too. +
- +
-</code>+
  
 ===== No Formatting ===== ===== No Formatting =====
Line 55: Line 45:
 If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''. If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
  
-<nowiki> This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. </nowiki> The same is true for <nowiki>//__this__ text// with a smiley ;-)</nowiki>. 
- 
-<code> 
 <nowiki> <nowiki>
 This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
 </nowiki> </nowiki>
-The same is true for <nowiki>//__this__ text// with a smiley ;-)</nowiki>.+The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-</code>+  <nowiki> 
 +  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. 
 +  </nowiki> 
 +  The same is true for %%//__this__ text// with a smiley ;-)%%.
  
 === Zitate - Quotes === === Zitate - Quotes ===
- +>"Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein." (S. 17 unten) \\ 
-_QUOT__ckgedit>Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein." (S. 17 unten) ''_QUOT''__''_GESHI_QUOT__Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein.__GESHI>_ (S. 17 unten) ''+<code> 
 +>"Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein." (S. 17 unten) \\ 
 +</code>
 ===== Tabellen - Tables ===== ===== Tabellen - Tables =====
- 
 You can have rowspans (vertically connected cells) by adding '':::'' into the cells below the one to which they should connect. 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. 
-<code> 
  
 ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
Line 85: Line 68:
 | Row 3 Col 1    | :::                        | Row 2 Col 3        | | Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-</code>+Apart from the rowspan syntax those cells should not contain anything else. 
 + 
 +  ^ 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        |
  
 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 ends for centered text. 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 ends for centered text.
- 
-^  Table with alignment  ^^| 
-|  right|  center  |left  | 
-|left  |  right|  center  | 
-|xxxxxxxxxxxx|xxxxxxxxxxxx|xxxxxxxxxxxx| 
- 
-This is how it looks in the source: 
-<code> 
  
 ^           Table with alignment           ^^^ ^           Table with alignment           ^^^
Line 102: Line 82:
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-</code>+This is how it looks in the source: 
 + 
 +  ^           Table with alignment           ^^^ 
 +  |         right|    center    |left          | 
 +  |left          |         right|    center    | 
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
 Note: Vertical alignment is not supported. Note: Vertical alignment is not supported.
Line 108: Line 93:
 ===== Links ===== ===== Links =====
  
-  * **simple link to a page:**  <nowiki>[[name of the wiki page|optional text for the link]]</nowiki> * **link to a section within the same page:**  <nowiki>[[#name of the section|optional text for the link]]</nowiki> * **link to a section of a different wiki page:**  <nowiki>[[name of the wiki page#name of the section|optional text for the link]]</nowiki> * **link to the www:**  <nowiki>[[url|optional text for the link]]</nowiki> i_tip_icon use the button with the chain and the globe to select and insert a link using a helpful dialog.+  * **simple link to a page:**  <nowiki>[[name of the wiki page|optional text for the link]]</nowiki>  
 +  * **link to a section within the same page:**  <nowiki>[[#name of the section|optional text for the link]]</nowiki>  
 +  * **link to a section of a different wiki page:**  <nowiki>[[name of the wiki page#name of the section|optional text for the link]]</nowiki>  
 +  * **link to the www:**  <nowiki>[[url|optional text for the link]]</nowiki> i_tip_icon use the button with the chain and the globe to select and insert a link using a helpful dialog.
 ===== Tag ===== ===== Tag =====
 <code> <code>
Line 123: Line 111:
   * with namespaces: ''<nowiki>{{tag>ns1:tag1 ns1:tag2 ns2:subns1:tag3}}</nowiki>''   * with namespaces: ''<nowiki>{{tag>ns1:tag1 ns1:tag2 ns2:subns1:tag3}}</nowiki>''
  
-==== Topic ==== 
-<code> 
- 
-{{topic>[tag]&[flags]}} 
- 
-</code> 
- 
-^[tag]|the category tag for which you want a list of pages|required| 
-^[flags]|pagelist flags delimited by ''&'', see [[:pagelist#flags|flags]]|optional| 
- 
-Example: 
  
-  * ''<nowiki>{{topic>tag1 -tag2}}</nowiki>''  – Lists all pages tagged with tag1 but not with tag2. 
-  * ''<nowiki>{{topic>tag1 +tag2}}</nowiki>''  – Lists all pages tagged with tag1 and tag2. 
-  * ''<nowiki>{{topic>tag1 tag2}}</nowiki>''  – Lists all pages tagged with either tag1 or tag2 or both. 
-  * ''<nowiki>{{topic>ns1?tag1 tag2}}</nowiki>''  – List all pages inside namespace ns1 tagged with either tag1 or tag2 
-  * ''<nowiki>{{topic>.?tag1 tag2}}</nowiki>''  – List all pages inside the current namespace tagged with either tag1 or tag2 
-  * ''<nowiki>{{topic>tag1 tag2 tag3&nodate&desc&sort}}</nowiki>''  (Adding [[:plugin:pagelist|]] options to change the design) 
 ==== Count ==== ==== Count ====
 <code> <code>
Line 186: Line 157:
 Syntax Highlighting Syntax Highlighting
  
-DokuWiki can highlight sourcecode, which makes it easier to read. It uses the 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> or <file java></nowiki>.+DokuWiki can highlight sourcecode, which makes it easier to read. It uses the 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> or <file java></nowiki>.
  
 +=== sxh syntax highlighter ===
 +Another option is:
 +<code> 
 +<sxh [brush][; options]>
 +... code/text ...
 +</sxh>
 +</code>
 +and the brushes are here: [[https://github.com/crazy-max/dokuwiki-plugin-syntaxhighlighter4]].
 +Most importantly it does support powershell and typescript. And it does look a bit more appealing, I think.
 ==== icons and labels ==== ==== icons and labels ====
 The smiley button in the editor shows a selection of icons. But you can also just type the label's name into the editor. Some labels should be used only for a certain purpose (we search for them):  The smiley button in the editor shows a selection of icons. But you can also just type the label's name into the editor. Some labels should be used only for a certain purpose (we search for them): 
  • wiki_kurzeinfuehrung.1613589362.txt.gz
  • Last modified: 17 Feb 2021 14:16
  • by lutz