| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| guide [2025/08/13 22:56] – Valentine | guide [2025/10/07 17:31] (current) – external edit 127.0.0.1 |
|---|
| The built-in page editor is very helpful because it automatically generates the syntax you need without you needing to memorize it all. Hovering over each icon on the editor will tell you what it does. | The built-in page editor is very helpful because it automatically generates the syntax you need without you needing to memorize it all. Hovering over each icon on the editor will tell you what it does. |
| |
| === Basics === | ==== Basics ==== |
| |
| The first 5 buttons are **bold**, //italicize//, __underline__, ''monospace/"code" text'', and <del>strikethrough</del>. | The first 5 buttons are **bold**, //italicize//, __underline__, ''monospace/"code" text'', and <del>strikethrough</del>. |
| |
| === Headlines === | ==== Headlines ==== |
| |
| Headlines or "headings" are essentially the titles of each section. DokuWiki uses five headline sizes; the higher the number, the smaller the heading. | Headlines or "headings" are essentially the titles of each section. DokuWiki uses five headline sizes; the higher the number, the smaller the heading. |
| The "same level headline" button creates a new headline of the same size as the last headline you created. "Lower headline" creates one a size smaller, and "higher headline" creates one that is a size larger. "Select headline" lets you directly choose what size you want. | The "same level headline" button creates a new headline of the same size as the last headline you created. "Lower headline" creates one a size smaller, and "higher headline" creates one that is a size larger. "Select headline" lets you directly choose what size you want. |
| |
| === Links === | ==== Links ==== |
| |
| The "internal link" button opens a popup for you to automatically generate a link to any other page on your wiki. The "external link" creates the basic formatting of a link for you to edit: ''%%[[http://example.com|External Link]]%%''. Just replace the first half with the link, and the second half with the text. It will look something like this: [[https://www.youtube.com/watch?v=dQw4w9WgXcQ|link text]]. | The "internal link" button opens a popup for you to automatically generate a link to any other page on your wiki. The "external link" creates the basic formatting of a link for you to edit: ''%%[[http://example.com|External Link]]%%''. Just replace the first half with the link, and the second half with the text. It will look something like this: [[https://www.youtube.com/watch?v=dQw4w9WgXcQ|link text]]. |
| |
| There are also built in ways to link between wikis without having to type the URL out. ''%%[[wp>wiki|Wiki]]%%'' will create a link to Wikipedia's page on wikis. The portion before the ''>'' is the identifier. | ==== Lists ==== |
| | |
| The following identifiers can be used: | |
| * ''doku'' for DokuWiki's official documentation | |
| * ''wp'' for Wikipedia | |
| * ''abs'' for Absinthe Town | |
| * ''sd'' for [[sd>|Secret Dragon]] | |
| * ''debt'' for [[debt>|KISSKISSFALLINDEBT]] | |
| | |
| === Lists === | |
| |
| "Ordered" and "unordered" lists are identical, except the former uses numbers and the latter uses bullet points. | "Ordered" and "unordered" lists are identical, except the former uses numbers and the latter uses bullet points. |
| |
| |
| === Horizontal Rule === | ==== Horizontal Rule ==== |
| |
| The "horizontal rule" adds a line across the screen to separate sections. | The "horizontal rule" adds a line across the screen to separate sections. |
| |
| ===== Special Syntax ===== | ===== Special Syntax ===== |
| There are some things that you have to do by hand instead of using the editor. These are tables and certain things I have added via plugins instead of being built into DokuWiki. | There are some things that you have to do by hand instead of using the editor. These are tables, more advanced versions of the above, and certain things I have added via plugins instead of being built into DokuWiki. |
| |
| ===== Tables ===== | ==== Inter-Wiki Links === |
| | |
| | There are built in ways to link between wikis without having to type the URL out completely. ''%%[[wp>wiki|Wiki]]%%'' will create a link to Wikipedia's page on wikis. The portion before the ''>'' is the identifier. |
| | |
| | The following identifiers can be used: |
| | * ''doku'' for DokuWiki's official documentation |
| | * ''wp'' for Wikipedia |
| | * ''abs'' for Absinthe Town |
| | * ''sd'' for [[sd>|Secret Dragon]] |
| | * ''debt'' for [[debt>|KISSKISSFALLINDEBT]] |
| | ==== Tables ==== |
| |
| **Note: I have copied this off of the [[wiki:syntax#tables|syntax guide]] with some small modifications.** Unlike the rest of this page, this is mostly not my own writing. | **Note: I have copied this off of the [[wiki:syntax#tables|syntax guide]] with some small modifications.** Unlike the rest of this page, this is mostly not my own writing. |
| ''%%{{gallery>:namespace:file.jpg}}%%'' | ''%%{{gallery>:namespace:file.jpg}}%%'' |
| |
| | There is a way to add captions to images (to credit an artist, for example) but it is slightly more advanced. I recommend reading the [[doku>plugin:gallery|gallery extension's documentation]] to learn how to use it. |
| | ==== Tags ==== |
| | Tags are a great and simple way to organize your pages. |
| | |
| | To add tags to a page, use this formatting: ''%%{{tag>example_tag example-tag exampletag example tag}}%%'' |
| | Put a space in between each tag to separate them. |
| | |
| | Underscores will be interpreted as spaces, while dashes will not. Capitalization does not affect anything, so ''exampletag'' and ''exampleTag'' will be interpreted as the same tag. Because this plugin was written primarily for use by English speakers, accents also do not affect anything; ''león'' and ''leon'' will also be considered the same tag. |
| | |
| | It will look something like this: |
| | {{tag>example_tag example-tag exampletag example tag}} |
| | |
| | To see all the pages with a particular tag, just click on the tag you want to look at. If you click on ''exampletag'' or ''example'', you will see a demo page with the tags ''exampleTag'' and ''éxamplé'' to show that they are still considered the same. |
| | |
| | I recommend adding this to the very top or very bottom of the page. |
| | |
| | More complex tagging features are explained by the extension's [[doku>plugin:tag|documentation]]. |
| ==== Comments ==== | ==== Comments ==== |
| |