[pmwiki-users] Some basic formatting question

[Marc Cooper]

=?UTF-8?Q?Jan_Erik_Mostr=C3=B6?= =?UTF-8?Q?m?= said...
> I just want to make sure that I've understood things correctly:
> 
> +   If I want some text marked as "code" in the middle of some text
>     then I should use @@, for example: this is some text with a piece
>     of @@code@@ in it. Correct?

Nope. @@...@@ is the monospaced font markup - similar to bold or italic 
markups. So, for example, @@ (:title fred:) @@ will be unescaped and 
thus produce no text, but change the title of the page.

For code, you usually want [@...@], which uses a monospaced font by 
default, and escaped the code.

> +   If I have several lines of code then I should use [= =], correct?

[=...=] produces escaped text - a regular font, instead of monospaced.

Try something like

''[= hello (:title fred:) =]''

@@(:title fred:) barney @@

 @@(:title fred:) barney @@

[@ hello @]

to get an idea of the different things going on.

> What I don't understand is how I can make a numbered list where I want to have
> some code without the numbering of the text is
> restarted. For example, if I have 
> 
> # aaaa
> 
> # bbbb
> 
> # dddd
> 
> [= some code =]
> 
> # eeeee
> 
> Then I get
> 
> 1. aaaa
> 2. bbbb
> 3. dddd
> some code
> 1. eeee
> 
> but I would like to have
> 
> 1. aaaa
> 
> 2. bbbb
> 
> 3. dddd
> 
>    some code
>    
> 4. eeee

# aaaa
# bbbb
# dddd\\
[= some code =]
# eeeee

Voila.

Also, compare with:

# aaaa
# bbbb
# dddd
  [@
some code @]
# eeeee

The alignment is important.

-- 
Best,
Marc