"Required Fields"
Page header:
Titel: primary title of the page/article
fieldname: {title_doc}
Sub-Title: sub title of the page/article
{title_sub_doc}
2. Sub-title: 2nd sub title of the page/article
<div id="H_docSubtitle2">
{title_sub2_doc}
Orig Edit info: introduction to author, discriminated by certain text like "by" or "translated from Pali to English by" or "edited/compiled by..."
{docby}
Title of Author: like "Ven." or "Upasaka"
{addr_author}
Orig. Author: Name of original Autor
{doc_author}
Translation Edit info: introduction to translator, discriminated by certain text like "translated from English Original to German by" or "translated and edited/compiled by..."
<div id="H_docAuthorTransInfo">
{docby_trans}
Title of Translator of original: like "Ven." or "Upasaka" or "Team, Sangha...", optional: if no authorship
{addr_trans}
Author Translation: Name of translator or team
<div id="H_docAuthorTrans">
{doc_author_trans}
Alternativ Translation of Original Links: Links to alternativ translations of the original
<div id="H_docAuthorTransAlt">
{doc_author_trans_alt}
Date of Original: Date of Original file and last edit "2012/2016-2018"now, incl "copy-gift"-link to footer; first date original, secound translation
{doc_date}
Date of Translation: see before
{doc_date_trans}
Alternative Original-Translation: for Suttas for example (not sure if required for imput or generated)
{doc_alt_trans}
Alternativ Edition: of Original and/or it's Translation, text with link
{doc_edition}
Alternativ Formats: kind with icon and link to media file
{doc_media}
{doc_media_pdf}
{doc_media_audio}
{...
Previous page/sutta: link (maybe possible to generate)
<a class='menu_l' href="..." title="go back to ..."><img src="left.png" alt='[previous]'/></a>
{doc_previous}
Next page/sutta: link (maybe possible to generate)
<a class='menu_r' href="..." title="go to ..."><img src="right.png" alt='[previous]'/></a>
{doc_next}
Footer and add Infos, licence, origin, last edits, dedication
Okay, what I understood so far:
The most basic ingredient of Plugin Syntax (https://www.dokuwiki.org/plugin:data#plugin_syntax) possibilities is the Data Entry (https://www.dokuwiki.org/plugin:data#data_entry_input) 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 (http://www.accesstoinsight.eu/doku.php?id=playground:playground):
====== 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 (http://forum.sangham.net/index.php?action=dlattach;topic=8656.0;attach=5831):
(https://forum.sangham.net/index.php?action=dlattach;topic=8656.0;attach=5831)
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 (https://www.dokuwiki.org/plugin%3Adata#custom_entry_editor) you have been looking for.
The syntax description for the Data entry input (https://www.dokuwiki.org/plugin%3Adata#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 (https://www.dokuwiki.org/plugin%3Adata#custom_entry_editor), 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 (https://www.dokuwiki.org/plugin%3Adata#custom_entry_editor), 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 (https://www.dokuwiki.org/plugin%3Adata#custom_entry_editor) "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 (https://www.dokuwiki.org/plugin%3Adata#custom_entry_editor). 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 (https://www.dokuwiki.org/plugin:data#plugin_syntax): Data Table (https://www.dokuwiki.org/plugin:data#data_table_output), Data List (https://www.dokuwiki.org/plugin:data#data_list_output), Related Pages (https://www.dokuwiki.org/plugin:data#related_pages_output), Tag Cloud (https://www.dokuwiki.org/plugin:data#tag_cloud_control) are somehow for collecting all that data from various different pages together and display them all together in some ways.
Having now given it a t/dry, in including in in a sample in page templates (see product in foundation of mindfulness) it seems to work optical with the current plugin, which is now signed as "ausgebremst" by others.
How ever, if understood right, if setting alias via the adminsection, it would not require a field value edit on each page manual, would it?
The draft, used in dictionary: (incl: data entrance) looks like that for now.
===== meta data =====
---- dataentry metadata ----
page ID: @ID@
pagename: @PAGE@
file: @FILE@
permanent link: http://accesstoinsight.eu/doku.php?id=@ID@
page initially given by: @NAME@
page creation date: @DATE@
origin author and source: see [[en:dictionary:source_of_dictionaries]].
source: various [[en:dictionaries]]
scope of gift: **This is a gift of Dhamma** and given to use for any skilful/wholesome purpose and undertaking but not for any commercial use or other use of exchange for worldly aims. For additional information see [[en:dhamma-dana|Dhamma-Dana]] and possible details at the [[en:dictionary|source pages]] for included parts. Much joy in using and share of the merits!
owner of this copy: Sublime [[en:wiki:sangha:Sangha]] of the eight directions.
current maintainer: The [[aramika]] and monastic disciples on [[http://forum.sangham.net/index.php?action=forum|sangham.net]]
dedications of editors: [[@Name@]]: for the Sublime Sangha of the Buddha and those following and interested, my teachers, parents and ancestors, all beings welfare.
----
/me : and now Atmas eyes, no more able to read the small letters, says: it's good to take a short sleep :)