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 [01 Aug 2020 07:29] – 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: %% \\ %%
- +
-If you do want wysiwyg. Go for it. But some things are still wiki markup, so you will still have to learn some markup (see below).+
  
 ===== Images ===== ===== Images =====
Line 36: 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 53: 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) +<code> 
-''_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) ''+>"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 84: 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 101: 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 107: 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 122: 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 172: Line 144:
 ===== Nützliches für den Editiermodus ===== ===== Nützliches für den Editiermodus =====
  
-  * **Keine Umbrüche verwenden**: Möglichst keine Umbrüche mit Enter erzeugen. Die Wiki soll das selbst regeln. Nur wenn wirklich ein Umbruch explizit gewünscht ist, kann er mit zwei Mal Enter forciert werden.  Zwei Backslashs eingeleitet und gefolgt von einem Leerzeichen haben ebenfalls einen Umbruch zur Folge.+  * **Keine Umbrüche verwenden**: Möglichst keine Umbrüche mit Enter erzeugen. Die Wiki soll das selbst regeln. Nur wenn wirklich ein Umbruch explizit gewünscht ist, kann er mit zwei Mal Enter forciert werden. Zwei Backslashs eingeleitet und gefolgt von einem Leerzeichen haben ebenfalls einen Umbruch zur Folge.
   * **<nowiki>** Text **</nowiki>**  : Text innerhalb eines Paares doppelter Sternchen wird fett formatiert   * **<nowiki>** Text **</nowiki>**  : Text innerhalb eines Paares doppelter Sternchen wird fett formatiert
   * Zwei Leerzeichen und ein * erzeugen einen unnummerierten Listenpunkt   * Zwei Leerzeichen und ein * erzeugen einen unnummerierten Listenpunkt
Line 185: 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 ==== 
 +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):  
 +^ command ^ looks like ^ meaning ^ 
 +| %%i_todo_icon%% |i_todo_icon |Something needs to be done. | 
 +| %%i_depr%% |i_depr | Correct information for a current version but a change is planned in the future.  |
  
 ==== folding ==== ==== folding ====
-<code>+we have two section toggle plugins installed:
  
 +the first one corresponds with the "fold/unfold all" button in the menu:
 +
 +<code>
 ++++ Title | ++++ Title |
  
Line 197: Line 188:
  
 ++++ ++++
 +</code>
 +
 +The second one does not, but is a bit more obviously styled:
 +<code>
 +<hidden my title>
 +content to be folded /unfolded.
 +</hidden>
  
 </code> </code>
  • wiki_kurzeinfuehrung.1596281395.txt.gz
  • Last modified: 01 Aug 2020 07:29
  • by lutz