http://qs321.pair.com?node_id=11112919


in reply to Re^2: Good Intentions: Wikisyntax for the Monastery (solved: "writeln wiki-toggle")
in thread Good Intentions: Wikisyntax for the Monastery

Maybe have the <b>*Wiki?*</b> be a link back to Good Intentions: Wikisyntax for the Monastery, in case someone forgets their Wiki syntax from one visit to the next. :-)

Also, the syntax accepted by the nodelet hack seems to be split between the spoiler of the original post and a reply (and here for https extension, and probably other posts that I haven't noticed). It makes it rather disjointed to see what's translated by the nodelet hack. It might be nice to have all the currently-valid syntax summarized somewhere in the root post (maybe in a third section alongside code and demo sections) -- or at least update demo with the additional linking options and the features like <nowiki> which have been added over time.

Replies are listed 'Best First'.
Re^4: Good Intentions: Wikisyntax for the Monastery (solved: "writeln wiki-toggle")
by LanX (Saint) on Feb 13, 2020 at 15:01 UTC
    Hello pryrt

    Welcome among the elite of MonkWiki-Users! ;-)

    > Maybe have the *Wiki?* be a link back to Good Intentions: Wikisyntax for the Monastery,

    Excellent idea! ;) °

    > Also, the syntax accepted by the nodelet hack seems to be split between the spoiler of the original post and a reply

    Yeah, I know ... :(

    It's because

    • a) it's work in progress and
    • b) I'm keeping the users informed about changes. (there are no update notifications in PM)
    My plan is to refactor the code in a way that it becomes self-documenting in a doc-stringish way.

    Like that the documentation would be generated by the code and would stay up-to-date.

    I also plan to add buttons to the bottom row to insert markup and pop-up the help message.

    Cheers Rolf
    (addicted to the Perl Programming Language :)
    Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

    UPDATE

    °) implemented

[reply]
      It's always hard to keep documentation up-to-date with the actual product.

      doc-string
      Maybe you should write a POD nodelet hack that can work in conjunction with, or separately from, the Wikisyntax? ;-) It could be "fun" to alternate betweeen writing whole posts in POD and writing just the documentation for the Wikisyntax with POD syntax.

      Thanks for all your work on this.

[reply]
        > Maybe you should write a POD nodelet hack that can work in conjunction with, or separately from, the Wikisyntax? ;-)

        Do you mind read?

        Actually I'm thinking of making the mark-up configurable, because the concept is flexible enough to switch grammars on the fly (like to BB-Code/POD/various Wiki-Flavours)

        Special casing an embedded <pod> </pod> area wouldn't be difficult, but someone would be needed to write / port the POD parser to JS though.

        At the moment it's easier to copy a HTML-selection from CPAN or Perldoc and to strip the non-approved tags.

        > Thanks for all your work on this.

        Self preservation, after over 8000 posts I'd risk to get crazy otherwise. Especially when posting from mobile.

        PS: *Wiki?* is a link now. :)

        Cheers Rolf
        (addicted to the Perl Programming Language :)
        Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

[reply]
[d/l]
      time to fork?
[reply]

In Section Perl Monks Discussion