Difference between revisions of "Example 1"

From FollowTheScore
Jump to: navigation, search
(country list (2))
Line 14: Line 14:
 
   includepage={Country} dpl,#History,#Religion[20],revolution
 
   includepage={Country} dpl,#History,#Religion[20],revolution
 
   addpagecounter=true
 
   addpagecounter=true
   mode=userformat
+
   format=¶{|class=sortable ¶!Country ¶!Official Name ¶!Capital ¶!Dial Code ¶!History ¶!Religion ¶!Revolutions,¶|-¶|[[%PAGE%]] (%COUNT%),,¶|}
  listseparators=¶{|class=sortable ¶!Country ¶!Official Name ¶!Capital ¶!Dial Code ¶!History ¶!Religion ¶!Revolutions,¶|-¶|[[%PAGE%]] (%COUNT%),,¶|}
 
 
   secseparators=¶|
 
   secseparators=¶|
 
</DPL>
 
</DPL>

Revision as of 16:01, 24 August 2007

Our demo web site contains some articles on fictitious countries (this is also the name of their common category).

They all use a template named "Country" which has parameters like capital. The template produces a small table and a link to the country list we want to generate. There are chapters on religion and history in most of the articles. We show how to create a sortable wikitable list of those articles which gives some excerpts of the contents.

DPL can be used as a mediawiki parser extension, which means that a special DPL tag is used:

parser extension syntax

<DPL>
  category=Fictitious country
  includepage={Country} dpl,#History,#Religion[20],revolution
  addpagecounter=true
  format=¶{|class=sortable ¶!Country ¶!Official Name ¶!Capital ¶!Dial Code ¶!History ¶!Religion ¶!Revolutions,¶|-¶|[[%PAGE%]] (%COUNT%),,¶|}
  secseparators=¶|
</DPL>

We select articles by category ("Fictitious Country") and explain that we want to see contents from the template "Country" and from two chapters. And we want to transclude text which is contained between special section markers named "revolution". We truncate the text on religion to a maximum of 20 characters. We create a sortable table which contains the article name (as a link) and its access frequency in the first column and the content pieces in the other columns. Note that at the end of truncated contents you will find a small arrow which links directly to the chapter from where the contents was taken. The formatting for the template variables is done in a special template which is by convention named after the original template plus a suffix (Template:Country dpl in our case). This template is very simple; it only presents the values for name, capital and dial code as columns of a table. The transcluded contents from the marked sections ("revolution") is not changed in any way. Note that only the text between the markers is transcluded, not the whole sentence.

As wiki syntax depends on line breaks we must use a symbol to represent a line break ("\n" or "¶" are possible) .

country list
Country Official Name Capital Dial Code History Religion Revolutions
DPL Example 007 main page 1 (%COUNT%) Template:Country dpl.default
Nigunda (%COUNT%) Republic of Nigunda Bamitogoo 237

some facts about ..→


revolution in 1977 which lasted 10 days
another revolution in 1987 which caused many deaths.
Nigunda Test (%COUNT%) Republic of Nigunda Test Bamitogoo Test 237

Nigunda Test History - Chapter Sequence in the article doesn´t matter for DPL ..

some facts about ..→

Somango (%COUNT%) Somango Island Aaaabququque 224

a text on the history of Somango; a text on the history of Somango; a text on the history of Somango;

some facts about ..→

Nothing to declare
country list (2)

DPL can also be used as a mediawiki parser function, which is more powerful as it allows DPL to be used within templates, parameters being template calls or variable expansions. The syntax looks a bit different.

Special care must be taken if you need the pipe symbol ("|") as contents of your statements. This happens for example, when you want to define a wiki table. We offer two ways for that purpose:

  • the classic way, i.e. define special macros like (! with a contents of {| (this is common practice in wikipedia).
  • use the special symbol ¦; this symbol looks very similar to the pipe character and is therefore more elegant.

See two examples (with identical results) to understand the difference:

parser function syntax with \n and macros parser function syntax with and ¦
{{#dpl:category=Fictitious country
  |includepage={Country} dpl,#History[80 img=pointing.hand.gif],#Religion
  |addpagecounter=true
  |mode=userformat
  |listseparators=\n{{(!}} class=sortable
    \n!Country
    \n!Official Name
    \n!Capital
    \n!Dial Code
    \n!History
    \n!Religion,\n{{!-}}\n{{!}}[[%PAGE%]] (%COUNT%),,\n{{!)}}
  |secseparators=\n{{!}}
}}

The result:


C1ountry Official Name Capital Dial Code History Religion
DPL Example 007 main page 1 (%COUNT%) Template:Country dpl.default
Nigunda (%COUNT%) Republic of Nigunda Bamitogoo 237

some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda;

Nigunda Test (%COUNT%) Republic of Nigunda Test Bamitogoo Test 237

Nigunda Test History - Chapter Sequence in the article doesn´t matter for <linkedimage>page=Nigunda Test#History img=Image:pointing.hand.gif </linkedimage>

some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda Test;

Somango (%COUNT%) Somango Island Aaaabququque 224

a text on the history of Somango; a text on the history of Somango; a text on <linkedimage>page=Somango#History img=Image:pointing.hand.gif </linkedimage>

some facts about religion in Somango

{{#dpl:category=Fictitious country
  |includepage={Country} dpl,#History[80 img=pointing.hand.gif],#Religion
  |addpagecounter=true
  |mode=userformat
  |listseparators=¶{¦ class=sortable
    ¶!Country
    ¶!Official Name
    ¶!Capital
    ¶!Dial Code
    ¶!History
    ¶!Religion,¶¦-¶¦[[%PAGE%]] (%COUNT%),,¶¦}
  |secseparators=¶¦
}}

The result:


Country Official Name Capital Dial Code History Religion
DPL Example 007 main page 1 (%COUNT%) Template:Country dpl.default
Nigunda (%COUNT%) Republic of Nigunda Bamitogoo 237

some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda;

Nigunda Test (%COUNT%) Republic of Nigunda Test Bamitogoo Test 237

Nigunda Test History - Chapter Sequence in the article doesn´t matter for <linkedimage>page=Nigunda Test#History img=Image:pointing.hand.gif </linkedimage>

some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda Test;

Somango (%COUNT%) Somango Island Aaaabququque 224

a text on the history of Somango; a text on the history of Somango; a text on <linkedimage>page=Somango#History img=Image:pointing.hand.gif </linkedimage>

some facts about religion in Somango

Have a look at a more realistic example ...