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

Patrick R. Michaud pmichaud at pobox.com
Mon Jul 23 13:20:07 CDT 2007


On Mon, Jul 23, 2007 at 12:07:42PM -0600, Nelson Ingersoll wrote:
> 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.
> 
> Fair enough... Let's recommend emphasizing novices NOT use the \\ and \\\;
> and, still suggest blank lines.

In reviewing the BasicEditing page, what I think really needs to happen
is that we take the \, \\, and \\\ markups out of the "General usage"
section at the top of the page and move them somewhere else.  

Visually the descriptions of \, \\, and \\\ eat up more space
than the information about blank lines starting a new paragraph,
and thus makes it appear as though they are more common/important
(when the reverse is true).  So, I think the information about \\
should go somewhere later in the page where it will be much
less prominent.

Pm



More information about the pmwiki-users mailing list