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.

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

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.