%% Just ANother Example %%

 1. Fonts and environments
   1.1. Using font beautifiers
   1.2. Environments
 2. Converting lists
   2.1. Ordered and non-ordered lists
   2.2. Description lists
   2.3. Nested lists
 3. Converting tables
 4. Browsing your document
   4.1. The table of content
   4.2. The list of links
 5. Contact






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. 

							 = Fonts and environments =

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

								  == 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:


This minipage (12cm) is centered without border.
This minipage (12cm) is centered without border.
This minipage (12cm) is centered without border.



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.



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:

											---

Another horizontal rule, put on the right:

                                                                   ---

								 = Converting lists =

					  == Ordered and non-ordered lists ==

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

	* Like this;
	* or like that.

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

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

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

							 = Browsing your document =

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

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

									  = Contact =

Please feel free to submit bugs or ideas:
bastien1@free.fr (BHL contact).