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.2. Bold, italic, underline and teletype

3.2.1. lkjfsldfkjsdf

3.2.2. lksjdflsdkjfl

3.2.2.1. slkdjfsd

3.2.2.1.0.0.1.

3.2.2.1.1.

3.2.3.

4. Lists

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

5. Tables

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.5. Lists

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

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

results in:

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.

An unnumbered heading

This heading will not appear in the contents table.

6.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

6.13. Tables

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

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

results in:

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

6.14. Images

Images are like URLs:

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

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

6.15. Citations

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

6.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

A spectre is haunting Europe - the spectre of communism. All the powers of old Europe have entered into a holy alliance to exorcise this spectre: Pope and Tsar, Metternich and Guizot, French Radicals and German police-spies.

Where is the party in opposition that has not been decried as communistic by its opponents in power? Where is the opposition that has not hurled back the branding reproach of communism, against the more advanced opposition parties, as well as against its reactionary adversaries?

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

II. It is high time that Communists should openly, in the face of the whole world, publish their views, their aims, their tendencies, and meet this nursery tale of the Spectre of Communism with a manifesto of the party itself.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

The Communists disdain to conceal their views and aims. They openly declare that their ends can be attained only by the forcible overthrow of all existing social conditions. Let the ruling classes tremble at a Communistic revolution. The proletarians have nothing to lose but their chains. They have a world to win.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

8. lasdfkjlskdfj8.1. sldfjsdlkfj8.1.0.0.0.1. klsjdflksdjfl 9. lksdjflksdjflkj 9.1. Bold, italic, underline and teletype #bold

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

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).9.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

15.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

15.15. Citations

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

15.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

17. lasdfkjlskdfj17.1. sldfjsdlkfj17.1.0.0.0.1. klsjdflksdjfl 18. lksdjflksdjflkj 18.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).18.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

24.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

24.15. Citations

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

24.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

¹⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm¹². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

26. lasdfkjlskdfj26.1. sldfjsdlkfj26.1.0.0.0.1. klsjdflksdjfl 27. lksdjflksdjflkj 27.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).27.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

33.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

33.15. Citations

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

33.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

¹⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm¹⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

35. lasdfkjlskdfj35.1. sldfjsdlkfj35.1.0.0.0.1. klsjdflksdjfl 36. lksdjflksdjflkj 36.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).36.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

42.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

42.15. Citations

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

42.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

¹⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm²⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

44. lasdfkjlskdfj44.1. sldfjsdlkfj44.1.0.0.0.1. klsjdflksdjfl 45. lksdjflksdjflkj 45.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).45.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

51.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

51.15. Citations

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

51.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

²²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm²⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

53. lasdfkjlskdfj53.1. sldfjsdlkfj53.1.0.0.0.1. klsjdflksdjfl 54. lksdjflksdjflkj 54.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).54.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

60.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

60.15. Citations

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

60.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

²⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm²⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

62. lasdfkjlskdfj62.1. sldfjsdlkfj62.1.0.0.0.1. klsjdflksdjfl 63. lksdjflksdjflkj 63.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).63.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

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.0.0.1.

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

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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

69.11. Block quotations

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

  %"This is a quote%"

becomes:

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 ALT tag

69.15. Citations

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

69.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

³⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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/='

Hmmm³². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

71. lasdfkjlskdfj71.1. sldfjsdlkfj71.1.0.0.0.1. klsjdflksdjfl 72. lksdjflksdjflkj 72.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).72.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

73. A level 1 heading

73.1. A level 2 heading

73.1.1. A level 3 heading

74. A level 1 heading YAM Syntax

75. Changes from version 3

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

75.1. Contents

75.2. Bold, italic, underline and teletype

75.2.1. lkjfsldfkjsdf

75.2.2. lksjdflsdkjfl

75.2.2.1. slkdjfsd

75.2.2.1.0.0.1.

75.2.2.1.1.

75.2.3.

75.3. Horizontal lines

76. Lists

76.1. Verbatim output

76.2. Footnotes

76.3. Escapes

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

76.5. Headings

An unnumbered heading

76.6. Links and anchors

76.7. A Heading

76.8. Block quotations

76.9. Line breaks

77. Tables

77.1. Images

77.2. Citations

77.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:

77.4. A level 1 heading

77.4.1. A level 2 heading

77.4.1.1. A level 3 heading

77.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

78. YAM Syntax

78.1. Changes from version 3

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

Slides: maybe:

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

78.2. Contents

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

78.3. Bold, italic, underline and teletype

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

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

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

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

78.4. Horizontal lines

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

---

and

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

both result in:

78.5. Lists

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

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

results in:

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

78.6. Verbatim output

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

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

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

78.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³³.

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

78.8. Escapes

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

 \---

will not generate a line.

78.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

78.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

78.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

78.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

78.13. Tables

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

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

results in:

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

78.14. Images

Images are like URLs:

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

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

78.15. Citations

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

78.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

³⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

79. 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/='

Hmmm³⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

80. lasdfkjlskdfj80.1. sldfjsdlkfj80.1.0.0.0.1. klsjdflksdjfl 81. lksdjflksdjflkj 81.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).81.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

82. A level 1 heading

82.1. A level 2 heading

82.1.1. A level 3 heading

83. A level 1 heading YAM Syntax

84. Changes from version 3

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

84.1. Contents

84.2. Bold, italic, underline and teletype

84.2.1. lkjfsldfkjsdf

84.2.2. lksjdflsdkjfl

84.2.2.1. slkdjfsd

84.2.2.1.0.0.1.

84.2.2.1.1.

84.2.3.

84.3. Horizontal lines

85. Lists

85.1. Verbatim output

85.2. Footnotes

85.3. Escapes

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

85.5. Headings

An unnumbered heading

85.6. Links and anchors

85.7. A Heading

85.8. Block quotations

85.9. Line breaks

86. Tables

86.1. Images

86.2. Citations

86.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:

86.4. A level 1 heading

86.4.1. A level 2 heading

86.4.1.1. A level 3 heading

86.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

87. YAM Syntax

87.1. Changes from version 3

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

Slides: maybe:

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

87.2. Contents

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

87.3. Bold, italic, underline and teletype

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

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

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

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

87.4. Horizontal lines

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

---

and

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

both result in:

87.5. Lists

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

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

results in:

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

87.6. Verbatim output

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

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

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

87.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:³⁷.

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

87.8. Escapes

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

 \---

will not generate a line.

87.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

87.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

87.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

87.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

87.13. Tables

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

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

results in:

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

87.14. Images

Images are like URLs:

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

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

87.15. Citations

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

87.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

³⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

88. 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/='

Hmmm⁴⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

89. lasdfkjlskdfj89.1. sldfjsdlkfj89.1.0.0.0.1. klsjdflksdjfl 90. lksdjflksdjflkj 90.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).90.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

91. A level 1 heading

91.1. A level 2 heading

91.1.1. A level 3 heading

92. A level 1 heading YAM Syntax

93. Changes from version 3

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

93.1. Contents

93.2. Bold, italic, underline and teletype

93.2.1. lkjfsldfkjsdf

93.2.2. lksjdflsdkjfl

93.2.2.1. slkdjfsd

93.2.2.1.0.0.1.

93.2.2.1.1.

93.2.3.

93.3. Horizontal lines

94. Lists

94.1. Verbatim output

94.2. Footnotes

94.3. Escapes

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

94.5. Headings

An unnumbered heading

94.6. Links and anchors

94.7. A Heading

94.8. Block quotations

94.9. Line breaks

95. Tables

95.1. Images

95.2. Citations

95.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:

95.4. A level 1 heading

95.4.1. A level 2 heading

95.4.1.1. A level 3 heading

95.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

96. YAM Syntax

96.1. Changes from version 3

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

Slides: maybe:

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

96.2. Contents

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

96.3. Bold, italic, underline and teletype

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

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

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

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

96.4. Horizontal lines

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

---

and

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

both result in:

96.5. Lists

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

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

results in:

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

96.6. Verbatim output

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

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

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

96.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴¹.

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

96.8. Escapes

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

 \---

will not generate a line.

96.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

96.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

96.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

96.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

96.13. Tables

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

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

results in:

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

96.14. Images

Images are like URLs:

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

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

96.15. Citations

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

96.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁴²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

97. 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/='

Hmmm⁴⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

98. lasdfkjlskdfj98.1. sldfjsdlkfj98.1.0.0.0.1. klsjdflksdjfl 99. lksdjflksdjflkj 99.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).99.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

100. A level 1 heading

100.1. A level 2 heading

100.1.1. A level 3 heading

101. A level 1 heading YAM Syntax

102. Changes from version 3

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

102.1. Contents

102.2. Bold, italic, underline and teletype

102.2.1. lkjfsldfkjsdf

102.2.2. lksjdflsdkjfl

102.2.2.1. slkdjfsd

102.2.2.1.0.0.1.

102.2.2.1.1.

102.2.3.

102.3. Horizontal lines

103. Lists

103.1. Verbatim output

103.2. Footnotes

103.3. Escapes

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

103.5. Headings

An unnumbered heading

103.6. Links and anchors

103.7. A Heading

103.8. Block quotations

103.9. Line breaks

104. Tables

104.1. Images

104.2. Citations

104.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:

104.4. A level 1 heading

104.4.1. A level 2 heading

104.4.1.1. A level 3 heading

104.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

105. YAM Syntax

105.1. Changes from version 3

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

Slides: maybe:

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

105.2. Contents

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

105.3. Bold, italic, underline and teletype

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

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

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

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

105.4. Horizontal lines

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

---

and

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

both result in:

105.5. Lists

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

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

results in:

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

105.6. Verbatim output

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

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

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

105.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁵.

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

105.8. Escapes

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

 \---

will not generate a line.

105.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

105.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

105.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

105.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

105.13. Tables

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

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

results in:

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

105.14. Images

Images are like URLs:

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

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

105.15. Citations

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

105.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁴⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

106. 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/='

Hmmm⁴⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

107. lasdfkjlskdfj107.1. sldfjsdlkfj107.1.0.0.0.1. klsjdflksdjfl 108. lksdjflksdjflkj 108.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).108.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

109. A level 1 heading

109.1. A level 2 heading

109.1.1. A level 3 heading

110. A level 1 heading YAM Syntax

111. Changes from version 3

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

111.1. Contents

111.2. Bold, italic, underline and teletype

111.2.1. lkjfsldfkjsdf

111.2.2. lksjdflsdkjfl

111.2.2.1. slkdjfsd

111.2.2.1.0.0.1.

111.2.2.1.1.

111.2.3.

111.3. Horizontal lines

112. Lists

112.1. Verbatim output

112.2. Footnotes

112.3. Escapes

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

112.5. Headings

An unnumbered heading

112.6. Links and anchors

112.7. A Heading

112.8. Block quotations

112.9. Line breaks

113. Tables

113.1. Images

113.2. Citations

113.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:

113.4. A level 1 heading

113.4.1. A level 2 heading

113.4.1.1. A level 3 heading

113.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

114. YAM Syntax

114.1. Changes from version 3

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

Slides: maybe:

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

114.2. Contents

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

114.3. Bold, italic, underline and teletype

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

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

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

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

114.4. Horizontal lines

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

---

and

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

both result in:

114.5. Lists

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

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

results in:

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

114.6. Verbatim output

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

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

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

114.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁴⁹.

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

114.8. Escapes

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

 \---

will not generate a line.

114.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

114.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

114.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

114.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

114.13. Tables

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

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

results in:

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

114.14. Images

Images are like URLs:

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

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

114.15. Citations

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

114.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁵⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

115. 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/='

Hmmm⁵². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

116. lasdfkjlskdfj116.1. sldfjsdlkfj116.1.0.0.0.1. klsjdflksdjfl 117. lksdjflksdjflkj 117.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).117.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

118. A level 1 heading

118.1. A level 2 heading

118.1.1. A level 3 heading

119. A level 1 heading YAM Syntax

120. Changes from version 3

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

120.1. Contents

120.2. Bold, italic, underline and teletype

120.2.1. lkjfsldfkjsdf

120.2.2. lksjdflsdkjfl

120.2.2.1. slkdjfsd

120.2.2.1.0.0.1.

120.2.2.1.1.

120.2.3.

120.3. Horizontal lines

121. Lists

121.1. Verbatim output

121.2. Footnotes

121.3. Escapes

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

121.5. Headings

An unnumbered heading

121.6. Links and anchors

121.7. A Heading

121.8. Block quotations

121.9. Line breaks

122. Tables

122.1. Images

122.2. Citations

122.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:

122.4. A level 1 heading

122.4.1. A level 2 heading

122.4.1.1. A level 3 heading

122.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

123. YAM Syntax

123.1. Changes from version 3

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

Slides: maybe:

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

123.2. Contents

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

123.3. Bold, italic, underline and teletype

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

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

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

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

123.4. Horizontal lines

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

---

and

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

both result in:

123.5. Lists

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

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

results in:

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

123.6. Verbatim output

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

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

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

123.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵³.

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

123.8. Escapes

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

 \---

will not generate a line.

123.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

123.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

123.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

123.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

123.13. Tables

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

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

results in:

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

123.14. Images

Images are like URLs:

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

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

123.15. Citations

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

123.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁵⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

124. 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/='

Hmmm⁵⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

125. lasdfkjlskdfj125.1. sldfjsdlkfj125.1.0.0.0.1. klsjdflksdjfl 126. lksdjflksdjflkj 126.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).126.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

127. A level 1 heading

127.1. A level 2 heading

127.1.1. A level 3 heading

128. A level 1 heading YAM Syntax

129. Changes from version 3

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

129.1. Contents

129.2. Bold, italic, underline and teletype

129.2.1. lkjfsldfkjsdf

129.2.2. lksjdflsdkjfl

129.2.2.1. slkdjfsd

129.2.2.1.0.0.1.

129.2.2.1.1.

129.2.3.

129.3. Horizontal lines

130. Lists

130.1. Verbatim output

130.2. Footnotes

130.3. Escapes

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

130.5. Headings

An unnumbered heading

130.6. Links and anchors

130.7. A Heading

130.8. Block quotations

130.9. Line breaks

131. Tables

131.1. Images

131.2. Citations

131.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:

131.4. A level 1 heading

131.4.1. A level 2 heading

131.4.1.1. A level 3 heading

131.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

132. YAM Syntax

132.1. Changes from version 3

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

Slides: maybe:

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

132.2. Contents

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

132.3. Bold, italic, underline and teletype

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

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

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

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

132.4. Horizontal lines

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

---

and

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

both result in:

132.5. Lists

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

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

results in:

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

132.6. Verbatim output

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

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

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

132.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁵⁷.

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

132.8. Escapes

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

 \---

will not generate a line.

132.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

132.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

132.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

132.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

132.13. Tables

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

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

results in:

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

132.14. Images

Images are like URLs:

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

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

132.15. Citations

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

132.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁵⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

133. 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/='

Hmmm⁶⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

134. lasdfkjlskdfj134.1. sldfjsdlkfj134.1.0.0.0.1. klsjdflksdjfl 135. lksdjflksdjflkj 135.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).135.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

136. A level 1 heading

136.1. A level 2 heading

136.1.1. A level 3 heading

137. A level 1 heading YAM Syntax

138. Changes from version 3

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

138.1. Contents

138.2. Bold, italic, underline and teletype

138.2.1. lkjfsldfkjsdf

138.2.2. lksjdflsdkjfl

138.2.2.1. slkdjfsd

138.2.2.1.0.0.1.

138.2.2.1.1.

138.2.3.

138.3. Horizontal lines

139. Lists

139.1. Verbatim output

139.2. Footnotes

139.3. Escapes

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

139.5. Headings

An unnumbered heading

139.6. Links and anchors

139.7. A Heading

139.8. Block quotations

139.9. Line breaks

140. Tables

140.1. Images

140.2. Citations

140.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:

140.4. A level 1 heading

140.4.1. A level 2 heading

140.4.1.1. A level 3 heading

140.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

141. YAM Syntax

141.1. Changes from version 3

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

Slides: maybe:

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

141.2. Contents

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

141.3. Bold, italic, underline and teletype

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

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

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

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

141.4. Horizontal lines

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

---

and

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

both result in:

141.5. Lists

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

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

results in:

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

141.6. Verbatim output

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

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

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

141.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶¹.

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

141.8. Escapes

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

 \---

will not generate a line.

141.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

141.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

141.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

141.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

141.13. Tables

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

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

results in:

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

141.14. Images

Images are like URLs:

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

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

141.15. Citations

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

141.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁶²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

142. 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/='

Hmmm⁶⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

143. lasdfkjlskdfj143.1. sldfjsdlkfj143.1.0.0.0.1. klsjdflksdjfl 144. lksdjflksdjflkj 144.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).144.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

145. A level 1 heading

145.1. A level 2 heading

145.1.1. A level 3 heading

146. A level 1 heading YAM Syntax

147. Changes from version 3

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

147.1. Contents

147.2. Bold, italic, underline and teletype

147.2.1. lkjfsldfkjsdf

147.2.2. lksjdflsdkjfl

147.2.2.1. slkdjfsd

147.2.2.1.0.0.1.

147.2.2.1.1.

147.2.3.

147.3. Horizontal lines

148. Lists

148.1. Verbatim output

148.2. Footnotes

148.3. Escapes

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

148.5. Headings

An unnumbered heading

148.6. Links and anchors

148.7. A Heading

148.8. Block quotations

148.9. Line breaks

149. Tables

149.1. Images

149.2. Citations

149.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:

149.4. A level 1 heading

149.4.1. A level 2 heading

149.4.1.1. A level 3 heading

149.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

150. YAM Syntax

150.1. Changes from version 3

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

Slides: maybe:

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

150.2. Contents

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

150.3. Bold, italic, underline and teletype

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

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

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

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

150.4. Horizontal lines

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

---

and

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

both result in:

150.5. Lists

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

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

results in:

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

150.6. Verbatim output

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

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

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

150.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁵.

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

150.8. Escapes

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

 \---

will not generate a line.

150.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

150.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

150.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

150.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

150.13. Tables

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

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

results in:

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

150.14. Images

Images are like URLs:

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

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

150.15. Citations

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

150.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁶⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

151. 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/='

Hmmm⁶⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

152. lasdfkjlskdfj152.1. sldfjsdlkfj152.1.0.0.0.1. klsjdflksdjfl 153. lksdjflksdjflkj 153.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).153.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

154. A level 1 heading

154.1. A level 2 heading

154.1.1. A level 3 heading

155. A level 1 heading YAM Syntax

156. Changes from version 3

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

156.1. Contents

156.2. Bold, italic, underline and teletype

156.2.1. lkjfsldfkjsdf

156.2.2. lksjdflsdkjfl

156.2.2.1. slkdjfsd

156.2.2.1.0.0.1.

156.2.2.1.1.

156.2.3.

156.3. Horizontal lines

157. Lists

157.1. Verbatim output

157.2. Footnotes

157.3. Escapes

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

157.5. Headings

An unnumbered heading

157.6. Links and anchors

157.7. A Heading

157.8. Block quotations

157.9. Line breaks

158. Tables

158.1. Images

158.2. Citations

158.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:

158.4. A level 1 heading

158.4.1. A level 2 heading

158.4.1.1. A level 3 heading

158.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

159. YAM Syntax

159.1. Changes from version 3

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

Slides: maybe:

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

159.2. Contents

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

159.3. Bold, italic, underline and teletype

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

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

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

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

159.4. Horizontal lines

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

---

and

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

both result in:

159.5. Lists

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

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

results in:

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

159.6. Verbatim output

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

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

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

159.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁶⁹.

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

159.8. Escapes

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

 \---

will not generate a line.

159.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

159.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

159.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

159.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

159.13. Tables

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

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

results in:

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

159.14. Images

Images are like URLs:

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

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

159.15. Citations

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

159.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁷⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

160. 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/='

Hmmm⁷². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

161. lasdfkjlskdfj161.1. sldfjsdlkfj161.1.0.0.0.1. klsjdflksdjfl 162. lksdjflksdjflkj 162.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).162.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

163. A level 1 heading

163.1. A level 2 heading

163.1.1. A level 3 heading

164. A level 1 heading YAM Syntax

165. Changes from version 3

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

165.1. Contents

165.2. Bold, italic, underline and teletype

165.2.1. lkjfsldfkjsdf

165.2.2. lksjdflsdkjfl

165.2.2.1. slkdjfsd

165.2.2.1.0.0.1.

165.2.2.1.1.

165.2.3.

165.3. Horizontal lines

166. Lists

166.1. Verbatim output

166.2. Footnotes

166.3. Escapes

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

166.5. Headings

An unnumbered heading

166.6. Links and anchors

166.7. A Heading

166.8. Block quotations

166.9. Line breaks

167. Tables

167.1. Images

167.2. Citations

167.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:

167.4. A level 1 heading

167.4.1. A level 2 heading

167.4.1.1. A level 3 heading

167.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

168. YAM Syntax

168.1. Changes from version 3

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

Slides: maybe:

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

168.2. Contents

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

168.3. Bold, italic, underline and teletype

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

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

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

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

168.4. Horizontal lines

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

---

and

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

both result in:

168.5. Lists

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

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

results in:

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

168.6. Verbatim output

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

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

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

168.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷³.

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

168.8. Escapes

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

 \---

will not generate a line.

168.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

168.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

168.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

168.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

168.13. Tables

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

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

results in:

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

168.14. Images

Images are like URLs:

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

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

168.15. Citations

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

168.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁷⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

169. 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/='

Hmmm⁷⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

170. lasdfkjlskdfj170.1. sldfjsdlkfj170.1.0.0.0.1. klsjdflksdjfl 171. lksdjflksdjflkj 171.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).171.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

172. A level 1 heading

172.1. A level 2 heading

172.1.1. A level 3 heading

173. A level 1 heading YAM Syntax

174. Changes from version 3

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

174.1. Contents

174.2. Bold, italic, underline and teletype

174.2.1. lkjfsldfkjsdf

174.2.2. lksjdflsdkjfl

174.2.2.1. slkdjfsd

174.2.2.1.0.0.1.

174.2.2.1.1.

174.2.3.

174.3. Horizontal lines

175. Lists

175.1. Verbatim output

175.2. Footnotes

175.3. Escapes

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

175.5. Headings

An unnumbered heading

175.6. Links and anchors

175.7. A Heading

175.8. Block quotations

175.9. Line breaks

176. Tables

176.1. Images

176.2. Citations

176.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:

176.4. A level 1 heading

176.4.1. A level 2 heading

176.4.1.1. A level 3 heading

176.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

177. YAM Syntax

177.1. Changes from version 3

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

Slides: maybe:

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

177.2. Contents

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

177.3. Bold, italic, underline and teletype

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

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

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

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

177.4. Horizontal lines

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

---

and

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

both result in:

177.5. Lists

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

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

results in:

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

177.6. Verbatim output

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

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

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

177.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁷⁷.

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

177.8. Escapes

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

 \---

will not generate a line.

177.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

177.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

177.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

177.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

177.13. Tables

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

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

results in:

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

177.14. Images

Images are like URLs:

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

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

177.15. Citations

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

177.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁷⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

178. 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/='

Hmmm⁸⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

179. lasdfkjlskdfj179.1. sldfjsdlkfj179.1.0.0.0.1. klsjdflksdjfl 180. lksdjflksdjflkj 180.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).180.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

181. A level 1 heading

181.1. A level 2 heading

181.1.1. A level 3 heading

182. A level 1 heading YAM Syntax

183. Changes from version 3

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

183.1. Contents

183.2. Bold, italic, underline and teletype

183.2.1. lkjfsldfkjsdf

183.2.2. lksjdflsdkjfl

183.2.2.1. slkdjfsd

183.2.2.1.0.0.1.

183.2.2.1.1.

183.2.3.

183.3. Horizontal lines

184. Lists

184.1. Verbatim output

184.2. Footnotes

184.3. Escapes

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

184.5. Headings

An unnumbered heading

184.6. Links and anchors

184.7. A Heading

184.8. Block quotations

184.9. Line breaks

185. Tables

185.1. Images

185.2. Citations

185.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:

185.4. A level 1 heading

185.4.1. A level 2 heading

185.4.1.1. A level 3 heading

185.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

186. YAM Syntax

186.1. Changes from version 3

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

Slides: maybe:

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

186.2. Contents

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

186.3. Bold, italic, underline and teletype

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

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

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

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

186.4. Horizontal lines

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

---

and

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

both result in:

186.5. Lists

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

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

results in:

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

186.6. Verbatim output

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

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

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

186.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸¹.

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

186.8. Escapes

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

 \---

will not generate a line.

186.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

186.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

186.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

186.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

186.13. Tables

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

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

results in:

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

186.14. Images

Images are like URLs:

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

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

186.15. Citations

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

186.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁸²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

187. 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/='

Hmmm⁸⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

188. lasdfkjlskdfj188.1. sldfjsdlkfj188.1.0.0.0.1. klsjdflksdjfl 189. lksdjflksdjflkj 189.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).189.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

190. A level 1 heading

190.1. A level 2 heading

190.1.1. A level 3 heading

191. A level 1 heading YAM Syntax

192. Changes from version 3

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

192.1. Contents

192.2. Bold, italic, underline and teletype

192.2.1. lkjfsldfkjsdf

192.2.2. lksjdflsdkjfl

192.2.2.1. slkdjfsd

192.2.2.1.0.0.1.

192.2.2.1.1.

192.2.3.

192.3. Horizontal lines

193. Lists

193.1. Verbatim output

193.2. Footnotes

193.3. Escapes

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

193.5. Headings

An unnumbered heading

193.6. Links and anchors

193.7. A Heading

193.8. Block quotations

193.9. Line breaks

194. Tables

194.1. Images

194.2. Citations

194.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:

194.4. A level 1 heading

194.4.1. A level 2 heading

194.4.1.1. A level 3 heading

194.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

195. YAM Syntax

195.1. Changes from version 3

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

Slides: maybe:

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

195.2. Contents

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

195.3. Bold, italic, underline and teletype

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

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

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

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

195.4. Horizontal lines

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

---

and

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

both result in:

195.5. Lists

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

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

results in:

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

195.6. Verbatim output

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

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

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

195.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁵.

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

195.8. Escapes

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

 \---

will not generate a line.

195.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

195.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

195.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

195.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

195.13. Tables

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

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

results in:

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

195.14. Images

Images are like URLs:

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

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

195.15. Citations

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

195.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁸⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

196. 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/='

Hmmm⁸⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

197. lasdfkjlskdfj197.1. sldfjsdlkfj197.1.0.0.0.1. klsjdflksdjfl 198. lksdjflksdjflkj 198.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).198.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

199. A level 1 heading

199.1. A level 2 heading

199.1.1. A level 3 heading

200. A level 1 heading YAM Syntax

201. Changes from version 3

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

201.1. Contents

201.2. Bold, italic, underline and teletype

201.2.1. lkjfsldfkjsdf

201.2.2. lksjdflsdkjfl

201.2.2.1. slkdjfsd

201.2.2.1.0.0.1.

201.2.2.1.1.

201.2.3.

201.3. Horizontal lines

202. Lists

202.1. Verbatim output

202.2. Footnotes

202.3. Escapes

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

202.5. Headings

An unnumbered heading

202.6. Links and anchors

202.7. A Heading

202.8. Block quotations

202.9. Line breaks

203. Tables

203.1. Images

203.2. Citations

203.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:

203.4. A level 1 heading

203.4.1. A level 2 heading

203.4.1.1. A level 3 heading

203.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

204. YAM Syntax

204.1. Changes from version 3

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

Slides: maybe:

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

204.2. Contents

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

204.3. Bold, italic, underline and teletype

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

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

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

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

204.4. Horizontal lines

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

---

and

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

both result in:

204.5. Lists

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

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

results in:

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

204.6. Verbatim output

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

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

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

204.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁸⁹.

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

204.8. Escapes

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

 \---

will not generate a line.

204.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

204.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

204.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

204.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

204.13. Tables

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

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

results in:

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

204.14. Images

Images are like URLs:

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

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

204.15. Citations

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

204.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁹⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

205. 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/='

Hmmm⁹². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

206. lasdfkjlskdfj206.1. sldfjsdlkfj206.1.0.0.0.1. klsjdflksdjfl 207. lksdjflksdjflkj 207.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).207.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

208. A level 1 heading

208.1. A level 2 heading

208.1.1. A level 3 heading

209. A level 1 heading YAM Syntax

210. Changes from version 3

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

210.1. Contents

210.2. Bold, italic, underline and teletype

210.2.1. lkjfsldfkjsdf

210.2.2. lksjdflsdkjfl

210.2.2.1. slkdjfsd

210.2.2.1.0.0.1.

210.2.2.1.1.

210.2.3.

210.3. Horizontal lines

211. Lists

211.1. Verbatim output

211.2. Footnotes

211.3. Escapes

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

211.5. Headings

An unnumbered heading

211.6. Links and anchors

211.7. A Heading

211.8. Block quotations

211.9. Line breaks

212. Tables

212.1. Images

212.2. Citations

212.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:

212.4. A level 1 heading

212.4.1. A level 2 heading

212.4.1.1. A level 3 heading

212.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

213. YAM Syntax

213.1. Changes from version 3

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

Slides: maybe:

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

213.2. Contents

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

213.3. Bold, italic, underline and teletype

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

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

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

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

213.4. Horizontal lines

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

---

and

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

both result in:

213.5. Lists

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

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

results in:

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

213.6. Verbatim output

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

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

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

213.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹³.

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

213.8. Escapes

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

 \---

will not generate a line.

213.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

213.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

213.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

213.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

213.13. Tables

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

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

results in:

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

213.14. Images

Images are like URLs:

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

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

213.15. Citations

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

213.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁹⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

214. 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/='

Hmmm⁹⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

215. lasdfkjlskdfj215.1. sldfjsdlkfj215.1.0.0.0.1. klsjdflksdjfl 216. lksdjflksdjflkj 216.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).216.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

217. A level 1 heading

217.1. A level 2 heading

217.1.1. A level 3 heading

218. A level 1 heading YAM Syntax

219. Changes from version 3

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

219.1. Contents

219.2. Bold, italic, underline and teletype

219.2.1. lkjfsldfkjsdf

219.2.2. lksjdflsdkjfl

219.2.2.1. slkdjfsd

219.2.2.1.0.0.1.

219.2.2.1.1.

219.2.3.

219.3. Horizontal lines

220. Lists

220.1. Verbatim output

220.2. Footnotes

220.3. Escapes

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

220.5. Headings

An unnumbered heading

220.6. Links and anchors

220.7. A Heading

220.8. Block quotations

220.9. Line breaks

221. Tables

221.1. Images

221.2. Citations

221.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:

221.4. A level 1 heading

221.4.1. A level 2 heading

221.4.1.1. A level 3 heading

221.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

222. YAM Syntax

222.1. Changes from version 3

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

Slides: maybe:

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

222.2. Contents

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

222.3. Bold, italic, underline and teletype

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

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

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

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

222.4. Horizontal lines

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

---

and

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

both result in:

222.5. Lists

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

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

results in:

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

222.6. Verbatim output

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

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

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

222.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:⁹⁷.

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

222.8. Escapes

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

 \---

will not generate a line.

222.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

222.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

222.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

222.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

222.13. Tables

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

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

results in:

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

222.14. Images

Images are like URLs:

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

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

222.15. Citations

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

222.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

⁹⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

223. 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/='

Hmmm¹⁰⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

224. lasdfkjlskdfj224.1. sldfjsdlkfj224.1.0.0.0.1. klsjdflksdjfl 225. lksdjflksdjflkj 225.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).225.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

226. A level 1 heading

226.1. A level 2 heading

226.1.1. A level 3 heading

227. A level 1 heading YAM Syntax

228. Changes from version 3

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

228.1. Contents

228.2. Bold, italic, underline and teletype

228.2.1. lkjfsldfkjsdf

228.2.2. lksjdflsdkjfl

228.2.2.1. slkdjfsd

228.2.2.1.0.0.1.

228.2.2.1.1.

228.2.3.

228.3. Horizontal lines

229. Lists

229.1. Verbatim output

229.2. Footnotes

229.3. Escapes

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

229.5. Headings

An unnumbered heading

229.6. Links and anchors

229.7. A Heading

229.8. Block quotations

229.9. Line breaks

230. Tables

230.1. Images

230.2. Citations

230.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:

230.4. A level 1 heading

230.4.1. A level 2 heading

230.4.1.1. A level 3 heading

230.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

231. YAM Syntax

231.1. Changes from version 3

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

Slides: maybe:

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

231.2. Contents

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

231.3. Bold, italic, underline and teletype

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

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

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

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

231.4. Horizontal lines

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

---

and

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

both result in:

231.5. Lists

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

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

results in:

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

231.6. Verbatim output

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

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

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

231.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰¹.

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

231.8. Escapes

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

 \---

will not generate a line.

231.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

231.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

231.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

231.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

231.13. Tables

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

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

results in:

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

231.14. Images

Images are like URLs:

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

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

231.15. Citations

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

231.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

¹⁰²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

232. 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/='

Hmmm¹⁰⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

233. lasdfkjlskdfj233.1. sldfjsdlkfj233.1.0.0.0.1. klsjdflksdjfl 234. lksdjflksdjflkj 234.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).234.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

235. A level 1 heading

235.1. A level 2 heading

235.1.1. A level 3 heading

236. A level 1 heading YAM Syntax

237. Changes from version 3

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

237.1. Contents

237.2. Bold, italic, underline and teletype

237.2.1. lkjfsldfkjsdf

237.2.2. lksjdflsdkjfl

237.2.2.1. slkdjfsd

237.2.2.1.0.0.1.

237.2.2.1.1.

237.2.3.

237.3. Horizontal lines

238. Lists

238.1. Verbatim output

238.2. Footnotes

238.3. Escapes

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

238.5. Headings

An unnumbered heading

238.6. Links and anchors

238.7. A Heading

238.8. Block quotations

238.9. Line breaks

239. Tables

239.1. Images

239.2. Citations

239.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:

239.4. A level 1 heading

239.4.1. A level 2 heading

239.4.1.1. A level 3 heading

239.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

240. YAM Syntax

240.1. Changes from version 3

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

Slides: maybe:

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

240.2. Contents

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

240.3. Bold, italic, underline and teletype

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

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

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

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

240.4. Horizontal lines

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

---

and

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

both result in:

240.5. Lists

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

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

results in:

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

240.6. Verbatim output

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

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

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

240.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁵.

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

240.8. Escapes

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

 \---

will not generate a line.

240.9. Headings

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

%2 Headings

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

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

240.10. Links and anchors

Links can be specified in three ways:

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

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

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

%2 A Heading %#label

will result in a heading followed by the anchor label.

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

240.11. Block quotations

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

  %"This is a quote%"

becomes:

This is a quote

240.12. Line breaks

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

This line is broken %\
in two.

becomes: % This line is broken % in two.

240.13. Tables

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

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

results in:

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

240.14. Images

Images are like URLs:

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

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

240.15. Citations

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

240.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

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

¹⁰⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

241. 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/='

Hmmm¹⁰⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

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

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

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

242. lasdfkjlskdfj242.1. sldfjsdlkfj242.1.0.0.0.1. klsjdflksdjfl 243. lksdjflksdjflkj 243.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).243.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

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

244. A level 1 heading

244.1. A level 2 heading

244.1.1. A level 3 heading

245. A level 1 heading YAM Syntax

246. Changes from version 3

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

246.1. Contents

246.2. Bold, italic, underline and teletype

246.2.1. lkjfsldfkjsdf

246.2.2. lksjdflsdkjfl

246.2.2.1. slkdjfsd

246.2.2.1.0.0.1.

246.2.2.1.1.

246.2.3.

246.3. Horizontal lines

247. Lists

247.1. Verbatim output

247.2. Footnotes

247.3. Escapes

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

247.5. Headings

An unnumbered heading

247.6. Links and anchors

247.7. A Heading

247.8. Block quotations

247.9. Line breaks

248. Tables

248.1. Images

248.2. Citations

248.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:

248.4. A level 1 heading

248.4.1. A level 2 heading

248.4.1.1. A level 3 heading

248.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

249. YAM Syntax

249.1. Changes from version 3

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

Slides: maybe:

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

249.2. Contents

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

249.3. Bold, italic, underline and teletype

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

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

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

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

249.4. Horizontal lines

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

---

and

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

both result in:

249.5. Lists

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

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

results in:

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

249.6. Verbatim output

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

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

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

249.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁰⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

249.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

249.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

249.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

249.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

249.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

249.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

249.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

249.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

249.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹¹⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

250. 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/='

Hmmm¹¹². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

251. lasdfkjlskdfj251.1. sldfjsdlkfj251.1.0.0.0.1. klsjdflksdjfl 252. lksdjflksdjflkj 252.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).252.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

253. A level 1 heading

253.1. A level 2 heading

253.1.1. A level 3 heading

254. A level 1 heading YAM Syntax

255. Changes from version 3

headings can be unnumbered, e.g. "%2*"

255.1. Contents

255.2. Bold, italic, underline and teletype

255.2.1. lkjfsldfkjsdf

255.2.2. lksjdflsdkjfl

255.2.2.1. slkdjfsd

255.2.2.1.0.0.1.

255.2.2.1.1.

255.2.3.

255.3. Horizontal lines

256. Lists

256.1. Verbatim output

256.2. Footnotes

256.3. Escapes

256.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

256.5. Headings

An unnumbered heading

256.6. Links and anchors

256.7. A Heading

256.8. Block quotations

256.9. Line breaks

257. Tables

257.1. Images

257.2. Citations

257.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:

257.4. A level 1 heading

257.4.1. A level 2 heading

257.4.1.1. A level 3 heading

257.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

258. YAM Syntax

258.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

258.2. Contents

Contents listings like that above are generated by '%contents'

258.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

258.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

258.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

258.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

258.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

258.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

258.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

258.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

258.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

258.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

258.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

258.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

258.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

258.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹¹⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

259. 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/='

Hmmm¹¹⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

260. lasdfkjlskdfj260.1. sldfjsdlkfj260.1.0.0.0.1. klsjdflksdjfl 261. lksdjflksdjflkj 261.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).261.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

262. A level 1 heading

262.1. A level 2 heading

262.1.1. A level 3 heading

263. A level 1 heading YAM Syntax

264. Changes from version 3

headings can be unnumbered, e.g. "%2*"

264.1. Contents

264.2. Bold, italic, underline and teletype

264.2.1. lkjfsldfkjsdf

264.2.2. lksjdflsdkjfl

264.2.2.1. slkdjfsd

264.2.2.1.0.0.1.

264.2.2.1.1.

264.2.3.

264.3. Horizontal lines

265. Lists

265.1. Verbatim output

265.2. Footnotes

265.3. Escapes

265.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

265.5. Headings

An unnumbered heading

265.6. Links and anchors

265.7. A Heading

265.8. Block quotations

265.9. Line breaks

266. Tables

266.1. Images

266.2. Citations

266.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:

266.4. A level 1 heading

266.4.1. A level 2 heading

266.4.1.1. A level 3 heading

266.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

267. YAM Syntax

267.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

267.2. Contents

Contents listings like that above are generated by '%contents'

267.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

267.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

267.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

267.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

267.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹¹⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

267.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

267.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

267.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

267.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

267.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

267.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

267.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

267.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

267.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹¹⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

268. 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/='

Hmmm¹²⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

269. lasdfkjlskdfj269.1. sldfjsdlkfj269.1.0.0.0.1. klsjdflksdjfl 270. lksdjflksdjflkj 270.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).270.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

271. A level 1 heading

271.1. A level 2 heading

271.1.1. A level 3 heading

272. A level 1 heading YAM Syntax

273. Changes from version 3

headings can be unnumbered, e.g. "%2*"

273.1. Contents

273.2. Bold, italic, underline and teletype

273.2.1. lkjfsldfkjsdf

273.2.2. lksjdflsdkjfl

273.2.2.1. slkdjfsd

273.2.2.1.0.0.1.

273.2.2.1.1.

273.2.3.

273.3. Horizontal lines

274. Lists

274.1. Verbatim output

274.2. Footnotes

274.3. Escapes

274.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

274.5. Headings

An unnumbered heading

274.6. Links and anchors

274.7. A Heading

274.8. Block quotations

274.9. Line breaks

275. Tables

275.1. Images

275.2. Citations

275.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:

275.4. A level 1 heading

275.4.1. A level 2 heading

275.4.1.1. A level 3 heading

275.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

276. YAM Syntax

276.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

276.2. Contents

Contents listings like that above are generated by '%contents'

276.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

276.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

276.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

276.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

276.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹²¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

276.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

276.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

276.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

276.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

276.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

276.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

276.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

276.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

276.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹²²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

277. 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/='

Hmmm¹²⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

278. lasdfkjlskdfj278.1. sldfjsdlkfj278.1.0.0.0.1. klsjdflksdjfl 279. lksdjflksdjflkj 279.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).279.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

280. A level 1 heading

280.1. A level 2 heading

280.1.1. A level 3 heading

281. A level 1 heading YAM Syntax

282. Changes from version 3

headings can be unnumbered, e.g. "%2*"

282.1. Contents

282.2. Bold, italic, underline and teletype

282.2.1. lkjfsldfkjsdf

282.2.2. lksjdflsdkjfl

282.2.2.1. slkdjfsd

282.2.2.1.0.0.1.

282.2.2.1.1.

282.2.3.

282.3. Horizontal lines

283. Lists

283.1. Verbatim output

283.2. Footnotes

283.3. Escapes

283.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

283.5. Headings

An unnumbered heading

283.6. Links and anchors

283.7. A Heading

283.8. Block quotations

283.9. Line breaks

284. Tables

284.1. Images

284.2. Citations

284.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:

284.4. A level 1 heading

284.4.1. A level 2 heading

284.4.1.1. A level 3 heading

284.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

285. YAM Syntax

285.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

285.2. Contents

Contents listings like that above are generated by '%contents'

285.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

285.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

285.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

285.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

285.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹²⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

285.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

285.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

285.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

285.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

285.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

285.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

285.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

285.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

285.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹²⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

286. 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/='

Hmmm¹²⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

287. lasdfkjlskdfj287.1. sldfjsdlkfj287.1.0.0.0.1. klsjdflksdjfl 288. lksdjflksdjflkj 288.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).288.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

289. A level 1 heading

289.1. A level 2 heading

289.1.1. A level 3 heading

290. A level 1 heading YAM Syntax

291. Changes from version 3

headings can be unnumbered, e.g. "%2*"

291.1. Contents

291.2. Bold, italic, underline and teletype

291.2.1. lkjfsldfkjsdf

291.2.2. lksjdflsdkjfl

291.2.2.1. slkdjfsd

291.2.2.1.0.0.1.

291.2.2.1.1.

291.2.3.

291.3. Horizontal lines

292. Lists

292.1. Verbatim output

292.2. Footnotes

292.3. Escapes

292.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

292.5. Headings

An unnumbered heading

292.6. Links and anchors

292.7. A Heading

292.8. Block quotations

292.9. Line breaks

293. Tables

293.1. Images

293.2. Citations

293.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:

293.4. A level 1 heading

293.4.1. A level 2 heading

293.4.1.1. A level 3 heading

293.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

294. YAM Syntax

294.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

294.2. Contents

Contents listings like that above are generated by '%contents'

294.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

294.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

294.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

294.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

294.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹²⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

294.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

294.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

294.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

294.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

294.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

294.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

294.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

294.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

294.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹³⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

295. 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/='

Hmmm¹³². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

296. lasdfkjlskdfj296.1. sldfjsdlkfj296.1.0.0.0.1. klsjdflksdjfl 297. lksdjflksdjflkj 297.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).297.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

298. A level 1 heading

298.1. A level 2 heading

298.1.1. A level 3 heading

299. A level 1 heading YAM Syntax

300. Changes from version 3

headings can be unnumbered, e.g. "%2*"

300.1. Contents

300.2. Bold, italic, underline and teletype

300.2.1. lkjfsldfkjsdf

300.2.2. lksjdflsdkjfl

300.2.2.1. slkdjfsd

300.2.2.1.0.0.1.

300.2.2.1.1.

300.2.3.

300.3. Horizontal lines

301. Lists

301.1. Verbatim output

301.2. Footnotes

301.3. Escapes

301.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

301.5. Headings

An unnumbered heading

301.6. Links and anchors

301.7. A Heading

301.8. Block quotations

301.9. Line breaks

302. Tables

302.1. Images

302.2. Citations

302.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:

302.4. A level 1 heading

302.4.1. A level 2 heading

302.4.1.1. A level 3 heading

302.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

303. YAM Syntax

303.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

303.2. Contents

Contents listings like that above are generated by '%contents'

303.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

303.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

303.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

303.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

303.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹³³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

303.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

303.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

303.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

303.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

303.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

303.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

303.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

303.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

303.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹³⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

304. 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/='

Hmmm¹³⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

305. lasdfkjlskdfj305.1. sldfjsdlkfj305.1.0.0.0.1. klsjdflksdjfl 306. lksdjflksdjflkj 306.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).306.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

307. A level 1 heading

307.1. A level 2 heading

307.1.1. A level 3 heading

308. A level 1 heading YAM Syntax

309. Changes from version 3

headings can be unnumbered, e.g. "%2*"

309.1. Contents

309.2. Bold, italic, underline and teletype

309.2.1. lkjfsldfkjsdf

309.2.2. lksjdflsdkjfl

309.2.2.1. slkdjfsd

309.2.2.1.0.0.1.

309.2.2.1.1.

309.2.3.

309.3. Horizontal lines

310. Lists

310.1. Verbatim output

310.2. Footnotes

310.3. Escapes

310.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

310.5. Headings

An unnumbered heading

310.6. Links and anchors

310.7. A Heading

310.8. Block quotations

310.9. Line breaks

311. Tables

311.1. Images

311.2. Citations

311.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:

311.4. A level 1 heading

311.4.1. A level 2 heading

311.4.1.1. A level 3 heading

311.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

312. YAM Syntax

312.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

312.2. Contents

Contents listings like that above are generated by '%contents'

312.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

312.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

312.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

312.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

312.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹³⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

312.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

312.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

312.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

312.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

312.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

312.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

312.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

312.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

312.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹³⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

313. 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/='

Hmmm¹⁴⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

314. lasdfkjlskdfj314.1. sldfjsdlkfj314.1.0.0.0.1. klsjdflksdjfl 315. lksdjflksdjflkj 315.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).315.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

316. A level 1 heading

316.1. A level 2 heading

316.1.1. A level 3 heading

317. A level 1 heading YAM Syntax

318. Changes from version 3

headings can be unnumbered, e.g. "%2*"

318.1. Contents

318.2. Bold, italic, underline and teletype

318.2.1. lkjfsldfkjsdf

318.2.2. lksjdflsdkjfl

318.2.2.1. slkdjfsd

318.2.2.1.0.0.1.

318.2.2.1.1.

318.2.3.

318.3. Horizontal lines

319. Lists

319.1. Verbatim output

319.2. Footnotes

319.3. Escapes

319.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

319.5. Headings

An unnumbered heading

319.6. Links and anchors

319.7. A Heading

319.8. Block quotations

319.9. Line breaks

320. Tables

320.1. Images

320.2. Citations

320.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:

320.4. A level 1 heading

320.4.1. A level 2 heading

320.4.1.1. A level 3 heading

320.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

321. YAM Syntax

321.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

321.2. Contents

Contents listings like that above are generated by '%contents'

321.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

321.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

321.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

321.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

321.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁴¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

321.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

321.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

321.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

321.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

321.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

321.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

321.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

321.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

321.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁴²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

322. 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/='

Hmmm¹⁴⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

323. lasdfkjlskdfj323.1. sldfjsdlkfj323.1.0.0.0.1. klsjdflksdjfl 324. lksdjflksdjflkj 324.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).324.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

325. A level 1 heading

325.1. A level 2 heading

325.1.1. A level 3 heading

326. A level 1 heading YAM Syntax

327. Changes from version 3

headings can be unnumbered, e.g. "%2*"

327.1. Contents

327.2. Bold, italic, underline and teletype

327.2.1. lkjfsldfkjsdf

327.2.2. lksjdflsdkjfl

327.2.2.1. slkdjfsd

327.2.2.1.0.0.1.

327.2.2.1.1.

327.2.3.

327.3. Horizontal lines

328. Lists

328.1. Verbatim output

328.2. Footnotes

328.3. Escapes

328.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

328.5. Headings

An unnumbered heading

328.6. Links and anchors

328.7. A Heading

328.8. Block quotations

328.9. Line breaks

329. Tables

329.1. Images

329.2. Citations

329.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:

329.4. A level 1 heading

329.4.1. A level 2 heading

329.4.1.1. A level 3 heading

329.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

330. YAM Syntax

330.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

330.2. Contents

Contents listings like that above are generated by '%contents'

330.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

330.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

330.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

330.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

330.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁴⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

330.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

330.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

330.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

330.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

330.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

330.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

330.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

330.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

330.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁴⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

331. 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/='

Hmmm¹⁴⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

332. lasdfkjlskdfj332.1. sldfjsdlkfj332.1.0.0.0.1. klsjdflksdjfl 333. lksdjflksdjflkj 333.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).333.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

334. A level 1 heading

334.1. A level 2 heading

334.1.1. A level 3 heading

335. A level 1 heading YAM Syntax

336. Changes from version 3

headings can be unnumbered, e.g. "%2*"

336.1. Contents

336.2. Bold, italic, underline and teletype

336.2.1. lkjfsldfkjsdf

336.2.2. lksjdflsdkjfl

336.2.2.1. slkdjfsd

336.2.2.1.0.0.1.

336.2.2.1.1.

336.2.3.

336.3. Horizontal lines

337. Lists

337.1. Verbatim output

337.2. Footnotes

337.3. Escapes

337.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

337.5. Headings

An unnumbered heading

337.6. Links and anchors

337.7. A Heading

337.8. Block quotations

337.9. Line breaks

338. Tables

338.1. Images

338.2. Citations

338.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:

338.4. A level 1 heading

338.4.1. A level 2 heading

338.4.1.1. A level 3 heading

338.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

339. YAM Syntax

339.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

339.2. Contents

Contents listings like that above are generated by '%contents'

339.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

339.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

339.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

339.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

339.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁴⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

339.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

339.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

339.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

339.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

339.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

339.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

339.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

339.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

339.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁵⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

340. 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/='

Hmmm¹⁵². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

341. lasdfkjlskdfj341.1. sldfjsdlkfj341.1.0.0.0.1. klsjdflksdjfl 342. lksdjflksdjflkj 342.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).342.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

343. A level 1 heading

343.1. A level 2 heading

343.1.1. A level 3 heading

344. A level 1 heading YAM Syntax

345. Changes from version 3

headings can be unnumbered, e.g. "%2*"

345.1. Contents

345.2. Bold, italic, underline and teletype

345.2.1. lkjfsldfkjsdf

345.2.2. lksjdflsdkjfl

345.2.2.1. slkdjfsd

345.2.2.1.0.0.1.

345.2.2.1.1.

345.2.3.

345.3. Horizontal lines

346. Lists

346.1. Verbatim output

346.2. Footnotes

346.3. Escapes

346.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

346.5. Headings

An unnumbered heading

346.6. Links and anchors

346.7. A Heading

346.8. Block quotations

346.9. Line breaks

347. Tables

347.1. Images

347.2. Citations

347.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:

347.4. A level 1 heading

347.4.1. A level 2 heading

347.4.1.1. A level 3 heading

347.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

348. YAM Syntax

348.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

348.2. Contents

Contents listings like that above are generated by '%contents'

348.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

348.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

348.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

348.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

348.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁵³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

348.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

348.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

348.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

348.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

348.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

348.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

348.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

348.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

348.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁵⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

349. 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/='

Hmmm¹⁵⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

350. lasdfkjlskdfj350.1. sldfjsdlkfj350.1.0.0.0.1. klsjdflksdjfl 351. lksdjflksdjflkj 351.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).351.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

352. A level 1 heading

352.1. A level 2 heading

352.1.1. A level 3 heading

353. A level 1 heading YAM Syntax

354. Changes from version 3

headings can be unnumbered, e.g. "%2*"

354.1. Contents

354.2. Bold, italic, underline and teletype

354.2.1. lkjfsldfkjsdf

354.2.2. lksjdflsdkjfl

354.2.2.1. slkdjfsd

354.2.2.1.0.0.1.

354.2.2.1.1.

354.2.3.

354.3. Horizontal lines

355. Lists

355.1. Verbatim output

355.2. Footnotes

355.3. Escapes

355.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

355.5. Headings

An unnumbered heading

355.6. Links and anchors

355.7. A Heading

355.8. Block quotations

355.9. Line breaks

356. Tables

356.1. Images

356.2. Citations

356.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:

356.4. A level 1 heading

356.4.1. A level 2 heading

356.4.1.1. A level 3 heading

356.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

357. YAM Syntax

357.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

357.2. Contents

Contents listings like that above are generated by '%contents'

357.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

357.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

357.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

357.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

357.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁵⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

357.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

357.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

357.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

357.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

357.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

357.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

357.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

357.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

357.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁵⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

358. 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/='

Hmmm¹⁶⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

359. lasdfkjlskdfj359.1. sldfjsdlkfj359.1.0.0.0.1. klsjdflksdjfl 360. lksdjflksdjflkj 360.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).360.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

361. A level 1 heading

361.1. A level 2 heading

361.1.1. A level 3 heading

362. A level 1 heading YAM Syntax

363. Changes from version 3

headings can be unnumbered, e.g. "%2*"

363.1. Contents

363.2. Bold, italic, underline and teletype

363.2.1. lkjfsldfkjsdf

363.2.2. lksjdflsdkjfl

363.2.2.1. slkdjfsd

363.2.2.1.0.0.1.

363.2.2.1.1.

363.2.3.

363.3. Horizontal lines

364. Lists

364.1. Verbatim output

364.2. Footnotes

364.3. Escapes

364.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

364.5. Headings

An unnumbered heading

364.6. Links and anchors

364.7. A Heading

364.8. Block quotations

364.9. Line breaks

365. Tables

365.1. Images

365.2. Citations

365.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:

365.4. A level 1 heading

365.4.1. A level 2 heading

365.4.1.1. A level 3 heading

365.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

366. YAM Syntax

366.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

366.2. Contents

Contents listings like that above are generated by '%contents'

366.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

366.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

366.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

366.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

366.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁶¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

366.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

366.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

366.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

366.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

366.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

366.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

366.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

366.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

366.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁶²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

367. 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/='

Hmmm¹⁶⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

368. lasdfkjlskdfj368.1. sldfjsdlkfj368.1.0.0.0.1. klsjdflksdjfl 369. lksdjflksdjflkj 369.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).369.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

370. A level 1 heading

370.1. A level 2 heading

370.1.1. A level 3 heading

371. A level 1 heading YAM Syntax

372. Changes from version 3

headings can be unnumbered, e.g. "%2*"

372.1. Contents

372.2. Bold, italic, underline and teletype

372.2.1. lkjfsldfkjsdf

372.2.2. lksjdflsdkjfl

372.2.2.1. slkdjfsd

372.2.2.1.0.0.1.

372.2.2.1.1.

372.2.3.

372.3. Horizontal lines

373. Lists

373.1. Verbatim output

373.2. Footnotes

373.3. Escapes

373.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

373.5. Headings

An unnumbered heading

373.6. Links and anchors

373.7. A Heading

373.8. Block quotations

373.9. Line breaks

374. Tables

374.1. Images

374.2. Citations

374.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:

374.4. A level 1 heading

374.4.1. A level 2 heading

374.4.1.1. A level 3 heading

374.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

375. YAM Syntax

375.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

375.2. Contents

Contents listings like that above are generated by '%contents'

375.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

375.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

375.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

375.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

375.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁶⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

375.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

375.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

375.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

375.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

375.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

375.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

375.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

375.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

375.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁶⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

376. 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/='

Hmmm¹⁶⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

377. lasdfkjlskdfj377.1. sldfjsdlkfj377.1.0.0.0.1. klsjdflksdjfl 378. lksdjflksdjflkj 378.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).378.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

379. A level 1 heading

379.1. A level 2 heading

379.1.1. A level 3 heading

380. A level 1 heading YAM Syntax

381. Changes from version 3

headings can be unnumbered, e.g. "%2*"

381.1. Contents

381.2. Bold, italic, underline and teletype

381.2.1. lkjfsldfkjsdf

381.2.2. lksjdflsdkjfl

381.2.2.1. slkdjfsd

381.2.2.1.0.0.1.

381.2.2.1.1.

381.2.3.

381.3. Horizontal lines

382. Lists

382.1. Verbatim output

382.2. Footnotes

382.3. Escapes

382.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

382.5. Headings

An unnumbered heading

382.6. Links and anchors

382.7. A Heading

382.8. Block quotations

382.9. Line breaks

383. Tables

383.1. Images

383.2. Citations

383.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:

383.4. A level 1 heading

383.4.1. A level 2 heading

383.4.1.1. A level 3 heading

383.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

384. YAM Syntax

384.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

384.2. Contents

Contents listings like that above are generated by '%contents'

384.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

384.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

384.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

384.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

384.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁶⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

384.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

384.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

384.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

384.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

384.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

384.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

384.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

384.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

384.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁷⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

385. 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/='

Hmmm¹⁷². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

386. lasdfkjlskdfj386.1. sldfjsdlkfj386.1.0.0.0.1. klsjdflksdjfl 387. lksdjflksdjflkj 387.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).387.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

388. A level 1 heading

388.1. A level 2 heading

388.1.1. A level 3 heading

389. A level 1 heading YAM Syntax

390. Changes from version 3

headings can be unnumbered, e.g. "%2*"

390.1. Contents

390.2. Bold, italic, underline and teletype

390.2.1. lkjfsldfkjsdf

390.2.2. lksjdflsdkjfl

390.2.2.1. slkdjfsd

390.2.2.1.0.0.1.

390.2.2.1.1.

390.2.3.

390.3. Horizontal lines

391. Lists

391.1. Verbatim output

391.2. Footnotes

391.3. Escapes

391.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

391.5. Headings

An unnumbered heading

391.6. Links and anchors

391.7. A Heading

391.8. Block quotations

391.9. Line breaks

392. Tables

392.1. Images

392.2. Citations

392.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:

392.4. A level 1 heading

392.4.1. A level 2 heading

392.4.1.1. A level 3 heading

392.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

393. YAM Syntax

393.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

393.2. Contents

Contents listings like that above are generated by '%contents'

393.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

393.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

393.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

393.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

393.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁷³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

393.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

393.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

393.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

393.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

393.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

393.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

393.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

393.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

393.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁷⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

394. 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/='

Hmmm¹⁷⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

395. lasdfkjlskdfj395.1. sldfjsdlkfj395.1.0.0.0.1. klsjdflksdjfl 396. lksdjflksdjflkj 396.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).396.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

397. A level 1 heading

397.1. A level 2 heading

397.1.1. A level 3 heading

398. A level 1 heading YAM Syntax

399. Changes from version 3

headings can be unnumbered, e.g. "%2*"

399.1. Contents

399.2. Bold, italic, underline and teletype

399.2.1. lkjfsldfkjsdf

399.2.2. lksjdflsdkjfl

399.2.2.1. slkdjfsd

399.2.2.1.0.0.1.

399.2.2.1.1.

399.2.3.

399.3. Horizontal lines

400. Lists

400.1. Verbatim output

400.2. Footnotes

400.3. Escapes

400.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

400.5. Headings

An unnumbered heading

400.6. Links and anchors

400.7. A Heading

400.8. Block quotations

400.9. Line breaks

401. Tables

401.1. Images

401.2. Citations

401.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:

401.4. A level 1 heading

401.4.1. A level 2 heading

401.4.1.1. A level 3 heading

401.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

402. YAM Syntax

402.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

402.2. Contents

Contents listings like that above are generated by '%contents'

402.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

402.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

402.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

402.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

402.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁷⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

402.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

402.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

402.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

402.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

402.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

402.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

402.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

402.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

402.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁷⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

403. 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/='

Hmmm¹⁸⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

404. lasdfkjlskdfj404.1. sldfjsdlkfj404.1.0.0.0.1. klsjdflksdjfl 405. lksdjflksdjflkj 405.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).405.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

406. A level 1 heading

406.1. A level 2 heading

406.1.1. A level 3 heading

407. A level 1 heading YAM Syntax

408. Changes from version 3

headings can be unnumbered, e.g. "%2*"

408.1. Contents

408.2. Bold, italic, underline and teletype

408.2.1. lkjfsldfkjsdf

408.2.2. lksjdflsdkjfl

408.2.2.1. slkdjfsd

408.2.2.1.0.0.1.

408.2.2.1.1.

408.2.3.

408.3. Horizontal lines

409. Lists

409.1. Verbatim output

409.2. Footnotes

409.3. Escapes

409.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

409.5. Headings

An unnumbered heading

409.6. Links and anchors

409.7. A Heading

409.8. Block quotations

409.9. Line breaks

410. Tables

410.1. Images

410.2. Citations

410.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:

410.4. A level 1 heading

410.4.1. A level 2 heading

410.4.1.1. A level 3 heading

410.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

411. YAM Syntax

411.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

411.2. Contents

Contents listings like that above are generated by '%contents'

411.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

411.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

411.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

411.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

411.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁸¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

411.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

411.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

411.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

411.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

411.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

411.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

411.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

411.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

411.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁸²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

412. 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/='

Hmmm¹⁸⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

413. lasdfkjlskdfj413.1. sldfjsdlkfj413.1.0.0.0.1. klsjdflksdjfl 414. lksdjflksdjflkj 414.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).414.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

415. A level 1 heading

415.1. A level 2 heading

415.1.1. A level 3 heading

416. A level 1 heading YAM Syntax

417. Changes from version 3

headings can be unnumbered, e.g. "%2*"

417.1. Contents

417.2. Bold, italic, underline and teletype

417.2.1. lkjfsldfkjsdf

417.2.2. lksjdflsdkjfl

417.2.2.1. slkdjfsd

417.2.2.1.0.0.1.

417.2.2.1.1.

417.2.3.

417.3. Horizontal lines

418. Lists

418.1. Verbatim output

418.2. Footnotes

418.3. Escapes

418.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

418.5. Headings

An unnumbered heading

418.6. Links and anchors

418.7. A Heading

418.8. Block quotations

418.9. Line breaks

419. Tables

419.1. Images

419.2. Citations

419.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:

419.4. A level 1 heading

419.4.1. A level 2 heading

419.4.1.1. A level 3 heading

419.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

420. YAM Syntax

420.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

420.2. Contents

Contents listings like that above are generated by '%contents'

420.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

420.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

420.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

420.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

420.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁸⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

420.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

420.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

420.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

420.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

420.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

420.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

420.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

420.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

420.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁸⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

421. 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/='

Hmmm¹⁸⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

422. lasdfkjlskdfj422.1. sldfjsdlkfj422.1.0.0.0.1. klsjdflksdjfl 423. lksdjflksdjflkj 423.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).423.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

424. A level 1 heading

424.1. A level 2 heading

424.1.1. A level 3 heading

425. A level 1 heading YAM Syntax

426. Changes from version 3

headings can be unnumbered, e.g. "%2*"

426.1. Contents

426.2. Bold, italic, underline and teletype

426.2.1. lkjfsldfkjsdf

426.2.2. lksjdflsdkjfl

426.2.2.1. slkdjfsd

426.2.2.1.0.0.1.

426.2.2.1.1.

426.2.3.

426.3. Horizontal lines

427. Lists

427.1. Verbatim output

427.2. Footnotes

427.3. Escapes

427.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

427.5. Headings

An unnumbered heading

427.6. Links and anchors

427.7. A Heading

427.8. Block quotations

427.9. Line breaks

428. Tables

428.1. Images

428.2. Citations

428.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:

428.4. A level 1 heading

428.4.1. A level 2 heading

428.4.1.1. A level 3 heading

428.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

429. YAM Syntax

429.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

429.2. Contents

Contents listings like that above are generated by '%contents'

429.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

429.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

429.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

429.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

429.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁸⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

429.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

429.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

429.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

429.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

429.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

429.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

429.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

429.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

429.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁹⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

430. 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/='

Hmmm¹⁹². http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

431. lasdfkjlskdfj431.1. sldfjsdlkfj431.1.0.0.0.1. klsjdflksdjfl 432. lksdjflksdjflkj 432.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).432.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

433. A level 1 heading

433.1. A level 2 heading

433.1.1. A level 3 heading

434. A level 1 heading YAM Syntax

435. Changes from version 3

headings can be unnumbered, e.g. "%2*"

435.1. Contents

435.2. Bold, italic, underline and teletype

435.2.1. lkjfsldfkjsdf

435.2.2. lksjdflsdkjfl

435.2.2.1. slkdjfsd

435.2.2.1.0.0.1.

435.2.2.1.1.

435.2.3.

435.3. Horizontal lines

436. Lists

436.1. Verbatim output

436.2. Footnotes

436.3. Escapes

436.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

436.5. Headings

An unnumbered heading

436.6. Links and anchors

436.7. A Heading

436.8. Block quotations

436.9. Line breaks

437. Tables

437.1. Images

437.2. Citations

437.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:

437.4. A level 1 heading

437.4.1. A level 2 heading

437.4.1.1. A level 3 heading

437.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

438. YAM Syntax

438.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

438.2. Contents

Contents listings like that above are generated by '%contents'

438.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

438.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

438.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

438.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

438.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁹³.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

438.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

438.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

438.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

438.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

438.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

438.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

438.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

438.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

438.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁹⁴

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

439. 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/='

Hmmm¹⁹⁶. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

440. lasdfkjlskdfj440.1. sldfjsdlkfj440.1.0.0.0.1. klsjdflksdjfl 441. lksdjflksdjflkj 441.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).441.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

442. A level 1 heading

442.1. A level 2 heading

442.1.1. A level 3 heading

443. A level 1 heading YAM Syntax

444. Changes from version 3

headings can be unnumbered, e.g. "%2*"

444.1. Contents

444.2. Bold, italic, underline and teletype

444.2.1. lkjfsldfkjsdf

444.2.2. lksjdflsdkjfl

444.2.2.1. slkdjfsd

444.2.2.1.0.0.1.

444.2.2.1.1.

444.2.3.

444.3. Horizontal lines

445. Lists

445.1. Verbatim output

445.2. Footnotes

445.3. Escapes

445.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

445.5. Headings

An unnumbered heading

445.6. Links and anchors

445.7. A Heading

445.8. Block quotations

445.9. Line breaks

446. Tables

446.1. Images

446.2. Citations

446.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:

446.4. A level 1 heading

446.4.1. A level 2 heading

446.4.1.1. A level 3 heading

446.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

447. YAM Syntax

447.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

447.2. Contents

Contents listings like that above are generated by '%contents'

447.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

447.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

447.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

447.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

447.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:¹⁹⁷.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

447.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

447.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

447.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

447.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

447.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

447.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

447.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

447.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

447.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

¹⁹⁸

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

448. 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/='

Hmmm²⁰⁰. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

449. lasdfkjlskdfj449.1. sldfjsdlkfj449.1.0.0.0.1. klsjdflksdjfl 450. lksdjflksdjflkj 450.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).450.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

451. A level 1 heading

451.1. A level 2 heading

451.1.1. A level 3 heading

452. A level 1 heading YAM Syntax

453. Changes from version 3

headings can be unnumbered, e.g. "%2*"

453.1. Contents

453.2. Bold, italic, underline and teletype

453.2.1. lkjfsldfkjsdf

453.2.2. lksjdflsdkjfl

453.2.2.1. slkdjfsd

453.2.2.1.0.0.1.

453.2.2.1.1.

453.2.3.

453.3. Horizontal lines

454. Lists

454.1. Verbatim output

454.2. Footnotes

454.3. Escapes

454.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

454.5. Headings

An unnumbered heading

454.6. Links and anchors

454.7. A Heading

454.8. Block quotations

454.9. Line breaks

455. Tables

455.1. Images

455.2. Citations

455.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:

455.4. A level 1 heading

455.4.1. A level 2 heading

455.4.1.1. A level 3 heading

455.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

456. YAM Syntax

456.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

456.2. Contents

Contents listings like that above are generated by '%contents'

456.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

456.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

456.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

456.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

456.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁰¹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

456.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

456.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

456.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

456.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

456.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

456.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

456.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

456.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

456.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

²⁰²

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

457. 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/='

Hmmm²⁰⁴. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

458. lasdfkjlskdfj458.1. sldfjsdlkfj458.1.0.0.0.1. klsjdflksdjfl 459. lksdjflksdjflkj 459.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).459.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

460. A level 1 heading

460.1. A level 2 heading

460.1.1. A level 3 heading

461. A level 1 heading YAM Syntax

462. Changes from version 3

headings can be unnumbered, e.g. "%2*"

462.1. Contents

462.2. Bold, italic, underline and teletype

462.2.1. lkjfsldfkjsdf

462.2.2. lksjdflsdkjfl

462.2.2.1. slkdjfsd

462.2.2.1.0.0.1.

462.2.2.1.1.

462.2.3.

462.3. Horizontal lines

463. Lists

463.1. Verbatim output

463.2. Footnotes

463.3. Escapes

463.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

463.5. Headings

An unnumbered heading

463.6. Links and anchors

463.7. A Heading

463.8. Block quotations

463.9. Line breaks

464. Tables

464.1. Images

464.2. Citations

464.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:

464.4. A level 1 heading

464.4.1. A level 2 heading

464.4.1.1. A level 3 heading

464.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

465. YAM Syntax

465.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

465.2. Contents

Contents listings like that above are generated by '%contents'

465.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

465.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

465.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

465.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

465.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁰⁵.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

465.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

465.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

465.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

465.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

465.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

465.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

465.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

465.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

465.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

²⁰⁶

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

This is

a small table

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...

466. 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/='

Hmmm²⁰⁸. http://gate.ac.uk http://gate.ac.uk http://gate.ac.uk/sale/tao/index.html#234234234 http://gate.ac.uk/sale/tao/index.html#234234234 thing thing

As plain text, e.g. 'http://gate.ac.uk/='
As plain text, e.g. 'http://gate.ac.uk/'

Old YAM URL processing (http://gate.ac.uk)

Using '%(target)', e.g. %(http://gate.ac.uk/)
Using 'target', e.g. http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home)
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***

467. lasdfkjlskdfj467.1. sldfjsdlkfj467.1.0.0.0.1. klsjdflksdjfl 468. lksdjflksdjflkj 468.1. Bold, italic, underline and teletype #bold

Unordered lists are indicated by 'o' at the start of a line, and ordered lists by '-'. Nesting is indicated by two spaces preceding the item indicator. For example: This is an o - - o undordered list Second item This is a nested... - - ...ordered list - Back to the third item of the enclosing list - skdjf sldkfjsdlkfj For example: This *will not* get translated The contents will be output to the translation file, but will be commented out in that file. \The quotation marks around the note are necessary; notes cannot contain quotation marks (even if escaped).468.2. Links and anchors #links Links can be specified in four ways:

As plain text, e.g. 'http://gate.ac.uk/=' will become http://gate.ac.uk/
Using 'target', e.g. http://gate.ac.uk/ will become http://gate.ac.uk/
Using 'label', e.g. GATE home will become GATE home
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

header col 1	header col 2
row 1 col 1	col 2 \|\|
	lkjflsdf
row 2 col 1	col 2

It is possible to have a

blockquote almost

-

sdfsdfsdfa

anywhere!

Though it may not be a great idea...

Another block quote.

Blockquoate

with a list

or two

This is a title.

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines. YAM Heading Increments

469. A level 1 heading

469.1. A level 2 heading

469.1.1. A level 3 heading

470. A level 1 heading YAM Syntax

471. Changes from version 3

headings can be unnumbered, e.g. "%2*"

471.1. Contents

471.2. Bold, italic, underline and teletype

471.2.1. lkjfsldfkjsdf

471.2.2. lksjdflsdkjfl

471.2.2.1. slkdjfsd

471.2.2.1.0.0.1.

471.2.2.1.1.

471.2.3.

471.3. Horizontal lines

472. Lists

472.1. Verbatim output

472.2. Footnotes

472.3. Escapes

472.4. Headings Headings are lines starting with `%1` (for first level), `%2`, `%3` or `%4`. For example, the heading for this section is

472.5. Headings

An unnumbered heading

472.6. Links and anchors

472.7. A Heading

472.8. Block quotations

472.9. Line breaks

473. Tables

473.1. Images

473.2. Citations

473.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:

473.4. A level 1 heading

473.4.1. A level 2 heading

473.4.1.1. A level 3 heading

473.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

a third list

and a fourth
that has two items

list 3/1
3/2
- 3a/1
- 3a/2
  1. 3aa/1
- 3a/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.

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
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.0.0.1.
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
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
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
6. YAM Syntax
6.1. Changes from version 3
6.2. Contents
6.3. Bold, italic, underline and teletype
6.4. Horizontal lines
6.5. Lists
6.6. Verbatim output
6.7. Footnotes
6.8. Escapes
6.9. Headings
6.10. Links and anchors
6.11. Block quotations
6.12. Line breaks
6.13. Tables
6.14. Images
6.15. Citations
6.16. Inclusion
7. Miscellaneous previous URL examples
8. lasdfkjlskdfj
8.1. sldfjsdlkfj
8.1.0.0.0.1. klsjdflksdjfl
9. lksdjflksdjflkj
9.1. Bold, italic, underline and teletype #bold
9.2. Links and anchors #links
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
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.0.0.1.
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
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
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
15. YAM Syntax
15.1. Changes from version 3
15.2. Contents
15.3. Bold, italic, underline and teletype
15.4. Horizontal lines
15.5. Lists
15.6. Verbatim output
15.7. Footnotes
15.8. Escapes
15.9. Headings
15.10. Links and anchors
15.11. Block quotations
15.12. Line breaks
15.13. Tables
15.14. Images
15.15. Citations
15.16. Inclusion
16. Miscellaneous previous URL examples
17. lasdfkjlskdfj
17.1. sldfjsdlkfj
17.1.0.0.0.1. klsjdflksdjfl
18. lksdjflksdjflkj
18.1. Bold, italic, underline and teletype #bold
18.2. Links and anchors #links
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
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.0.0.1.
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
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
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
24. YAM Syntax
24.1. Changes from version 3
24.2. Contents
24.3. Bold, italic, underline and teletype
24.4. Horizontal lines
24.5. Lists
24.6. Verbatim output
24.7. Footnotes
24.8. Escapes
24.9. Headings
24.10. Links and anchors
24.11. Block quotations
24.12. Line breaks
24.13. Tables
24.14. Images
24.15. Citations
24.16. Inclusion
25. Miscellaneous previous URL examples
26. lasdfkjlskdfj
26.1. sldfjsdlkfj
26.1.0.0.0.1. klsjdflksdjfl
27. lksdjflksdjflkj
27.1. Bold, italic, underline and teletype #bold
27.2. Links and anchors #links
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
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.0.0.1.
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
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
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
33. YAM Syntax
33.1. Changes from version 3
33.2. Contents
33.3. Bold, italic, underline and teletype
33.4. Horizontal lines
33.5. Lists
33.6. Verbatim output
33.7. Footnotes
33.8. Escapes
33.9. Headings
33.10. Links and anchors
33.11. Block quotations
33.12. Line breaks
33.13. Tables
33.14. Images
33.15. Citations
33.16. Inclusion
34. Miscellaneous previous URL examples
35. lasdfkjlskdfj
35.1. sldfjsdlkfj
35.1.0.0.0.1. klsjdflksdjfl
36. lksdjflksdjflkj
36.1. Bold, italic, underline and teletype #bold
36.2. Links and anchors #links
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
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.0.0.1.
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
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
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
42. YAM Syntax
42.1. Changes from version 3
42.2. Contents
42.3. Bold, italic, underline and teletype
42.4. Horizontal lines
42.5. Lists
42.6. Verbatim output
42.7. Footnotes
42.8. Escapes
42.9. Headings
42.10. Links and anchors
42.11. Block quotations
42.12. Line breaks
42.13. Tables
42.14. Images
42.15. Citations
42.16. Inclusion
43. Miscellaneous previous URL examples
44. lasdfkjlskdfj
44.1. sldfjsdlkfj
44.1.0.0.0.1. klsjdflksdjfl
45. lksdjflksdjflkj
45.1. Bold, italic, underline and teletype #bold
45.2. Links and anchors #links
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
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.0.0.1.
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
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
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
51. YAM Syntax
51.1. Changes from version 3
51.2. Contents
51.3. Bold, italic, underline and teletype
51.4. Horizontal lines
51.5. Lists
51.6. Verbatim output
51.7. Footnotes
51.8. Escapes
51.9. Headings
51.10. Links and anchors
51.11. Block quotations
51.12. Line breaks
51.13. Tables
51.14. Images
51.15. Citations
51.16. Inclusion
52. Miscellaneous previous URL examples
53. lasdfkjlskdfj
53.1. sldfjsdlkfj
53.1.0.0.0.1. klsjdflksdjfl
54. lksdjflksdjflkj
54.1. Bold, italic, underline and teletype #bold
54.2. Links and anchors #links
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
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.0.0.1.
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
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
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
60. YAM Syntax
60.1. Changes from version 3
60.2. Contents
60.3. Bold, italic, underline and teletype
60.4. Horizontal lines
60.5. Lists
60.6. Verbatim output
60.7. Footnotes
60.8. Escapes
60.9. Headings
60.10. Links and anchors
60.11. Block quotations
60.12. Line breaks
60.13. Tables
60.14. Images
60.15. Citations
60.16. Inclusion
61. Miscellaneous previous URL examples
62. lasdfkjlskdfj
62.1. sldfjsdlkfj
62.1.0.0.0.1. klsjdflksdjfl
63. lksdjflksdjflkj
63.1. Bold, italic, underline and teletype #bold
63.2. Links and anchors #links
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
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.0.0.1.
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
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
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
69. YAM Syntax
69.1. Changes from version 3
69.2. Contents
69.3. Bold, italic, underline and teletype
69.4. Horizontal lines
69.5. Lists
69.6. Verbatim output
69.7. Footnotes
69.8. Escapes
69.9. Headings
69.10. Links and anchors
69.11. Block quotations
69.12. Line breaks
69.13. Tables
69.14. Images
69.15. Citations
69.16. Inclusion
70. Miscellaneous previous URL examples
71. lasdfkjlskdfj
71.1. sldfjsdlkfj
71.1.0.0.0.1. klsjdflksdjfl
72. lksdjflksdjflkj
72.1. Bold, italic, underline and teletype #bold
72.2. Links and anchors #links
73. A level 1 heading
73.1. A level 2 heading
73.1.1. A level 3 heading
74. A level 1 heading YAM Syntax
75. Changes from version 3
75.1. Contents
75.2. Bold, italic, underline and teletype
75.2.1. lkjfsldfkjsdf
75.2.2. lksjdflsdkjfl
75.2.2.1. slkdjfsd
75.2.2.1.0.0.1.
75.2.2.1.1.
75.2.3.
75.3. Horizontal lines
76. Lists
76.1. Verbatim output
76.2. Footnotes
76.3. Escapes
76.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
76.5. Headings
76.6. Links and anchors
76.7. A Heading
76.8. Block quotations
76.9. Line breaks
77. Tables
77.1. Images
77.2. Citations
77.3. Inclusion Images and other predicates
77.4. A level 1 heading
77.4.1. A level 2 heading
77.4.1.1. A level 3 heading
77.5. A level 1 heading
78. YAM Syntax
78.1. Changes from version 3
78.2. Contents
78.3. Bold, italic, underline and teletype
78.4. Horizontal lines
78.5. Lists
78.6. Verbatim output
78.7. Footnotes
78.8. Escapes
78.9. Headings
78.10. Links and anchors
78.11. Block quotations
78.12. Line breaks
78.13. Tables
78.14. Images
78.15. Citations
78.16. Inclusion
79. Miscellaneous previous URL examples
80. lasdfkjlskdfj
80.1. sldfjsdlkfj
80.1.0.0.0.1. klsjdflksdjfl
81. lksdjflksdjflkj
81.1. Bold, italic, underline and teletype #bold
81.2. Links and anchors #links
82. A level 1 heading
82.1. A level 2 heading
82.1.1. A level 3 heading
83. A level 1 heading YAM Syntax
84. Changes from version 3
84.1. Contents
84.2. Bold, italic, underline and teletype
84.2.1. lkjfsldfkjsdf
84.2.2. lksjdflsdkjfl
84.2.2.1. slkdjfsd
84.2.2.1.0.0.1.
84.2.2.1.1.
84.2.3.
84.3. Horizontal lines
85. Lists
85.1. Verbatim output
85.2. Footnotes
85.3. Escapes
85.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
85.5. Headings
85.6. Links and anchors
85.7. A Heading
85.8. Block quotations
85.9. Line breaks
86. Tables
86.1. Images
86.2. Citations
86.3. Inclusion Images and other predicates
86.4. A level 1 heading
86.4.1. A level 2 heading
86.4.1.1. A level 3 heading
86.5. A level 1 heading
87. YAM Syntax
87.1. Changes from version 3
87.2. Contents
87.3. Bold, italic, underline and teletype
87.4. Horizontal lines
87.5. Lists
87.6. Verbatim output
87.7. Footnotes
87.8. Escapes
87.9. Headings
87.10. Links and anchors
87.11. Block quotations
87.12. Line breaks
87.13. Tables
87.14. Images
87.15. Citations
87.16. Inclusion
88. Miscellaneous previous URL examples
89. lasdfkjlskdfj
89.1. sldfjsdlkfj
89.1.0.0.0.1. klsjdflksdjfl
90. lksdjflksdjflkj
90.1. Bold, italic, underline and teletype #bold
90.2. Links and anchors #links
91. A level 1 heading
91.1. A level 2 heading
91.1.1. A level 3 heading
92. A level 1 heading YAM Syntax
93. Changes from version 3
93.1. Contents
93.2. Bold, italic, underline and teletype
93.2.1. lkjfsldfkjsdf
93.2.2. lksjdflsdkjfl
93.2.2.1. slkdjfsd
93.2.2.1.0.0.1.
93.2.2.1.1.
93.2.3.
93.3. Horizontal lines
94. Lists
94.1. Verbatim output
94.2. Footnotes
94.3. Escapes
94.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
94.5. Headings
94.6. Links and anchors
94.7. A Heading
94.8. Block quotations
94.9. Line breaks
95. Tables
95.1. Images
95.2. Citations
95.3. Inclusion Images and other predicates
95.4. A level 1 heading
95.4.1. A level 2 heading
95.4.1.1. A level 3 heading
95.5. A level 1 heading
96. YAM Syntax
96.1. Changes from version 3
96.2. Contents
96.3. Bold, italic, underline and teletype
96.4. Horizontal lines
96.5. Lists
96.6. Verbatim output
96.7. Footnotes
96.8. Escapes
96.9. Headings
96.10. Links and anchors
96.11. Block quotations
96.12. Line breaks
96.13. Tables
96.14. Images
96.15. Citations
96.16. Inclusion
97. Miscellaneous previous URL examples
98. lasdfkjlskdfj
98.1. sldfjsdlkfj
98.1.0.0.0.1. klsjdflksdjfl
99. lksdjflksdjflkj
99.1. Bold, italic, underline and teletype #bold
99.2. Links and anchors #links
100. A level 1 heading
100.1. A level 2 heading
100.1.1. A level 3 heading
101. A level 1 heading YAM Syntax
102. Changes from version 3
102.1. Contents
102.2. Bold, italic, underline and teletype
102.2.1. lkjfsldfkjsdf
102.2.2. lksjdflsdkjfl
102.2.2.1. slkdjfsd
102.2.2.1.0.0.1.
102.2.2.1.1.
102.2.3.
102.3. Horizontal lines
103. Lists
103.1. Verbatim output
103.2. Footnotes
103.3. Escapes
103.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
103.5. Headings
103.6. Links and anchors
103.7. A Heading
103.8. Block quotations
103.9. Line breaks
104. Tables
104.1. Images
104.2. Citations
104.3. Inclusion Images and other predicates
104.4. A level 1 heading
104.4.1. A level 2 heading
104.4.1.1. A level 3 heading
104.5. A level 1 heading
105. YAM Syntax
105.1. Changes from version 3
105.2. Contents
105.3. Bold, italic, underline and teletype
105.4. Horizontal lines
105.5. Lists
105.6. Verbatim output
105.7. Footnotes
105.8. Escapes
105.9. Headings
105.10. Links and anchors
105.11. Block quotations
105.12. Line breaks
105.13. Tables
105.14. Images
105.15. Citations
105.16. Inclusion
106. Miscellaneous previous URL examples
107. lasdfkjlskdfj
107.1. sldfjsdlkfj
107.1.0.0.0.1. klsjdflksdjfl
108. lksdjflksdjflkj
108.1. Bold, italic, underline and teletype #bold
108.2. Links and anchors #links
109. A level 1 heading
109.1. A level 2 heading
109.1.1. A level 3 heading
110. A level 1 heading YAM Syntax
111. Changes from version 3
111.1. Contents
111.2. Bold, italic, underline and teletype
111.2.1. lkjfsldfkjsdf
111.2.2. lksjdflsdkjfl
111.2.2.1. slkdjfsd
111.2.2.1.0.0.1.
111.2.2.1.1.
111.2.3.
111.3. Horizontal lines
112. Lists
112.1. Verbatim output
112.2. Footnotes
112.3. Escapes
112.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
112.5. Headings
112.6. Links and anchors
112.7. A Heading
112.8. Block quotations
112.9. Line breaks
113. Tables
113.1. Images
113.2. Citations
113.3. Inclusion Images and other predicates
113.4. A level 1 heading
113.4.1. A level 2 heading
113.4.1.1. A level 3 heading
113.5. A level 1 heading
114. YAM Syntax
114.1. Changes from version 3
114.2. Contents
114.3. Bold, italic, underline and teletype
114.4. Horizontal lines
114.5. Lists
114.6. Verbatim output
114.7. Footnotes
114.8. Escapes
114.9. Headings
114.10. Links and anchors
114.11. Block quotations
114.12. Line breaks
114.13. Tables
114.14. Images
114.15. Citations
114.16. Inclusion
115. Miscellaneous previous URL examples
116. lasdfkjlskdfj
116.1. sldfjsdlkfj
116.1.0.0.0.1. klsjdflksdjfl
117. lksdjflksdjflkj
117.1. Bold, italic, underline and teletype #bold
117.2. Links and anchors #links
118. A level 1 heading
118.1. A level 2 heading
118.1.1. A level 3 heading
119. A level 1 heading YAM Syntax
120. Changes from version 3
120.1. Contents
120.2. Bold, italic, underline and teletype
120.2.1. lkjfsldfkjsdf
120.2.2. lksjdflsdkjfl
120.2.2.1. slkdjfsd
120.2.2.1.0.0.1.
120.2.2.1.1.
120.2.3.
120.3. Horizontal lines
121. Lists
121.1. Verbatim output
121.2. Footnotes
121.3. Escapes
121.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
121.5. Headings
121.6. Links and anchors
121.7. A Heading
121.8. Block quotations
121.9. Line breaks
122. Tables
122.1. Images
122.2. Citations
122.3. Inclusion Images and other predicates
122.4. A level 1 heading
122.4.1. A level 2 heading
122.4.1.1. A level 3 heading
122.5. A level 1 heading
123. YAM Syntax
123.1. Changes from version 3
123.2. Contents
123.3. Bold, italic, underline and teletype
123.4. Horizontal lines
123.5. Lists
123.6. Verbatim output
123.7. Footnotes
123.8. Escapes
123.9. Headings
123.10. Links and anchors
123.11. Block quotations
123.12. Line breaks
123.13. Tables
123.14. Images
123.15. Citations
123.16. Inclusion
124. Miscellaneous previous URL examples
125. lasdfkjlskdfj
125.1. sldfjsdlkfj
125.1.0.0.0.1. klsjdflksdjfl
126. lksdjflksdjflkj
126.1. Bold, italic, underline and teletype #bold
126.2. Links and anchors #links
127. A level 1 heading
127.1. A level 2 heading
127.1.1. A level 3 heading
128. A level 1 heading YAM Syntax
129. Changes from version 3
129.1. Contents
129.2. Bold, italic, underline and teletype
129.2.1. lkjfsldfkjsdf
129.2.2. lksjdflsdkjfl
129.2.2.1. slkdjfsd
129.2.2.1.0.0.1.
129.2.2.1.1.
129.2.3.
129.3. Horizontal lines
130. Lists
130.1. Verbatim output
130.2. Footnotes
130.3. Escapes
130.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
130.5. Headings
130.6. Links and anchors
130.7. A Heading
130.8. Block quotations
130.9. Line breaks
131. Tables
131.1. Images
131.2. Citations
131.3. Inclusion Images and other predicates
131.4. A level 1 heading
131.4.1. A level 2 heading
131.4.1.1. A level 3 heading
131.5. A level 1 heading
132. YAM Syntax
132.1. Changes from version 3
132.2. Contents
132.3. Bold, italic, underline and teletype
132.4. Horizontal lines
132.5. Lists
132.6. Verbatim output
132.7. Footnotes
132.8. Escapes
132.9. Headings
132.10. Links and anchors
132.11. Block quotations
132.12. Line breaks
132.13. Tables
132.14. Images
132.15. Citations
132.16. Inclusion
133. Miscellaneous previous URL examples
134. lasdfkjlskdfj
134.1. sldfjsdlkfj
134.1.0.0.0.1. klsjdflksdjfl
135. lksdjflksdjflkj
135.1. Bold, italic, underline and teletype #bold
135.2. Links and anchors #links
136. A level 1 heading
136.1. A level 2 heading
136.1.1. A level 3 heading
137. A level 1 heading YAM Syntax
138. Changes from version 3
138.1. Contents
138.2. Bold, italic, underline and teletype
138.2.1. lkjfsldfkjsdf
138.2.2. lksjdflsdkjfl
138.2.2.1. slkdjfsd
138.2.2.1.0.0.1.
138.2.2.1.1.
138.2.3.
138.3. Horizontal lines
139. Lists
139.1. Verbatim output
139.2. Footnotes
139.3. Escapes
139.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
139.5. Headings
139.6. Links and anchors
139.7. A Heading
139.8. Block quotations
139.9. Line breaks
140. Tables
140.1. Images
140.2. Citations
140.3. Inclusion Images and other predicates
140.4. A level 1 heading
140.4.1. A level 2 heading
140.4.1.1. A level 3 heading
140.5. A level 1 heading
141. YAM Syntax
141.1. Changes from version 3
141.2. Contents
141.3. Bold, italic, underline and teletype
141.4. Horizontal lines
141.5. Lists
141.6. Verbatim output
141.7. Footnotes
141.8. Escapes
141.9. Headings
141.10. Links and anchors
141.11. Block quotations
141.12. Line breaks
141.13. Tables
141.14. Images
141.15. Citations
141.16. Inclusion
142. Miscellaneous previous URL examples
143. lasdfkjlskdfj
143.1. sldfjsdlkfj
143.1.0.0.0.1. klsjdflksdjfl
144. lksdjflksdjflkj
144.1. Bold, italic, underline and teletype #bold
144.2. Links and anchors #links
145. A level 1 heading
145.1. A level 2 heading
145.1.1. A level 3 heading
146. A level 1 heading YAM Syntax
147. Changes from version 3
147.1. Contents
147.2. Bold, italic, underline and teletype
147.2.1. lkjfsldfkjsdf
147.2.2. lksjdflsdkjfl
147.2.2.1. slkdjfsd
147.2.2.1.0.0.1.
147.2.2.1.1.
147.2.3.
147.3. Horizontal lines
148. Lists
148.1. Verbatim output
148.2. Footnotes
148.3. Escapes
148.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
148.5. Headings
148.6. Links and anchors
148.7. A Heading
148.8. Block quotations
148.9. Line breaks
149. Tables
149.1. Images
149.2. Citations
149.3. Inclusion Images and other predicates
149.4. A level 1 heading
149.4.1. A level 2 heading
149.4.1.1. A level 3 heading
149.5. A level 1 heading
150. YAM Syntax
150.1. Changes from version 3
150.2. Contents
150.3. Bold, italic, underline and teletype
150.4. Horizontal lines
150.5. Lists
150.6. Verbatim output
150.7. Footnotes
150.8. Escapes
150.9. Headings
150.10. Links and anchors
150.11. Block quotations
150.12. Line breaks
150.13. Tables
150.14. Images
150.15. Citations
150.16. Inclusion
151. Miscellaneous previous URL examples
152. lasdfkjlskdfj
152.1. sldfjsdlkfj
152.1.0.0.0.1. klsjdflksdjfl
153. lksdjflksdjflkj
153.1. Bold, italic, underline and teletype #bold
153.2. Links and anchors #links
154. A level 1 heading
154.1. A level 2 heading
154.1.1. A level 3 heading
155. A level 1 heading YAM Syntax
156. Changes from version 3
156.1. Contents
156.2. Bold, italic, underline and teletype
156.2.1. lkjfsldfkjsdf
156.2.2. lksjdflsdkjfl
156.2.2.1. slkdjfsd
156.2.2.1.0.0.1.
156.2.2.1.1.
156.2.3.
156.3. Horizontal lines
157. Lists
157.1. Verbatim output
157.2. Footnotes
157.3. Escapes
157.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
157.5. Headings
157.6. Links and anchors
157.7. A Heading
157.8. Block quotations
157.9. Line breaks
158. Tables
158.1. Images
158.2. Citations
158.3. Inclusion Images and other predicates
158.4. A level 1 heading
158.4.1. A level 2 heading
158.4.1.1. A level 3 heading
158.5. A level 1 heading
159. YAM Syntax
159.1. Changes from version 3
159.2. Contents
159.3. Bold, italic, underline and teletype
159.4. Horizontal lines
159.5. Lists
159.6. Verbatim output
159.7. Footnotes
159.8. Escapes
159.9. Headings
159.10. Links and anchors
159.11. Block quotations
159.12. Line breaks
159.13. Tables
159.14. Images
159.15. Citations
159.16. Inclusion
160. Miscellaneous previous URL examples
161. lasdfkjlskdfj
161.1. sldfjsdlkfj
161.1.0.0.0.1. klsjdflksdjfl
162. lksdjflksdjflkj
162.1. Bold, italic, underline and teletype #bold
162.2. Links and anchors #links
163. A level 1 heading
163.1. A level 2 heading
163.1.1. A level 3 heading
164. A level 1 heading YAM Syntax
165. Changes from version 3
165.1. Contents
165.2. Bold, italic, underline and teletype
165.2.1. lkjfsldfkjsdf
165.2.2. lksjdflsdkjfl
165.2.2.1. slkdjfsd
165.2.2.1.0.0.1.
165.2.2.1.1.
165.2.3.
165.3. Horizontal lines
166. Lists
166.1. Verbatim output
166.2. Footnotes
166.3. Escapes
166.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
166.5. Headings
166.6. Links and anchors
166.7. A Heading
166.8. Block quotations
166.9. Line breaks
167. Tables
167.1. Images
167.2. Citations
167.3. Inclusion Images and other predicates
167.4. A level 1 heading
167.4.1. A level 2 heading
167.4.1.1. A level 3 heading
167.5. A level 1 heading
168. YAM Syntax
168.1. Changes from version 3
168.2. Contents
168.3. Bold, italic, underline and teletype
168.4. Horizontal lines
168.5. Lists
168.6. Verbatim output
168.7. Footnotes
168.8. Escapes
168.9. Headings
168.10. Links and anchors
168.11. Block quotations
168.12. Line breaks
168.13. Tables
168.14. Images
168.15. Citations
168.16. Inclusion
169. Miscellaneous previous URL examples
170. lasdfkjlskdfj
170.1. sldfjsdlkfj
170.1.0.0.0.1. klsjdflksdjfl
171. lksdjflksdjflkj
171.1. Bold, italic, underline and teletype #bold
171.2. Links and anchors #links
172. A level 1 heading
172.1. A level 2 heading
172.1.1. A level 3 heading
173. A level 1 heading YAM Syntax
174. Changes from version 3
174.1. Contents
174.2. Bold, italic, underline and teletype
174.2.1. lkjfsldfkjsdf
174.2.2. lksjdflsdkjfl
174.2.2.1. slkdjfsd
174.2.2.1.0.0.1.
174.2.2.1.1.
174.2.3.
174.3. Horizontal lines
175. Lists
175.1. Verbatim output
175.2. Footnotes
175.3. Escapes
175.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
175.5. Headings
175.6. Links and anchors
175.7. A Heading
175.8. Block quotations
175.9. Line breaks
176. Tables
176.1. Images
176.2. Citations
176.3. Inclusion Images and other predicates
176.4. A level 1 heading
176.4.1. A level 2 heading
176.4.1.1. A level 3 heading
176.5. A level 1 heading
177. YAM Syntax
177.1. Changes from version 3
177.2. Contents
177.3. Bold, italic, underline and teletype
177.4. Horizontal lines
177.5. Lists
177.6. Verbatim output
177.7. Footnotes
177.8. Escapes
177.9. Headings
177.10. Links and anchors
177.11. Block quotations
177.12. Line breaks
177.13. Tables
177.14. Images
177.15. Citations
177.16. Inclusion
178. Miscellaneous previous URL examples
179. lasdfkjlskdfj
179.1. sldfjsdlkfj
179.1.0.0.0.1. klsjdflksdjfl
180. lksdjflksdjflkj
180.1. Bold, italic, underline and teletype #bold
180.2. Links and anchors #links
181. A level 1 heading
181.1. A level 2 heading
181.1.1. A level 3 heading
182. A level 1 heading YAM Syntax
183. Changes from version 3
183.1. Contents
183.2. Bold, italic, underline and teletype
183.2.1. lkjfsldfkjsdf
183.2.2. lksjdflsdkjfl
183.2.2.1. slkdjfsd
183.2.2.1.0.0.1.
183.2.2.1.1.
183.2.3.
183.3. Horizontal lines
184. Lists
184.1. Verbatim output
184.2. Footnotes
184.3. Escapes
184.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
184.5. Headings
184.6. Links and anchors
184.7. A Heading
184.8. Block quotations
184.9. Line breaks
185. Tables
185.1. Images
185.2. Citations
185.3. Inclusion Images and other predicates
185.4. A level 1 heading
185.4.1. A level 2 heading
185.4.1.1. A level 3 heading
185.5. A level 1 heading
186. YAM Syntax
186.1. Changes from version 3
186.2. Contents
186.3. Bold, italic, underline and teletype
186.4. Horizontal lines
186.5. Lists
186.6. Verbatim output
186.7. Footnotes
186.8. Escapes
186.9. Headings
186.10. Links and anchors
186.11. Block quotations
186.12. Line breaks
186.13. Tables
186.14. Images
186.15. Citations
186.16. Inclusion
187. Miscellaneous previous URL examples
188. lasdfkjlskdfj
188.1. sldfjsdlkfj
188.1.0.0.0.1. klsjdflksdjfl
189. lksdjflksdjflkj
189.1. Bold, italic, underline and teletype #bold
189.2. Links and anchors #links
190. A level 1 heading
190.1. A level 2 heading
190.1.1. A level 3 heading
191. A level 1 heading YAM Syntax
192. Changes from version 3
192.1. Contents
192.2. Bold, italic, underline and teletype
192.2.1. lkjfsldfkjsdf
192.2.2. lksjdflsdkjfl
192.2.2.1. slkdjfsd
192.2.2.1.0.0.1.
192.2.2.1.1.
192.2.3.
192.3. Horizontal lines
193. Lists
193.1. Verbatim output
193.2. Footnotes
193.3. Escapes
193.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
193.5. Headings
193.6. Links and anchors
193.7. A Heading
193.8. Block quotations
193.9. Line breaks
194. Tables
194.1. Images
194.2. Citations
194.3. Inclusion Images and other predicates
194.4. A level 1 heading
194.4.1. A level 2 heading
194.4.1.1. A level 3 heading
194.5. A level 1 heading
195. YAM Syntax
195.1. Changes from version 3
195.2. Contents
195.3. Bold, italic, underline and teletype
195.4. Horizontal lines
195.5. Lists
195.6. Verbatim output
195.7. Footnotes
195.8. Escapes
195.9. Headings
195.10. Links and anchors
195.11. Block quotations
195.12. Line breaks
195.13. Tables
195.14. Images
195.15. Citations
195.16. Inclusion
196. Miscellaneous previous URL examples
197. lasdfkjlskdfj
197.1. sldfjsdlkfj
197.1.0.0.0.1. klsjdflksdjfl
198. lksdjflksdjflkj
198.1. Bold, italic, underline and teletype #bold
198.2. Links and anchors #links
199. A level 1 heading
199.1. A level 2 heading
199.1.1. A level 3 heading
200. A level 1 heading YAM Syntax
201. Changes from version 3
201.1. Contents
201.2. Bold, italic, underline and teletype
201.2.1. lkjfsldfkjsdf
201.2.2. lksjdflsdkjfl
201.2.2.1. slkdjfsd
201.2.2.1.0.0.1.
201.2.2.1.1.
201.2.3.
201.3. Horizontal lines
202. Lists
202.1. Verbatim output
202.2. Footnotes
202.3. Escapes
202.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
202.5. Headings
202.6. Links and anchors
202.7. A Heading
202.8. Block quotations
202.9. Line breaks
203. Tables
203.1. Images
203.2. Citations
203.3. Inclusion Images and other predicates
203.4. A level 1 heading
203.4.1. A level 2 heading
203.4.1.1. A level 3 heading
203.5. A level 1 heading
204. YAM Syntax
204.1. Changes from version 3
204.2. Contents
204.3. Bold, italic, underline and teletype
204.4. Horizontal lines
204.5. Lists
204.6. Verbatim output
204.7. Footnotes
204.8. Escapes
204.9. Headings
204.10. Links and anchors
204.11. Block quotations
204.12. Line breaks
204.13. Tables
204.14. Images
204.15. Citations
204.16. Inclusion
205. Miscellaneous previous URL examples
206. lasdfkjlskdfj
206.1. sldfjsdlkfj
206.1.0.0.0.1. klsjdflksdjfl
207. lksdjflksdjflkj
207.1. Bold, italic, underline and teletype #bold
207.2. Links and anchors #links
208. A level 1 heading
208.1. A level 2 heading
208.1.1. A level 3 heading
209. A level 1 heading YAM Syntax
210. Changes from version 3
210.1. Contents
210.2. Bold, italic, underline and teletype
210.2.1. lkjfsldfkjsdf
210.2.2. lksjdflsdkjfl
210.2.2.1. slkdjfsd
210.2.2.1.0.0.1.
210.2.2.1.1.
210.2.3.
210.3. Horizontal lines
211. Lists
211.1. Verbatim output
211.2. Footnotes
211.3. Escapes
211.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
211.5. Headings
211.6. Links and anchors
211.7. A Heading
211.8. Block quotations
211.9. Line breaks
212. Tables
212.1. Images
212.2. Citations
212.3. Inclusion Images and other predicates
212.4. A level 1 heading
212.4.1. A level 2 heading
212.4.1.1. A level 3 heading
212.5. A level 1 heading
213. YAM Syntax
213.1. Changes from version 3
213.2. Contents
213.3. Bold, italic, underline and teletype
213.4. Horizontal lines
213.5. Lists
213.6. Verbatim output
213.7. Footnotes
213.8. Escapes
213.9. Headings
213.10. Links and anchors
213.11. Block quotations
213.12. Line breaks
213.13. Tables
213.14. Images
213.15. Citations
213.16. Inclusion
214. Miscellaneous previous URL examples
215. lasdfkjlskdfj
215.1. sldfjsdlkfj
215.1.0.0.0.1. klsjdflksdjfl
216. lksdjflksdjflkj
216.1. Bold, italic, underline and teletype #bold
216.2. Links and anchors #links
217. A level 1 heading
217.1. A level 2 heading
217.1.1. A level 3 heading
218. A level 1 heading YAM Syntax
219. Changes from version 3
219.1. Contents
219.2. Bold, italic, underline and teletype
219.2.1. lkjfsldfkjsdf
219.2.2. lksjdflsdkjfl
219.2.2.1. slkdjfsd
219.2.2.1.0.0.1.
219.2.2.1.1.
219.2.3.
219.3. Horizontal lines
220. Lists
220.1. Verbatim output
220.2. Footnotes
220.3. Escapes
220.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
220.5. Headings
220.6. Links and anchors
220.7. A Heading
220.8. Block quotations
220.9. Line breaks
221. Tables
221.1. Images
221.2. Citations
221.3. Inclusion Images and other predicates
221.4. A level 1 heading
221.4.1. A level 2 heading
221.4.1.1. A level 3 heading
221.5. A level 1 heading
222. YAM Syntax
222.1. Changes from version 3
222.2. Contents
222.3. Bold, italic, underline and teletype
222.4. Horizontal lines
222.5. Lists
222.6. Verbatim output
222.7. Footnotes
222.8. Escapes
222.9. Headings
222.10. Links and anchors
222.11. Block quotations
222.12. Line breaks
222.13. Tables
222.14. Images
222.15. Citations
222.16. Inclusion
223. Miscellaneous previous URL examples
224. lasdfkjlskdfj
224.1. sldfjsdlkfj
224.1.0.0.0.1. klsjdflksdjfl
225. lksdjflksdjflkj
225.1. Bold, italic, underline and teletype #bold
225.2. Links and anchors #links
226. A level 1 heading
226.1. A level 2 heading
226.1.1. A level 3 heading
227. A level 1 heading YAM Syntax
228. Changes from version 3
228.1. Contents
228.2. Bold, italic, underline and teletype
228.2.1. lkjfsldfkjsdf
228.2.2. lksjdflsdkjfl
228.2.2.1. slkdjfsd
228.2.2.1.0.0.1.
228.2.2.1.1.
228.2.3.
228.3. Horizontal lines
229. Lists
229.1. Verbatim output
229.2. Footnotes
229.3. Escapes
229.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
229.5. Headings
229.6. Links and anchors
229.7. A Heading
229.8. Block quotations
229.9. Line breaks
230. Tables
230.1. Images
230.2. Citations
230.3. Inclusion Images and other predicates
230.4. A level 1 heading
230.4.1. A level 2 heading
230.4.1.1. A level 3 heading
230.5. A level 1 heading
231. YAM Syntax
231.1. Changes from version 3
231.2. Contents
231.3. Bold, italic, underline and teletype
231.4. Horizontal lines
231.5. Lists
231.6. Verbatim output
231.7. Footnotes
231.8. Escapes
231.9. Headings
231.10. Links and anchors
231.11. Block quotations
231.12. Line breaks
231.13. Tables
231.14. Images
231.15. Citations
231.16. Inclusion
232. Miscellaneous previous URL examples
233. lasdfkjlskdfj
233.1. sldfjsdlkfj
233.1.0.0.0.1. klsjdflksdjfl
234. lksdjflksdjflkj
234.1. Bold, italic, underline and teletype #bold
234.2. Links and anchors #links
235. A level 1 heading
235.1. A level 2 heading
235.1.1. A level 3 heading
236. A level 1 heading YAM Syntax
237. Changes from version 3
237.1. Contents
237.2. Bold, italic, underline and teletype
237.2.1. lkjfsldfkjsdf
237.2.2. lksjdflsdkjfl
237.2.2.1. slkdjfsd
237.2.2.1.0.0.1.
237.2.2.1.1.
237.2.3.
237.3. Horizontal lines
238. Lists
238.1. Verbatim output
238.2. Footnotes
238.3. Escapes
238.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
238.5. Headings
238.6. Links and anchors
238.7. A Heading
238.8. Block quotations
238.9. Line breaks
239. Tables
239.1. Images
239.2. Citations
239.3. Inclusion Images and other predicates
239.4. A level 1 heading
239.4.1. A level 2 heading
239.4.1.1. A level 3 heading
239.5. A level 1 heading
240. YAM Syntax
240.1. Changes from version 3
240.2. Contents
240.3. Bold, italic, underline and teletype
240.4. Horizontal lines
240.5. Lists
240.6. Verbatim output
240.7. Footnotes
240.8. Escapes
240.9. Headings
240.10. Links and anchors
240.11. Block quotations
240.12. Line breaks
240.13. Tables
240.14. Images
240.15. Citations
240.16. Inclusion
241. Miscellaneous previous URL examples
242. lasdfkjlskdfj
242.1. sldfjsdlkfj
242.1.0.0.0.1. klsjdflksdjfl
243. lksdjflksdjflkj
243.1. Bold, italic, underline and teletype #bold
243.2. Links and anchors #links
244. A level 1 heading
244.1. A level 2 heading
244.1.1. A level 3 heading
245. A level 1 heading YAM Syntax
246. Changes from version 3
246.1. Contents
246.2. Bold, italic, underline and teletype
246.2.1. lkjfsldfkjsdf
246.2.2. lksjdflsdkjfl
246.2.2.1. slkdjfsd
246.2.2.1.0.0.1.
246.2.2.1.1.
246.2.3.
246.3. Horizontal lines
247. Lists
247.1. Verbatim output
247.2. Footnotes
247.3. Escapes
247.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
247.5. Headings
247.6. Links and anchors
247.7. A Heading
247.8. Block quotations
247.9. Line breaks
248. Tables
248.1. Images
248.2. Citations
248.3. Inclusion Images and other predicates
248.4. A level 1 heading
248.4.1. A level 2 heading
248.4.1.1. A level 3 heading
248.5. A level 1 heading
249. YAM Syntax
249.1. Changes from version 3
249.2. Contents
249.3. Bold, italic, underline and teletype
249.4. Horizontal lines
249.5. Lists
249.6. Verbatim output
249.7. Footnotes
249.8. Escapes
249.9. Headings
249.10. Links and anchors
249.11. Block quotations
249.12. Line breaks
249.13. Tables
249.14. Images
249.15. Citations
249.16. Inclusion
250. Miscellaneous previous URL examples
251. lasdfkjlskdfj
251.1. sldfjsdlkfj
251.1.0.0.0.1. klsjdflksdjfl
252. lksdjflksdjflkj
252.1. Bold, italic, underline and teletype #bold
252.2. Links and anchors #links
253. A level 1 heading
253.1. A level 2 heading
253.1.1. A level 3 heading
254. A level 1 heading YAM Syntax
255. Changes from version 3
255.1. Contents
255.2. Bold, italic, underline and teletype
255.2.1. lkjfsldfkjsdf
255.2.2. lksjdflsdkjfl
255.2.2.1. slkdjfsd
255.2.2.1.0.0.1.
255.2.2.1.1.
255.2.3.
255.3. Horizontal lines
256. Lists
256.1. Verbatim output
256.2. Footnotes
256.3. Escapes
256.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
256.5. Headings
256.6. Links and anchors
256.7. A Heading
256.8. Block quotations
256.9. Line breaks
257. Tables
257.1. Images
257.2. Citations
257.3. Inclusion Images and other predicates
257.4. A level 1 heading
257.4.1. A level 2 heading
257.4.1.1. A level 3 heading
257.5. A level 1 heading
258. YAM Syntax
258.1. Changes from version 3
258.2. Contents
258.3. Bold, italic, underline and teletype
258.4. Horizontal lines
258.5. Lists
258.6. Verbatim output
258.7. Footnotes
258.8. Escapes
258.9. Headings
258.10. Links and anchors
258.11. Block quotations
258.12. Line breaks
258.13. Tables
258.14. Images
258.15. Citations
258.16. Inclusion
259. Miscellaneous previous URL examples
260. lasdfkjlskdfj
260.1. sldfjsdlkfj
260.1.0.0.0.1. klsjdflksdjfl
261. lksdjflksdjflkj
261.1. Bold, italic, underline and teletype #bold
261.2. Links and anchors #links
262. A level 1 heading
262.1. A level 2 heading
262.1.1. A level 3 heading
263. A level 1 heading YAM Syntax
264. Changes from version 3
264.1. Contents
264.2. Bold, italic, underline and teletype
264.2.1. lkjfsldfkjsdf
264.2.2. lksjdflsdkjfl
264.2.2.1. slkdjfsd
264.2.2.1.0.0.1.
264.2.2.1.1.
264.2.3.
264.3. Horizontal lines
265. Lists
265.1. Verbatim output
265.2. Footnotes
265.3. Escapes
265.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
265.5. Headings
265.6. Links and anchors
265.7. A Heading
265.8. Block quotations
265.9. Line breaks
266. Tables
266.1. Images
266.2. Citations
266.3. Inclusion Images and other predicates
266.4. A level 1 heading
266.4.1. A level 2 heading
266.4.1.1. A level 3 heading
266.5. A level 1 heading
267. YAM Syntax
267.1. Changes from version 3
267.2. Contents
267.3. Bold, italic, underline and teletype
267.4. Horizontal lines
267.5. Lists
267.6. Verbatim output
267.7. Footnotes
267.8. Escapes
267.9. Headings
267.10. Links and anchors
267.11. Block quotations
267.12. Line breaks
267.13. Tables
267.14. Images
267.15. Citations
267.16. Inclusion
268. Miscellaneous previous URL examples
269. lasdfkjlskdfj
269.1. sldfjsdlkfj
269.1.0.0.0.1. klsjdflksdjfl
270. lksdjflksdjflkj
270.1. Bold, italic, underline and teletype #bold
270.2. Links and anchors #links
271. A level 1 heading
271.1. A level 2 heading
271.1.1. A level 3 heading
272. A level 1 heading YAM Syntax
273. Changes from version 3
273.1. Contents
273.2. Bold, italic, underline and teletype
273.2.1. lkjfsldfkjsdf
273.2.2. lksjdflsdkjfl
273.2.2.1. slkdjfsd
273.2.2.1.0.0.1.
273.2.2.1.1.
273.2.3.
273.3. Horizontal lines
274. Lists
274.1. Verbatim output
274.2. Footnotes
274.3. Escapes
274.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
274.5. Headings
274.6. Links and anchors
274.7. A Heading
274.8. Block quotations
274.9. Line breaks
275. Tables
275.1. Images
275.2. Citations
275.3. Inclusion Images and other predicates
275.4. A level 1 heading
275.4.1. A level 2 heading
275.4.1.1. A level 3 heading
275.5. A level 1 heading
276. YAM Syntax
276.1. Changes from version 3
276.2. Contents
276.3. Bold, italic, underline and teletype
276.4. Horizontal lines
276.5. Lists
276.6. Verbatim output
276.7. Footnotes
276.8. Escapes
276.9. Headings
276.10. Links and anchors
276.11. Block quotations
276.12. Line breaks
276.13. Tables
276.14. Images
276.15. Citations
276.16. Inclusion
277. Miscellaneous previous URL examples
278. lasdfkjlskdfj
278.1. sldfjsdlkfj
278.1.0.0.0.1. klsjdflksdjfl
279. lksdjflksdjflkj
279.1. Bold, italic, underline and teletype #bold
279.2. Links and anchors #links
280. A level 1 heading
280.1. A level 2 heading
280.1.1. A level 3 heading
281. A level 1 heading YAM Syntax
282. Changes from version 3
282.1. Contents
282.2. Bold, italic, underline and teletype
282.2.1. lkjfsldfkjsdf
282.2.2. lksjdflsdkjfl
282.2.2.1. slkdjfsd
282.2.2.1.0.0.1.
282.2.2.1.1.
282.2.3.
282.3. Horizontal lines
283. Lists
283.1. Verbatim output
283.2. Footnotes
283.3. Escapes
283.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
283.5. Headings
283.6. Links and anchors
283.7. A Heading
283.8. Block quotations
283.9. Line breaks
284. Tables
284.1. Images
284.2. Citations
284.3. Inclusion Images and other predicates
284.4. A level 1 heading
284.4.1. A level 2 heading
284.4.1.1. A level 3 heading
284.5. A level 1 heading
285. YAM Syntax
285.1. Changes from version 3
285.2. Contents
285.3. Bold, italic, underline and teletype
285.4. Horizontal lines
285.5. Lists
285.6. Verbatim output
285.7. Footnotes
285.8. Escapes
285.9. Headings
285.10. Links and anchors
285.11. Block quotations
285.12. Line breaks
285.13. Tables
285.14. Images
285.15. Citations
285.16. Inclusion
286. Miscellaneous previous URL examples
287. lasdfkjlskdfj
287.1. sldfjsdlkfj
287.1.0.0.0.1. klsjdflksdjfl
288. lksdjflksdjflkj
288.1. Bold, italic, underline and teletype #bold
288.2. Links and anchors #links
289. A level 1 heading
289.1. A level 2 heading
289.1.1. A level 3 heading
290. A level 1 heading YAM Syntax
291. Changes from version 3
291.1. Contents
291.2. Bold, italic, underline and teletype
291.2.1. lkjfsldfkjsdf
291.2.2. lksjdflsdkjfl
291.2.2.1. slkdjfsd
291.2.2.1.0.0.1.
291.2.2.1.1.
291.2.3.
291.3. Horizontal lines
292. Lists
292.1. Verbatim output
292.2. Footnotes
292.3. Escapes
292.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
292.5. Headings
292.6. Links and anchors
292.7. A Heading
292.8. Block quotations
292.9. Line breaks
293. Tables
293.1. Images
293.2. Citations
293.3. Inclusion Images and other predicates
293.4. A level 1 heading
293.4.1. A level 2 heading
293.4.1.1. A level 3 heading
293.5. A level 1 heading
294. YAM Syntax
294.1. Changes from version 3
294.2. Contents
294.3. Bold, italic, underline and teletype
294.4. Horizontal lines
294.5. Lists
294.6. Verbatim output
294.7. Footnotes
294.8. Escapes
294.9. Headings
294.10. Links and anchors
294.11. Block quotations
294.12. Line breaks
294.13. Tables
294.14. Images
294.15. Citations
294.16. Inclusion
295. Miscellaneous previous URL examples
296. lasdfkjlskdfj
296.1. sldfjsdlkfj
296.1.0.0.0.1. klsjdflksdjfl
297. lksdjflksdjflkj
297.1. Bold, italic, underline and teletype #bold
297.2. Links and anchors #links
298. A level 1 heading
298.1. A level 2 heading
298.1.1. A level 3 heading
299. A level 1 heading YAM Syntax
300. Changes from version 3
300.1. Contents
300.2. Bold, italic, underline and teletype
300.2.1. lkjfsldfkjsdf
300.2.2. lksjdflsdkjfl
300.2.2.1. slkdjfsd
300.2.2.1.0.0.1.
300.2.2.1.1.
300.2.3.
300.3. Horizontal lines
301. Lists
301.1. Verbatim output
301.2. Footnotes
301.3. Escapes
301.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
301.5. Headings
301.6. Links and anchors
301.7. A Heading
301.8. Block quotations
301.9. Line breaks
302. Tables
302.1. Images
302.2. Citations
302.3. Inclusion Images and other predicates
302.4. A level 1 heading
302.4.1. A level 2 heading
302.4.1.1. A level 3 heading
302.5. A level 1 heading
303. YAM Syntax
303.1. Changes from version 3
303.2. Contents
303.3. Bold, italic, underline and teletype
303.4. Horizontal lines
303.5. Lists
303.6. Verbatim output
303.7. Footnotes
303.8. Escapes
303.9. Headings
303.10. Links and anchors
303.11. Block quotations
303.12. Line breaks
303.13. Tables
303.14. Images
303.15. Citations
303.16. Inclusion
304. Miscellaneous previous URL examples
305. lasdfkjlskdfj
305.1. sldfjsdlkfj
305.1.0.0.0.1. klsjdflksdjfl
306. lksdjflksdjflkj
306.1. Bold, italic, underline and teletype #bold
306.2. Links and anchors #links
307. A level 1 heading
307.1. A level 2 heading
307.1.1. A level 3 heading
308. A level 1 heading YAM Syntax
309. Changes from version 3
309.1. Contents
309.2. Bold, italic, underline and teletype
309.2.1. lkjfsldfkjsdf
309.2.2. lksjdflsdkjfl
309.2.2.1. slkdjfsd
309.2.2.1.0.0.1.
309.2.2.1.1.
309.2.3.
309.3. Horizontal lines
310. Lists
310.1. Verbatim output
310.2. Footnotes
310.3. Escapes
310.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
310.5. Headings
310.6. Links and anchors
310.7. A Heading
310.8. Block quotations
310.9. Line breaks
311. Tables
311.1. Images
311.2. Citations
311.3. Inclusion Images and other predicates
311.4. A level 1 heading
311.4.1. A level 2 heading
311.4.1.1. A level 3 heading
311.5. A level 1 heading
312. YAM Syntax
312.1. Changes from version 3
312.2. Contents
312.3. Bold, italic, underline and teletype
312.4. Horizontal lines
312.5. Lists
312.6. Verbatim output
312.7. Footnotes
312.8. Escapes
312.9. Headings
312.10. Links and anchors
312.11. Block quotations
312.12. Line breaks
312.13. Tables
312.14. Images
312.15. Citations
312.16. Inclusion
313. Miscellaneous previous URL examples
314. lasdfkjlskdfj
314.1. sldfjsdlkfj
314.1.0.0.0.1. klsjdflksdjfl
315. lksdjflksdjflkj
315.1. Bold, italic, underline and teletype #bold
315.2. Links and anchors #links
316. A level 1 heading
316.1. A level 2 heading
316.1.1. A level 3 heading
317. A level 1 heading YAM Syntax
318. Changes from version 3
318.1. Contents
318.2. Bold, italic, underline and teletype
318.2.1. lkjfsldfkjsdf
318.2.2. lksjdflsdkjfl
318.2.2.1. slkdjfsd
318.2.2.1.0.0.1.
318.2.2.1.1.
318.2.3.
318.3. Horizontal lines
319. Lists
319.1. Verbatim output
319.2. Footnotes
319.3. Escapes
319.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
319.5. Headings
319.6. Links and anchors
319.7. A Heading
319.8. Block quotations
319.9. Line breaks
320. Tables
320.1. Images
320.2. Citations
320.3. Inclusion Images and other predicates
320.4. A level 1 heading
320.4.1. A level 2 heading
320.4.1.1. A level 3 heading
320.5. A level 1 heading
321. YAM Syntax
321.1. Changes from version 3
321.2. Contents
321.3. Bold, italic, underline and teletype
321.4. Horizontal lines
321.5. Lists
321.6. Verbatim output
321.7. Footnotes
321.8. Escapes
321.9. Headings
321.10. Links and anchors
321.11. Block quotations
321.12. Line breaks
321.13. Tables
321.14. Images
321.15. Citations
321.16. Inclusion
322. Miscellaneous previous URL examples
323. lasdfkjlskdfj
323.1. sldfjsdlkfj
323.1.0.0.0.1. klsjdflksdjfl
324. lksdjflksdjflkj
324.1. Bold, italic, underline and teletype #bold
324.2. Links and anchors #links
325. A level 1 heading
325.1. A level 2 heading
325.1.1. A level 3 heading
326. A level 1 heading YAM Syntax
327. Changes from version 3
327.1. Contents
327.2. Bold, italic, underline and teletype
327.2.1. lkjfsldfkjsdf
327.2.2. lksjdflsdkjfl
327.2.2.1. slkdjfsd
327.2.2.1.0.0.1.
327.2.2.1.1.
327.2.3.
327.3. Horizontal lines
328. Lists
328.1. Verbatim output
328.2. Footnotes
328.3. Escapes
328.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
328.5. Headings
328.6. Links and anchors
328.7. A Heading
328.8. Block quotations
328.9. Line breaks
329. Tables
329.1. Images
329.2. Citations
329.3. Inclusion Images and other predicates
329.4. A level 1 heading
329.4.1. A level 2 heading
329.4.1.1. A level 3 heading
329.5. A level 1 heading
330. YAM Syntax
330.1. Changes from version 3
330.2. Contents
330.3. Bold, italic, underline and teletype
330.4. Horizontal lines
330.5. Lists
330.6. Verbatim output
330.7. Footnotes
330.8. Escapes
330.9. Headings
330.10. Links and anchors
330.11. Block quotations
330.12. Line breaks
330.13. Tables
330.14. Images
330.15. Citations
330.16. Inclusion
331. Miscellaneous previous URL examples
332. lasdfkjlskdfj
332.1. sldfjsdlkfj
332.1.0.0.0.1. klsjdflksdjfl
333. lksdjflksdjflkj
333.1. Bold, italic, underline and teletype #bold
333.2. Links and anchors #links
334. A level 1 heading
334.1. A level 2 heading
334.1.1. A level 3 heading
335. A level 1 heading YAM Syntax
336. Changes from version 3
336.1. Contents
336.2. Bold, italic, underline and teletype
336.2.1. lkjfsldfkjsdf
336.2.2. lksjdflsdkjfl
336.2.2.1. slkdjfsd
336.2.2.1.0.0.1.
336.2.2.1.1.
336.2.3.
336.3. Horizontal lines
337. Lists
337.1. Verbatim output
337.2. Footnotes
337.3. Escapes
337.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
337.5. Headings
337.6. Links and anchors
337.7. A Heading
337.8. Block quotations
337.9. Line breaks
338. Tables
338.1. Images
338.2. Citations
338.3. Inclusion Images and other predicates
338.4. A level 1 heading
338.4.1. A level 2 heading
338.4.1.1. A level 3 heading
338.5. A level 1 heading
339. YAM Syntax
339.1. Changes from version 3
339.2. Contents
339.3. Bold, italic, underline and teletype
339.4. Horizontal lines
339.5. Lists
339.6. Verbatim output
339.7. Footnotes
339.8. Escapes
339.9. Headings
339.10. Links and anchors
339.11. Block quotations
339.12. Line breaks
339.13. Tables
339.14. Images
339.15. Citations
339.16. Inclusion
340. Miscellaneous previous URL examples
341. lasdfkjlskdfj
341.1. sldfjsdlkfj
341.1.0.0.0.1. klsjdflksdjfl
342. lksdjflksdjflkj
342.1. Bold, italic, underline and teletype #bold
342.2. Links and anchors #links
343. A level 1 heading
343.1. A level 2 heading
343.1.1. A level 3 heading
344. A level 1 heading YAM Syntax
345. Changes from version 3
345.1. Contents
345.2. Bold, italic, underline and teletype
345.2.1. lkjfsldfkjsdf
345.2.2. lksjdflsdkjfl
345.2.2.1. slkdjfsd
345.2.2.1.0.0.1.
345.2.2.1.1.
345.2.3.
345.3. Horizontal lines
346. Lists
346.1. Verbatim output
346.2. Footnotes
346.3. Escapes
346.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
346.5. Headings
346.6. Links and anchors
346.7. A Heading
346.8. Block quotations
346.9. Line breaks
347. Tables
347.1. Images
347.2. Citations
347.3. Inclusion Images and other predicates
347.4. A level 1 heading
347.4.1. A level 2 heading
347.4.1.1. A level 3 heading
347.5. A level 1 heading
348. YAM Syntax
348.1. Changes from version 3
348.2. Contents
348.3. Bold, italic, underline and teletype
348.4. Horizontal lines
348.5. Lists
348.6. Verbatim output
348.7. Footnotes
348.8. Escapes
348.9. Headings
348.10. Links and anchors
348.11. Block quotations
348.12. Line breaks
348.13. Tables
348.14. Images
348.15. Citations
348.16. Inclusion
349. Miscellaneous previous URL examples
350. lasdfkjlskdfj
350.1. sldfjsdlkfj
350.1.0.0.0.1. klsjdflksdjfl
351. lksdjflksdjflkj
351.1. Bold, italic, underline and teletype #bold
351.2. Links and anchors #links
352. A level 1 heading
352.1. A level 2 heading
352.1.1. A level 3 heading
353. A level 1 heading YAM Syntax
354. Changes from version 3
354.1. Contents
354.2. Bold, italic, underline and teletype
354.2.1. lkjfsldfkjsdf
354.2.2. lksjdflsdkjfl
354.2.2.1. slkdjfsd
354.2.2.1.0.0.1.
354.2.2.1.1.
354.2.3.
354.3. Horizontal lines
355. Lists
355.1. Verbatim output
355.2. Footnotes
355.3. Escapes
355.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
355.5. Headings
355.6. Links and anchors
355.7. A Heading
355.8. Block quotations
355.9. Line breaks
356. Tables
356.1. Images
356.2. Citations
356.3. Inclusion Images and other predicates
356.4. A level 1 heading
356.4.1. A level 2 heading
356.4.1.1. A level 3 heading
356.5. A level 1 heading
357. YAM Syntax
357.1. Changes from version 3
357.2. Contents
357.3. Bold, italic, underline and teletype
357.4. Horizontal lines
357.5. Lists
357.6. Verbatim output
357.7. Footnotes
357.8. Escapes
357.9. Headings
357.10. Links and anchors
357.11. Block quotations
357.12. Line breaks
357.13. Tables
357.14. Images
357.15. Citations
357.16. Inclusion
358. Miscellaneous previous URL examples
359. lasdfkjlskdfj
359.1. sldfjsdlkfj
359.1.0.0.0.1. klsjdflksdjfl
360. lksdjflksdjflkj
360.1. Bold, italic, underline and teletype #bold
360.2. Links and anchors #links
361. A level 1 heading
361.1. A level 2 heading
361.1.1. A level 3 heading
362. A level 1 heading YAM Syntax
363. Changes from version 3
363.1. Contents
363.2. Bold, italic, underline and teletype
363.2.1. lkjfsldfkjsdf
363.2.2. lksjdflsdkjfl
363.2.2.1. slkdjfsd
363.2.2.1.0.0.1.
363.2.2.1.1.
363.2.3.
363.3. Horizontal lines
364. Lists
364.1. Verbatim output
364.2. Footnotes
364.3. Escapes
364.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
364.5. Headings
364.6. Links and anchors
364.7. A Heading
364.8. Block quotations
364.9. Line breaks
365. Tables
365.1. Images
365.2. Citations
365.3. Inclusion Images and other predicates
365.4. A level 1 heading
365.4.1. A level 2 heading
365.4.1.1. A level 3 heading
365.5. A level 1 heading
366. YAM Syntax
366.1. Changes from version 3
366.2. Contents
366.3. Bold, italic, underline and teletype
366.4. Horizontal lines
366.5. Lists
366.6. Verbatim output
366.7. Footnotes
366.8. Escapes
366.9. Headings
366.10. Links and anchors
366.11. Block quotations
366.12. Line breaks
366.13. Tables
366.14. Images
366.15. Citations
366.16. Inclusion
367. Miscellaneous previous URL examples
368. lasdfkjlskdfj
368.1. sldfjsdlkfj
368.1.0.0.0.1. klsjdflksdjfl
369. lksdjflksdjflkj
369.1. Bold, italic, underline and teletype #bold
369.2. Links and anchors #links
370. A level 1 heading
370.1. A level 2 heading
370.1.1. A level 3 heading
371. A level 1 heading YAM Syntax
372. Changes from version 3
372.1. Contents
372.2. Bold, italic, underline and teletype
372.2.1. lkjfsldfkjsdf
372.2.2. lksjdflsdkjfl
372.2.2.1. slkdjfsd
372.2.2.1.0.0.1.
372.2.2.1.1.
372.2.3.
372.3. Horizontal lines
373. Lists
373.1. Verbatim output
373.2. Footnotes
373.3. Escapes
373.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
373.5. Headings
373.6. Links and anchors
373.7. A Heading
373.8. Block quotations
373.9. Line breaks
374. Tables
374.1. Images
374.2. Citations
374.3. Inclusion Images and other predicates
374.4. A level 1 heading
374.4.1. A level 2 heading
374.4.1.1. A level 3 heading
374.5. A level 1 heading
375. YAM Syntax
375.1. Changes from version 3
375.2. Contents
375.3. Bold, italic, underline and teletype
375.4. Horizontal lines
375.5. Lists
375.6. Verbatim output
375.7. Footnotes
375.8. Escapes
375.9. Headings
375.10. Links and anchors
375.11. Block quotations
375.12. Line breaks
375.13. Tables
375.14. Images
375.15. Citations
375.16. Inclusion
376. Miscellaneous previous URL examples
377. lasdfkjlskdfj
377.1. sldfjsdlkfj
377.1.0.0.0.1. klsjdflksdjfl
378. lksdjflksdjflkj
378.1. Bold, italic, underline and teletype #bold
378.2. Links and anchors #links
379. A level 1 heading
379.1. A level 2 heading
379.1.1. A level 3 heading
380. A level 1 heading YAM Syntax
381. Changes from version 3
381.1. Contents
381.2. Bold, italic, underline and teletype
381.2.1. lkjfsldfkjsdf
381.2.2. lksjdflsdkjfl
381.2.2.1. slkdjfsd
381.2.2.1.0.0.1.
381.2.2.1.1.
381.2.3.
381.3. Horizontal lines
382. Lists
382.1. Verbatim output
382.2. Footnotes
382.3. Escapes
382.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
382.5. Headings
382.6. Links and anchors
382.7. A Heading
382.8. Block quotations
382.9. Line breaks
383. Tables
383.1. Images
383.2. Citations
383.3. Inclusion Images and other predicates
383.4. A level 1 heading
383.4.1. A level 2 heading
383.4.1.1. A level 3 heading
383.5. A level 1 heading
384. YAM Syntax
384.1. Changes from version 3
384.2. Contents
384.3. Bold, italic, underline and teletype
384.4. Horizontal lines
384.5. Lists
384.6. Verbatim output
384.7. Footnotes
384.8. Escapes
384.9. Headings
384.10. Links and anchors
384.11. Block quotations
384.12. Line breaks
384.13. Tables
384.14. Images
384.15. Citations
384.16. Inclusion
385. Miscellaneous previous URL examples
386. lasdfkjlskdfj
386.1. sldfjsdlkfj
386.1.0.0.0.1. klsjdflksdjfl
387. lksdjflksdjflkj
387.1. Bold, italic, underline and teletype #bold
387.2. Links and anchors #links
388. A level 1 heading
388.1. A level 2 heading
388.1.1. A level 3 heading
389. A level 1 heading YAM Syntax
390. Changes from version 3
390.1. Contents
390.2. Bold, italic, underline and teletype
390.2.1. lkjfsldfkjsdf
390.2.2. lksjdflsdkjfl
390.2.2.1. slkdjfsd
390.2.2.1.0.0.1.
390.2.2.1.1.
390.2.3.
390.3. Horizontal lines
391. Lists
391.1. Verbatim output
391.2. Footnotes
391.3. Escapes
391.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
391.5. Headings
391.6. Links and anchors
391.7. A Heading
391.8. Block quotations
391.9. Line breaks
392. Tables
392.1. Images
392.2. Citations
392.3. Inclusion Images and other predicates
392.4. A level 1 heading
392.4.1. A level 2 heading
392.4.1.1. A level 3 heading
392.5. A level 1 heading
393. YAM Syntax
393.1. Changes from version 3
393.2. Contents
393.3. Bold, italic, underline and teletype
393.4. Horizontal lines
393.5. Lists
393.6. Verbatim output
393.7. Footnotes
393.8. Escapes
393.9. Headings
393.10. Links and anchors
393.11. Block quotations
393.12. Line breaks
393.13. Tables
393.14. Images
393.15. Citations
393.16. Inclusion
394. Miscellaneous previous URL examples
395. lasdfkjlskdfj
395.1. sldfjsdlkfj
395.1.0.0.0.1. klsjdflksdjfl
396. lksdjflksdjflkj
396.1. Bold, italic, underline and teletype #bold
396.2. Links and anchors #links
397. A level 1 heading
397.1. A level 2 heading
397.1.1. A level 3 heading
398. A level 1 heading YAM Syntax
399. Changes from version 3
399.1. Contents
399.2. Bold, italic, underline and teletype
399.2.1. lkjfsldfkjsdf
399.2.2. lksjdflsdkjfl
399.2.2.1. slkdjfsd
399.2.2.1.0.0.1.
399.2.2.1.1.
399.2.3.
399.3. Horizontal lines
400. Lists
400.1. Verbatim output
400.2. Footnotes
400.3. Escapes
400.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
400.5. Headings
400.6. Links and anchors
400.7. A Heading
400.8. Block quotations
400.9. Line breaks
401. Tables
401.1. Images
401.2. Citations
401.3. Inclusion Images and other predicates
401.4. A level 1 heading
401.4.1. A level 2 heading
401.4.1.1. A level 3 heading
401.5. A level 1 heading
402. YAM Syntax
402.1. Changes from version 3
402.2. Contents
402.3. Bold, italic, underline and teletype
402.4. Horizontal lines
402.5. Lists
402.6. Verbatim output
402.7. Footnotes
402.8. Escapes
402.9. Headings
402.10. Links and anchors
402.11. Block quotations
402.12. Line breaks
402.13. Tables
402.14. Images
402.15. Citations
402.16. Inclusion
403. Miscellaneous previous URL examples
404. lasdfkjlskdfj
404.1. sldfjsdlkfj
404.1.0.0.0.1. klsjdflksdjfl
405. lksdjflksdjflkj
405.1. Bold, italic, underline and teletype #bold
405.2. Links and anchors #links
406. A level 1 heading
406.1. A level 2 heading
406.1.1. A level 3 heading
407. A level 1 heading YAM Syntax
408. Changes from version 3
408.1. Contents
408.2. Bold, italic, underline and teletype
408.2.1. lkjfsldfkjsdf
408.2.2. lksjdflsdkjfl
408.2.2.1. slkdjfsd
408.2.2.1.0.0.1.
408.2.2.1.1.
408.2.3.
408.3. Horizontal lines
409. Lists
409.1. Verbatim output
409.2. Footnotes
409.3. Escapes
409.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
409.5. Headings
409.6. Links and anchors
409.7. A Heading
409.8. Block quotations
409.9. Line breaks
410. Tables
410.1. Images
410.2. Citations
410.3. Inclusion Images and other predicates
410.4. A level 1 heading
410.4.1. A level 2 heading
410.4.1.1. A level 3 heading
410.5. A level 1 heading
411. YAM Syntax
411.1. Changes from version 3
411.2. Contents
411.3. Bold, italic, underline and teletype
411.4. Horizontal lines
411.5. Lists
411.6. Verbatim output
411.7. Footnotes
411.8. Escapes
411.9. Headings
411.10. Links and anchors
411.11. Block quotations
411.12. Line breaks
411.13. Tables
411.14. Images
411.15. Citations
411.16. Inclusion
412. Miscellaneous previous URL examples
413. lasdfkjlskdfj
413.1. sldfjsdlkfj
413.1.0.0.0.1. klsjdflksdjfl
414. lksdjflksdjflkj
414.1. Bold, italic, underline and teletype #bold
414.2. Links and anchors #links
415. A level 1 heading
415.1. A level 2 heading
415.1.1. A level 3 heading
416. A level 1 heading YAM Syntax
417. Changes from version 3
417.1. Contents
417.2. Bold, italic, underline and teletype
417.2.1. lkjfsldfkjsdf
417.2.2. lksjdflsdkjfl
417.2.2.1. slkdjfsd
417.2.2.1.0.0.1.
417.2.2.1.1.
417.2.3.
417.3. Horizontal lines
418. Lists
418.1. Verbatim output
418.2. Footnotes
418.3. Escapes
418.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
418.5. Headings
418.6. Links and anchors
418.7. A Heading
418.8. Block quotations
418.9. Line breaks
419. Tables
419.1. Images
419.2. Citations
419.3. Inclusion Images and other predicates
419.4. A level 1 heading
419.4.1. A level 2 heading
419.4.1.1. A level 3 heading
419.5. A level 1 heading
420. YAM Syntax
420.1. Changes from version 3
420.2. Contents
420.3. Bold, italic, underline and teletype
420.4. Horizontal lines
420.5. Lists
420.6. Verbatim output
420.7. Footnotes
420.8. Escapes
420.9. Headings
420.10. Links and anchors
420.11. Block quotations
420.12. Line breaks
420.13. Tables
420.14. Images
420.15. Citations
420.16. Inclusion
421. Miscellaneous previous URL examples
422. lasdfkjlskdfj
422.1. sldfjsdlkfj
422.1.0.0.0.1. klsjdflksdjfl
423. lksdjflksdjflkj
423.1. Bold, italic, underline and teletype #bold
423.2. Links and anchors #links
424. A level 1 heading
424.1. A level 2 heading
424.1.1. A level 3 heading
425. A level 1 heading YAM Syntax
426. Changes from version 3
426.1. Contents
426.2. Bold, italic, underline and teletype
426.2.1. lkjfsldfkjsdf
426.2.2. lksjdflsdkjfl
426.2.2.1. slkdjfsd
426.2.2.1.0.0.1.
426.2.2.1.1.
426.2.3.
426.3. Horizontal lines
427. Lists
427.1. Verbatim output
427.2. Footnotes
427.3. Escapes
427.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
427.5. Headings
427.6. Links and anchors
427.7. A Heading
427.8. Block quotations
427.9. Line breaks
428. Tables
428.1. Images
428.2. Citations
428.3. Inclusion Images and other predicates
428.4. A level 1 heading
428.4.1. A level 2 heading
428.4.1.1. A level 3 heading
428.5. A level 1 heading
429. YAM Syntax
429.1. Changes from version 3
429.2. Contents
429.3. Bold, italic, underline and teletype
429.4. Horizontal lines
429.5. Lists
429.6. Verbatim output
429.7. Footnotes
429.8. Escapes
429.9. Headings
429.10. Links and anchors
429.11. Block quotations
429.12. Line breaks
429.13. Tables
429.14. Images
429.15. Citations
429.16. Inclusion
430. Miscellaneous previous URL examples
431. lasdfkjlskdfj
431.1. sldfjsdlkfj
431.1.0.0.0.1. klsjdflksdjfl
432. lksdjflksdjflkj
432.1. Bold, italic, underline and teletype #bold
432.2. Links and anchors #links
433. A level 1 heading
433.1. A level 2 heading
433.1.1. A level 3 heading
434. A level 1 heading YAM Syntax
435. Changes from version 3
435.1. Contents
435.2. Bold, italic, underline and teletype
435.2.1. lkjfsldfkjsdf
435.2.2. lksjdflsdkjfl
435.2.2.1. slkdjfsd
435.2.2.1.0.0.1.
435.2.2.1.1.
435.2.3.
435.3. Horizontal lines
436. Lists
436.1. Verbatim output
436.2. Footnotes
436.3. Escapes
436.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
436.5. Headings
436.6. Links and anchors
436.7. A Heading
436.8. Block quotations
436.9. Line breaks
437. Tables
437.1. Images
437.2. Citations
437.3. Inclusion Images and other predicates
437.4. A level 1 heading
437.4.1. A level 2 heading
437.4.1.1. A level 3 heading
437.5. A level 1 heading
438. YAM Syntax
438.1. Changes from version 3
438.2. Contents
438.3. Bold, italic, underline and teletype
438.4. Horizontal lines
438.5. Lists
438.6. Verbatim output
438.7. Footnotes
438.8. Escapes
438.9. Headings
438.10. Links and anchors
438.11. Block quotations
438.12. Line breaks
438.13. Tables
438.14. Images
438.15. Citations
438.16. Inclusion
439. Miscellaneous previous URL examples
440. lasdfkjlskdfj
440.1. sldfjsdlkfj
440.1.0.0.0.1. klsjdflksdjfl
441. lksdjflksdjflkj
441.1. Bold, italic, underline and teletype #bold
441.2. Links and anchors #links
442. A level 1 heading
442.1. A level 2 heading
442.1.1. A level 3 heading
443. A level 1 heading YAM Syntax
444. Changes from version 3
444.1. Contents
444.2. Bold, italic, underline and teletype
444.2.1. lkjfsldfkjsdf
444.2.2. lksjdflsdkjfl
444.2.2.1. slkdjfsd
444.2.2.1.0.0.1.
444.2.2.1.1.
444.2.3.
444.3. Horizontal lines
445. Lists
445.1. Verbatim output
445.2. Footnotes
445.3. Escapes
445.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
445.5. Headings
445.6. Links and anchors
445.7. A Heading
445.8. Block quotations
445.9. Line breaks
446. Tables
446.1. Images
446.2. Citations
446.3. Inclusion Images and other predicates
446.4. A level 1 heading
446.4.1. A level 2 heading
446.4.1.1. A level 3 heading
446.5. A level 1 heading
447. YAM Syntax
447.1. Changes from version 3
447.2. Contents
447.3. Bold, italic, underline and teletype
447.4. Horizontal lines
447.5. Lists
447.6. Verbatim output
447.7. Footnotes
447.8. Escapes
447.9. Headings
447.10. Links and anchors
447.11. Block quotations
447.12. Line breaks
447.13. Tables
447.14. Images
447.15. Citations
447.16. Inclusion
448. Miscellaneous previous URL examples
449. lasdfkjlskdfj
449.1. sldfjsdlkfj
449.1.0.0.0.1. klsjdflksdjfl
450. lksdjflksdjflkj
450.1. Bold, italic, underline and teletype #bold
450.2. Links and anchors #links
451. A level 1 heading
451.1. A level 2 heading
451.1.1. A level 3 heading
452. A level 1 heading YAM Syntax
453. Changes from version 3
453.1. Contents
453.2. Bold, italic, underline and teletype
453.2.1. lkjfsldfkjsdf
453.2.2. lksjdflsdkjfl
453.2.2.1. slkdjfsd
453.2.2.1.0.0.1.
453.2.2.1.1.
453.2.3.
453.3. Horizontal lines
454. Lists
454.1. Verbatim output
454.2. Footnotes
454.3. Escapes
454.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
454.5. Headings
454.6. Links and anchors
454.7. A Heading
454.8. Block quotations
454.9. Line breaks
455. Tables
455.1. Images
455.2. Citations
455.3. Inclusion Images and other predicates
455.4. A level 1 heading
455.4.1. A level 2 heading
455.4.1.1. A level 3 heading
455.5. A level 1 heading
456. YAM Syntax
456.1. Changes from version 3
456.2. Contents
456.3. Bold, italic, underline and teletype
456.4. Horizontal lines
456.5. Lists
456.6. Verbatim output
456.7. Footnotes
456.8. Escapes
456.9. Headings
456.10. Links and anchors
456.11. Block quotations
456.12. Line breaks
456.13. Tables
456.14. Images
456.15. Citations
456.16. Inclusion
457. Miscellaneous previous URL examples
458. lasdfkjlskdfj
458.1. sldfjsdlkfj
458.1.0.0.0.1. klsjdflksdjfl
459. lksdjflksdjflkj
459.1. Bold, italic, underline and teletype #bold
459.2. Links and anchors #links
460. A level 1 heading
460.1. A level 2 heading
460.1.1. A level 3 heading
461. A level 1 heading YAM Syntax
462. Changes from version 3
462.1. Contents
462.2. Bold, italic, underline and teletype
462.2.1. lkjfsldfkjsdf
462.2.2. lksjdflsdkjfl
462.2.2.1. slkdjfsd
462.2.2.1.0.0.1.
462.2.2.1.1.
462.2.3.
462.3. Horizontal lines
463. Lists
463.1. Verbatim output
463.2. Footnotes
463.3. Escapes
463.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
463.5. Headings
463.6. Links and anchors
463.7. A Heading
463.8. Block quotations
463.9. Line breaks
464. Tables
464.1. Images
464.2. Citations
464.3. Inclusion Images and other predicates
464.4. A level 1 heading
464.4.1. A level 2 heading
464.4.1.1. A level 3 heading
464.5. A level 1 heading
465. YAM Syntax
465.1. Changes from version 3
465.2. Contents
465.3. Bold, italic, underline and teletype
465.4. Horizontal lines
465.5. Lists
465.6. Verbatim output
465.7. Footnotes
465.8. Escapes
465.9. Headings
465.10. Links and anchors
465.11. Block quotations
465.12. Line breaks
465.13. Tables
465.14. Images
465.15. Citations
465.16. Inclusion
466. Miscellaneous previous URL examples
467. lasdfkjlskdfj
467.1. sldfjsdlkfj
467.1.0.0.0.1. klsjdflksdjfl
468. lksdjflksdjflkj
468.1. Bold, italic, underline and teletype #bold
468.2. Links and anchors #links
469. A level 1 heading
469.1. A level 2 heading
469.1.1. A level 3 heading
470. A level 1 heading YAM Syntax
471. Changes from version 3
471.1. Contents
471.2. Bold, italic, underline and teletype
471.2.1. lkjfsldfkjsdf
471.2.2. lksjdflsdkjfl
471.2.2.1. slkdjfsd
471.2.2.1.0.0.1.
471.2.2.1.1.
471.2.3.
471.3. Horizontal lines
472. Lists
472.1. Verbatim output
472.2. Footnotes
472.3. Escapes
472.4. Headings Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is
472.5. Headings
472.6. Links and anchors
472.7. A Heading
472.8. Block quotations
472.9. Line breaks
473. Tables
473.1. Images
473.2. Citations
473.3. Inclusion Images and other predicates
473.4. A level 1 heading
473.4.1. A level 2 heading
473.4.1.1. A level 3 heading
473.5. A level 1 heading
474. YAM Syntax
474.1. Changes from version 3
474.2. Contents
474.3. Bold, italic, underline and teletype
474.4. Horizontal lines
474.5. Lists
474.6. Verbatim output
474.7. Footnotes
474.8. Escapes
474.9. Headings
474.10. Links and anchors
474.11. Block quotations
474.12. Line breaks
474.13. Tables
474.14. Images
474.15. Citations
474.16. Inclusion

474. YAM Syntax

474.1. Changes from version 3

horizontal lines are now three or more dashes
comment syntax: %% for single lines, and /* */ for multiple lines (should replace notes?)
addition of column separator bars at the start and end of table rows
multiple lines allowed in titles
added underlining
no more %output function
changed quotation syntax to %"
changed of line break style to %\
output is correct XHTML
verbatim output is %< ... %>
target language control characters (like < or &) now dealt with properly
headings can be unnumbered, e.g. "%2*"

Slides: maybe:

if the document contains %slides then treat it all as slides
else if it contains %slide...%endslide then treat each of those as slides

474.2. Contents

Contents listings like that above are generated by '%contents'

474.3. Bold, italic, underline and teletype

Bold text is contained in stars: *this is bold* becomes this is bold.

Italic text is contained in underscores: _this is italic_ becomes this is italic.

Fixed-width text is contained in equals signs: =this is teletype= becomes this is teletype.

Underlined text is contained in doubles undercores: __this is underlined__ becomes this is underlined.

474.4. Horizontal lines

Horizontal lines are indicated by 3 or more - signs at the start of a line. For example:

---

and

---------------------------

both result in:

474.5. Lists

Unordered lists are indicated by '-' at the start of a line, and ordered lists by 'o'. Nesting is indicated by increased spacing preceding the item indicator. For example:

- This is an undordered list
- Second item
  # This is a nested...
  # ...ordered list
- Back to the third item of the enclosing list

results in:

This is an undordered list
Second item
1. This is a nested...
2. ...ordered list
Back to the third item of the enclosing list

474.6. Verbatim output

Verbatim output starts with '%<' and ends with '%>'. For example:

%< This will *not* get translated. %>

When the target language is HTML, for example, the output will contain '<pre>' tags.

474.7. Footnotes

Footnotes are like this:

%footnote(This is a footnote.)

Becomes:²⁰⁹.

The contents will be put in a section at the end of the document (HTML) or at the bottom of the page (LaTeX), and linked by number from where they occured.

474.8. Escapes

To stop a special character from being interpreted, use a '\'. For example,

 \---

will not generate a line.

474.9. Headings

Headings are lines starting with %1 (for first level), %2, %3 or %4. For example, the heading for this section is

%2 Headings

If a heading level is followed by "*" it is not numbered, e.g.:

%2* An unnumbered heading

Becomes:

An unnumbered heading

This heading will not appear in the contents table.

474.10. Links and anchors

Links can be specified in three ways:

As plain text, e.g. 'http://gate.ac.uk/' will become http://gate.ac.uk/
Using '%(target)', e.g. %(http://gate.ac.uk/) will become http://gate.ac.uk/
Using '%(target, label)', e.g. %(http://gate.ac.uk/, GATE home) will become GATE home

Spaces or commas inside URLs must be escaped. A URL that appears in plain text must be followed by a space, tab or newline.

Anchors and labels are specified using '%#name'. For example,

%2 A Heading %#label

will result in a heading followed by the anchor label.

Spaces or commas inside anchors must be escaped. An anchor that appears in plain text must be followed by a space, tab or newline.

474.11. Block quotations

Block quotations are enclosed in %" marks. For example,

  %"This is a quote%"

becomes:

This is a quote

474.12. Line breaks

Line breaks are indicated by %\ at the end of a line. For example:

This line is broken %\
in two.

becomes: % This line is broken % in two.

474.13. Tables

Tables use square brackets, bars and dashes. For example:

%[
 | *header col 1*	| *header col 2*        |
 ---
 | row 1 col 1	        | col 2                 |              
 ---
 | row 2 col 1	        | col 2                 |
%]

results in:

header col 1	header col 2
row 1 col 1	col 2
row 2 col 1	col 2

474.14. Images

Images are like URLs:

'%image(test-image.png)' will become
'%image(test-image.png, a test image)' will become (the text becomes the "alt" attribute of the image)

You can also specify an ALT tag, width and height, position and border width: '%image(test-image.png, ALT tag, 500, 500, left, 0)' becomes ALT tag

474.15. Citations

Citations work like this: '%cite(Cun06a)' becomes Cun06a. Multiple cite keys should be separated by commas, e.g.: '%cite(Cun05a,Cun06a)' becomes Cun05a, Cun06a.

474.16. Inclusion

A page can include another page like this:

%include(yam-first.yam)

Becomes:

This, by way of contrast, is a paragraph.

This is another paragraph. It contains two lines.

YAM Predicates

%unknown(1 2 3 ) %unknown(1 2 3 )

²¹⁰

Cun94a Yam Scratch

x x

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!

Some Tables

11	12	13
21	22	23
31	32	33

41		43

n11

n12

21b

1	2
3	4	5	6	7	8
9	10	11	12

x x

Book

Introduction

Conclusion

Author	Title
Marx and Engels	The Communist Manifesto

Two things result from this fact:

I. Communism is already acknowledged by all European powers to be itself a power.

To this end, Communists of various nationalities have assembled in London and sketched the following manifesto, to be published in the English, French, German, Italian, Flemish and Danish languages.

In short, the Communists everywhere support every revolutionary movement against the existing social and political order of things.

In all these movements, they bring to the front, as the leading question in each, the property question, no matter what its degree of development at the time.

Finally, they labour everywhere for the union and agreement of the democratic parties of all countries.

WORKING MEN OF ALL COUNTRIES, UNITE!