meta data for this page
  •  

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wiki:contribution_guide [2026/04/24 10:59] – dorepswiki:contribution_guide [2026/05/10 19:27] (current) – external edit 127.0.0.1
Line 6: Line 6:
 So, let's get started with what can be helpful in this next step. So, let's get started with what can be helpful in this next step.
 ===== Benefits of Registration ===== ===== Benefits of Registration =====
 +Why register? ++++Click here.|
  
 +Discuss and ...
 +  * List benefits here
 +  * Media Uploads: Mentions that only registered users can upload images to the media manager.
 +  * Subscription Services: Explains the ability to "Subscribe" to namespaces or pages to receive email notifications when changes occur.
 +  * User Profile: Mentions the ability to track personal contributions via the "Recent Changes" or user profile link.
 +++++
 ===== Navigation Around the Wiki ===== ===== Navigation Around the Wiki =====
-There are many aids available with uiTLM to research and find areas of interest related to the Total Launcher application. Learn more ++++below.|This is where the more would be added like+There are many aids available with uiTLM to research and find areas of interest related to the Total Launcher application. Learn more ++++below.|This is where more would be added like...
 ==== Search ==== ==== Search ====
 ==== Left Sidebar ==== ==== Left Sidebar ====
 +Sitemap: Suggests including the "Sitemap" as a primary navigation tool for viewing the entire namespace hierarchy.
 +
 ==== Right Sidebar ==== ==== Right Sidebar ====
 ==== Toby Quick Help ==== ==== Toby Quick Help ====
 +  * Toby Quick Help: Defines this tool more clearly. If it is an AI assistant or a specific plugin, the functional interaction should be described (e.g., "Accesses the automated assistance tool...").
 ++++ ++++
 ===== Wiki Concepts: Getting Started ===== ===== Wiki Concepts: Getting Started =====
Line 43: Line 53:
       * Click the red URL       * Click the red URL
       * A new page will open ready for text entry.       * A new page will open ready for text entry.
 +
 +== Case Sensitivity ==
 +  * While DokuWiki converts pagenames to lowercase, the server system for uiTLM is case-sensitive:
 +    * **Lower Case**: **All filenames** for pages created, media, and internal/external links
  
 <WRAP center round tip> <WRAP center round tip>
Line 60: Line 74:
     * If it looks acceptable tap **Save**     * If it looks acceptable tap **Save**
     * or scroll up to the editing window to make more changes     * or scroll up to the editing window to make more changes
-    * Forgetting to **Save* will cause a notification to pop-up and ask +    * Forgetting to **Save** will cause a notification to pop-up and ask 
       * "Leave site? Changes to your page will not be saved"       * "Leave site? Changes to your page will not be saved"
       * Tap ''Cancel'' to return to the editing page (scrolling to the editing location may be necessary)       * Tap ''Cancel'' to return to the editing page (scrolling to the editing location may be necessary)
Line 67: Line 81:
 > **A Supporting Note:** DokuWiki is "Plain Text" first. Even if the formatting looks messy in the editor, the final page will look clean and professional! > **A Supporting Note:** DokuWiki is "Plain Text" first. Even if the formatting looks messy in the editor, the final page will look clean and professional!
 ++++ ++++
 +After becoming acquainted with Wiki Concepts and Syntax visit the **Playground** namespace where new users can practice syntax without affecting live documentation. Navigate there in either of 2 ways:
 +  - If registered, the **left sidebar** offers
 +    * **Sitemap**: Click the item ''Sitemap''
 +    * A listing of all namespaces will scroll (alphabetical order)
 +    * **Playground**: Click ''Playground'' and the namespace will open to list all pages
 +    * **Playground Page**: Click ''Playground'' to open the page ... Enjoy!
 +  - Use this link to navigate there directly: [[:playground:playground|Playground]]
 +
 ---- ----
  
 ===== DokuWiki Syntax: The Essentials ===== ===== DokuWiki Syntax: The Essentials =====
  
-Welcome! DokuWiki is designed to be simple. You don't need to learn complex code; you just "wrap" your text in a few special characters.+DokuWiki is designed to be simple. There is no need to learn complex code ... just "wrap" text in a few special characters. To learn more ++++click here.|
  
 ==== Headings ==== ==== Headings ====
Line 79: Line 101:
   * ==== Sub-Section ====   * ==== Sub-Section ====
  
-Headings use equals signs `=`. The more equals signs you use, the **larger** or **higher** the heading. The '=' must start on the left margin.+Headings use equals signs `=`. 
 +  * The more equal signs used, the **larger** or **higher** the heading. The '=' must start on the left margin. 
 +<WRAP indent>
   * `====== Top Level Title ======` (Main page title)   * `====== Top Level Title ======` (Main page title)
   * `===== Section Title =====`   * `===== Section Title =====`
   * `==== Sub-Section ====`   * `==== Sub-Section ====`
 +</WRAP>
  
 ==== Formatting Text ==== ==== Formatting Text ====
Line 95: Line 119:
   * **New Paragraph:** Press **Enter twice** to leave a blank line. This is the best way to keep text readable.   * **New Paragraph:** Press **Enter twice** to leave a blank line. This is the best way to keep text readable.
   * **Forced New Line:** If you want to drop to the next line without starting a new paragraph, type two backslashes followed by a space: ''\\ ''   * **Forced New Line:** If you want to drop to the next line without starting a new paragraph, type two backslashes followed by a space: ''\\ ''
-  * **The "SprintDoc" Rule:** Always leave a blank line before and after a list, table, or code block to ensure the layout doesn't "break." +<WRAP centered round tip> 
- +<WRAP centeralign>**Special Note for the "SprintDoc" Template**</WRAP> 
-==== Lists ==== +  - **Save often:** The preview button is your best friend. 
-**Important:** You must start a list item with **two spaces**. +  - **Whitespace matters:** Always leave one empty line between a paragraph and a list or table to make sure the "SprintDoc" template displays everything perfectly. 
-  * Bullet points use an asterisk: ''  * Item'' +</WRAP>
-  * Numbered lists use a dash: ''  - Item'' +
- +
-==== Links ==== +
-To link to another page or a website, use double square brackets. +
-  * Internal: ''[[pagename]]'' +
-  * Internal with custom name: ''[[pagename | Clickable Text]]'' +
-  * External: ''[[https://google.com | Google]]'' +
- +
-==== Images ==== +
-Use curly braces to show an image. +
-  * Standard: ''{{image.png}}'' +
-  * Resized (50px wide): ''{{image.png?50}}'' +
- +
-==== Simple Tables ==== +
-Tables use the pipe ''|'' for regular cells and the caret ''^'' for headers. +
- +
-^ Header 1 ^ Header 2 ^ +
-| Content A | Content B | +
-| Content C | Content D | +
- +
-  & *Pro Tip:** Always leave one empty line between a paragraph and a list or table to make sure the "SprintDoc" template displays everything perfectly. +
-   +
- +
----- +
- +
-Here is a simplified "Cheat Sheet" focusing on the essentials that will be used **90%** of the time. +
- +
-==== Headings ==== +
- +
-Headings use equals signs `=`. The more equals signs you use, the **larger** or **higher** the heading. The '=' must start on the left margin. +
-  * `====== Top Level Title ======` (Main page title) +
-  * `===== Section Title =====` +
-  * `==== Sub-Section ====` +
-  ***Tip:** DokuWiki automatically creates a Table of Contents if there areat least three headings on a page. +
- +
------ +
- +
-==== Text ==== +
-Think of these as "wrappers" around the words. +
-  * **Bold:** `**Double Asterisks**` +
-  * **//Italic//:** `//Double Slashes//` +
-  * **__Underline__:** <code>__Underscores__</code> +
-  * **''Monospaced'':** <code>''Double Single-Quotes''</code> (Great for file paths or Tasker variables!) +
- +
------+
  
 ==== Lists ==== ==== Lists ====
 Building lists is all about the **indentation** and **steps**. Building lists is all about the **indentation** and **steps**.
-  * For bullet point: Use **two spaces** from the left margin and an **asterisk** '*' +  * For bullet point: Use **two spaces** from the left margin and an **asterisk** "'*'' 
-  * For numbered list: Use **two spaces** from the left margin and a **dash** '-'+  * For numbered list: Use **two spaces** from the left margin and a **dash** ''-''
   * To create further indentation for either: add 2 more spaces to the previous **indentation**   * To create further indentation for either: add 2 more spaces to the previous **indentation**
 +<WRAP indent>
   * First bullet item   * First bullet item
   * Second bullet item   * Second bullet item
Line 157: Line 136:
   - First numbered item   - First numbered item
   - Second numbered item   - Second numbered item
 +</WRAP>
  
------+==== Links ==== 
 +To link to another **page**, a **section** on the eisting or other page or a **website**, use opening and closing  double square brackets around the pagename 
 +  * Internal: <code>[[pagename]]</code> 
 +  * Internal with custom name: <code>[[pagename | Clickable Text]]</code> 
 +  * External: <code>[[https://google.com | Google]]</code>
  
-==== File Paths ==== +=== Media ===
-Linking is the "Wiki" part of DokuWiki. To another page (called a namespace) or to a part of the same page (called a section). Full paths **do not** use backslashes (\) and Windows or Android, but **do use** colons (:) with the single colon meaning root and a following subfolder (namespace) using a colon (:) between the two.+
  
-^  In Windows or Android filename  ^  In Dokuwiki a .txt or .png  ^ +To display any media use opening and closing curly braces (''{{...}}'') 
-|  \root\subdirectory\filename.ext  |  :root_namespace:sub_namespace:text_filename (not extension needed for .txt (text files)  |+  * Images (PNG, jpg gif, webp) 
 +  * Video (animated gifs  mp4((mp4 format is discouraged due to file size))), use curly braces. 
 +  * All  media on a page must be located in the ''medi'' namespace  
 +  * Media for a page is to be located in page namespace for the media 
 +  *  **Example**: write about a fish and insert a fish.webp. The page is fish.tx 
 +    * The fish lives in a "pond" (namespace/folder) 
 +    * The link would be ''{{:media:pond:fish:fish.webp}}''
  
-==== Links: To Pages or Sections on the Same Page ==== +  * ''{{namespace:filename.ext}}'' 
-  * **Internal Link within the wiki:**  +  * ''{{wiki:logo.png}}'' — Displays the image at its original size. 
-    * To the same page and section heading '== XYZ ==' <code>[[:pagename#XYZ]]</code> or <code>[[:pagename#XY|Viewable Clickable Text]]</code> +  * ''{{wiki:logo.png?50}}'' — Displays the image at **50 pixels** wide (resizing made easy).
-  * **External Link outside the wiki:** <code>[[https://google.com | Link to Google]]</code> would show as [[https://google.com | Link to Google]] +
- +
------ +
- +
-=== Media (Images) === +
- +
-To display an image, use curly braces. +
- +
-  * '{{namespace:filename.ext}}' +
-  * `{{wiki:logo.png}}` — Displays the image at its original size. +
-  * `{{wiki:logo.png?50}}` — Displays the image at **50 pixels** wide (resizing made easy). +
- +
------+
  
 === Simple Tables === === Simple Tables ===
  
-Tables are built using vertical bars `|` for (cells) and carets for `^` (headers). Alignment can be specific **for each cell or heading**: To center contents leave 2 spaces between the beginning and ending cell or header marker, otherwise leave 1 space for left aligned entries.+Tables are built using vertical bars ''|'' for (cells) and carets for ''^'' (headers). Alignment can be specific **for each cell or heading**:  
 +  * To **center** contents leave 2 spaces between the beginning and ending cell or header marker,  
 +  * leave 1 space for left aligned entries.
  
 | Goal |  Syntax  | | Goal |  Syntax  |
-| **Header Row** | `^ Header 1 ^ Header 2 ^` | +^  **Header 1**  ^  **Header 2**  ^ 
-| **Standard Row** | `| Content 1 | Content 2 || +| Content A | |  Content B  | 
- +++++ 
------ +<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>
- +
-=== Special Note for the "SprintDoc" Template === +
- +
-  - **Save often:** The preview button is your best friend. +
-  - **Whitespace matters:** Always leave a blank line between a paragraph and a list or a table to ensure it renders correctly. +
- +
----- +
- +