This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

1. A level 1 heading

1.1. A level 2 heading

1.1.1. A level 3 heading

2. A level 1 heading YAM Syntax

3. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

3.1. Contents

3.2. Bold, italic, underline and teletype

3.2.1. lkjfsldfkjsdf

3.2.2. lksjdflsdkjfl

3.2.2.1. slkdjfsd

3.2.2.1.1.

3.2.3.

3.3. Horizontal lines

4. Lists

4.1. Verbatim output

4.2. Footnotes

4.3. Escapes

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

4.5. Headings

An unnumbered heading

An unnumbered heading

4.6. Links and anchors

4.7. A Heading

4.8. Block quotations

4.9. Line breaks

5. Tables

5.1. Images

5.2. Citations

5.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

5.4. A level 1 heading

5.4.1. A level 2 heading

5.4.1.1. A level 3 heading

5.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

²

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

7. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:³.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

10. A level 1 heading

10.1. A level 2 heading

10.1.1. A level 3 heading

11. A level 1 heading YAM Syntax

12. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

12.1. Contents

12.2. Bold, italic, underline and teletype

12.2.1. lkjfsldfkjsdf

12.2.2. lksjdflsdkjfl

12.2.2.1. slkdjfsd

12.2.2.1.1.

12.2.3.

12.3. Horizontal lines

13. Lists

13.1. Verbatim output

13.2. Footnotes

13.3. Escapes

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

13.5. Headings

An unnumbered heading

An unnumbered heading

13.6. Links and anchors

13.7. A Heading

13.8. Block quotations

13.9. Line breaks

14. Tables

14.1. Images

14.2. Citations

14.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

14.4. A level 1 heading

14.4.1. A level 2 heading

14.4.1.1. A level 3 heading

14.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

⁶

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

16. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:⁷.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

19. A level 1 heading

19.1. A level 2 heading

19.1.1. A level 3 heading

20. A level 1 heading YAM Syntax

21. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

21.1. Contents

21.2. Bold, italic, underline and teletype

21.2.1. lkjfsldfkjsdf

21.2.2. lksjdflsdkjfl

21.2.2.1. slkdjfsd

21.2.2.1.1.

21.2.3.

21.3. Horizontal lines

22. Lists

22.1. Verbatim output

22.2. Footnotes

22.3. Escapes

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

22.5. Headings

An unnumbered heading

An unnumbered heading

22.6. Links and anchors

22.7. A Heading

22.8. Block quotations

22.9. Line breaks

23. Tables

23.1. Images

23.2. Citations

23.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

23.4. A level 1 heading

23.4.1. A level 2 heading

23.4.1.1. A level 3 heading

23.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁰

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

25. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:¹¹.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

28. A level 1 heading

28.1. A level 2 heading

28.1.1. A level 3 heading

29. A level 1 heading YAM Syntax

30. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

30.1. Contents

30.2. Bold, italic, underline and teletype

30.2.1. lkjfsldfkjsdf

30.2.2. lksjdflsdkjfl

30.2.2.1. slkdjfsd

30.2.2.1.1.

30.2.3.

30.3. Horizontal lines

31. Lists

31.1. Verbatim output

31.2. Footnotes

31.3. Escapes

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

31.5. Headings

An unnumbered heading

An unnumbered heading

31.6. Links and anchors

31.7. A Heading

31.8. Block quotations

31.9. Line breaks

32. Tables

32.1. Images

32.2. Citations

32.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

32.4. A level 1 heading

32.4.1. A level 2 heading

32.4.1.1. A level 3 heading

32.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁴

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

34. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:¹⁵.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

37. A level 1 heading

37.1. A level 2 heading

37.1.1. A level 3 heading

38. A level 1 heading YAM Syntax

39. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

39.1. Contents

39.2. Bold, italic, underline and teletype

39.2.1. lkjfsldfkjsdf

39.2.2. lksjdflsdkjfl

39.2.2.1. slkdjfsd

39.2.2.1.1.

39.2.3.

39.3. Horizontal lines

40. Lists

40.1. Verbatim output

40.2. Footnotes

40.3. Escapes

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

40.5. Headings

An unnumbered heading

An unnumbered heading

40.6. Links and anchors

40.7. A Heading

40.8. Block quotations

40.9. Line breaks

41. Tables

41.1. Images

41.2. Citations

41.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

41.4. A level 1 heading

41.4.1. A level 2 heading

41.4.1.1. A level 3 heading

41.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁸

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

43. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:¹⁹.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

46. A level 1 heading

46.1. A level 2 heading

46.1.1. A level 3 heading

47. A level 1 heading YAM Syntax

48. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

48.1. Contents

48.2. Bold, italic, underline and teletype

48.2.1. lkjfsldfkjsdf

48.2.2. lksjdflsdkjfl

48.2.2.1. slkdjfsd

48.2.2.1.1.

48.2.3.

48.3. Horizontal lines

49. Lists

49.1. Verbatim output

49.2. Footnotes

49.3. Escapes

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

49.5. Headings

An unnumbered heading

An unnumbered heading

49.6. Links and anchors

49.7. A Heading

49.8. Block quotations

49.9. Line breaks

50. Tables

50.1. Images

50.2. Citations

50.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

50.4. A level 1 heading

50.4.1. A level 2 heading

50.4.1.1. A level 3 heading

50.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

²²

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

52. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:²³.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

55. A level 1 heading

55.1. A level 2 heading

55.1.1. A level 3 heading

56. A level 1 heading YAM Syntax

57. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

57.1. Contents

57.2. Bold, italic, underline and teletype

57.2.1. lkjfsldfkjsdf

57.2.2. lksjdflsdkjfl

57.2.2.1. slkdjfsd

57.2.2.1.1.

57.2.3.

57.3. Horizontal lines

58. Lists

58.1. Verbatim output

58.2. Footnotes

58.3. Escapes

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

58.5. Headings

An unnumbered heading

An unnumbered heading

58.6. Links and anchors

58.7. A Heading

58.8. Block quotations

58.9. Line breaks

59. Tables

59.1. Images

59.2. Citations

59.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

59.4. A level 1 heading

59.4.1. A level 2 heading

59.4.1.1. A level 3 heading

59.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

²⁶

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

61. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:²⁷.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj

It is possible to have a

blockquote almost

-

• sdfsdfsdfa

anywhere!

Another block quote.

Blockquoate

• with a list
• or two

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

64. A level 1 heading

64.1. A level 2 heading

64.1.1. A level 3 heading

65. A level 1 heading YAM Syntax

66. Changes from version 3

• headings can be unnumbered, e.g. "%2*"

66.1. Contents

66.2. Bold, italic, underline and teletype

66.2.1. lkjfsldfkjsdf

66.2.2. lksjdflsdkjfl

66.2.2.1. slkdjfsd

66.2.2.1.1.

66.2.3.

66.3. Horizontal lines

67. Lists

67.1. Verbatim output

67.2. Footnotes

67.3. Escapes

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

67.5. Headings

An unnumbered heading

An unnumbered heading

67.6. Links and anchors

67.7. A Heading

67.8. Block quotations

67.9. Line breaks

68. Tables

68.1. Images

68.2. Citations

68.3. Inclusion Images and other predicates

Images are like URLs:

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

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

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

An include directive can reference more than one file, e.g.

%include(yam-first.yam, yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

The first argument of an include directive can be an integer specifying an increment to add to the heading levels in the included file(s), e.g.:

%include(1, yam-first.yam)

Becomes:

68.4. A level 1 heading

68.4.1. A level 2 heading

68.4.1.1. A level 3 heading

68.5. A level 1 heading

Recursive includes are a bad idea:

%include(yam-includes.yam)

Will result in this file being included 1000 times (this is the include depth recursion limit). Some Lists

• list item 1
• list item 2
  • embedded 1
• list item 3

• a second list

1. a third list

• and a fourth
• that has two items

1. list 3/1
2. 3/2
   • 3a/1
   • 3a/2
     1. 3aa/1
   • 3a/3
3. 3/3

• second and subsequent lines of list items

no longer have to be indented properly

• this is a

list with two elements

• and a nested

list with one element

This is a three item list (after each - there is a space, which is necessary):

Empty elements can also nest...

This

• is
  • a
    • deeply
      • nested
        • list
          • that
            • seems
              • to
                • go
                  • on
                    • for
                      • ever
                        • but
• doesn't!

Indentation

• deals
  • properly
    • with
      • tabs:
        • • • • • • • this is the most indented list

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:

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.

%unknown(1 2 3 ) %unknown(1 2 3 )

³⁰

Cun94a Yam Scratch

Some Tables

Some Tables

but %[|This|isn't|%]

YAM URLs

Plain text URLs:

http://antlr.org/doc/lexer.html#unicode ftp://antlr.org/home/someone/thing.jsp mailto:hamish@something.org

They have to be followed by space: this doesn't work: ftp://antlr.org/home/someone/thing.jsp... so do this instead: ftp://antlr.org/home/someone/thing.jsp...

70. Miscellaneous previous URL examples

auto parsing all in-line links like http:, mailto:, ...

Footnote:³¹.

http://antlr.org/doc/lexer.html#unicode: includes the ":"

'http://gate.ac.uk/='

1. As plain text, e.g. 'http://gate.ac.uk/='
2. As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

1. Using '%(target)', e.g. %(http://gate.ac.uk/)
2. Using 'target', e.g. http://gate.ac.uk/
3. Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
4. Using 'label', e.g. GATE home result 'http://gate.ac.uk/='). will become http://gate.ac.uk/ will become http://gate.ac.uk/ will become GATE home This is a Title***

Bold text is contained in stars: *this is bold* becomes this is bold. Italic text is contained in underscores: _this is italic_ becomes this is italic. Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype. Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

               
This *will not* get translated               
      

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 'label', e.g. GATE home will become GATE home
4. Using Wiki syntax %ThisIsAWikiLink will become %ThisIsAWikiLink. Wiki links may also contain paths, specified with "/" relative to the current page.

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

                 
%2 A Heading #label                 

will result in a heading followed by the anchor label.

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

This is a quote

Line breaks are indicated by %\ at the end of a line. For example: becomes:   This line is broken   in two.

Tables use square brackets, bars and dashes. For example: results in: (|| ) | lkj