Modified Markdown Syntax

The syntax of our wiki pages is based on the markdown syntax (see this guide). If you need more background, read the Wiki Guide for Beginners and the Quick Guide. That makes it more "standard" and portable than other formats, while allowing experts to type it directly.

The simplifications to the markdown syntax are:

  • simpler links:
    • [http://site text] this is common wiki syntax and translates into [text](http://site) and looks like text
    • [http://site] this is common wiki syntax and translates into [http://site](http://site) and looks like http://site
  • Newlines: simple text lines separated by only one CRLF are treated as two separate sentences, with a <br> inserted between
  • Simpler lists - it's really annoying having to indent at 4 spaces. We modified that rule so that you can only indent at 1 space for the first 3 levels.

The restrictions are:

  • restricted set of html/xml tags allowed

The additions are:

The wiki extensions

  • [[Topic]] - to add a link to a page in this same wiki, for instance [[Modified Markdown Syntax]] which looks like Modified Markdown Syntax
    • [[Category:Topic]] to link to a page in a known category
    • [[alias:Category:Topic]] means that the current page is only an alias to the other topic. Note that IF a topic's only content is an alias tag, it will result in a redirect to the other topic - this is great if you want to rename things and try to redirect the old URL.
    • [[search:How to edit wikis]] or [[q:How to edit wikis]] link to a google search on the subject, like How to edit wikis
    • [[include:Category:Topic]] include the body of the other topic
  • [[[Topic]]] - to add a link to a page in wikipedia, for instance [[[Terms of service]]] looks like Terms of service
  • {{special code}} - special code for properties
    • {{when:2012-05-28}} - tag a page with a date/time. Dates are always in Razie's universal date format: YYYY-MM-DD like here.
      • Note that you can use date or on instead of when
      • for instance {{when:2012-05-28}} looks like {{Date 2012-05-28}}
    • {{where:RJ}} - specify the Venue where an event takes place. The venues are topics in the category Venue++
      • for instance {{at Burnt River}} looks like {{at Burnt River++}}
      • Note that you can use at or venue instead of where

Location

See Help with locations++ for details.

[Section details not found in [[rk.Admin:Help with locations#details]]!]

Category / domain definition

When defining a category, which is a restricted operation, certain syntax can be used to add more information about the relationship between categories.

{{roles:Category2:Role1,Role2}} means that a topic in the current category can be linked from one in Category2 as one of the roles in the list. There are special roles:

  • {{roles:Category2:Child}} denotes a parent/child relationship
  • {{roles:User:Owner,Admin,Member,Coach,Fan}} users can link to this as one of the roles.
    • Owner and Admin are restricted roles that allow one to administer the given category.

Other properties

{{.noComments:true}} will turn off comments on the respective topic - they are by default on.

See more properties at Wiki Properties.

{{xpl...}} see WikiPath

{{xmap...}} see WikiPath

Photos and images

{{img[.icon|.small|.medium] URL ARGS}}

{{photo URL ARGS}}

ARGS are optional attributes of the img http tag.

{{video URL}} is good for videos shared from youtube.

Forms and fields

Insert form fields using the {{f: properties. These are some example:

A simple string field: {{f:simpleField}}

SimpleField:

Select/choices: {{f:province:type=select,choices=ON|QC}}

Province

A checkbox: {{f:check1:type=checkbox}}

Check:

A memo: {{f:memo1:type=textarea,rows=3}}

Memo:

DSL

Note that we also use special DSL markups - so avoid starting any line with a dot . or a dollar sign $ - these have special meanings.

Embedding HTML

There are several ways to embed HTML, each with it's own quirks.

Direct embedding

Most HTML tags are allowed to be embedded freely inside the markdown content.

`{{html}}...{{/html}}

The lines between these tags will be printed "as is" in the page - i.e. they can contain any HTML content.

HTML content type

Scripts

You can embed scripts in {{html}} tags, HTML content type pages as well as inside {{inline}} tags.

Note that you should likely turn off require.js by using this setting in pages that use scripts, especially if you load external js libraries - require.js has a tendency to mess with these:

..diesel.requireJs false

Per page stylesheet section

You can include specific stylesheet and css inside any page: put it in a section called stylesheet.light:

{{section stylesheet.light}}
{{/section}}

Include in there anything you would normally put in a <style> tag. Light is the default theme and optionally, if you allow it, you can have a .dark version.



Was this useful?    

By: Razie | 2012-09-04 .. 2021-10-06 | Tags: wiki , help


Viewed 3958 times ( | History | Print ) this page.

You need to log in to post a comment!
© Copyright DieselApps, 2012-2024, all rights reserved.