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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

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:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

75.15. Citations

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

75.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM minimal test file.

76. YAM Syntax

76.1. Changes from version 3

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

Slides: maybe:

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

76.2. Contents

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

76.3. Bold, italic, underline and teletype

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

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

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

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

76.4. Horizontal lines

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

---

and

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

both result in:

---

76.5. Lists

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

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

results in:

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

76.6. Verbatim output

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

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

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

76.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁵.

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

76.8. Escapes

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

 \--- 

will not generate a line.

76.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

76.10. Links and anchors

Links can be specified in three ways:

1. As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
2. Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
3. 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:

This is a quote

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

76.15. Citations

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

76.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

Footnotes

1. This is a footnote.
2. This is a footnote.
3. This is a footnote.
4. This is a footnote.
5. This is a footnote.
6. This is a footnote.
7. This is a footnote.
8. This is a footnote.
9. This is a footnote.
10. This is a footnote.
11. This is a footnote.
12. This is a footnote.
13. This is a footnote.
14. This is a footnote.
15. This is a footnote.
16. This is a footnote.
17. This is a footnote.
18. This is a footnote.
19. This is a footnote.
20. This is a footnote.
21. This is a footnote.
22. This is a footnote.
23. This is a footnote.
24. This is a footnote.
25. This is a footnote.
26. This is a footnote.
27. This is a footnote.
28. This is a footnote.
29. This is a footnote.
30. This is a footnote.
31. This is a footnote.
32. This is a footnote.
33. This is a footnote.
34. This is a footnote.
35. This is a footnote.
36. This is a footnote.
37. This is a footnote.
38. This is a footnote.
39. This is a footnote.
40. This is a footnote.
41. This is a footnote.
42. This is a footnote.
43. This is a footnote.
44. This is a footnote.
45. This is a footnote.
46. This is a footnote.
47. This is a footnote.
48. This is a footnote.
49. This is a footnote.
50. This is a footnote.
51. This is a footnote.
52. This is a footnote.
53. This is a footnote.
54. This is a footnote.
55. This is a footnote.
56. This is a footnote.
57. This is a footnote.
58. This is a footnote.
59. This is a footnote.
60. This is a footnote.
61. This is a footnote.
62. This is a footnote.
63. This is a footnote.
64. This is a footnote.
65. This is a footnote.
66. This is a footnote.
67. This is a footnote.
68. This is a footnote.
69. This is a footnote.
70. This is a footnote.
71. This is a footnote.
72. This is a footnote.
73. This is a footnote.
74. This is a footnote.
75. This is a footnote.