Just ANother Example

--- Table of contents

 1. Fonts and environments
 2. Converting lists
 3. Converting tables
 4. The table of contents

--- End of the table of contents

# This is the last example of a BHL file converted into HTML, LaTeX
# and SGML formats. This example shows you the various syntaxic rules
# that BHL handles. For further details, please refer to the manual of
# the BHL mode. http://www.nongnu.org/bhl

# These lines are comments.
# You can comment a region with `bhl-comment-region'

# The few next lines are specification lines. They
# indicate the properties of the different conversions.

#!author!Bastien Guerry
#!date!It is %Hh%M on %d/%m/%Y.
#!sectioning!num

#!html!toc:nocaption:noprefix:noi18n
#!sgml!caption
#!latex!notoc:caption:prefix:i18n
#!latex-options!11pt:a4paper

This document is a small example of what BHL can do. For further
details, please read the full documentation on
http://www.nongnu.org/bhl. 

1. Fonts and environments

1.1. Using font beautifiers

Here is a list of the *different* fonts beautifiers that you can
use inside the BHL mode.

	Bold -- *one or two words.*
	Emphasis -- _one or two words._
	Truetype -- ==one or two words.==
	Underline -- __one or two words.__
	Bold italic --  _*one or two words*_.

If want to insert an asterisk, you can use the escape character like
\*this\* or like \_this\_. This is also available for \#comments.

1.2. Environments

BHL handles two specific environments: verbatim and minipage.

Verbatim:

--
Here is a *part* of text that			will be displayed
in 	verbatim								#a comment

Please remark that this environment has no syntactic rule, except you
modify the variable bhl-verbatim-ignore.

	* list are ignored

And so does...

	Item -- descriptions.

And so does tables!

| A | B |
| C | D |

Etc.
--


A minipage:

%%%[12cm]
This minipage (12cm) is centered without border.
This minipage (12cm) is centered without border.
This minipage (12cm) is centered without border.
%%%

<%%[10cm]
This minipage (10cm) is put on the left without border.
This minipage (10cm) is put on the left without border.
This minipage (10cm) is put on the left without border.
%%%

>-%[8cm]
This minipage (8cm) is put on the right with border.
This minipage (8cm) is put on the right with border.
This minipage (8cm) is put on the right with border.
%%%

A horizontal rule:

----[3cm]

Another horizontal rule, put on the right:

>---[3cm]

2. Converting lists

2.1. Ordered and non-ordered lists

*Ordered* lists begin with three *whitespaces*, a list separator (*, - or o)
and another whitespace.

	* Like this;
	* or like that.

2.2. Description lists

Description lists are treated like other lists, except that they
cannot be nested in other lists.

A description item consists in tabs, a term to be defined, a
whitespace, two dashes and another whitespace.

	Term -- a definition of the terme. 
	Definition -- another definition. 

2.3. Nested lists

	* Lists can be nested inside other lists. 

		* You just need to add three whitespaces more. 
		* These to items will be nested into two other items. sldkfj
		  lskdjf lmmlkm

			1. Three levels of nested lists are supported. 
			2. Four levels won't be very useful...

	* Blank lines are not mandatory between items.

3. Converting tables

Here is a table:

| @dHL et lqskdj@						|  @qsdqsdOolsqdf@ 		|
| Free softxware	 					| 	bastien1@free.fr	  	|
| With Emacs							|  Without Emacs			|
|  bastien 								|  Without Emacs			|

A table line begins and ends with a "|".  Other "|" inside a line of
the table separate two cells.  Arobases around the content of a cell
mean that this cell is a header of the table.

4. Browsing your document

4.1. The table of content

You can _browse_ the table of content, _insert_ it inside your
document, and _update_ the numbering of sections.

The default key binding for browsing the table of content is C-c
C-t.

You can also choose the style of sectioning and swith from one style
to another. The style of this document is set to *num* (which is the
default style) by the specification line above.

4.2. The list of links

The default key binding for browsing the list of links is C-c
C-/. This creates a new buffer with a list of URLs or wikinames that
you can follow.

5. Contact

Please feel free to submit bugs or ideas:
[[mailto:bastien1@free.fr][BHL contact]].