Qwiki Syntax Rules: QwikiWiki uses its own syntactical rule set. It may seem rather terse and complex when you read it here, but it really is quite simple and natural as you do it. For example, the text that created all this is shown at the end of this page. Creating Headings Any line containing at least two words, all of which are capitalized, becomes a heading. Any Other Line: That starts with one or more capitalized words followed by a colon becomes a sub-heading. Each line is intended as many times as there are spaces at the beginning. Creating Lists Any line starting with a "bullet identifier" becomes a line in a list. Bullet identifiers (including numbered and non-numbered) can be mixed-and-matched at will. The supported bullet identifiers are as follows: ? Question Mark (?): Creates a "question item" ! Exclamation Mark (!): Creates an "action item" - Hyphen (-): Creates a hyphenated line . Period (.): Creates a bulleted line 1. Number: Creates a numbered line. Any numbered line starting with one resets the list counter. Lines starting with numbers other than one are renumbered as necessary. Likewise, the list counter is reset with every heading. Automatic Linking Text in a QwikiWiki page is scanned for several patterns, which automatically produce links of the following types: - Email addresses and DNS names become hyperlinks, as do URLs of the form xxx://email@example.com?xxx - Any word with "!CamelBack" capitalization (meaning "UPPERCASE lowercase UPPERCASE lowercase" etc) becomes a link to a page with its corresponding name, such as QwikiWiki. ! Note: You can disable this on a per-instance basis by prefacing the word with an exclamation point (!), or by adding the word to the #'ignoreQwikiTagArray'# variable in #_config.php#. - Any group of words surrounded and separated by underscores (_) becomes a link to a page with its corresponding name, such as _Home_. Formatting Notes - Words surrounded by asteriks (*) become *bold*. - Words surrounded by forward-slashes (/) become /italicized/. - Words surrounded by pound-signs (#) are shown as #code#. HTML Notes - QwikiSyntax and HTML can be freely intermixed, though care must be taken to avoid conflicting with the other automated markup rules. ! Note: To insert HTML code that should be visible to the user, be sure to replace the '<' and '>' with '<' and '>', respectively, - Text surrounded by <HTML> and </HTML> tags will be ignored by QwikiWiki and passed to the browser without alteration. ! Note: For security reasons, only a subset of HTML tags are allowed in QwikiWiki pages. The specific set allowed is up to the administrator; click *Help* when editing a page to see the complete list of acceptable HTML tags. Attached Files And Images If enabled by the QwikiWiki administrator, you can upload and "attach" files to each page. Attached files are stored in a page-specific subdirectory, and can be linked to from within the page by simply typing its filename into the page text. If the attached file is an image type (GIF, JPG, PNG), it is inserted directly rather than linked to. ! Note: Only certain file types can be attached, as specified by QwikiWiki administrator. Click *Help* when editing a page to see the complete list of acceptable file types.
Copyright 2004-2007 Ryan Pavlik. Code released under the appropriate license to contribute. All trademarks are the property of their respective owners.