[pmwiki-users] PmWiki 'Basic Editing' Documentation suggestion

Nelson Ingersoll nelson.ingersoll at email.com
Mon Jul 23 13:07:42 CDT 2007


Patrick R. Michaud wrote:
> On Mon, Jul 23, 2007 at 11:37:07AM -0600, Nelson Ingersoll wrote:
<snipped>
> I think the more important message is that authors should use
> '\\' and '\\\' very sparingly -- i.e., only when the author needs
> to insert a blank line in the middle of a paragraph or heading.
> 
> Otherwise, the proper way to generate vertical whitespace in
> PmWiki is to use blank lines.
> 
> I notice a lot of authors using \\ to generate blank lines even
> in normal text, and I'm not sure what leads people to believe that
> necessary.
> 
> Borrowing from your example:
> 
>> -----
>> Markup that looks good to a novice; '''AND IS!'''
>> -----
>>
>>>> center<<
>> [+++Centered Three+++]
>>>> <<
>> \\
>>
>> !!Heading Three\\
>>
>> [[Path:pub/doc3.pdf | Document3]]\\\
> 
> None of the \\'s are necessary here -- omit them and you get the
> correct results.
> 
>> ----
>>
>>>> center<<
>> [+++Centered Four+++]
>>>> <<
>> !!Heading Four\\
>>
>> [[Path:pub/doc4.pdf | Document4]]\\
> 
> Same here -- the \\'s can (and should) be omitted.
> 
> Pm
> 

Fair enough... Let's recommend emphasizing novices NOT use the \\ and \\\;
and, still suggest blank lines.

- Nelson




More information about the pmwiki-users mailing list