[pmwiki-users] Division block nomenclature

[Nelson E. Ingersoll]

Patrick R. Michaud wrote:
> On Thu, Aug 02, 2007 at 10:14:58AM -0600, Nelson E. Ingersoll wrote:
>>    Hmmm... the documentation (http://www.pmwiki.org/wiki/PmWiki/BlockMarkup)
>> does indicate that the >>blah<< block can NOT be nested while the (:div
>> ...:) can be.  That sorta suggests one is not a substitute for the other.
> 
> The (:div:) markup can be nested only if the "div" is followed by
> a digit.  In all other respects it's currently the same.

Excellent info.  Thank you.

> 
> There is also a proposal to use digits to allow nested forms 
> of >>blah<< -- see http://www.pmwiki.org/wiki/Test/VoteOnNestedDivMarkup .
> I'm pretty sure we'll adopt one or the other -- still, this
> means that >>>blah<<< will translate into an equivalent (:div#:) 
> markup of some sort.
> 

I looked at the page and voted.  I do not understand why there should be two
methods, ">>1 foo<<...>><<" and "(:div:)...(:divend:)", to perform the same
function; however, if it must be, it must be.  I voted most favorably for
the 3rd of the alternatives and strongly against implementing two of the
alternatives.  (I also created a Profiles page for myself.)

>>    At this time I must demur suggesting a naming convention.  I'm an expert
>> at being PmWiki specifically and wikis, in general, ignorant.  8-)  I am not
>> "markup" sufficient.  Yet.  As I struggle with using PmWiki I will (do!)
>> have suggestions; however.  Should I send suggestions directly to you or
>> make (try?) to update/modify the documentation myself?
> 
> Either try modifying the documentation directly, or post a message
> to the mailing list for discussion and comment.  :-)
>

Great!  I'll make changes myself whenever possible and stand up for any
feedback which results.

> Thanks!
> 
> Pm
> 
>> Patrick R. Michaud wrote:
>>> On Thu, Aug 02, 2007 at 09:12:07AM -0600, Nelson E. Ingersoll wrote:
>>>> I'm doing a little research.  There are, if I not mistaken, two major
>>>> division block directives.  However, I don't know their names and haven't
>>>> been able to find their names in the documentation.  So what are
>>>>
>>>>>> blah<<   and    (:div ...:)
>>>>>> <<              (:divend:)
>>>> each called?  How would I refer to them to differentiate one from the other
>>>> for a third party?
>>> I don't know what they're called beyond being "divs".
>>>
>>> The >>blah<< form is simply a shortcut for "(:div:) %blah apply=div%".
>>> Similarly, ">><<" is a shortcut for "(:divend:)".  So, they are
>>> in fact the same construct but with different syntax.
>>>
>>> Any suggestions or improvements you could make for the documentation
>>> would be greatly appreciated.
>>>
>>> Pm
>>>
>