Differences

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

--- start [2025/05/20 07:10] – wikiadmin
+++ start [2025/05/30 09:22] (current) – [Key points about DokuWiki markup (how it does formatting), and differences from MediaWiki markup] wikiadmin
@@ Line 5: / Line 5: @@
   * [[Treasurer|How FSGW handles money]]
   * [[policies|FSGW Bylaws and Policies]]
-  * [[website|Website (fsgw.org, database, fsgw2.org, Google workspace)]]
+  * [[website|Websites and cloud (fsgw.org, database, fsgw2.org, Google workspace)]]
   * [[futureoffsgw|Future of FSGW]]
   * [[staff:information|Board and Staff Information]]
 ====Wiki help====
+  * [[howtofind|What is in this wiki? How can I find things?]]
+  * [[howtouse|How should FSGW use this wiki?]]
   * [[wiki:syntax|DokuWiki Formatting Syntax guide (a good place to start)]]
   * A great way to see how markup (Formatting) works is to look at pages in this wiki. Find a page that looks like what you want, then click on the "**Edit this page**" pencil icon, at the top of the 4 blue icons along the right page border. That will show you the markup for the page. Try to understand how it works, so you can imitate it. When done, click on "**Cancel**" to leave it unchanged.
-  * link to [[playground:playground|a playground page you can safely experiment in]]
+  * Link to [[playground:playground|a playground page you can safely experiment in]]
   * [[https://www.dokuwiki.org/manual|DokuWiki Manual (detailed)]]
   * [[wiki:dokuwiki|DokuWiki Resources and Installation Guide]]
@@ Line 20: / Line 22: @@
 DokuWiki markup looks similar to MediaWiki markup (used in [[https://www.wikipedia.org/|WikiPedia]]), but it actually differs in a number of ways.
-  - Headings (headlines) are defined by equal signs (like '**%%=====%%**Heading**%%=====%%**'), but they may ONLY contain text. Especially, links are NOT allowed in Headings, while MediaWiki does allow links there. (Info on why is here: https://www.dokuwiki.org/faq:headerlinks)
+  - Headings (headlines) are defined by equal signs (like '**%%=====%%**Heading**%%=====%%**'), but they may ONLY contain text. Especially, links are NOT allowed in Headings, unlike MediaWiki which does allow links. (Info on why is here: https://www.dokuwiki.org/faq:headerlinks)
   - More '**=**'s makes BIGGER heading text, not smaller. I use 4, 5, and 6 '**=**'s for small, medium, and large (top of page) headings, what would be 3, 2, and 1 '**=**'s in MediaWiki.
   - The characters to start a list item are star (**%%*%%**) for unnumbered, and dash (**-**) for numbered (NOT '#'). They **MUST** be indented by 2 spaces, will **NOT** work at the left margin. For each further list indent, add 2 more leading spaces, NOT another star or dash. [[https://www.dokuwiki.org/faq:lists|Working with Lists]]
-  - To display text without wrapping it into paragraphs, for example text copied from a terminal or an email, use **%%<text>%%**your text**%%</text>%%**. Uppercase **%%<TEXT>%%**your text**%%</TEXT>%%** does the same and draws a box around it.
+  - To display text without wrapping it into paragraphs, for example text copied from an email or a terminal, use **%%<text>%%**your text**%%</text>%%**. Uppercase **%%<TEXT>%%**your text**%%</TEXT>%%** does the same and draws a box around it.
-  - To force a new line, use '**\\**' at the end of a line, or '**%%\\ %%**' in the  middle of a line (note the required trailing whitespace).  An empty line acts as a paragraph separator, which causes a new line followed by an empty line.
+  - To force a new line, use '**%%\\%%**' at the end of a line, or '**%%\\ %%**' in the middle of a line (note the required trailing space). An empty line acts as a paragraph separator, which causes a new line followed by an empty line.
+  - To force a new line after a list item requires 2 new lines, so add '**%%\\ \\%%**' at the end of the list item.
   - To prevent characters from being interpreted as markup, bracket them with a pair of percent signs (**%**) on each end.
   - There is no Page Title stored outside of the page markup, unlike MediaWiki. FSGW has DokuWiki configured to use the first Headline on each page as that pages title. If you need to override that, you can put "**~~Title:**Desired Page Title**~~**" at the top of the page markup.
   - Links are defined as: %%[[<URL>|description to display]]%%, for example: %%[[https://fsgw.org|FSGW website]]%%
-  - External (outside the wiki) links will open in a new tab. This is a configuration choice we made in DokuWiki.
+  - External (outside the wiki) links will open in a new tab. This is a configuration choice FSGW made in DokuWiki.
-  - A basic MediaWiki to DokuWiki markup converter is: https://www.vertopal.com/en/convert/wiki-mediawiki-to-dokuwiki
+  - The page editing window can easily be expanded vertically.  Click on the fat down and up arrows below the bottom right corner of the editing window, to vertically expand or contract the editing window somewhat at each click. This size change is saved from edit to edit in that tab.\\ For a temporary change, hover your mouse cursor just inside the bottom right corner of the editing window, move it around until it becomes a horizontal line with up and down arrows. Click and hold as you move the mouse cursor to where you want the bottom right corner of the editing window to be. This can also narrow or widen the editing window.
+  - A basic MediaWiki to DokuWiki markup converter is: [[https://www.vertopal.com/en/convert/wiki-mediawiki-to-dokuwiki]]