Qoppa is an application to help you write web pages. Double click !Qoppa to put its icon on the iconbar. Click Select on the iconbar icon to see this help page and click Adjust on the iconbar icon to open the directory <qoppa$dir>.Doc. In it you will see a textfile Helpsrc. This webpage was created by dragging Helpsrc to the iconbar icon.

To make a webpage drag a textfile to the iconbar icon. The webpage needs to be in a certain form. Its first three lines should define TITLE, the webpages title which your browser may show in its titlebar, CSS the path, relative to the webpage in Unix notation, of its style sheet, and TARGET the pathname of the webpage itself, in RISC OS notation.

Text values are enclosed in double square brackets. Text can spread over many lines. The first newline after the opening double square brackets is ignored. The symbols <, > and & should not appear in text. Instead use the expressions &lt;, &gt; and &amp; respectively.

Lines beginning with two hyphens are ignored, unless they are followed immediately by opening double square brackets, in which case the whole of that text is ignored.

The textfile must end with a definition for BODY, that describes the body of the web page. This is made up by sequences of expressions or text, both of which may be tagged. Sequences are denoted by braces and their items are terminated by semicolons. Tags must be declared before use by a statement of the form

               local ... in TAG

A tag takes two arguments - the first for the text, if any, within the opening tag, the second for the text between the opening and closing tag, if any. Empty arguments are denoted ( ).

If the first argument of a tag has the form

          (CLASS [[foo]]) 

then the CSS-style foo will be used for its contents. Note that arguments which are compound expressions must be enclosed in parentheses. Short line-level tags, e.g. <em>, are probably easier to insert directly into the text.

!Qoppa does not need RiscLua or the Weave library to be installed.