wiki documentation

From Lazarus wiki
Jump to navigationJump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

English (en)

Guide to Wiki Editing

Overview

Tutorials

A Sand Box is available for practice.

If you have any problems, please use this Forum. You can also leave a note or suggestion on our Site Feedback page.

Syntax Highlighting

A Wiki for a programming language site needs a powerful way of showing source code in readable fashion. Therefore we use an automatic syntax highlighter to for sources.

Use the "<syntaxhighlight=pascal>" tag for FPC and Pascal code.

Use the "<syntaxhighlight=delphi>" tag for Delphi code.

Note: "<source=pascal>" could also work but is not recommended (see highlighter docs)

More languages are supported; for a list, see the highlighter docs.

  • for XML code, use <syntaxhighlight lang=xml>
  • for SQL code, use <syntaxhighlight lang=sql>
  • for DOS/CMD window code, use <syntaxhighlight lang=dos>
  • for bash/shell script code, use <syntaxhighlight lang=bash>
  • for ini file content, use use <syntaxhighlight lang=ini>
  • for Visual BASIC code, use <syntaxhighlight lang=vb>
  • for Java code, use <syntaxhighlight lang=java>
  • for JavaScript code, use <syntaxhighlight lang=javascript>

The following example shows the use of the syntax highlighter in this Wiki:

<syntaxhighlight lang=pascal>
Program Test;
Uses Crt;

Var I : Integer;

Begin
  For I := 0 to 12 do
    WriteLn('Test ',I:2);
End.
</syntaxhighlight>

results in this output

Program Test;
Uses Crt;

Var I : Integer;

Begin
  For I := 0 to 12 do
    WriteLn('Test ',I:2);
End.

Below is an example for XML sources.

<syntaxhighlight lang="xml">
<xs:complexType name="DecimalWithUnits">
  <xs:simpleContent>
    <xs:extension base="xs:decimal">
      <xs:attribute name="Units" type="xs:string"
                    use="required"/>
    </xs:extension>
  </xs:simpleContent>
</xs:complexType> 
</syntaxhighlight>

which results in:

<xs:complexType name="DecimalWithUnits">
  <xs:simpleContent>
    <xs:extension base="xs:decimal">
      <xs:attribute name="Units" type="xs:string"
                    use="required"/>
    </xs:extension>
  </xs:simpleContent>
</xs:complexType>

Below is an example for INI file content:

<syntaxhighlight lang=ini>
[Section Name]
Name=Value
Height=23
Width=32
</syntaxhighlight>

which results in:

[Section Name]
Name=Value
Height=23
Width=32

For program output or other verbatim quotes simply indent the text by one character like this:

This text is indented from the left margin by one character.

You can also use <pre> and </pre> tags. For example:

This text begins with the <pre> tag and ends with the </pre> tag

Keyboard shortcuts

To display keyboard shortcuts use template Template:keypress:

{{keypress|Ctrl}}+{{keypress|F12}}

This will show as:

Ctrl+F12

Note

To make text visible as a note use template Note:

{{Note|This is a note for the reader}}

This will be displayed as:

Light bulb  Note: This is a note for the reader

Tip

To make text visible as a tip use the Tip template:

{{Tip|This is a tip for the reader}}

This will be displayed as:

Note-icon.png

Tip: This is a tip for the reader

Warning

To make text visible as a warning use template Warning:

{{Warning|This is a warning for the reader}}

This will be displayed as:

Warning-icon.png

Warning: This is a warning for the reader