≪ View 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
software:dokuwiki [2025/12/22 22:31] – diamondsoftware:dokuwiki [2026/01/07 08:33] (current) – add note on wrap plugin diamond
Line 11: Line 11:
 - Some inline Dokuwiki syntax are still supported. For example, the "Add image" button in the editor still works, even though it inserts Dokuwiki markup. - Some inline Dokuwiki syntax are still supported. For example, the "Add image" button in the editor still works, even though it inserts Dokuwiki markup.
 - Some Commonmark syntax are parsed incorrectly by the plugin. For example, list items with multiple text paragraphs are not supported. - Some Commonmark syntax are parsed incorrectly by the plugin. For example, list items with multiple text paragraphs are not supported.
-- You may add custom Dokuwiki markup into the space by opening a code block with a `dokuwiki` language. The [main page](/) utilizes this; just look at its source code.+- You may add custom Dokuwiki markup by opening a code block with a `dokuwiki` language. The [main page](/) utilizes this; just look at its source code. 
 +- The main editor is [TinyMDE](#tinymde), not Dokuwiki's default editor.
  
 ### Admonitions ### Admonitions
Line 23: Line 24:
 Here's the code for it: Here's the code for it:
  
-````+```
 > **Note:** Fire Warning > **Note:** Fire Warning
 > >
 > This device may catch fire. Use with caution. > This device may catch fire. Use with caution.
-````+```
  
 For this to work, the first text part of the blockquote must be a bold string (`**bold**`). The CSS will automatically style it like the above. For this to work, the first text part of the blockquote must be a bold string (`**bold**`). The CSS will automatically style it like the above.
 +
 +### TinyMDE
 +
 +We use [TinyMDE](https://github.com/jefago/tiny-markdown-editor) as the default page editor for Dokuwiki. This is done via custom userscripts that automatically replace the editor on load.
 +
 +If this is breaking for some reason, you may revert to the previous editor by adding `tinymde=no` to the query URL, e.g. `https://wiki.dma.space/page?do=edit&tinymde=no`.
 +
 +### Images
 +
 +TinyMDE's toolbar contains a custom image button that spawns the normal Media Manager dialog, but you won't be able to choose alignment, size and other parameters using this dialog. Instead, the dialog just lets you upload files and insert image links (in Markdown) to the editor.
 +
 +For reference:
 +
 +- To set the width of the image to 100, add `?100` to the end of the image URL.
 +- To set the height of the image to 100, add `?0x100` to the end of the image URL.
 +- To center the image, wrap it in a `<div centeralign>` block like you would in HTML. Note that this isn't actually HTML but rather custom Dokuwiki markup intermingling with Markdown.
 +
 +### Format using Prettier
 +
 +The sparkly button on the editor toolbar will format the entire page's source using Prettier as a Markdown file. **DO NOT run this if the page is written entirely in Dokuwiki markup.**
 +
 +It is recommended that you run this tool whenever you paste any Markdown snippet from outside.
 +
 +### Aligning Content
 +
 +We run the [Wrap plugin](https://www.dokuwiki.org/plugin:wrap), which lets you do layouting tricks, such as aligning images in the center:
 +
 +```
 +<div centeralign>
 +  ![](path/to/image.jpg)
 +</div>
 +```
 +
 +Refer to their documentation for more information.
  
 ## Namespacing ## Namespacing
Line 78: Line 113:
  
 These patchsets are maintained by a set of NixOS configurations. See [NixOS Boxes](/infrastructure/nixos-boxes) for more information. These patchsets are maintained by a set of NixOS configurations. See [NixOS Boxes](/infrastructure/nixos-boxes) for more information.
 +