(anonymous guest) (logged out)

Copyright (C) by the contributors. Some rights reserved, license BY-SA.

Sponsored by the Wiki Symposium and the Nuveon GmbH.

 
View Attach Info

Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-5) was last changed on 24-May-2008 13:56 by ChristophSauer  

This page was created on 06-May-2008 13:41 by ChristophSauer

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 removed one line
For "magic words" that are processed at render-time, I would suggest to use the same syntax as for macros (whatever that may be) like {{{<<CurrentDate>>}}}. Effectively, these just become macros, there is no need for a separate syntax.
At line 3 removed 6 lines
For "magic words" that are processed at save-time, a character could be added in front, e.g. {{{~<<CurrentDate>>}}}. Reusing the escape character (tilde) here would degrade nicely if, for some reason, save-time processing didn't happen (i.e., it would just render as "{{{<<CurrentDate>>}}}").
If angle brackets were not used for the save-time case, (i.e, ~CurrentDate instead of {{{~<<CurrentDate>>}}}), there would be no easy way to include arguments like {{{~<<CurrentTimePlugin format='yyyy.MM.dd'>>}}}.
-- [[StephenDay]], 2008-Mai-13
At line 70 added 31 lines
-----------------
For "magic words" that are processed at render-time, I would suggest to use the same syntax as for macros (whatever that may be) like {{{<<CurrentDate>>}}}. Effectively, these just become macros, there is no need for a separate syntax.
For "magic words" that are processed at save-time, a character could be added in front, e.g. {{{~<<CurrentDate>>}}}. Reusing the escape character (tilde) here would degrade nicely if, for some reason, save-time processing didn't happen (i.e., it would just render as "{{{<<CurrentDate>>}}}").
If angle brackets were not used for the save-time case, (i.e, ~CurrentDate instead of {{{~<<CurrentDate>>}}}), there would be no easy way to include arguments like {{{~<<CurrentTime format='yyyy.MM.dd'>>}}}.
-- [[StephenDay]], 2008-Mai-13
Tilde is already the escape character. Plugin syntax would be the most obvious choice (something like {{{<<sig>>}}}).
-- [[YvesPiguet]], 2008-May-19
Problem with Plugins is that they always create content at runtime (per page view) in the context of the current user. So if you would write a plugin in JSPWiki named {{{<<Sig>>}}} it could always only replace the current user logged in. Clearly not what was intended. In JSPWiki the [[magic word]] "Signature" was implemented by a filter, replacing a markup at translation time. It replaces exactly the two minus and 4 tildes. So we have to distinguish from an technical point of view between
* Always at runtime -> plugins, create content dynamically (like portlets in portal software)
* Pre Translate -> filter
* Translate -> parser
* Post Translate -> filter
I don't have a clear picture yet how to categorize them more clearly to fit for all engines and converters. But because of the "pretranslate" of the magic words, the tildes where no problem to implement in JSPWiki, except that you have to avoid to pretranslate them if they are put into a nowiki block.
{{{
--~~~~
}}}
I would therefore suggest that we prefix a magic word something, e. g. two [[Hyphens And Dashes|dashes]].
-- [[ChristophSauer]], 2008-Mai-24 10:01 (CEST)
Version Date Modified Size Author Changes ... Change note
5 24-May-2008 13:56 4.748 kB ChristophSauer to previous Refactored from Signature.Talk
4 13-May-2008 19:47 3.412 kB StephenDay to previous | to last argument example added
3 13-May-2008 19:46 3.418 kB StephenDay to previous | to last suggestion
2 13-May-2008 19:41 3.364 kB StephenDay to previous | to last added suggestion
1 06-May-2008 13:41 2.632 kB ChristophSauer to last mail into wiki ;-)
« This page (revision-5) was last changed on 24-Mai-2008 13:56 by ChristophSauer