Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
author_tips [2019/05/07 16:10] – Add YouTube link info and tag guidelines espiegel123 | author_tips [2020/02/07 06:53] (current) – Updated tags _ki | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Author Tips ====== | ====== Author Tips ====== | ||
+ | This page contains helpful tips and conventions for Audiobus Wiki contributors. Please give it a quick review. | ||
- | This page contains helpful tips for wiki contributors. | + | Want to get deeper? There are more articles related to Audiobus Wiki authoring [[wiki:|here]]. These articles include tutorials about particular authoring tasks and information about non-basic features that are available to wiki authors. |
- | ===== Page Links ===== | + | SEE ALSO: [[wiki: |
+ | ===== Creating | ||
Links to wiki and external pages are easy to create by typing manually or by using the handy tools in the editing toolbar. | Links to wiki and external pages are easy to create by typing manually or by using the handy tools in the editing toolbar. | ||
Line 10: | Line 12: | ||
**For pages on this wiki**, please use local links rather than URLs. | **For pages on this wiki**, please use local links rather than URLs. | ||
+ | |||
+ | ===== Creating New Pages ===== | ||
+ | To create a new page with the Add New Page tool: click on the Add New Page icon that appears in the page header and enter a page name. The actual location and appearance depends on the device and browser. | ||
+ | |||
+ | To create a new playground page: click on the Add New Page icon and type " | ||
+ | |||
+ | Creating new pages from links: it can be convenient to create a link to a page you plan to create. When you are viewing a page with a link to a non-existent page, clicking on the link gives you a chance to create it. For example, you might enter < | ||
+ | ===== Page Structure ===== | ||
+ | |||
+ | By convention, Dokuwiki pages should have a heading at the top of the page followed by some introductory or summary text. The headline should serve as the article title. This convention is somewhat different from what one finds on Wikipedia (for example), but following this convention helps Dokuwiki build nice looking/ | ||
+ | |||
+ | ====== Synth History 101 ====== | ||
+ | A short history of modern synthesis techniques | ||
===== Tagging Pages ===== | ===== Tagging Pages ===== | ||
- | You can add tags to wiki pages by adding the following to the bottom of a page: | + | You can add tags to wiki pages by adding the following to the bottom of a page. Separate each tag with a space: |
+ | |||
+ | {{tag> | ||
+ | |||
+ | **Multi-word tags**. You can create tags with spaces in them by using double-quote to enclose the tag, but think twice before using a multi-word tag. | ||
- | {{tag> | ||
- | | ||
**Important Guideline** | **Important Guideline** | ||
Line 28: | Line 45: | ||
To embed a YouTube video the most basic syntax is: | To embed a YouTube video the most basic syntax is: | ||
- | {{youtube> | + | {{youtube> |
| | ||
- | You can also embed video content from other popular sites, too. There are additional options which you can read about [[https:// | + | where myVideoId will be the actual video id of the YouTube |
+ | The ID is going to be something like // | ||
+ | |||
+ | You can also embed video content from other popular sites, too. | ||
+ | |||
+ | There are additional options described on the [[https:// | ||
+ | |||
+ | If you want more help there’s a [[wiki: | ||
+ | ===== Table of Contents Suppression ===== | ||
+ | By default, Audiobus Wiki pages have a table of contents (TOC) that appears at the top of each page. The The TOC is built from the page's headings. Sometimes, this TOC is unnecessary. To suppress it, add the following text at the top of a page. | ||
+ | |||
+ | ~~NOTOC~~ | ||
+ | | ||
===== Deleting pages ==== | ===== Deleting pages ==== | ||
If you need to delete a page, just edit it, then erase the contents and save. | If you need to delete a page, just edit it, then erase the contents and save. | ||
===== NoWiki markup ===== | ===== NoWiki markup ===== | ||
- | If you want text that would normally be " | + | If you want text that would normally be " |
- | < | + | < |
- | <nowiki></nowiki> | + | |
- | </nowiki> | + | Or, simply enclose the text with double percent signs ''< |
+ | |||
+ | This is handy if you need to display syntax that would normally be wiki-ized. | ||
+ | |||
+ | You can also precede a line with two spaces to have the wiki format it as “code” and ignore wiki syntax. | ||
+ | ===== Uploading Files ===== | ||
+ | |||
+ | If you want to upload files other than images, Audiobus presets or Audiobus controller profiles, and the uploader is rejecting the file type, you'll need to either contact Michael or package the file in a zip. | ||
+ | |||
+ | ===== Indenting (WRAP) ===== | ||
+ | |||
+ | The WRAP tag can be used to extend Dokuwiki' | ||
+ | |||
+ | To indent a block of text, wrap the text with the WRAP tag and indent flag: | ||
+ | |||
+ | <WRAP indent>some text to indent</WRAP> | ||
+ | |||
+ | <WRAP indent> | ||
+ | |||
+ | It can do a lot more than just indenting, too. More information about WRAP can be found [[https:// | ||
+ | ===== Soundcloud Player Embedding ===== | ||
+ | It is impossible to embed SoundCloud track players. See the page [[wiki: | ||
- | ===== Wiki Author Tutorials ===== | ||
- | [[https:// | ||
- | {{tag>authoring tutorial}} | + | {{tag>wiki_authoring}} |