author_tips

This is an old revision of the document!


Author Tips

This page contains helpful tips and conventions for Audiobus Wiki contributors.

Links to wiki and external pages are easy to create by typing manually or by using the handy tools in the editing toolbar.

Manual Links. To create a link, enclose either a URL or a wiki page name in doubled square brackets [[pagenamehere]]. To have a link title appear instead of the page name or URL, use this syntax [[pagenamehere|Text You Want to Appear]]. For example, use [[author_tips|Tips for Authors]] to create a link to this page: Tips for Authors

For pages on this wiki, please use local links rather than URLs.

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/readable indexes and tables of contents. Just press the leftmost headline button when you first create a page and type your page's preferred title. For example:

====== Synth History 101 ======
A short history of modern synthesis techniques

You can add tags to wiki pages by adding the following to the bottom of a page. Separate each tag with a space:

{{tag>[list of tags]}}  

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.

Important Guideline

When tagging pages, don’t go overboard with tags. Generally, pages will only need a few tags at most. Using too many tags on pages can make tag indexes less meaningful. For example, if AUM is mentioned on a page but the page is really about something else, it doesn’t need to be tagged with AUM.

Visitors can do searches using words, too. So, one doesn’t need to tag every word of possible interest. Only tag the most key topic or category. People mostly will search by word.

Think of tags as a targeting tool that prevents too many search results or as aids to find pages that might not be found when searching by word.

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~~ 

To embed a YouTube video the most basic syntax is:

{{youtube>L-WM8YxwqEU}}

You can also embed video content from other popular sites, too. There are additional options which you can read about here

If you need to delete a page, just edit it, then erase the contents and save.

If you want text that would normally be “wiki-ized” to actually appear on the page, surround it with the tags

<nowiki>{{don’t wiki me> more stuff}}</nowiki>

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.

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.

  • author_tips.1557369503.txt.gz
  • Last modified: 2019/05/09 12:38
  • by espiegel123