Puppet users - Apr 2010 - Wiki: Syntax woes? Page preview on non-edited page -> big mess :)

Greetings,

I am new to the Redmine Wiki which powers the Puppet Wiki. I wanted to
fix a link in the Downloading Puppet -> Solaris section [1], but when I
try to edit the page, the shown page source / markup doesn''t match with
what is listed as valid markup in the editing help [2]. Headings use
only ''#''s, lists use dashes instead of stars, etc.

Furthermore, hitting preview (without any changes from my side) shows a
page that looks quite different from the current page. Content is the
same, just the layout is messed up. For instance, indented item lists
end up as strike-throughs and headings as numbered items (all starting
with 1.). Is this a known issue?

I checked the Wiki''s main page and the mailing list archives, but only
found some threads regarding last year''s Wiki move, nothing in
particular pointing to such a problem.

Sebastian

[1]http://projects.puppetlabs.com/projects/puppet/wiki/Downloading_Puppet
[2]http://projects.puppetlabs.com/plugin_assets/redmine_markdown_extra_formatter/help/markdown_extra_syntax.html

-- 
You received this message because you are subscribed to the Google Groups
"Puppet Users" group.
To post to this group, send email to puppet-users@googlegroups.com.
To unsubscribe from this group, send email to
puppet-users+unsubscribe@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/puppet-users?hl=en.

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 27/04/10 7:42 AM, Sebastian Kayser wrote:
> Greetings,
> 
> I am new to the Redmine Wiki which powers the Puppet Wiki. I wanted to
> fix a link in the Downloading Puppet -> Solaris section [1], but when I
> try to edit the page, the shown page source / markup doesn''t match
with
> what is listed as valid markup in the editing help [2]. Headings use
> only ''#''s, lists use dashes instead of stars, etc.
> 
> Furthermore, hitting preview (without any changes from my side) shows a
> page that looks quite different from the current page. Content is the
> same, just the layout is messed up. For instance, indented item lists
> end up as strike-throughs and headings as numbered items (all starting
> with 1.). Is this a known issue?
> 
> I checked the Wiki''s main page and the mailing list archives, but
only
> found some threads regarding last year''s Wiki move, nothing in
> particular pointing to such a problem.
> 
It is a known problem.  We''ve used Markdown to power the Wiki and
some of the integration of Markdown into Redmine isn''t perfect.
I''m
working to fix it the issues in the next little while.

Ignore the preview for example - it''s broken and tries to convert
Markdown into something else and on my TODO list.

In terms of Markdown format - ### and dashes and stars are all
acceptable header and list formats.  So different people will use
different ways of doing H1, H2, H3 etc.  Have a look at:

http://daringfireball.net/projects/markdown/

for a more complete syntax.

Cheers

James

- -- 
Author of:
* Pro Linux System Administration (http://tinyurl.com/linuxadmin)
* Pulling Strings with Puppet (http://tinyurl.com/pupbook)
* Pro Nagios 2.0 (http://tinyurl.com/pronagios)
* Hardening Linux (http://tinyurl.com/hardeninglinux)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEVAwUBS9YheSFa/lDkFHAyAQISMwf/VdDjsBhtm7BY9nvA6EqJec/gtGsbPdIb
qTC/pW3JamXCFbnGZJYZhmviDAoVzrgAByC11TP+hNIGTkXJvNBTEr8eVtSs0ARY
+doc7amxplXLplEyO/imZw4+9Qae3IATVax9simViNMHVJWT7KLH38QZJvexOuOR
pHmTtMLUPEKy0oMKGw9FwXWmEjUE3+6Mw5GgBq1I1Ip1/rgrfLOfQrWHQGA5cCpI
BrBNY0zs6EB9WEVVL4MIcFQbyLS/YYz1niE4kcfDPgoXO952+rEcDix4lR8m1E3f
CsFQF0XG4hPfqLPrWlfrmlk2pXQxzMjoukaxfVlRWK+nzO5Cbkes5A==wupf
-----END PGP SIGNATURE-----

-- 
You received this message because you are subscribed to the Google Groups
"Puppet Users" group.
To post to this group, send email to puppet-users@googlegroups.com.
To unsubscribe from this group, send email to
puppet-users+unsubscribe@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/puppet-users?hl=en.

James Turnbull wrote on 27.04.2010 01:27:
> On 27/04/10 7:42 AM, Sebastian Kayser wrote:
>> I am new to the Redmine Wiki which powers the Puppet Wiki. I wanted to
>> fix a link in the Downloading Puppet -> Solaris section [1], but
when I
>> try to edit the page, the shown page source / markup doesn''t
match with
>> what is listed as valid markup in the editing help [2]. Headings use
>> only ''#''s, lists use dashes instead of stars, etc.
> 
>> Furthermore, hitting preview (without any changes from my side) shows a
>> page that looks quite different from the current page.
> 
> It is a known problem.  We''ve used Markdown to power the Wiki and
> some of the integration of Markdown into Redmine isn''t perfect.
I''m
> working to fix it the issues in the next little while.
> 
> Ignore the preview for example - it''s broken and tries to convert
> Markdown into something else and on my TODO list.
Thanks for the info, James. Worked flawlessly. Is there any macro to
create a table of contents (and thereby some structure) for longish
pages like the following?

  http://projects.puppetlabs.com/projects/puppet/wiki/Puppet_Solaris

Sebastian

-- 
You received this message because you are subscribed to the Google Groups
"Puppet Users" group.
To post to this group, send email to puppet-users@googlegroups.com.
To unsubscribe from this group, send email to
puppet-users+unsubscribe@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/puppet-users?hl=en.

On 28/04/2010 9:02 AM, Sebastian Kayser wrote:
> Thanks for the info, James. Worked flawlessly. Is there any macro to
> create a table of contents (and thereby some structure) for longish
> pages like the following?
>
>    http://projects.puppetlabs.com/projects/puppet/wiki/Puppet_Solaris
>
> Sebastian
>
That''s also on the TODO list - we''re going to rewrite the
Markdown
plug-in and enable proper macro support and fix the help pop-up and the 
preview function.  Currently the {toc} macro in Redmine in core is weird 
and needs to be abstracted into a separate function.

Regards

James Turnbull

-- 
Author of:
* Pro Linux System Administration (http://tinyurl.com/linuxadmin)
* Pulling Strings with Puppet (http://tinyurl.com/pupbook)
* Pro Nagios 2.0 (http://tinyurl.com/pronagios)
* Hardening Linux (http://tinyurl.com/hardeninglinux)

-- 
You received this message because you are subscribed to the Google Groups
"Puppet Users" group.
To post to this group, send email to puppet-users@googlegroups.com.
To unsubscribe from this group, send email to
puppet-users+unsubscribe@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/puppet-users?hl=en.