5
sandbox
2007-09-16 18:49:00
2008-09-07 22:30:00
pyguicms helpsystem 
sandbox le bac a sable
The sandbox, the place where you can experiment with the syntax


///Table of Contents Goes Here///

# Introduction

The `SandBox` is a little place where you can learn about the `python-markdown`
syntax. It's the ideal page to inspect the code of. Not the stuff that was
rendered in the web browser. Cause likely the plain syntax is processed and
converted to some HTML syntax. There may some stuff that we could not show you
here in some `<pre>` tags, cause it may break some things. So we insist on it,
please look to the syntax of this page cause it likely use all the different
syntaxes that there may be available.

It is strongly encouraged to inspect the plain text of this page. So that you
may be familiar with the different syntax to use. This page is especially made
for this goal! If you been learn the syntax to use, it will be easy and faster
for you to write some pages. Look to the code, try and see the results. Anyway,
best that you keep this page and that you not delete it or destroy to much.
Keep your experiments on the bottom of this page. This is your sand box, not
your crap box ;-)

# Paragraph

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Curabitur vel ipsum
ut dui accumsan auctor. Aliquam molestie nunc ac ligula. Nunc pharetra augue at
pede. Pellentesque ante. Donec vitae justo vel magna viverra posuere. Proin
bibendum eros vel nunc. Cras at pede. Nunc nonummy malesuada tellus.
Pellentesque habitant morbi tristique.

Code:

    Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Curabitur vel
    ipsum ut dui accumsan auctor. Aliquam molestie nunc ac ligula. Nunc
    pharetra augue at pede. Pellentesque ante. Donec vitae justo vel magna
    viverra posuere. Proin bibendum eros vel nunc. Cras at pede. Nunc nonummy
    malesuada tellus.  Pellentesque habitant morbi tristique.

# Text formating: bold, italic

To write _italic_ text:

    _italic_

or

    *italic*

To write **bold** text:

    **bold**

or

    __bold__

# Block quotes

Please, look to the content of this page, it may be impossible to add this
stuff in a `<pre>` tag.

> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean tincidunt
> dictum orci. Integer arcu libero, accumsan at, sodales malesuada, dictum
> congue, magna. Suspendisse placerat congue nibh. Integer ut leo quis augue
> vulputate laoreet. Nam sit amet mi. Pellentesque sed ligula quis urna
> suscipit egestas. Morbi dignissim mauris vitae ante. Donec id nunc. Nam non
> dolor. Quisque varius, nibh et porttitor sollicitudin, ligula lectus
> scelerisque nunc, sit amet congue metus eros vitae odio. Nulla facilisi.
> Praesent dapibus neque id nunc.

To make the block quote a deeper level:

>> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean tincidunt
>> dictum orci. Integer arcu libero, accumsan at, sodales malesuada, dictum
>> congue, magna. Suspendisse placerat congue nibh. Integer ut leo quis augue
>> vulputate laoreet. Nam sit amet mi. Pellentesque sed ligula quis urna
>> suscipit egestas. Morbi dignissim mauris vitae ante. Donec id nunc. Nam non
>> dolor. Quisque varius, nibh et porttitor sollicitudin, ligula lectus
>> scelerisque nunc, sit amet congue metus eros vitae odio. Nulla facilisi.
>> Praesent dapibus neque id nunc.

A third level of block quote

>>> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean tincidunt
>>> dictum orci. Integer arcu libero, accumsan at, sodales malesuada, dictum
>>> congue, magna. Suspendisse placerat congue nibh. Integer ut leo quis augue
>>> vulputate laoreet. Nam sit amet mi. Pellentesque sed ligula quis urna
>>> suscipit egestas. Morbi dignissim mauris vitae ante. Donec id nunc. Nam non
>>> dolor. Quisque varius, nibh et porttitor sollicitudin, ligula lectus
>>> scelerisque nunc, sit amet congue metus eros vitae odio. Nulla facilisi.
>>> Praesent dapibus neque id nunc.

# Headers

Headers are useful to make some little sub categories. Pay attention that the
`///Table of Contents Goes Here///` make use of the headers to build a table of
content.

# Header 1

    # Header 1
    // Optionally on the right side
    # Header 1 #

## Header 2

    ## Header 2





### Header 3

    ### Header 3

#### Header 4

    #### Header 4

##### Header 5

    ##### Header 5

# Other syntax for headers


We can use the = chars to make a h1:

    Other way of a header
    =================

Produce:

Other way of a header
=================

We can use the - chars to make a h2:

    Other way of a header
    ----------------------

Produce:

Other way of a header
----------------------

# Table of contents

The table of content can be add on top of each page with the following:

    ///Table of Contents Goes Here///

If the table of content isn't specified, one will be created on the bottom of
the page.

# Code block

In the sandbox there is many `crap` leaved by sad owners of dogs.

    In the sandbox there is many `crap` leaved by sad owners of dogs.

# pre tag

Require 4 spaces at the beginning.

    aptitude install foo

# bulled lists and ordered lists

Pay attention the to first space before the bulled list character. It is
important to have this space before the special character.

With the * sign:

     * foo
     * bar

Produce:

 * foo
 * bar

With the + sign:

     + foo
     + bar

Produce:

 + foo
 + bar

With the - sign:

     - foo
     - bar

Produce:

 - foo
 - bar

Numbered lists:

     1. foo
     1. bar

Produce:

 1. foo
 1. bar

# Links

To make links, it's easy with the following syntax

    [link_name](http://www.some_url.org)

    [Introduction](introduction)

That make as link:

[link_name](http://www.some_url.org)

[Introduction](introduction)

A link with a title. You see the title in the :

    [link_name](http://www.some_url.org "Some title")

That output:

[link_name](http://www.some_url.org "Some title")

If you need to repeat multiples time a link. You can make it once and then
reference to it:

A [link](http://example.net/).

Another [link][id]. Then, later on, define the link:

  [id]: http://example.com/

[Introduction](introduction)

You can even make automatic links like this one <http://www.google.com>.

# Images

*You should take a look to the source of this page because the code block don't
all the expected stuff!*

You can put image somewhere with:

    ![a banner](../../files/imgs/19)

This shows:

![a banner](../../files/imgs/19)

We can even align some image:

    ![{@align=right}](../../files/imgs/19)

![{@align=right}](../../files/imgs/19)

Aligning an image to `left` or `right` has the advantage to add an image on the
beginning of a paragraph. But the next coming paragraph is on the same level of
this image:

    ![{@align=left}](../../files/imgs/19) Lorem ipsum dolor sit amet, 
    consectetuer adipiscing elit. Donec dignissim hendrerit lacus. 
    Phasellus dignissim consequat risus. Aliquam erat volutpat. Mauris
    feugiat justo eget metus. Phasellus tempus mollis lorem.

![{@align=left}](../../files/imgs/19) Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Donec dignissim hendrerit lacus. Phasellus dignissim consequat
risus. Aliquam erat volutpat. Mauris feugiat justo eget metus. Phasellus tempus
mollis lorem. Aenean augue metus, condimentum mattis, dapibus aliquet,
convallis vel, nisi. Aliquam imperdiet ornare enim. Mauris odio. Phasellus
libero. Ut commodo urna in nisi. Quisque a eros vitae magna tempor mollis. Sed
purus risus, laoreet vel, dictum quis, rutrum non, enim.  Aenean placerat.
Phasellus non pede id metus auctor vulputate.

*Note that we are not able to center an image!*

# Simple tables

    | a |* b *|
    | [c](#) | *d* |

| a |* b *|
| [c](#) | *d* |

# Rules

You can easy add a rule where you want. These take the style of the style
sheet.

With asterisks:

    * * * *

Produce:

* * * *

or another way with asterisks:

    ****

Produce:

****

With minus signs:

    -------

Produce:

-------

With underscore signs:

    _____

Produce:

_____

# Escaping some special character

Some time you want to display some characters, or use a way, that markdown
would like to translate it and finally mess up your expected behavior. Some
time you need to escape some character that have some special meaning in the
markdown syntax.

Some \*literal asteriks\*

Some \`literal backticks\`

Some \\literal backslach\\

Code:

    Some \*literal asteriks\*
    Some \`literal backticks\`
    Some \\literal backslach\\

The special characters are:

    \   backslash
    `   backtick
    *   asterisk
    _   underscore
    {}  curly braces
    []  square brackets
    ()  parentheses
    #   hash mark
    +   plus sign
    -   minus sign (hyphen)
    .   dot
    !   exclamation mark

# Codehilight

This is some experimental implementation of the code hilight. It is not yet
completely implemented and need to be tested before we going to adopt this
highlighting system. See [here] (http://achinghead.com/markdown/codehilite/)
for more informations.

With path:

    #!/usr/bin/python
    # Code goes here ...
    print "Hello, world!"

Without path:

    #!python
    # Code goes here ...
    print "Hello, world!"

With colons:

    :::python
    # Code goes here ...
    print "Hello, world!"

Some C code:

    #!c
    #include <stdio.h>
    
    /****************************************************************** 
    * This is some basic app.
    ******************************************************************/

    /*
     * This is some C comment
     */
    int main()
    {
        printf("Value is %d", 123);
        return(0);
    }

# Resources

 * [Markdown on wikipedia](http://en.wikipedia.org/wiki/Markdown)
 * [http://daringfireball.net/projects/markdown/syntax]
 (http://daringfireball.net/projects/markdown/syntax)
 * [http://markdown.infogami.com/] (http://markdown.infogami.com/)
 * [http://markdown.infogami.com/Extending_PythonMarkdown]
 (http://markdown.infogami.com/Extending_PythonMarkdown)
 * [http://www.freewisdom.org/projects/python-markdown/]
 (http://www.freewisdom.org/projects/python-markdown/)
 * [Additional attributs]
 (http://six.pairlist.net/pipermail/markdown-discuss/2005-August/001486.html)

# Add here below your own experimental stuff

Foo say "bla bla bla" to bar.