Okay, what I understood so far:
The most basic ingredient of
Plugin Syntax possibilities is the
Data Entry input.
With this one can associate some data to each individual page. The Wiki syntax for adding a data entry is given in the example:
---- dataentry projects ----
type : web development
volume : 1 Mrd # how much do they pay?
employees : Joe, Jane, Jim
description_wiki: **Important** project
customer_page : customers:microsoft
deadline_dt : 2009-08-17
server_pages : servers:devel01, extern:microsoft
website_url : http://www.microsoft.com
task_tags : programming, coding, design, html
----
So it starts with "---- dataentry {{some-class-name}} ----" and ends with "----". And the lines in between are definitions for all the data fields that one wants to define.
The name ({{some-class-name}}, or "projects" in the example) is added as a CSS class to the data enry box. One can define the CSS for that in the "{%dokuwiki%}/conf/userstyle.css" file on the server.
I have tried some things out on the
Playground page :
====== PlayGround ======
Test test test.
---- dataentry whatever ----
something : something **something**
puhelin : Nokia, Samsung, Sony, Lg, Motorola
perkele_tags : Perun, Perkwunos
rölli-peikko : Alavaka Yakkha
yksi : ០
kaksi : ១
kolme : ៣
neljä : ៤
viisii : ៥
numeros : ០, ១, ៣, ៤, ៥
smiley_imgs : http://forum.sangham.net/Smileys/sangham/smile_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/happy_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sad_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/shock_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/confused_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/well_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/gift_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sanghagift_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/thumb_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/forgiveme_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sadhu_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/wink_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/neutral_sangham_sw.gif
smileysmall_img14s : http://forum.sangham.net/Smileys/sangham/smile_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/happy_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sad_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/shock_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/confused_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/well_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/gift_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sanghagift_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/thumb_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/forgiveme_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/sadhu_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/wink_sangham_sw.gif, http://forum.sangham.net/Smileys/sangham/neutral_sangham_sw.gif
----
This now looks like this picture in the
attached screenshot :
After typing the data entry in with Wiki syntax as shown, it is now possible to use the "Edit" button below the data display box on the page to change everything and add new entries etc. It seems that this is the
Edit form you have been looking for.
The syntax description for the
Data entry input also includes some explanations about different data types:
dt a date in the form YYYY-MM-DD, formatted as simple text but the input is checked for correct format
page the entry is treated as Wiki pagename and will be linked in output. It is always considered to be an absolute pagename starting in the root namespace. Relative pagenames are not possible.
title like page, but an additional display title can be given separated by a pipe. It is always considered to be an absolute pagename starting in the root namespace. Relative pagenames are not possible.
nspage like page, but the column name is treated as namespace for the link.
url the value will be treated as external link
tag the values are linked to a page named after the column name, using the value as control filter for a data table (change target by a type alias)
mail the value is checked to contain a valid email address, additional text is used as name that will be linked with the given email address
img<num> the input is assumed to be a image URL or local media id. The optional <num> is the wanted width in pixels to resize the image to (defaults to 40)
wiki render the input as wikitext (use sparingly as this type impacts performance)
pageid the input is the caption for a link to the data entry page
hidden the input will not be shown in the data entry or the entry editor
One can specify a data type for an entry by adding '_{{type}}' to its name, where '{{type}}' is one of the data type nams in that table above.
So for example, in my test example there is an entry 'smiley_imgs'.
The 'img' indicates that the data type is expected to be an url to an image file. In the
Edit form , this can be set by selecting a type from the Type dropdown menu.
And the 's' at the end indicates that it is a list of multiple values, separated by commas. In the
Edit form , one can set the check mark "multi" for this option.
On the displayed wiki page the 'type' and the 's' ending are not displayed. So, although I wrote 'smiley_imgs', the displayed name is only 'smiley', and the 'imgs' is only helping the program interpret the data in the right way, and that is also what is modified in the
Edit form "Type" dropdown and "Multi" checkmark.
Images are displayed as 40 pixels wide by default. One can change this by adding the width after 'img'.
For the 'smileysmall' entry, I have typed in 'smileysmall_img14s'. The 14 in this places indicates that the images should all be displayed with the width of 14 pixels.
One thing not workign as expected with the Edit form:
But this is one thing missing from the
Edit form . One can not set the size for images in the edit form. It is only possible by editing the code in the page.
Also, if one had defined the size of 'img' entries by editing the page code, then this type info will be deleted by using the edit form.
The entry "perkele" is of type "tag", and is multi-valued. So I typed in "perkele_tags" as the name in Wiki code.
Tags are displayed as links, and when clicking on it, it seems to link to a page where all other pages including this tag should be displayed. But I am not sure yet how that works. At the moment, there is no page for that yet.
So this "Data entry" input is for defining all the data on each wiki page. And this data is displayed in a small box.
I think the other
syntax options :
Data Table ,
Data List ,
Related Pages ,
Tag Cloud are somehow for collecting all that data from various different pages together and display them all together in some ways.