[pmwiki-users] Division block nomenclature
Nelson E. Ingersoll
nelson.ingersoll at atmel.com
Thu Aug 2 13:38:50 CDT 2007
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.
>> 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.
More information about the pmwiki-users