YAM minimal test file.

1. YAM Syntax

1.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

1.2. Contents

Contents listings like that above are generated by '%contents'

1.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

1.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

1.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

1.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

1.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

1.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

1.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

1.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

1.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

1.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

1.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

1.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

1.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

1.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

2. YAM Syntax

2.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

2.2. Contents

Contents listings like that above are generated by '%contents'

2.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

2.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

2.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

2.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

2.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

2.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

2.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

2.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

2.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

2.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

2.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

2.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

2.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

2.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

3. YAM Syntax

3.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

3.2. Contents

Contents listings like that above are generated by '%contents'

3.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

3.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

3.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

3.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

3.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

3.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

3.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

3.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

3.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

3.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

3.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

3.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

3.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

3.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

4. YAM Syntax

4.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

4.2. Contents

Contents listings like that above are generated by '%contents'

4.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

4.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

4.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

4.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

4.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

4.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

4.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

4.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

4.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

4.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

4.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

4.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

4.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

4.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

5. YAM Syntax

5.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

5.2. Contents

Contents listings like that above are generated by '%contents'

5.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

5.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

5.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

5.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

5.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

5.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

5.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

5.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

5.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

5.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

5.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

5.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

5.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

5.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

6. YAM Syntax

6.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

6.2. Contents

Contents listings like that above are generated by '%contents'

6.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

6.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

6.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

6.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

6.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

6.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

6.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

6.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

6.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

6.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

6.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

6.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

6.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

6.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

7. YAM Syntax

7.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

7.2. Contents

Contents listings like that above are generated by '%contents'

7.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

7.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

7.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

7.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

7.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

7.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

7.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

7.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

7.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

7.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

7.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

7.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

7.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

7.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

8. YAM Syntax

8.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

8.2. Contents

Contents listings like that above are generated by '%contents'

8.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

8.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

8.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

8.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

8.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

8.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

8.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

8.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

8.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

8.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

8.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

8.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

8.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

8.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

9. YAM Syntax

9.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

9.2. Contents

Contents listings like that above are generated by '%contents'

9.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

9.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

9.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

9.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

9.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

9.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

9.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

9.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

9.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

9.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

9.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

9.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

9.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

9.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

10. YAM Syntax

10.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

10.2. Contents

Contents listings like that above are generated by '%contents'

10.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

10.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

10.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

10.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

10.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

10.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

10.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

10.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

10.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

10.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

10.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

10.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

10.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

10.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

11. YAM Syntax

11.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

11.2. Contents

Contents listings like that above are generated by '%contents'

11.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

11.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

11.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

11.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

11.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

11.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

11.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

11.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

11.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

11.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

11.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

11.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

11.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

11.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

12. YAM Syntax

12.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

12.2. Contents

Contents listings like that above are generated by '%contents'

12.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

12.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

12.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

12.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

12.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

12.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

12.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

12.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

12.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

12.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

12.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

12.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

12.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

12.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

13. YAM Syntax

13.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

13.2. Contents

Contents listings like that above are generated by '%contents'

13.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

13.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

13.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

13.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

13.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

13.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

13.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

13.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

13.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

13.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

13.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

13.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

13.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

13.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

14. YAM Syntax

14.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

14.2. Contents

Contents listings like that above are generated by '%contents'

14.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

14.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

14.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

14.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

14.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

14.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

14.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

14.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

14.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

14.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

14.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

14.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

14.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

14.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

15. YAM Syntax

15.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

15.2. Contents

Contents listings like that above are generated by '%contents'

15.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

15.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

15.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

15.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

15.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

15.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

15.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

15.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

15.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

15.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

15.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

15.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

15.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

15.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

16. YAM Syntax

16.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

16.2. Contents

Contents listings like that above are generated by '%contents'

16.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

16.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

16.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

16.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

16.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

16.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

16.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

16.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

16.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

16.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

16.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

16.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

16.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

16.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

17. YAM Syntax

17.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

17.2. Contents

Contents listings like that above are generated by '%contents'

17.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

17.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

17.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

17.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

17.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

17.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

17.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

17.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

17.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

17.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

17.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

17.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

17.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

17.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

18. YAM Syntax

18.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

18.2. Contents

Contents listings like that above are generated by '%contents'

18.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

18.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

18.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

18.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

18.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

18.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

18.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

18.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

18.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

18.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

18.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

18.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

18.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

18.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

19. YAM Syntax

19.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

19.2. Contents

Contents listings like that above are generated by '%contents'

19.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

19.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

19.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

19.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

19.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

19.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

19.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

19.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

19.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

19.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

19.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

19.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

19.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

19.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

20. YAM Syntax

20.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

20.2. Contents

Contents listings like that above are generated by '%contents'

20.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

20.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

20.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

20.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

20.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

20.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

20.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

20.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

20.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

20.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

20.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

20.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

20.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

20.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

21. YAM Syntax

21.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

21.2. Contents

Contents listings like that above are generated by '%contents'

21.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

21.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

21.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

21.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

21.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

21.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

21.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

21.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

21.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

21.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

21.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

21.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

21.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

21.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

22. YAM Syntax

22.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

22.2. Contents

Contents listings like that above are generated by '%contents'

22.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

22.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

22.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

22.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

22.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

22.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

22.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

22.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

22.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

22.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

22.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

22.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

22.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

22.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

23. YAM Syntax

23.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

23.2. Contents

Contents listings like that above are generated by '%contents'

23.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

23.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

23.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

23.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

23.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

23.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

23.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

23.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

23.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

23.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

23.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

23.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

23.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

23.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

24. YAM Syntax

24.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

24.2. Contents

Contents listings like that above are generated by '%contents'

24.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

24.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

24.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

24.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

24.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

24.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

24.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

24.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

24.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

24.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

24.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

24.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

24.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

24.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

25. YAM Syntax

25.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

25.2. Contents

Contents listings like that above are generated by '%contents'

25.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

25.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

25.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

25.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

25.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

25.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

25.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

25.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

25.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

25.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

25.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

25.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

25.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

25.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

26. YAM Syntax

26.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

26.2. Contents

Contents listings like that above are generated by '%contents'

26.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

26.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

26.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

26.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

26.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

26.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

26.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

26.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

26.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

26.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

26.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

26.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

26.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

26.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

27. YAM Syntax

27.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

27.2. Contents

Contents listings like that above are generated by '%contents'

27.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

27.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

27.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

27.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

27.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

27.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

27.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

27.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

27.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

27.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

27.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

27.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

27.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

27.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

28. YAM Syntax

28.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

28.2. Contents

Contents listings like that above are generated by '%contents'

28.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

28.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

28.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

28.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

28.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

28.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

28.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

28.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

28.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

28.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

28.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

28.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

28.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

28.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

29. YAM Syntax

29.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

29.2. Contents

Contents listings like that above are generated by '%contents'

29.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

29.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

29.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

29.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

29.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

29.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

29.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

29.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

29.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

29.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

29.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

29.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

29.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

29.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

30. YAM Syntax

30.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

30.2. Contents

Contents listings like that above are generated by '%contents'

30.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

30.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

30.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

30.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

30.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

30.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

30.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

30.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

30.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

30.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

30.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

30.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

30.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

30.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

31. YAM Syntax

31.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

31.2. Contents

Contents listings like that above are generated by '%contents'

31.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

31.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

31.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

31.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

31.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

31.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

31.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

31.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

31.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

31.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

31.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

31.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

31.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

31.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

32. YAM Syntax

32.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

32.2. Contents

Contents listings like that above are generated by '%contents'

32.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

32.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

32.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

32.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

32.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

32.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

32.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

32.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

32.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

32.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

32.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

32.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

32.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

32.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

33. YAM Syntax

33.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

33.2. Contents

Contents listings like that above are generated by '%contents'

33.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

33.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

33.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

33.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

33.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

33.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

33.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

33.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

33.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

33.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

33.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

33.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

33.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

33.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

34. YAM Syntax

34.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

34.2. Contents

Contents listings like that above are generated by '%contents'

34.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

34.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

34.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

34.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

34.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

34.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

34.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

34.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

34.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

34.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

34.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

34.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

34.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

34.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

35. YAM Syntax

35.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

35.2. Contents

Contents listings like that above are generated by '%contents'

35.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

35.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

35.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

35.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

35.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

35.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

35.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

35.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

35.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

35.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

35.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

35.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

35.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

35.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

36. YAM Syntax

36.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

36.2. Contents

Contents listings like that above are generated by '%contents'

36.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

36.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

36.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

36.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

36.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

36.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

36.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

36.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

36.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

36.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

36.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

36.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

36.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

36.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

37. YAM Syntax

37.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

37.2. Contents

Contents listings like that above are generated by '%contents'

37.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

37.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

37.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

37.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

37.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

37.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

37.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

37.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

37.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

37.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

37.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

37.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

37.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

37.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

38. YAM Syntax

38.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

38.2. Contents

Contents listings like that above are generated by '%contents'

38.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

38.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

38.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

38.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

38.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

38.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

38.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

38.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

38.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

38.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

38.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

38.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

38.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

38.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

39. YAM Syntax

39.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

39.2. Contents

Contents listings like that above are generated by '%contents'

39.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

39.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

39.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

39.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

39.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

39.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

39.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

39.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

39.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

39.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

39.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

39.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

39.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

39.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

40. YAM Syntax

40.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

40.2. Contents

Contents listings like that above are generated by '%contents'

40.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

40.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

40.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

40.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

40.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

40.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

40.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

40.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

40.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

40.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

40.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

40.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

40.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

40.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

41. YAM Syntax

41.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

41.2. Contents

Contents listings like that above are generated by '%contents'

41.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

41.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

41.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

41.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

41.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

41.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

41.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

41.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

41.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

41.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

41.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

41.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

41.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

41.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

42. YAM Syntax

42.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

42.2. Contents

Contents listings like that above are generated by '%contents'

42.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

42.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

42.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

42.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

42.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

42.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

42.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

42.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

42.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

42.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

42.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

42.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

42.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

42.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

43. YAM Syntax

43.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

43.2. Contents

Contents listings like that above are generated by '%contents'

43.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

43.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

43.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

43.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

43.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

43.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

43.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

43.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

43.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

43.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

43.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

43.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

43.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

43.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

44. YAM Syntax

44.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

44.2. Contents

Contents listings like that above are generated by '%contents'

44.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

44.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

44.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

44.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

44.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

44.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

44.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

44.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

44.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

44.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

44.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

44.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

44.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

44.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

45. YAM Syntax

45.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

45.2. Contents

Contents listings like that above are generated by '%contents'

45.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

45.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

45.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

45.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

45.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

45.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

45.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

45.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

45.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

45.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

45.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

45.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

45.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

45.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

46. YAM Syntax

46.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

46.2. Contents

Contents listings like that above are generated by '%contents'

46.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

46.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

46.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

46.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

46.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

46.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

46.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

46.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

46.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

46.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

46.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

46.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

46.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

46.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

47. YAM Syntax

47.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

47.2. Contents

Contents listings like that above are generated by '%contents'

47.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

47.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

47.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

47.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

47.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

47.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

47.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

47.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

47.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

47.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

47.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

47.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

47.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

47.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

48. YAM Syntax

48.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

48.2. Contents

Contents listings like that above are generated by '%contents'

48.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

48.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

48.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

48.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

48.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

48.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

48.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

48.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

48.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

48.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

48.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

48.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

48.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

48.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

49. YAM Syntax

49.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

49.2. Contents

Contents listings like that above are generated by '%contents'

49.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

49.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

49.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

49.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

49.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

49.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

49.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

49.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

49.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

49.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

49.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

49.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

49.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

49.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

50. YAM Syntax

50.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

50.2. Contents

Contents listings like that above are generated by '%contents'

50.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

50.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

50.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

50.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

50.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

50.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

50.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

50.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

50.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

50.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

50.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

50.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

50.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

50.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

51. YAM Syntax

51.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

51.2. Contents

Contents listings like that above are generated by '%contents'

51.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

51.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

51.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

51.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

51.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

51.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

51.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

51.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

51.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

51.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

51.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

51.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

51.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

51.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

52. YAM Syntax

52.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

52.2. Contents

Contents listings like that above are generated by '%contents'

52.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

52.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

52.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

52.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

52.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

52.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

52.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

52.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

52.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

52.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

52.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

52.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

52.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

52.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

53. YAM Syntax

53.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

53.2. Contents

Contents listings like that above are generated by '%contents'

53.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

53.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

53.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

53.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

53.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

53.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

53.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

53.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

53.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

53.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

53.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

53.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

53.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

53.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

54. YAM Syntax

54.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

54.2. Contents

Contents listings like that above are generated by '%contents'

54.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

54.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

54.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

54.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

54.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

54.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

54.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

54.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

54.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

54.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

54.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

54.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

54.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

54.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

55. YAM Syntax

55.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

55.2. Contents

Contents listings like that above are generated by '%contents'

55.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

55.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

55.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

55.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

55.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

55.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

55.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

55.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

55.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

55.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

55.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

55.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

55.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

55.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

56. YAM Syntax

56.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

56.2. Contents

Contents listings like that above are generated by '%contents'

56.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

56.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

56.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

56.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

56.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

56.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

56.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

56.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

56.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

56.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

56.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

56.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

56.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

56.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

57. YAM Syntax

57.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

57.2. Contents

Contents listings like that above are generated by '%contents'

57.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

57.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

57.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

57.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

57.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

57.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

57.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

57.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

57.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

57.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

57.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

57.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

57.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

57.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

58. YAM Syntax

58.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

58.2. Contents

Contents listings like that above are generated by '%contents'

58.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

58.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

58.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

58.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

58.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

58.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

58.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

58.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

58.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

58.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

58.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

58.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

58.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

58.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

59. YAM Syntax

59.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

59.2. Contents

Contents listings like that above are generated by '%contents'

59.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

59.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

59.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

59.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

59.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

59.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

59.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

59.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

59.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

59.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

59.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

59.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

59.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

59.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

60. YAM Syntax

60.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

60.2. Contents

Contents listings like that above are generated by '%contents'

60.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

60.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

60.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

60.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

60.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

60.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

60.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

60.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

60.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

60.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

60.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

60.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

60.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

60.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

61. YAM Syntax

61.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

61.2. Contents

Contents listings like that above are generated by '%contents'

61.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

61.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

61.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

61.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

61.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

61.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

61.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

61.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

61.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

61.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

61.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

61.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

61.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

61.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

62. YAM Syntax

62.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

62.2. Contents

Contents listings like that above are generated by '%contents'

62.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

62.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

62.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

62.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

62.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

62.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

62.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

62.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

62.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

62.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

62.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

62.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

62.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

62.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

63. YAM Syntax

63.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

63.2. Contents

Contents listings like that above are generated by '%contents'

63.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

63.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

63.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

63.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

63.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

63.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

63.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

63.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

63.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

63.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

63.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

63.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

63.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

63.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

64. YAM Syntax

64.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

64.2. Contents

Contents listings like that above are generated by '%contents'

64.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

64.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

64.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

64.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

64.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

64.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

64.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

64.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

64.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

64.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

64.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

64.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

64.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

64.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

65. YAM Syntax

65.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

65.2. Contents

Contents listings like that above are generated by '%contents'

65.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

65.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

65.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

65.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

65.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

65.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

65.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

65.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

65.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

65.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

65.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

65.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

65.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

65.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

66. YAM Syntax

66.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

66.2. Contents

Contents listings like that above are generated by '%contents'

66.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

66.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

66.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

66.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

66.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

66.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

66.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

66.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

66.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

66.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

66.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

66.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

66.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

66.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

67. YAM Syntax

67.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

67.2. Contents

Contents listings like that above are generated by '%contents'

67.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

67.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

67.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

67.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

67.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

67.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

67.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

67.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

67.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

67.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

67.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

67.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

67.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

67.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

68. YAM Syntax

68.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

68.2. Contents

Contents listings like that above are generated by '%contents'

68.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

68.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

68.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

68.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

68.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

68.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

68.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

68.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

68.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

68.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

68.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

68.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

68.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

68.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

69. YAM Syntax

69.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

69.2. Contents

Contents listings like that above are generated by '%contents'

69.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

69.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

69.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

69.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

69.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

69.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

69.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

69.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

69.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

69.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

69.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

69.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

69.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

69.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

70. YAM Syntax

70.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

70.2. Contents

Contents listings like that above are generated by '%contents'

70.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

70.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

70.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

70.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

70.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

70.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

70.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

70.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

70.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

70.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

70.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

70.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

70.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

70.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

71. YAM Syntax

71.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

71.2. Contents

Contents listings like that above are generated by '%contents'

71.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

71.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

71.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

71.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

71.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

71.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

71.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

71.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

71.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

71.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

71.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

71.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

71.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

71.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

72. YAM Syntax

72.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

72.2. Contents

Contents listings like that above are generated by '%contents'

72.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

72.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

72.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

72.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

72.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

72.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

72.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

72.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

72.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

72.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

72.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

72.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

72.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

72.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

73. YAM Syntax

73.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

73.2. Contents

Contents listings like that above are generated by '%contents'

73.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

73.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

73.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

73.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

73.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

73.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

73.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

73.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

73.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

73.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

73.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

73.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

73.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

73.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

74. YAM Syntax

74.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

74.2. Contents

Contents listings like that above are generated by '%contents'

74.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

74.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

74.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

74.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

74.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

74.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

74.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

74.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

74.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

74.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

74.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

74.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

74.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

74.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

75. YAM Syntax

75.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

75.2. Contents

Contents listings like that above are generated by '%contents'

75.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

75.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

75.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

75.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

75.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

75.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

75.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

75.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

75.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

75.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

75.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

75.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

75.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

75.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

76. YAM Syntax

76.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

76.2. Contents

Contents listings like that above are generated by '%contents'

76.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

76.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

76.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

76.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

76.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

76.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

76.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

76.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

76.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

76.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

76.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

76.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

76.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

76.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

77. YAM Syntax

77.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

77.2. Contents

Contents listings like that above are generated by '%contents'

77.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

77.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

77.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

77.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

77.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

77.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

77.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

77.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

77.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

77.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

77.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

77.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

77.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

77.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

78. YAM Syntax

78.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

78.2. Contents

Contents listings like that above are generated by '%contents'

78.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

78.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

78.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

78.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

78.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

78.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

78.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

78.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

78.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

78.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

78.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

78.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

78.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

78.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

79. YAM Syntax

79.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

79.2. Contents

Contents listings like that above are generated by '%contents'

79.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

79.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

79.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

79.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

79.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

79.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

79.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

79.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

79.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

79.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

79.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

79.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

79.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

79.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

80. YAM Syntax

80.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

80.2. Contents

Contents listings like that above are generated by '%contents'

80.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

80.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

80.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

80.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

80.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

80.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

80.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

80.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

80.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

80.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

80.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

80.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

80.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

80.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

81. YAM Syntax

81.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

81.2. Contents

Contents listings like that above are generated by '%contents'

81.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

81.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

81.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

81.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

81.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

81.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

81.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

81.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

81.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

81.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

81.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

81.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

81.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

81.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

82. YAM Syntax

82.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

82.2. Contents

Contents listings like that above are generated by '%contents'

82.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

82.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

82.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

82.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

82.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

82.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

82.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

82.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

82.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

82.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

82.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

82.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

82.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

82.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

83. YAM Syntax

83.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

83.2. Contents

Contents listings like that above are generated by '%contents'

83.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

83.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

83.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

83.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

83.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

83.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

83.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

83.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

83.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

83.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

83.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

83.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

83.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

83.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

84. YAM Syntax

84.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

84.2. Contents

Contents listings like that above are generated by '%contents'

84.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

84.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

84.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

84.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

84.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

84.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

84.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

84.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

84.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

84.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

84.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

84.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

84.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

84.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

85. YAM Syntax

85.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

85.2. Contents

Contents listings like that above are generated by '%contents'

85.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

85.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

85.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

85.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

85.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

85.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

85.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

85.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

85.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

85.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

85.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

85.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

85.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

85.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

86. YAM Syntax

86.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

86.2. Contents

Contents listings like that above are generated by '%contents'

86.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

86.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

86.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

86.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

86.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

86.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

86.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

86.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

86.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

86.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

86.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

86.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

86.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

86.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

87. YAM Syntax

87.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

87.2. Contents

Contents listings like that above are generated by '%contents'

87.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

87.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

87.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

87.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

87.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

87.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

87.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

87.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

87.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

87.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

87.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

87.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

87.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

87.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

88. YAM Syntax

88.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

88.2. Contents

Contents listings like that above are generated by '%contents'

88.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

88.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

88.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

88.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

88.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

88.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

88.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

88.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

88.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

88.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

88.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

88.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

88.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

88.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

89. YAM Syntax

89.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

89.2. Contents

Contents listings like that above are generated by '%contents'

89.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

89.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

89.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

89.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

89.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

89.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

89.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

89.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

89.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

89.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

89.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

89.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

89.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

89.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

90. YAM Syntax

90.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

90.2. Contents

Contents listings like that above are generated by '%contents'

90.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

90.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

90.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

90.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

90.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

90.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

90.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

90.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

90.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

90.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

90.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

90.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

90.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

90.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

91. YAM Syntax

91.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

91.2. Contents

Contents listings like that above are generated by '%contents'

91.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

91.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

91.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

91.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

91.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

91.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

91.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

91.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

91.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

91.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

91.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

91.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

91.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

91.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

92. YAM Syntax

92.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

92.2. Contents

Contents listings like that above are generated by '%contents'

92.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

92.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

92.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

92.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

92.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

92.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

92.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

92.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

92.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

92.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

92.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

92.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

92.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

92.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

93. YAM Syntax

93.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

93.2. Contents

Contents listings like that above are generated by '%contents'

93.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

93.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

93.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

93.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

93.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

93.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

93.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

93.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

93.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

93.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

93.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

93.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

93.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

93.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

94. YAM Syntax

94.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

94.2. Contents

Contents listings like that above are generated by '%contents'

94.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

94.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

94.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

94.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

94.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

94.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

94.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

94.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

94.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

94.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

94.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

94.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

94.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

94.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

95. YAM Syntax

95.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

95.2. Contents

Contents listings like that above are generated by '%contents'

95.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

95.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

95.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

95.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

95.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

95.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

95.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

95.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

95.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

95.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

95.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

95.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

95.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

95.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

96. YAM Syntax

96.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

96.2. Contents

Contents listings like that above are generated by '%contents'

96.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

96.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

96.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

96.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

96.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

96.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

96.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

96.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

96.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

96.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

96.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

96.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

96.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

96.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

97. YAM Syntax

97.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

97.2. Contents

Contents listings like that above are generated by '%contents'

97.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

97.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

97.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

97.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

97.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

97.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

97.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

97.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

97.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

97.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

97.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

97.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

97.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

97.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

98. YAM Syntax

98.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

98.2. Contents

Contents listings like that above are generated by '%contents'

98.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

98.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

98.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

98.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

98.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

98.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

98.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

98.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

98.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

98.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

98.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

98.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

98.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

98.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

99. YAM Syntax

99.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

99.2. Contents

Contents listings like that above are generated by '%contents'

99.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

99.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

99.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

99.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

99.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

99.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

99.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

99.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

99.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

99.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

99.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

99.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

99.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

99.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

100. YAM Syntax

100.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

100.2. Contents

Contents listings like that above are generated by '%contents'

100.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

100.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

100.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

100.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

100.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

100.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

100.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

100.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

100.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

100.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

100.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

100.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

100.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

100.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

101. YAM Syntax

101.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

101.2. Contents

Contents listings like that above are generated by '%contents'

101.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

101.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

101.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

101.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

101.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

101.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

101.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

101.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

101.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

101.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

101.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

101.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

101.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

101.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

102. YAM Syntax

102.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

102.2. Contents

Contents listings like that above are generated by '%contents'

102.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

102.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

102.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

102.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

102.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

102.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

102.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

102.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

102.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

102.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

102.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

102.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

102.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

102.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

103. YAM Syntax

103.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

103.2. Contents

Contents listings like that above are generated by '%contents'

103.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

103.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

103.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

103.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

103.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

103.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

103.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

103.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

103.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

103.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

103.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

103.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

103.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

103.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

104. YAM Syntax

104.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

104.2. Contents

Contents listings like that above are generated by '%contents'

104.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

104.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

104.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

104.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

104.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

104.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

104.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

104.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

104.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

104.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

104.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

104.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

104.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

104.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

105. YAM Syntax

105.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

105.2. Contents

Contents listings like that above are generated by '%contents'

105.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

105.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

105.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

105.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

105.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

105.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

105.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

105.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

105.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

105.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

105.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

105.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

105.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

105.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

106. YAM Syntax

106.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

106.2. Contents

Contents listings like that above are generated by '%contents'

106.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

106.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

106.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

106.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

106.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁶.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

106.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

106.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

106.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

106.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

106.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

106.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

106.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

106.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

106.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

107. YAM Syntax

107.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

107.2. Contents

Contents listings like that above are generated by '%contents'

107.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

107.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

107.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

107.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

107.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

107.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

107.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

107.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

107.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

107.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

107.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

107.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

107.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

107.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

108. YAM Syntax

108.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

108.2. Contents

Contents listings like that above are generated by '%contents'

108.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

108.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

108.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

108.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

108.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁸.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

108.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

108.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

108.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

108.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

108.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

108.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

108.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

108.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

108.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

109. YAM Syntax

109.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

109.2. Contents

Contents listings like that above are generated by '%contents'

109.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

109.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

109.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

109.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

109.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

109.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

109.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

109.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

109.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

109.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

109.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

109.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

109.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

109.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

110. YAM Syntax

110.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

110.2. Contents

Contents listings like that above are generated by '%contents'

110.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

110.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

110.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

110.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

110.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹⁰.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

110.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

110.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

110.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

110.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

110.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

110.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

110.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

110.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

110.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

111. YAM Syntax

111.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

111.2. Contents

Contents listings like that above are generated by '%contents'

111.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

111.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

111.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

111.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

111.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

111.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

111.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

111.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

111.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

111.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

111.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

111.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

111.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

111.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

112. YAM Syntax

112.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

112.2. Contents

Contents listings like that above are generated by '%contents'

112.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

112.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

112.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

112.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

112.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹².

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

112.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

112.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

112.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

112.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

112.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

112.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

112.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

112.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

112.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

113. YAM Syntax

113.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

113.2. Contents

Contents listings like that above are generated by '%contents'

113.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

113.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

113.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

113.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

113.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

113.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

113.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

113.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

113.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

113.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

113.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

113.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

113.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

113.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

1. YAM Syntax
1.1. Changes from version 3
1.2. Contents
1.3. Bold, italic, underline and teletype
1.4. Horizontal lines
1.5. Lists
1.6. Verbatim output
1.7. Footnotes
1.8. Escapes
1.9. Headings
1.10. Links and anchors
1.11. Block quotations
1.12. Line breaks
1.13. Tables
1.14. Images
1.15. Citations
1.16. Inclusion
2. YAM Syntax
2.1. Changes from version 3
2.2. Contents
2.3. Bold, italic, underline and teletype
2.4. Horizontal lines
2.5. Lists
2.6. Verbatim output
2.7. Footnotes
2.8. Escapes
2.9. Headings
2.10. Links and anchors
2.11. Block quotations
2.12. Line breaks
2.13. Tables
2.14. Images
2.15. Citations
2.16. Inclusion
3. YAM Syntax
3.1. Changes from version 3
3.2. Contents
3.3. Bold, italic, underline and teletype
3.4. Horizontal lines
3.5. Lists
3.6. Verbatim output
3.7. Footnotes
3.8. Escapes
3.9. Headings
3.10. Links and anchors
3.11. Block quotations
3.12. Line breaks
3.13. Tables
3.14. Images
3.15. Citations
3.16. Inclusion
4. YAM Syntax
4.1. Changes from version 3
4.2. Contents
4.3. Bold, italic, underline and teletype
4.4. Horizontal lines
4.5. Lists
4.6. Verbatim output
4.7. Footnotes
4.8. Escapes
4.9. Headings
4.10. Links and anchors
4.11. Block quotations
4.12. Line breaks
4.13. Tables
4.14. Images
4.15. Citations
4.16. Inclusion
5. YAM Syntax
5.1. Changes from version 3
5.2. Contents
5.3. Bold, italic, underline and teletype
5.4. Horizontal lines
5.5. Lists
5.6. Verbatim output
5.7. Footnotes
5.8. Escapes
5.9. Headings
5.10. Links and anchors
5.11. Block quotations
5.12. Line breaks
5.13. Tables
5.14. Images
5.15. Citations
5.16. Inclusion
6. YAM Syntax
6.1. Changes from version 3
6.2. Contents
6.3. Bold, italic, underline and teletype
6.4. Horizontal lines
6.5. Lists
6.6. Verbatim output
6.7. Footnotes
6.8. Escapes
6.9. Headings
6.10. Links and anchors
6.11. Block quotations
6.12. Line breaks
6.13. Tables
6.14. Images
6.15. Citations
6.16. Inclusion
7. YAM Syntax
7.1. Changes from version 3
7.2. Contents
7.3. Bold, italic, underline and teletype
7.4. Horizontal lines
7.5. Lists
7.6. Verbatim output
7.7. Footnotes
7.8. Escapes
7.9. Headings
7.10. Links and anchors
7.11. Block quotations
7.12. Line breaks
7.13. Tables
7.14. Images
7.15. Citations
7.16. Inclusion
8. YAM Syntax
8.1. Changes from version 3
8.2. Contents
8.3. Bold, italic, underline and teletype
8.4. Horizontal lines
8.5. Lists
8.6. Verbatim output
8.7. Footnotes
8.8. Escapes
8.9. Headings
8.10. Links and anchors
8.11. Block quotations
8.12. Line breaks
8.13. Tables
8.14. Images
8.15. Citations
8.16. Inclusion
9. YAM Syntax
9.1. Changes from version 3
9.2. Contents
9.3. Bold, italic, underline and teletype
9.4. Horizontal lines
9.5. Lists
9.6. Verbatim output
9.7. Footnotes
9.8. Escapes
9.9. Headings
9.10. Links and anchors
9.11. Block quotations
9.12. Line breaks
9.13. Tables
9.14. Images
9.15. Citations
9.16. Inclusion
10. YAM Syntax
10.1. Changes from version 3
10.2. Contents
10.3. Bold, italic, underline and teletype
10.4. Horizontal lines
10.5. Lists
10.6. Verbatim output
10.7. Footnotes
10.8. Escapes
10.9. Headings
10.10. Links and anchors
10.11. Block quotations
10.12. Line breaks
10.13. Tables
10.14. Images
10.15. Citations
10.16. Inclusion
11. YAM Syntax
11.1. Changes from version 3
11.2. Contents
11.3. Bold, italic, underline and teletype
11.4. Horizontal lines
11.5. Lists
11.6. Verbatim output
11.7. Footnotes
11.8. Escapes
11.9. Headings
11.10. Links and anchors
11.11. Block quotations
11.12. Line breaks
11.13. Tables
11.14. Images
11.15. Citations
11.16. Inclusion
12. YAM Syntax
12.1. Changes from version 3
12.2. Contents
12.3. Bold, italic, underline and teletype
12.4. Horizontal lines
12.5. Lists
12.6. Verbatim output
12.7. Footnotes
12.8. Escapes
12.9. Headings
12.10. Links and anchors
12.11. Block quotations
12.12. Line breaks
12.13. Tables
12.14. Images
12.15. Citations
12.16. Inclusion
13. YAM Syntax
13.1. Changes from version 3
13.2. Contents
13.3. Bold, italic, underline and teletype
13.4. Horizontal lines
13.5. Lists
13.6. Verbatim output
13.7. Footnotes
13.8. Escapes
13.9. Headings
13.10. Links and anchors
13.11. Block quotations
13.12. Line breaks
13.13. Tables
13.14. Images
13.15. Citations
13.16. Inclusion
14. YAM Syntax
14.1. Changes from version 3
14.2. Contents
14.3. Bold, italic, underline and teletype
14.4. Horizontal lines
14.5. Lists
14.6. Verbatim output
14.7. Footnotes
14.8. Escapes
14.9. Headings
14.10. Links and anchors
14.11. Block quotations
14.12. Line breaks
14.13. Tables
14.14. Images
14.15. Citations
14.16. Inclusion
15. YAM Syntax
15.1. Changes from version 3
15.2. Contents
15.3. Bold, italic, underline and teletype
15.4. Horizontal lines
15.5. Lists
15.6. Verbatim output
15.7. Footnotes
15.8. Escapes
15.9. Headings
15.10. Links and anchors
15.11. Block quotations
15.12. Line breaks
15.13. Tables
15.14. Images
15.15. Citations
15.16. Inclusion
16. YAM Syntax
16.1. Changes from version 3
16.2. Contents
16.3. Bold, italic, underline and teletype
16.4. Horizontal lines
16.5. Lists
16.6. Verbatim output
16.7. Footnotes
16.8. Escapes
16.9. Headings
16.10. Links and anchors
16.11. Block quotations
16.12. Line breaks
16.13. Tables
16.14. Images
16.15. Citations
16.16. Inclusion
17. YAM Syntax
17.1. Changes from version 3
17.2. Contents
17.3. Bold, italic, underline and teletype
17.4. Horizontal lines
17.5. Lists
17.6. Verbatim output
17.7. Footnotes
17.8. Escapes
17.9. Headings
17.10. Links and anchors
17.11. Block quotations
17.12. Line breaks
17.13. Tables
17.14. Images
17.15. Citations
17.16. Inclusion
18. YAM Syntax
18.1. Changes from version 3
18.2. Contents
18.3. Bold, italic, underline and teletype
18.4. Horizontal lines
18.5. Lists
18.6. Verbatim output
18.7. Footnotes
18.8. Escapes
18.9. Headings
18.10. Links and anchors
18.11. Block quotations
18.12. Line breaks
18.13. Tables
18.14. Images
18.15. Citations
18.16. Inclusion
19. YAM Syntax
19.1. Changes from version 3
19.2. Contents
19.3. Bold, italic, underline and teletype
19.4. Horizontal lines
19.5. Lists
19.6. Verbatim output
19.7. Footnotes
19.8. Escapes
19.9. Headings
19.10. Links and anchors
19.11. Block quotations
19.12. Line breaks
19.13. Tables
19.14. Images
19.15. Citations
19.16. Inclusion
20. YAM Syntax
20.1. Changes from version 3
20.2. Contents
20.3. Bold, italic, underline and teletype
20.4. Horizontal lines
20.5. Lists
20.6. Verbatim output
20.7. Footnotes
20.8. Escapes
20.9. Headings
20.10. Links and anchors
20.11. Block quotations
20.12. Line breaks
20.13. Tables
20.14. Images
20.15. Citations
20.16. Inclusion
21. YAM Syntax
21.1. Changes from version 3
21.2. Contents
21.3. Bold, italic, underline and teletype
21.4. Horizontal lines
21.5. Lists
21.6. Verbatim output
21.7. Footnotes
21.8. Escapes
21.9. Headings
21.10. Links and anchors
21.11. Block quotations
21.12. Line breaks
21.13. Tables
21.14. Images
21.15. Citations
21.16. Inclusion
22. YAM Syntax
22.1. Changes from version 3
22.2. Contents
22.3. Bold, italic, underline and teletype
22.4. Horizontal lines
22.5. Lists
22.6. Verbatim output
22.7. Footnotes
22.8. Escapes
22.9. Headings
22.10. Links and anchors
22.11. Block quotations
22.12. Line breaks
22.13. Tables
22.14. Images
22.15. Citations
22.16. Inclusion
23. YAM Syntax
23.1. Changes from version 3
23.2. Contents
23.3. Bold, italic, underline and teletype
23.4. Horizontal lines
23.5. Lists
23.6. Verbatim output
23.7. Footnotes
23.8. Escapes
23.9. Headings
23.10. Links and anchors
23.11. Block quotations
23.12. Line breaks
23.13. Tables
23.14. Images
23.15. Citations
23.16. Inclusion
24. YAM Syntax
24.1. Changes from version 3
24.2. Contents
24.3. Bold, italic, underline and teletype
24.4. Horizontal lines
24.5. Lists
24.6. Verbatim output
24.7. Footnotes
24.8. Escapes
24.9. Headings
24.10. Links and anchors
24.11. Block quotations
24.12. Line breaks
24.13. Tables
24.14. Images
24.15. Citations
24.16. Inclusion
25. YAM Syntax
25.1. Changes from version 3
25.2. Contents
25.3. Bold, italic, underline and teletype
25.4. Horizontal lines
25.5. Lists
25.6. Verbatim output
25.7. Footnotes
25.8. Escapes
25.9. Headings
25.10. Links and anchors
25.11. Block quotations
25.12. Line breaks
25.13. Tables
25.14. Images
25.15. Citations
25.16. Inclusion
26. YAM Syntax
26.1. Changes from version 3
26.2. Contents
26.3. Bold, italic, underline and teletype
26.4. Horizontal lines
26.5. Lists
26.6. Verbatim output
26.7. Footnotes
26.8. Escapes
26.9. Headings
26.10. Links and anchors
26.11. Block quotations
26.12. Line breaks
26.13. Tables
26.14. Images
26.15. Citations
26.16. Inclusion
27. YAM Syntax
27.1. Changes from version 3
27.2. Contents
27.3. Bold, italic, underline and teletype
27.4. Horizontal lines
27.5. Lists
27.6. Verbatim output
27.7. Footnotes
27.8. Escapes
27.9. Headings
27.10. Links and anchors
27.11. Block quotations
27.12. Line breaks
27.13. Tables
27.14. Images
27.15. Citations
27.16. Inclusion
28. YAM Syntax
28.1. Changes from version 3
28.2. Contents
28.3. Bold, italic, underline and teletype
28.4. Horizontal lines
28.5. Lists
28.6. Verbatim output
28.7. Footnotes
28.8. Escapes
28.9. Headings
28.10. Links and anchors
28.11. Block quotations
28.12. Line breaks
28.13. Tables
28.14. Images
28.15. Citations
28.16. Inclusion
29. YAM Syntax
29.1. Changes from version 3
29.2. Contents
29.3. Bold, italic, underline and teletype
29.4. Horizontal lines
29.5. Lists
29.6. Verbatim output
29.7. Footnotes
29.8. Escapes
29.9. Headings
29.10. Links and anchors
29.11. Block quotations
29.12. Line breaks
29.13. Tables
29.14. Images
29.15. Citations
29.16. Inclusion
30. YAM Syntax
30.1. Changes from version 3
30.2. Contents
30.3. Bold, italic, underline and teletype
30.4. Horizontal lines
30.5. Lists
30.6. Verbatim output
30.7. Footnotes
30.8. Escapes
30.9. Headings
30.10. Links and anchors
30.11. Block quotations
30.12. Line breaks
30.13. Tables
30.14. Images
30.15. Citations
30.16. Inclusion
31. YAM Syntax
31.1. Changes from version 3
31.2. Contents
31.3. Bold, italic, underline and teletype
31.4. Horizontal lines
31.5. Lists
31.6. Verbatim output
31.7. Footnotes
31.8. Escapes
31.9. Headings
31.10. Links and anchors
31.11. Block quotations
31.12. Line breaks
31.13. Tables
31.14. Images
31.15. Citations
31.16. Inclusion
32. YAM Syntax
32.1. Changes from version 3
32.2. Contents
32.3. Bold, italic, underline and teletype
32.4. Horizontal lines
32.5. Lists
32.6. Verbatim output
32.7. Footnotes
32.8. Escapes
32.9. Headings
32.10. Links and anchors
32.11. Block quotations
32.12. Line breaks
32.13. Tables
32.14. Images
32.15. Citations
32.16. Inclusion
33. YAM Syntax
33.1. Changes from version 3
33.2. Contents
33.3. Bold, italic, underline and teletype
33.4. Horizontal lines
33.5. Lists
33.6. Verbatim output
33.7. Footnotes
33.8. Escapes
33.9. Headings
33.10. Links and anchors
33.11. Block quotations
33.12. Line breaks
33.13. Tables
33.14. Images
33.15. Citations
33.16. Inclusion
34. YAM Syntax
34.1. Changes from version 3
34.2. Contents
34.3. Bold, italic, underline and teletype
34.4. Horizontal lines
34.5. Lists
34.6. Verbatim output
34.7. Footnotes
34.8. Escapes
34.9. Headings
34.10. Links and anchors
34.11. Block quotations
34.12. Line breaks
34.13. Tables
34.14. Images
34.15. Citations
34.16. Inclusion
35. YAM Syntax
35.1. Changes from version 3
35.2. Contents
35.3. Bold, italic, underline and teletype
35.4. Horizontal lines
35.5. Lists
35.6. Verbatim output
35.7. Footnotes
35.8. Escapes
35.9. Headings
35.10. Links and anchors
35.11. Block quotations
35.12. Line breaks
35.13. Tables
35.14. Images
35.15. Citations
35.16. Inclusion
36. YAM Syntax
36.1. Changes from version 3
36.2. Contents
36.3. Bold, italic, underline and teletype
36.4. Horizontal lines
36.5. Lists
36.6. Verbatim output
36.7. Footnotes
36.8. Escapes
36.9. Headings
36.10. Links and anchors
36.11. Block quotations
36.12. Line breaks
36.13. Tables
36.14. Images
36.15. Citations
36.16. Inclusion
37. YAM Syntax
37.1. Changes from version 3
37.2. Contents
37.3. Bold, italic, underline and teletype
37.4. Horizontal lines
37.5. Lists
37.6. Verbatim output
37.7. Footnotes
37.8. Escapes
37.9. Headings
37.10. Links and anchors
37.11. Block quotations
37.12. Line breaks
37.13. Tables
37.14. Images
37.15. Citations
37.16. Inclusion
38. YAM Syntax
38.1. Changes from version 3
38.2. Contents
38.3. Bold, italic, underline and teletype
38.4. Horizontal lines
38.5. Lists
38.6. Verbatim output
38.7. Footnotes
38.8. Escapes
38.9. Headings
38.10. Links and anchors
38.11. Block quotations
38.12. Line breaks
38.13. Tables
38.14. Images
38.15. Citations
38.16. Inclusion
39. YAM Syntax
39.1. Changes from version 3
39.2. Contents
39.3. Bold, italic, underline and teletype
39.4. Horizontal lines
39.5. Lists
39.6. Verbatim output
39.7. Footnotes
39.8. Escapes
39.9. Headings
39.10. Links and anchors
39.11. Block quotations
39.12. Line breaks
39.13. Tables
39.14. Images
39.15. Citations
39.16. Inclusion
40. YAM Syntax
40.1. Changes from version 3
40.2. Contents
40.3. Bold, italic, underline and teletype
40.4. Horizontal lines
40.5. Lists
40.6. Verbatim output
40.7. Footnotes
40.8. Escapes
40.9. Headings
40.10. Links and anchors
40.11. Block quotations
40.12. Line breaks
40.13. Tables
40.14. Images
40.15. Citations
40.16. Inclusion
41. YAM Syntax
41.1. Changes from version 3
41.2. Contents
41.3. Bold, italic, underline and teletype
41.4. Horizontal lines
41.5. Lists
41.6. Verbatim output
41.7. Footnotes
41.8. Escapes
41.9. Headings
41.10. Links and anchors
41.11. Block quotations
41.12. Line breaks
41.13. Tables
41.14. Images
41.15. Citations
41.16. Inclusion
42. YAM Syntax
42.1. Changes from version 3
42.2. Contents
42.3. Bold, italic, underline and teletype
42.4. Horizontal lines
42.5. Lists
42.6. Verbatim output
42.7. Footnotes
42.8. Escapes
42.9. Headings
42.10. Links and anchors
42.11. Block quotations
42.12. Line breaks
42.13. Tables
42.14. Images
42.15. Citations
42.16. Inclusion
43. YAM Syntax
43.1. Changes from version 3
43.2. Contents
43.3. Bold, italic, underline and teletype
43.4. Horizontal lines
43.5. Lists
43.6. Verbatim output
43.7. Footnotes
43.8. Escapes
43.9. Headings
43.10. Links and anchors
43.11. Block quotations
43.12. Line breaks
43.13. Tables
43.14. Images
43.15. Citations
43.16. Inclusion
44. YAM Syntax
44.1. Changes from version 3
44.2. Contents
44.3. Bold, italic, underline and teletype
44.4. Horizontal lines
44.5. Lists
44.6. Verbatim output
44.7. Footnotes
44.8. Escapes
44.9. Headings
44.10. Links and anchors
44.11. Block quotations
44.12. Line breaks
44.13. Tables
44.14. Images
44.15. Citations
44.16. Inclusion
45. YAM Syntax
45.1. Changes from version 3
45.2. Contents
45.3. Bold, italic, underline and teletype
45.4. Horizontal lines
45.5. Lists
45.6. Verbatim output
45.7. Footnotes
45.8. Escapes
45.9. Headings
45.10. Links and anchors
45.11. Block quotations
45.12. Line breaks
45.13. Tables
45.14. Images
45.15. Citations
45.16. Inclusion
46. YAM Syntax
46.1. Changes from version 3
46.2. Contents
46.3. Bold, italic, underline and teletype
46.4. Horizontal lines
46.5. Lists
46.6. Verbatim output
46.7. Footnotes
46.8. Escapes
46.9. Headings
46.10. Links and anchors
46.11. Block quotations
46.12. Line breaks
46.13. Tables
46.14. Images
46.15. Citations
46.16. Inclusion
47. YAM Syntax
47.1. Changes from version 3
47.2. Contents
47.3. Bold, italic, underline and teletype
47.4. Horizontal lines
47.5. Lists
47.6. Verbatim output
47.7. Footnotes
47.8. Escapes
47.9. Headings
47.10. Links and anchors
47.11. Block quotations
47.12. Line breaks
47.13. Tables
47.14. Images
47.15. Citations
47.16. Inclusion
48. YAM Syntax
48.1. Changes from version 3
48.2. Contents
48.3. Bold, italic, underline and teletype
48.4. Horizontal lines
48.5. Lists
48.6. Verbatim output
48.7. Footnotes
48.8. Escapes
48.9. Headings
48.10. Links and anchors
48.11. Block quotations
48.12. Line breaks
48.13. Tables
48.14. Images
48.15. Citations
48.16. Inclusion
49. YAM Syntax
49.1. Changes from version 3
49.2. Contents
49.3. Bold, italic, underline and teletype
49.4. Horizontal lines
49.5. Lists
49.6. Verbatim output
49.7. Footnotes
49.8. Escapes
49.9. Headings
49.10. Links and anchors
49.11. Block quotations
49.12. Line breaks
49.13. Tables
49.14. Images
49.15. Citations
49.16. Inclusion
50. YAM Syntax
50.1. Changes from version 3
50.2. Contents
50.3. Bold, italic, underline and teletype
50.4. Horizontal lines
50.5. Lists
50.6. Verbatim output
50.7. Footnotes
50.8. Escapes
50.9. Headings
50.10. Links and anchors
50.11. Block quotations
50.12. Line breaks
50.13. Tables
50.14. Images
50.15. Citations
50.16. Inclusion
51. YAM Syntax
51.1. Changes from version 3
51.2. Contents
51.3. Bold, italic, underline and teletype
51.4. Horizontal lines
51.5. Lists
51.6. Verbatim output
51.7. Footnotes
51.8. Escapes
51.9. Headings
51.10. Links and anchors
51.11. Block quotations
51.12. Line breaks
51.13. Tables
51.14. Images
51.15. Citations
51.16. Inclusion
52. YAM Syntax
52.1. Changes from version 3
52.2. Contents
52.3. Bold, italic, underline and teletype
52.4. Horizontal lines
52.5. Lists
52.6. Verbatim output
52.7. Footnotes
52.8. Escapes
52.9. Headings
52.10. Links and anchors
52.11. Block quotations
52.12. Line breaks
52.13. Tables
52.14. Images
52.15. Citations
52.16. Inclusion
53. YAM Syntax
53.1. Changes from version 3
53.2. Contents
53.3. Bold, italic, underline and teletype
53.4. Horizontal lines
53.5. Lists
53.6. Verbatim output
53.7. Footnotes
53.8. Escapes
53.9. Headings
53.10. Links and anchors
53.11. Block quotations
53.12. Line breaks
53.13. Tables
53.14. Images
53.15. Citations
53.16. Inclusion
54. YAM Syntax
54.1. Changes from version 3
54.2. Contents
54.3. Bold, italic, underline and teletype
54.4. Horizontal lines
54.5. Lists
54.6. Verbatim output
54.7. Footnotes
54.8. Escapes
54.9. Headings
54.10. Links and anchors
54.11. Block quotations
54.12. Line breaks
54.13. Tables
54.14. Images
54.15. Citations
54.16. Inclusion
55. YAM Syntax
55.1. Changes from version 3
55.2. Contents
55.3. Bold, italic, underline and teletype
55.4. Horizontal lines
55.5. Lists
55.6. Verbatim output
55.7. Footnotes
55.8. Escapes
55.9. Headings
55.10. Links and anchors
55.11. Block quotations
55.12. Line breaks
55.13. Tables
55.14. Images
55.15. Citations
55.16. Inclusion
56. YAM Syntax
56.1. Changes from version 3
56.2. Contents
56.3. Bold, italic, underline and teletype
56.4. Horizontal lines
56.5. Lists
56.6. Verbatim output
56.7. Footnotes
56.8. Escapes
56.9. Headings
56.10. Links and anchors
56.11. Block quotations
56.12. Line breaks
56.13. Tables
56.14. Images
56.15. Citations
56.16. Inclusion
57. YAM Syntax
57.1. Changes from version 3
57.2. Contents
57.3. Bold, italic, underline and teletype
57.4. Horizontal lines
57.5. Lists
57.6. Verbatim output
57.7. Footnotes
57.8. Escapes
57.9. Headings
57.10. Links and anchors
57.11. Block quotations
57.12. Line breaks
57.13. Tables
57.14. Images
57.15. Citations
57.16. Inclusion
58. YAM Syntax
58.1. Changes from version 3
58.2. Contents
58.3. Bold, italic, underline and teletype
58.4. Horizontal lines
58.5. Lists
58.6. Verbatim output
58.7. Footnotes
58.8. Escapes
58.9. Headings
58.10. Links and anchors
58.11. Block quotations
58.12. Line breaks
58.13. Tables
58.14. Images
58.15. Citations
58.16. Inclusion
59. YAM Syntax
59.1. Changes from version 3
59.2. Contents
59.3. Bold, italic, underline and teletype
59.4. Horizontal lines
59.5. Lists
59.6. Verbatim output
59.7. Footnotes
59.8. Escapes
59.9. Headings
59.10. Links and anchors
59.11. Block quotations
59.12. Line breaks
59.13. Tables
59.14. Images
59.15. Citations
59.16. Inclusion
60. YAM Syntax
60.1. Changes from version 3
60.2. Contents
60.3. Bold, italic, underline and teletype
60.4. Horizontal lines
60.5. Lists
60.6. Verbatim output
60.7. Footnotes
60.8. Escapes
60.9. Headings
60.10. Links and anchors
60.11. Block quotations
60.12. Line breaks
60.13. Tables
60.14. Images
60.15. Citations
60.16. Inclusion
61. YAM Syntax
61.1. Changes from version 3
61.2. Contents
61.3. Bold, italic, underline and teletype
61.4. Horizontal lines
61.5. Lists
61.6. Verbatim output
61.7. Footnotes
61.8. Escapes
61.9. Headings
61.10. Links and anchors
61.11. Block quotations
61.12. Line breaks
61.13. Tables
61.14. Images
61.15. Citations
61.16. Inclusion
62. YAM Syntax
62.1. Changes from version 3
62.2. Contents
62.3. Bold, italic, underline and teletype
62.4. Horizontal lines
62.5. Lists
62.6. Verbatim output
62.7. Footnotes
62.8. Escapes
62.9. Headings
62.10. Links and anchors
62.11. Block quotations
62.12. Line breaks
62.13. Tables
62.14. Images
62.15. Citations
62.16. Inclusion
63. YAM Syntax
63.1. Changes from version 3
63.2. Contents
63.3. Bold, italic, underline and teletype
63.4. Horizontal lines
63.5. Lists
63.6. Verbatim output
63.7. Footnotes
63.8. Escapes
63.9. Headings
63.10. Links and anchors
63.11. Block quotations
63.12. Line breaks
63.13. Tables
63.14. Images
63.15. Citations
63.16. Inclusion
64. YAM Syntax
64.1. Changes from version 3
64.2. Contents
64.3. Bold, italic, underline and teletype
64.4. Horizontal lines
64.5. Lists
64.6. Verbatim output
64.7. Footnotes
64.8. Escapes
64.9. Headings
64.10. Links and anchors
64.11. Block quotations
64.12. Line breaks
64.13. Tables
64.14. Images
64.15. Citations
64.16. Inclusion
65. YAM Syntax
65.1. Changes from version 3
65.2. Contents
65.3. Bold, italic, underline and teletype
65.4. Horizontal lines
65.5. Lists
65.6. Verbatim output
65.7. Footnotes
65.8. Escapes
65.9. Headings
65.10. Links and anchors
65.11. Block quotations
65.12. Line breaks
65.13. Tables
65.14. Images
65.15. Citations
65.16. Inclusion
66. YAM Syntax
66.1. Changes from version 3
66.2. Contents
66.3. Bold, italic, underline and teletype
66.4. Horizontal lines
66.5. Lists
66.6. Verbatim output
66.7. Footnotes
66.8. Escapes
66.9. Headings
66.10. Links and anchors
66.11. Block quotations
66.12. Line breaks
66.13. Tables
66.14. Images
66.15. Citations
66.16. Inclusion
67. YAM Syntax
67.1. Changes from version 3
67.2. Contents
67.3. Bold, italic, underline and teletype
67.4. Horizontal lines
67.5. Lists
67.6. Verbatim output
67.7. Footnotes
67.8. Escapes
67.9. Headings
67.10. Links and anchors
67.11. Block quotations
67.12. Line breaks
67.13. Tables
67.14. Images
67.15. Citations
67.16. Inclusion
68. YAM Syntax
68.1. Changes from version 3
68.2. Contents
68.3. Bold, italic, underline and teletype
68.4. Horizontal lines
68.5. Lists
68.6. Verbatim output
68.7. Footnotes
68.8. Escapes
68.9. Headings
68.10. Links and anchors
68.11. Block quotations
68.12. Line breaks
68.13. Tables
68.14. Images
68.15. Citations
68.16. Inclusion
69. YAM Syntax
69.1. Changes from version 3
69.2. Contents
69.3. Bold, italic, underline and teletype
69.4. Horizontal lines
69.5. Lists
69.6. Verbatim output
69.7. Footnotes
69.8. Escapes
69.9. Headings
69.10. Links and anchors
69.11. Block quotations
69.12. Line breaks
69.13. Tables
69.14. Images
69.15. Citations
69.16. Inclusion
70. YAM Syntax
70.1. Changes from version 3
70.2. Contents
70.3. Bold, italic, underline and teletype
70.4. Horizontal lines
70.5. Lists
70.6. Verbatim output
70.7. Footnotes
70.8. Escapes
70.9. Headings
70.10. Links and anchors
70.11. Block quotations
70.12. Line breaks
70.13. Tables
70.14. Images
70.15. Citations
70.16. Inclusion
71. YAM Syntax
71.1. Changes from version 3
71.2. Contents
71.3. Bold, italic, underline and teletype
71.4. Horizontal lines
71.5. Lists
71.6. Verbatim output
71.7. Footnotes
71.8. Escapes
71.9. Headings
71.10. Links and anchors
71.11. Block quotations
71.12. Line breaks
71.13. Tables
71.14. Images
71.15. Citations
71.16. Inclusion
72. YAM Syntax
72.1. Changes from version 3
72.2. Contents
72.3. Bold, italic, underline and teletype
72.4. Horizontal lines
72.5. Lists
72.6. Verbatim output
72.7. Footnotes
72.8. Escapes
72.9. Headings
72.10. Links and anchors
72.11. Block quotations
72.12. Line breaks
72.13. Tables
72.14. Images
72.15. Citations
72.16. Inclusion
73. YAM Syntax
73.1. Changes from version 3
73.2. Contents
73.3. Bold, italic, underline and teletype
73.4. Horizontal lines
73.5. Lists
73.6. Verbatim output
73.7. Footnotes
73.8. Escapes
73.9. Headings
73.10. Links and anchors
73.11. Block quotations
73.12. Line breaks
73.13. Tables
73.14. Images
73.15. Citations
73.16. Inclusion
74. YAM Syntax
74.1. Changes from version 3
74.2. Contents
74.3. Bold, italic, underline and teletype
74.4. Horizontal lines
74.5. Lists
74.6. Verbatim output
74.7. Footnotes
74.8. Escapes
74.9. Headings
74.10. Links and anchors
74.11. Block quotations
74.12. Line breaks
74.13. Tables
74.14. Images
74.15. Citations
74.16. Inclusion
75. YAM Syntax
75.1. Changes from version 3
75.2. Contents
75.3. Bold, italic, underline and teletype
75.4. Horizontal lines
75.5. Lists
75.6. Verbatim output
75.7. Footnotes
75.8. Escapes
75.9. Headings
75.10. Links and anchors
75.11. Block quotations
75.12. Line breaks
75.13. Tables
75.14. Images
75.15. Citations
75.16. Inclusion
76. YAM Syntax
76.1. Changes from version 3
76.2. Contents
76.3. Bold, italic, underline and teletype
76.4. Horizontal lines
76.5. Lists
76.6. Verbatim output
76.7. Footnotes
76.8. Escapes
76.9. Headings
76.10. Links and anchors
76.11. Block quotations
76.12. Line breaks
76.13. Tables
76.14. Images
76.15. Citations
76.16. Inclusion
77. YAM Syntax
77.1. Changes from version 3
77.2. Contents
77.3. Bold, italic, underline and teletype
77.4. Horizontal lines
77.5. Lists
77.6. Verbatim output
77.7. Footnotes
77.8. Escapes
77.9. Headings
77.10. Links and anchors
77.11. Block quotations
77.12. Line breaks
77.13. Tables
77.14. Images
77.15. Citations
77.16. Inclusion
78. YAM Syntax
78.1. Changes from version 3
78.2. Contents
78.3. Bold, italic, underline and teletype
78.4. Horizontal lines
78.5. Lists
78.6. Verbatim output
78.7. Footnotes
78.8. Escapes
78.9. Headings
78.10. Links and anchors
78.11. Block quotations
78.12. Line breaks
78.13. Tables
78.14. Images
78.15. Citations
78.16. Inclusion
79. YAM Syntax
79.1. Changes from version 3
79.2. Contents
79.3. Bold, italic, underline and teletype
79.4. Horizontal lines
79.5. Lists
79.6. Verbatim output
79.7. Footnotes
79.8. Escapes
79.9. Headings
79.10. Links and anchors
79.11. Block quotations
79.12. Line breaks
79.13. Tables
79.14. Images
79.15. Citations
79.16. Inclusion
80. YAM Syntax
80.1. Changes from version 3
80.2. Contents
80.3. Bold, italic, underline and teletype
80.4. Horizontal lines
80.5. Lists
80.6. Verbatim output
80.7. Footnotes
80.8. Escapes
80.9. Headings
80.10. Links and anchors
80.11. Block quotations
80.12. Line breaks
80.13. Tables
80.14. Images
80.15. Citations
80.16. Inclusion
81. YAM Syntax
81.1. Changes from version 3
81.2. Contents
81.3. Bold, italic, underline and teletype
81.4. Horizontal lines
81.5. Lists
81.6. Verbatim output
81.7. Footnotes
81.8. Escapes
81.9. Headings
81.10. Links and anchors
81.11. Block quotations
81.12. Line breaks
81.13. Tables
81.14. Images
81.15. Citations
81.16. Inclusion
82. YAM Syntax
82.1. Changes from version 3
82.2. Contents
82.3. Bold, italic, underline and teletype
82.4. Horizontal lines
82.5. Lists
82.6. Verbatim output
82.7. Footnotes
82.8. Escapes
82.9. Headings
82.10. Links and anchors
82.11. Block quotations
82.12. Line breaks
82.13. Tables
82.14. Images
82.15. Citations
82.16. Inclusion
83. YAM Syntax
83.1. Changes from version 3
83.2. Contents
83.3. Bold, italic, underline and teletype
83.4. Horizontal lines
83.5. Lists
83.6. Verbatim output
83.7. Footnotes
83.8. Escapes
83.9. Headings
83.10. Links and anchors
83.11. Block quotations
83.12. Line breaks
83.13. Tables
83.14. Images
83.15. Citations
83.16. Inclusion
84. YAM Syntax
84.1. Changes from version 3
84.2. Contents
84.3. Bold, italic, underline and teletype
84.4. Horizontal lines
84.5. Lists
84.6. Verbatim output
84.7. Footnotes
84.8. Escapes
84.9. Headings
84.10. Links and anchors
84.11. Block quotations
84.12. Line breaks
84.13. Tables
84.14. Images
84.15. Citations
84.16. Inclusion
85. YAM Syntax
85.1. Changes from version 3
85.2. Contents
85.3. Bold, italic, underline and teletype
85.4. Horizontal lines
85.5. Lists
85.6. Verbatim output
85.7. Footnotes
85.8. Escapes
85.9. Headings
85.10. Links and anchors
85.11. Block quotations
85.12. Line breaks
85.13. Tables
85.14. Images
85.15. Citations
85.16. Inclusion
86. YAM Syntax
86.1. Changes from version 3
86.2. Contents
86.3. Bold, italic, underline and teletype
86.4. Horizontal lines
86.5. Lists
86.6. Verbatim output
86.7. Footnotes
86.8. Escapes
86.9. Headings
86.10. Links and anchors
86.11. Block quotations
86.12. Line breaks
86.13. Tables
86.14. Images
86.15. Citations
86.16. Inclusion
87. YAM Syntax
87.1. Changes from version 3
87.2. Contents
87.3. Bold, italic, underline and teletype
87.4. Horizontal lines
87.5. Lists
87.6. Verbatim output
87.7. Footnotes
87.8. Escapes
87.9. Headings
87.10. Links and anchors
87.11. Block quotations
87.12. Line breaks
87.13. Tables
87.14. Images
87.15. Citations
87.16. Inclusion
88. YAM Syntax
88.1. Changes from version 3
88.2. Contents
88.3. Bold, italic, underline and teletype
88.4. Horizontal lines
88.5. Lists
88.6. Verbatim output
88.7. Footnotes
88.8. Escapes
88.9. Headings
88.10. Links and anchors
88.11. Block quotations
88.12. Line breaks
88.13. Tables
88.14. Images
88.15. Citations
88.16. Inclusion
89. YAM Syntax
89.1. Changes from version 3
89.2. Contents
89.3. Bold, italic, underline and teletype
89.4. Horizontal lines
89.5. Lists
89.6. Verbatim output
89.7. Footnotes
89.8. Escapes
89.9. Headings
89.10. Links and anchors
89.11. Block quotations
89.12. Line breaks
89.13. Tables
89.14. Images
89.15. Citations
89.16. Inclusion
90. YAM Syntax
90.1. Changes from version 3
90.2. Contents
90.3. Bold, italic, underline and teletype
90.4. Horizontal lines
90.5. Lists
90.6. Verbatim output
90.7. Footnotes
90.8. Escapes
90.9. Headings
90.10. Links and anchors
90.11. Block quotations
90.12. Line breaks
90.13. Tables
90.14. Images
90.15. Citations
90.16. Inclusion
91. YAM Syntax
91.1. Changes from version 3
91.2. Contents
91.3. Bold, italic, underline and teletype
91.4. Horizontal lines
91.5. Lists
91.6. Verbatim output
91.7. Footnotes
91.8. Escapes
91.9. Headings
91.10. Links and anchors
91.11. Block quotations
91.12. Line breaks
91.13. Tables
91.14. Images
91.15. Citations
91.16. Inclusion
92. YAM Syntax
92.1. Changes from version 3
92.2. Contents
92.3. Bold, italic, underline and teletype
92.4. Horizontal lines
92.5. Lists
92.6. Verbatim output
92.7. Footnotes
92.8. Escapes
92.9. Headings
92.10. Links and anchors
92.11. Block quotations
92.12. Line breaks
92.13. Tables
92.14. Images
92.15. Citations
92.16. Inclusion
93. YAM Syntax
93.1. Changes from version 3
93.2. Contents
93.3. Bold, italic, underline and teletype
93.4. Horizontal lines
93.5. Lists
93.6. Verbatim output
93.7. Footnotes
93.8. Escapes
93.9. Headings
93.10. Links and anchors
93.11. Block quotations
93.12. Line breaks
93.13. Tables
93.14. Images
93.15. Citations
93.16. Inclusion
94. YAM Syntax
94.1. Changes from version 3
94.2. Contents
94.3. Bold, italic, underline and teletype
94.4. Horizontal lines
94.5. Lists
94.6. Verbatim output
94.7. Footnotes
94.8. Escapes
94.9. Headings
94.10. Links and anchors
94.11. Block quotations
94.12. Line breaks
94.13. Tables
94.14. Images
94.15. Citations
94.16. Inclusion
95. YAM Syntax
95.1. Changes from version 3
95.2. Contents
95.3. Bold, italic, underline and teletype
95.4. Horizontal lines
95.5. Lists
95.6. Verbatim output
95.7. Footnotes
95.8. Escapes
95.9. Headings
95.10. Links and anchors
95.11. Block quotations
95.12. Line breaks
95.13. Tables
95.14. Images
95.15. Citations
95.16. Inclusion
96. YAM Syntax
96.1. Changes from version 3
96.2. Contents
96.3. Bold, italic, underline and teletype
96.4. Horizontal lines
96.5. Lists
96.6. Verbatim output
96.7. Footnotes
96.8. Escapes
96.9. Headings
96.10. Links and anchors
96.11. Block quotations
96.12. Line breaks
96.13. Tables
96.14. Images
96.15. Citations
96.16. Inclusion
97. YAM Syntax
97.1. Changes from version 3
97.2. Contents
97.3. Bold, italic, underline and teletype
97.4. Horizontal lines
97.5. Lists
97.6. Verbatim output
97.7. Footnotes
97.8. Escapes
97.9. Headings
97.10. Links and anchors
97.11. Block quotations
97.12. Line breaks
97.13. Tables
97.14. Images
97.15. Citations
97.16. Inclusion
98. YAM Syntax
98.1. Changes from version 3
98.2. Contents
98.3. Bold, italic, underline and teletype
98.4. Horizontal lines
98.5. Lists
98.6. Verbatim output
98.7. Footnotes
98.8. Escapes
98.9. Headings
98.10. Links and anchors
98.11. Block quotations
98.12. Line breaks
98.13. Tables
98.14. Images
98.15. Citations
98.16. Inclusion
99. YAM Syntax
99.1. Changes from version 3
99.2. Contents
99.3. Bold, italic, underline and teletype
99.4. Horizontal lines
99.5. Lists
99.6. Verbatim output
99.7. Footnotes
99.8. Escapes
99.9. Headings
99.10. Links and anchors
99.11. Block quotations
99.12. Line breaks
99.13. Tables
99.14. Images
99.15. Citations
99.16. Inclusion
100. YAM Syntax
100.1. Changes from version 3
100.2. Contents
100.3. Bold, italic, underline and teletype
100.4. Horizontal lines
100.5. Lists
100.6. Verbatim output
100.7. Footnotes
100.8. Escapes
100.9. Headings
100.10. Links and anchors
100.11. Block quotations
100.12. Line breaks
100.13. Tables
100.14. Images
100.15. Citations
100.16. Inclusion
101. YAM Syntax
101.1. Changes from version 3
101.2. Contents
101.3. Bold, italic, underline and teletype
101.4. Horizontal lines
101.5. Lists
101.6. Verbatim output
101.7. Footnotes
101.8. Escapes
101.9. Headings
101.10. Links and anchors
101.11. Block quotations
101.12. Line breaks
101.13. Tables
101.14. Images
101.15. Citations
101.16. Inclusion
102. YAM Syntax
102.1. Changes from version 3
102.2. Contents
102.3. Bold, italic, underline and teletype
102.4. Horizontal lines
102.5. Lists
102.6. Verbatim output
102.7. Footnotes
102.8. Escapes
102.9. Headings
102.10. Links and anchors
102.11. Block quotations
102.12. Line breaks
102.13. Tables
102.14. Images
102.15. Citations
102.16. Inclusion
103. YAM Syntax
103.1. Changes from version 3
103.2. Contents
103.3. Bold, italic, underline and teletype
103.4. Horizontal lines
103.5. Lists
103.6. Verbatim output
103.7. Footnotes
103.8. Escapes
103.9. Headings
103.10. Links and anchors
103.11. Block quotations
103.12. Line breaks
103.13. Tables
103.14. Images
103.15. Citations
103.16. Inclusion
104. YAM Syntax
104.1. Changes from version 3
104.2. Contents
104.3. Bold, italic, underline and teletype
104.4. Horizontal lines
104.5. Lists
104.6. Verbatim output
104.7. Footnotes
104.8. Escapes
104.9. Headings
104.10. Links and anchors
104.11. Block quotations
104.12. Line breaks
104.13. Tables
104.14. Images
104.15. Citations
104.16. Inclusion
105. YAM Syntax
105.1. Changes from version 3
105.2. Contents
105.3. Bold, italic, underline and teletype
105.4. Horizontal lines
105.5. Lists
105.6. Verbatim output
105.7. Footnotes
105.8. Escapes
105.9. Headings
105.10. Links and anchors
105.11. Block quotations
105.12. Line breaks
105.13. Tables
105.14. Images
105.15. Citations
105.16. Inclusion
106. YAM Syntax
106.1. Changes from version 3
106.2. Contents
106.3. Bold, italic, underline and teletype
106.4. Horizontal lines
106.5. Lists
106.6. Verbatim output
106.7. Footnotes
106.8. Escapes
106.9. Headings
106.10. Links and anchors
106.11. Block quotations
106.12. Line breaks
106.13. Tables
106.14. Images
106.15. Citations
106.16. Inclusion
107. YAM Syntax
107.1. Changes from version 3
107.2. Contents
107.3. Bold, italic, underline and teletype
107.4. Horizontal lines
107.5. Lists
107.6. Verbatim output
107.7. Footnotes
107.8. Escapes
107.9. Headings
107.10. Links and anchors
107.11. Block quotations
107.12. Line breaks
107.13. Tables
107.14. Images
107.15. Citations
107.16. Inclusion
108. YAM Syntax
108.1. Changes from version 3
108.2. Contents
108.3. Bold, italic, underline and teletype
108.4. Horizontal lines
108.5. Lists
108.6. Verbatim output
108.7. Footnotes
108.8. Escapes
108.9. Headings
108.10. Links and anchors
108.11. Block quotations
108.12. Line breaks
108.13. Tables
108.14. Images
108.15. Citations
108.16. Inclusion
109. YAM Syntax
109.1. Changes from version 3
109.2. Contents
109.3. Bold, italic, underline and teletype
109.4. Horizontal lines
109.5. Lists
109.6. Verbatim output
109.7. Footnotes
109.8. Escapes
109.9. Headings
109.10. Links and anchors
109.11. Block quotations
109.12. Line breaks
109.13. Tables
109.14. Images
109.15. Citations
109.16. Inclusion
110. YAM Syntax
110.1. Changes from version 3
110.2. Contents
110.3. Bold, italic, underline and teletype
110.4. Horizontal lines
110.5. Lists
110.6. Verbatim output
110.7. Footnotes
110.8. Escapes
110.9. Headings
110.10. Links and anchors
110.11. Block quotations
110.12. Line breaks
110.13. Tables
110.14. Images
110.15. Citations
110.16. Inclusion
111. YAM Syntax
111.1. Changes from version 3
111.2. Contents
111.3. Bold, italic, underline and teletype
111.4. Horizontal lines
111.5. Lists
111.6. Verbatim output
111.7. Footnotes
111.8. Escapes
111.9. Headings
111.10. Links and anchors
111.11. Block quotations
111.12. Line breaks
111.13. Tables
111.14. Images
111.15. Citations
111.16. Inclusion
112. YAM Syntax
112.1. Changes from version 3
112.2. Contents
112.3. Bold, italic, underline and teletype
112.4. Horizontal lines
112.5. Lists
112.6. Verbatim output
112.7. Footnotes
112.8. Escapes
112.9. Headings
112.10. Links and anchors
112.11. Block quotations
112.12. Line breaks
112.13. Tables
112.14. Images
112.15. Citations
112.16. Inclusion
113. YAM Syntax
113.1. Changes from version 3
113.2. Contents
113.3. Bold, italic, underline and teletype
113.4. Horizontal lines
113.5. Lists
113.6. Verbatim output
113.7. Footnotes
113.8. Escapes
113.9. Headings
113.10. Links and anchors
113.11. Block quotations
113.12. Line breaks
113.13. Tables
113.14. Images
113.15. Citations
113.16. Inclusion
114. YAM Syntax
114.1. Changes from version 3
114.2. Contents
114.3. Bold, italic, underline and teletype
114.4. Horizontal lines
114.5. Lists
114.6. Verbatim output
114.7. Footnotes
114.8. Escapes
114.9. Headings
114.10. Links and anchors
114.11. Block quotations
114.12. Line breaks
114.13. Tables
114.14. Images
114.15. Citations
114.16. Inclusion

114. YAM Syntax

114.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

114.2. Contents

Contents listings like that above are generated by '%contents'

114.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

114.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

114.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

114.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

114.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹⁴.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

114.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

114.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

114.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

114.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

114.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

114.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

114.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

114.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.