Arbeiten mit DPL3 - Revision history

KB at 08:02, 23 July 2025

2025-07-23T08:02:01Z

← Older revision		Revision as of 10:02, 23 July 2025
Line 29:		Line 29:
	** (uses=Template:ImageMetadata)		** (uses=Template:ImageMetadata)
	* title (Select one single page by its (namespace and) title, requires additional parameters)		* title (Select one single page by its (namespace and) title, requires additional parameters)
	** title=Projektseite \|include=#Temporäre Hilfe-Seiten		** (title=Projektseite \|include=#Temporäre Hilfe-Seiten)
	* contents		* contents

KB at 07:58, 23 July 2025

2025-07-23T07:58:59Z

← Older revision		Revision as of 09:58, 23 July 2025
Line 82:		Line 82:
	* (mode=none)		* (mode=none)
	* (mode=inline)		* (mode=inline)
	** ~~add~~ (inlinetext=  •  )		** (inlinetext=  •  )
	* (mode=category) (requires "ordermethod" with one of the values: title; titlewithoutnamespace; category,title; or user,title).		* (mode=category) (requires "ordermethod" with one of the values: title; titlewithoutnamespace; category,title; or user,title).
	* (mode=userformat)		* (mode=userformat)

KB at 07:58, 23 July 2025

2025-07-23T07:58:03Z

← Older revision		Revision as of 09:58, 23 July 2025
Line 4:		Line 4:
	Manual: https://dpl3.wikitide.org/wiki/Main_Page		Manual: https://dpl3.wikitide.org/wiki/Main_Page

	~~There are~~ different parameters to structure '''which pages''' are included, '''what content''' from these pages is included, and '''how the output is formatted'''.		Basic use of DPL3 works similar to that of Templates / Parser Functions:

			<code>
			<nowiki>
			{{#dpl:
			\|parameter1 = xy
			\|parameter2 = yx
			}}
			</nowiki>
			</code>

			The different parameters structure '''which pages''' are included, '''what content''' from these pages is included, and '''how the output is formatted'''.

	== Inclusion Criteria: Page Selection ==		== Inclusion Criteria: Page Selection ==

KB at 08:27, 18 July 2025

2025-07-18T08:27:20Z

← Older revision		Revision as of 10:27, 18 July 2025
Line 23:		Line 23:
	Restricting the output to a certain number of results can be done with "count" (count=2).		Restricting the output to a certain number of results can be done with "count" (count=2).

	~~===~~ Example ~~===~~
			'''Example:'''
	The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).		The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).

	~~'''~~Result of the function call:~~'''~~		Result of the function call:
	{{#dpl:		{{#dpl:
	\|category=Illustration		\|category=Illustration
Line 50:		Line 51:
	** (include={ImageMetadata}:work-title:year:%PAGE%)		** (include={ImageMetadata}:work-title:year:%PAGE%)

	~~===~~ Example ~~===~~
			'''Example:'''
	The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.		The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.

	~~'''~~Result of the function call:~~'''~~		Result of the function call:
	{{#dpl:		{{#dpl:
	\|uses=Template:ImageMetadata		\|uses=Template:ImageMetadata
Line 76:		Line 78:
	* (include={ImageMetadata}:work-title:year \|table=class="wikitable imageTable", Image, Work Title, Year)		* (include={ImageMetadata}:work-title:year \|table=class="wikitable imageTable", Image, Work Title, Year)

	~~===~~ Example ~~===~~
			'''Example:'''
	The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.		The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.

	~~'''~~Result of the function call:~~'''~~		Result of the function call:
	{{#dpl:		{{#dpl:
	\|uses=Template:ImageMetadata		\|uses=Template:ImageMetadata
Line 88:		Line 91:

	=== Userformat Output ===		=== Userformat Output ===
	"Userformat" mode makes the output fully flexible, enabling formatting with wikitext and supported html elements. This mode has a system of three tags which are used to enclose (a) the whole output, (b) each item, (c) each transcluded section of an item.		"Userformat" mode makes the output fully flexible, enabling formatting with wikitext and supported html elements. This mode has a system of three tags which are used to enclose (a) the whole output, (b) each item, (c) each transcluded section of an item; they can also contain [https://dpl3.wikitide.org/wiki/Controlling_output_format#variables\| variables]:
			* listseparators
			** (listseparators = <Outputstart>,<Itemstart>,<Itemend>,<Outputend>)
			** (listseparators = \n ''Start of the List'' \n,~ , \n,\n ''End of the List'')
			* secseparators
			** (secseparators=1a,1b,2a,2b,3a,3b)


			'''Example:'''
			The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).

			Result of the function call:
			{{#dpl:
			\|uses=Template:ImageMetadata
			\|include={ImageMetadata}:work-title,{ImageMetadata}:year,{ImageMetadata}:id
			\|mode=userformat
			\|listseparators=A,B,C,D
			\|secseparators=1a,1b,2a,2b,3a,3b
			}}


			Result of the function call:
			{{#dpl:
			\|uses=Template:ImageMetadata
			\|include={ImageMetadata}:work-title,{ImageMetadata}:year,{ImageMetadata}:id
			\|mode=userformat
			\|listseparators=A <br>, \n# B , C, <br> D
			\|secseparators= [[%PAGE%\|%TITLE%]] a '' , '' b , c (,) d , e ''',''' f
			}}


			The parameter "format" implicitly sets "mode=userformat" and enables similar styling to the "listseperator" parameter.
			* (format=A,B,C,D,E)
			* (format=,\n<span style="font-size: ²{#expr:%NR% * 0.5}²em;">'''[[%PAGE%]]''',</span> \n ,)
			* (\|uses=Template:ImageMetadata \|format = «gallery mode="packed" widths="80px" heights="80px"»,%PAGE%\n,,«/gallery»)


	~~====~~ Example ~~====~~		'''Example:'''
	The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function)~~. Some include statements only make sense in combination with specific page selection criteria~~.		The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).

	~~'''~~Result of the function call:~~'''~~		Result of the function call:
	{{#dpl:		{{#dpl:
	\|uses=Template:ImageMetadata		\|uses=Template:ImageMetadata
	\|include={ImageMetadata}:work-title:year		\|include={ImageMetadata}:work-title,{ImageMetadata}:year,{ImageMetadata}:id
	\|~~table~~=~~class~~="~~wikitable imageTable~~", ~~Image, Work Title~~, ~~Year~~		\|format=,\n<span style="font-size: ²{#expr:%NR% * 0.5}²em;">'''[[%PAGE%]]''',</span> \n ,
	}}		}}


	=== Table Output ===		=== Table Output ===
			The "table" parameter creates a standard wikitable in wikitext syntax. If no class attribute is specified, the default class is "wikitable".
			Relevant parameters are:
			* table
			** (table= ,Header1,Header2,Header3,Header4,Header5)
			** (table= class="imageTable wikitable" style="color:seagreen; font-weight:600;", File, Title, Work Title, Year, Chapter)
			* tablerow
			** (tablerow=%%,%%,%%,%%,%%)
			** (\|include={ImageMetadata}:%TITLE%:ill-title:work-title:year:chapt \|table= ,-,Image,Title,Book Title,Year of Publication,Chapter \|tablerow=[[File:%%{{!}}x100px]],'''%%''',''%%'',%%,%%)
			* tablesortcol (number starting at 1)



			'''Example:'''
			The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).

			Result of the function call:
			{{#dpl:
			\|uses=Template:ImageMetadata
			\|include={ImageMetadata}:ill-title:work-title:year:chapt
			\|table= ,Image,Title,Book Title,Year of Publication,Chapter
			}}

KB at 06:50, 18 July 2025

2025-07-18T06:50:05Z

← Older revision		Revision as of 08:50, 18 July 2025
Line 85:		Line 85:
	\|table=class="wikitable imageTable", Image, Work Title, Year		\|table=class="wikitable imageTable", Image, Work Title, Year
	}}		}}


			=== Userformat Output ===
			"Userformat" mode makes the output fully flexible, enabling formatting with wikitext and supported html elements. This mode has a system of three tags which are used to enclose (a) the whole output, (b) each item, (c) each transcluded section of an item.

			==== Example ====
			The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.

			'''Result of the function call:'''
			{{#dpl:
			\|uses=Template:ImageMetadata
			\|include={ImageMetadata}:work-title:year
			\|table=class="wikitable imageTable", Image, Work Title, Year
			}}


			=== Table Output ===

KB at 10:02, 17 July 2025

2025-07-17T10:02:24Z

@@ Line 58: / Line 58: @@
 |resultsheader = <i>There are %PAGES% entries.</i>
 |include={ImageMetadata}:work-title:year:%PAGE%
 }}

KB: Created page with "= Basics of DynamicPageList3 (23.07.2025)= DynamicPageList3 generates lists of pages, page properties (metadata), and/or template parameter values, for display in other articles. Manual: https://dpl3.wikitide.org/wiki/Main_Page There are different parameters to structure '''which pages''' are included, '''what content''' from these pages is included, and '''how the output is formatted'''. == Inclusion Criteria: Page Selection == DPL3 needs criteria for what to include..."

2025-07-17T09:31:46Z

Created page with "= Basics of DynamicPageList3 (23.07.2025)= DynamicPageList3 generates lists of pages, page properties (metadata), and/or template parameter values, for display in other articles. Manual: https://dpl3.wikitide.org/wiki/Main_Page There are different parameters to structure '''which pages''' are included, '''what content''' from these pages is included, and '''how the output is formatted'''. == Inclusion Criteria: Page Selection == DPL3 needs criteria for what to include..."

New page

= Basics of DynamicPageList3 (23.07.2025)=
DynamicPageList3 generates lists of pages, page properties (metadata), and/or template parameter values, for display in other articles.

Manual: https://dpl3.wikitide.org/wiki/Main_Page

There are different parameters to structure '''which pages''' are included, '''what content''' from these pages is included, and '''how the output is formatted'''.

== Inclusion Criteria: Page Selection ==
DPL3 needs criteria for what to include in the list it generates. Some possible choices are:
* category OR notcategory
** (category=Illustration)
* namespace
**(namespace=Template)
* links
** (linksfrom=Projektseite)
** (linksto={{FULLPAGENAME}})
* use of templates
** (uses=Template:ImageMetadata)
* title (Select one single page by its (namespace and) title, requires additional parameters)
** title=Projektseite |include=#Temporäre Hilfe-Seiten
* contents

Restricting the output to a certain number of results can be done with "count" (count=2).

=== Example ===
The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function).

'''Result of the function call:'''
{{#dpl:
|category=Illustration
}}

== Inclusion Criteria: Output Volume ==
The default list view only includes the page name as a link in a basic list format (unordered list). Other data can be included from each page to:
* Specify a header/footer to show when results are found or not found
* Show the number of articles in the result set
* Add metadata (size, author, last edited by, date of last change, etc.) to the output (not discussed below, refer to the [https://dpl3.wikitide.org/wiki/Controlling_output_volume#Adding_metadata_to_the_output| manual])
* Include contents from articles (text, template variables, etc.)
* Cut off the articles' content at a certain length

Some possible parameters are:
* resultsheader / oneresultheader / noresultheader
* resultsfooter / onersultfooter / noresultfooter
** (resultsheader = <i>There are %PAGES% entries.</i>)
* include
** (include=*)
** (include=%0[200])
** (include={ImageMetadata}:work-title:year:%PAGE%)

=== Example ===
The example can be changed to see how the different parameters work in real time (using the Preview all changes can be observed while working on the parser function). Some include statements only make sense in combination with specific page selection criteria.

'''Result of the function call:'''
{{#dpl:
|uses=Template:ImageMetadata
|resultsheader = <i>There are %PAGES% entries.</i>
|include={ImageMetadata}:work-title:year:%PAGE%
}}