Renegade54 (talk | contribs) m (copyedit) Tag: sourceedit |
(→Use: Updated links to DPL manual) |
||
Line 26: | Line 26: | ||
− | <big>Below are some commonly-used options and parameters. For a complete set of DynamicPageList commands, see the [http:// |
+ | <big>Below are some commonly-used options and parameters. For a complete set of DynamicPageList commands, see the [http://followthescore.org/dpldemo/DPL:Manual manual] on the [http://followthescore.org/dpldemo/ DPL website].</big> |
---- |
---- |
Revision as of 14:41, 13 November 2018
DynamicPageList is a Mediawiki extension originally developed for Wikinews. It enables Memory Alpha archivists to create a list of pages that are listed in a set of categories. For more information see Dynamic Page List on MediaWiki.
Every page on Memory Alpha that invokes DPL links to a special "Extension DPL" template automatically.
Use
DynamicPageList can be used with XML-like syntax in the wiki edit view. The parameters control the pages to list, the display order, and the display mode. See the following sections for information on each parameter. For example, the following are the oldest five pages on Memory Alpha that need one or more citations:
<dpl> category = Memory Alpha pages needing citation count = 5 order = ascending addfirstcategorydate = true </dpl>
- 2013-08-28 03:36:51 Category:Memory Alpha files needing citation
- 2013-08-28 03:38:17 Undeveloped Star Trek: The Original Series episodes
- 2013-08-28 03:38:25 Bridge
- 2013-08-28 04:05:53 Endgame (episode)
- 2013-08-28 04:05:58 Plato's Stepchildren (episode)
Below are some commonly-used options and parameters. For a complete set of DynamicPageList commands, see the manual on the DPL website.
Page selection
- category
- lists categories from which to select articles. DynamicPageList will list pages that are found in every category listed on a separate category line (i.e. an AND operation). To perform an OR operation, separate categories with the pipe character ("|") on a single category line. A minimum and maximum number of entries to list is set in the extension's source code. You may use magic words like {{CURRENTMONTHNAME}} in the category name.
- The syntax is
category = 1st category name | 2nd category name | ...
This example will list pages that have [[Category:TOS performers]] OR [[Category:TAS performers]], AND [[Category:ENT performers]]:
<dpl> category = TOS performers|TAS performers category = ENT performers </dpl>
- notcategory
- restricts the list of pages to those not in a particular category. You can use magic words like {{CURRENTMONTHNAME}} in the category name.
- The syntax is
notcategory = category name
This example will list pages that have [[Category:TAS performers]] but NOT [[Category:TOS performers]]:
<dpl> category = TAS performers notcategory = TOS performers </dpl>
- namespace
- restricts the list of pages displayed to those in one of the listed namespaces, specified by name (see the List of namespaces). To select the main namespace, use a null string as the namespace parameter (i.e.
namespace =
). An invalid name produces an error message.- Note that namespace ids are no longer valid as namespace arguments.
- The syntax is
namespace = 1st namespace name | 2nd namespace name | ...
<dpl> category = Memory Alpha maintenance templates namespace = Template </dpl>
- Template:Colored Panel
- Template:Panel
- Template:Panel2
- Template:Anchor
- Template:Here
- Template:TOCright
- Template:Tba
- Template:Trek box office
- Template:Navbox
- Template:Edit
- Template:Daysago
- Template:Shortcut
- Template:!
- Template:!!
- Template:&
- Template:'
- Template:=
- Template:Bracket left
- Template:Bracket right
- Template:Colon
- Template:Curly left
- Template:Curly right
- Template:Extension DPL
- Template:Also
- Template:Blurb
- Template:New
- Template:Hidden category
- Template:Image link
- Template:Extension DPL cache
- Template:Unsigned
- Template:Portal
- Template:Cm2cmn
- Template:International needs translation
- Template:RequestedLinks
- Template:Visible anchor
- Template:Censored
- Template:Tabview message
- Template:Ogginfo
- Template:(!
- Template:!)
- Template:((
- Template:Code
- Template:!-
- Template:Yesno
- Template:\sandbox
- Template:DEFAULTSORT
- Template:DISPLAYTITLE
- Template:Bleeped
- Template:Meta file
- Template:Star Trek owner
- Template:Category handler
- Template:Bdayremoved
- Template:Renamed
- Template:Clear
- Template:RailModule
- Template:Greek
- Template:Linktip
- Template:Documentation
- Template:Documentation subpage
- Template:Enabled with WikiFeatures
- Template:Example
- Template:Startdiscussion
- Template:Svg
- Template:Min
- Template:Template link with title with subst
- Template:Tag
- Template:How-to
- Template:International
- Template:International flags
- Template:International short
- Template:Purge
- Template:----
- Template:Sandbox other
- Template:ParserFunction
- Template:))
- Template:Unsigned-anon
- Template:Bots
- redirects
- determines whether or not to include redirect pages. The value can be exclude (default, don't list redirects), include (list redirects), or only (don't list pages that aren't redirects).
<dpl> category = Nicknames redirects = only </dpl>
- Wix
- Kodos the Executioner
- Q-Ball
- Stompie
- Sawbones
- Jake-O
- Itchy
- Hutch
- Stinky
- Smike
- D'akturak
- Mitch
- Trip
- Tiny
- Noggles
- Miss Turtle Head
- Old Sneezy
- Friendly Angel
- Cal
- Gertrude
- Old Iron Boots
- The Vomitorium
- Renny
- Jonny Archer
- Z
- The Slayer of Sorna Prime
- The Witch of Wurna Minor
- Captain Killy
- Lobekins
- Mr. Adventure
- Smiley
- Gentleman Jim
- Catarina
- Reg
- Mystery meal
- Mac
- B.C.
- Ruthie
- Ol' Miss
- Mister Tricorder
- Mr. President
- Pickerd
- Stilly
- Mommy
- Nana
- Buttercup
- Emergency Medical Hothead
- Extremely Marginal Housecalls
- Ole Miss
- Hero of Maxia
- Owo
- Mister Klingon
- Doctor Z
- Mister Scotty
- Quique
- Frannie
- Number One
- Papa
- Mama
- Daddy
- Dad
- Maman
- Pa
- Mom
- Dirty Cash
- Hermit of La Barre
- Tattooed Terror
- Scruffles
- Space whale
- Star creature
- Jake-o
- Salt succubus
- Boims
- Scottish planet
- Ensign Hazmat
- Random communications officer-man
- Killy
- Carol Bear
- Commander Protocol
- Ruthy
- Captain Mommy
- Clone Boimler
- Mr. Falls-Out-of-His-Bunk
- Dr. T
- Mr. Pain-In-My-Tail-Butt
- Tail-Butt
- Cali class
- Poggy
- Fletch
- Nok-head
- Pointy
- Mr. First Husband
- Mr. Alphabet
- Annika Seven Shot
- Dino
- Book (nickname)
- JL
- Denny
- Ruthy Ruth
- Gav (nickname)
- 'Gazer
- Banjo Man
- Boimy
- Peanut Butter
- Crash La Forge
- Marked Woman
- D
- count
- restricts the number of results that are shown. By default, the pages added to the category most recently are shown (see order). Note that the extension will not list more results than the maximum defined in the extension source code.
<dpl> category = Performers count = 3 </dpl>
Details displayed
- shownamespace
- displays the namespace in the page names. The value can be true (default, display in name: Help:Contents) or false (don't display in name: Contents).
<dpl> category = Memory Alpha maintenance templates shownamespace = false </dpl>
- Memory Alpha did you know templates
- Memory Alpha pic of the day templates
- Memory Alpha stub templates
- Memory Alpha internal templates
- Memory Alpha constants templates
- Memory Alpha featured article templates
- Memory Alpha message templates
- Memory Alpha navigational templates (maintenance)
- Colored Panel
- Panel
- Panel2
- Anchor
- Here
- TOCright
- Tba
- Trek box office
- Navbox
- Edit
- Daysago
- Shortcut
- !
- !!
- &
- '
- =
- Bracket left
- Bracket right
- Colon
- Curly left
- Curly right
- Extension DPL
- Also
- Blurb
- New
- Hidden category
- Image link
- Extension DPL cache
- Unsigned
- Portal
- Cm2cmn
- International needs translation
- RequestedLinks
- Visible anchor
- Memory Alpha article type templates
- Censored
- Tabview message
- Ogginfo
- (!
- !)
- ((
- Code
- !-
- Yesno
- \sandbox
- DEFAULTSORT
- DISPLAYTITLE
- Bleeped
- Meta file
- Star Trek owner
- Category handler
- Bdayremoved
- Renamed
- Clear
- RailModule
- Greek
- Linktip
- Documentation
- Documentation subpage
- Enabled with WikiFeatures
- Example
- Startdiscussion
- Svg
- Min
- Template link with title with subst
- Tag
- How-to
- International
- International flags
- International short
- Purge
- ----
- Sandbox other
- ParserFunction
- ))
- Unsigned-anon
- Bots
- addfirstcategorydate
- shows the date each article was added to category. The value can be true (display date) or false (default, don't display date). If many categories are specified, it uses the first category. The linked page names are prepended with the date formatted according to your date display preferences.
<dpl> category = Aquans addfirstcategorydate = true </dpl>
- 2006-11-28 01:57:20 Lemus
- 2006-11-28 01:57:20 Nephro
- 2006-11-28 01:57:27 Cadmar
- 2006-11-28 01:57:27 Domar
- 2006-11-28 01:57:37 Rila
- 2007-08-24 13:45:01 Unnamed Aquans
- 2009-04-25 21:28:26 Category:Memory Alpha images (Aquans)
- 2017-02-22 02:08:24 Cheeron
- mode
- determines the format of the list. The value can be unordered (default, outputs a bulleted list, HTML tag "ul"), ordered (outputs numbered list, HTML tag "ol"), none (outputs plain text with line breaks), or inline (outputs an inline list separated by the character(s) specified in the 'inlinetext' parameter).
unordered: <dpl> category = Constellations mode = unordered </dpl> ordered: <dpl> category = Constellations mode = ordered </dpl> plain text: <dpl> category = Constellations mode = none </dpl> inline: <dpl> category = Constellations mode = inline </dpl>
unordered:
- Orion (constellation)
- Leo (constellation)
- Eridanus
- Cygnus
- Auriga
- Gemini (constellation)
- Andromeda
- Cancer (constellation)
- Puppis
- Aries
- Canis Major
- Canis Minor
- Cetus
- Fornax
- Columba
- Lepus
- Monoceros
- Sculptor (constellation)
- Pisces
- Taurus
- Lynx
- Hercules (constellation)
- Virgo
- Scorpius
- Great Horn
- Eastern lights
- Perseus
- Gezid
- Paedos
- The Runners
ordered:
- Orion (constellation)
- Leo (constellation)
- Eridanus
- Cygnus
- Auriga
- Gemini (constellation)
- Andromeda
- Cancer (constellation)
- Puppis
- Aries
- Canis Major
- Canis Minor
- Cetus
- Fornax
- Columba
- Lepus
- Monoceros
- Sculptor (constellation)
- Pisces
- Taurus
- Lynx
- Hercules (constellation)
- Virgo
- Scorpius
- Great Horn
- Eastern lights
- Perseus
- Gezid
- Paedos
- The Runners
plain text:
Leo (constellation)
Eridanus
Cygnus
Auriga
Gemini (constellation)
Andromeda
Cancer (constellation)
Puppis
Aries
Canis Major
Canis Minor
Cetus
Fornax
Columba
Lepus
Monoceros
Sculptor (constellation)
Pisces
Taurus
Lynx
Hercules (constellation)
Virgo
Scorpius
Great Horn
Eastern lights
Perseus
Gezid
Paedos
The Runners
inline:
- inlinetext
- defines the inline text separator to be used when
mode = inline
is specified. The default is - .
<dpl> category = Asteroids mode = inline shownamespace = false inlinetext = • </dpl>
Order
- ordermethod
- determines the order and date to display. The value can be categoryadd (output sorted by date pages added to first category), counter (output sorted based on number of times pages have been viewed, i.e. ~popularity), size (output sorted based on size of articles), firstedit (output sorted by date pages were first edited, i.e. page creation), lastedit (output sorted by date pages were last edited), title (default, output sorted by article (prefix+)title) or titlewithoutnamespace (output sorted by article title regardless of namespace).
lastedit: <dpl> category = Ba'ku addfirstcategorydate = true ordermethod = lastedit </dpl> categoryadd: <dpl> category = Ba'ku addfirstcategorydate = true ordermethod = categoryadd </dpl>
lastedit:
- 2009-04-25 21:29:02 Category:Memory Alpha images (Ba'ku)
- 2010-08-01 05:20:22 Unnamed Ba'ku
- 2012-06-26 11:45:25 Sojef
- 2012-06-26 12:20:10 Ru'afo
- 2007-02-07 22:54:57 Artim
- 2007-02-07 22:56:16 Tournel
- 2007-02-07 22:54:40 Anij
- 2012-06-26 11:26:10 Gallatin
- 2020-11-23 19:57:30 Unnamed Son'a
categoryadd:
- 2007-02-07 22:54:40 Anij
- 2007-02-07 22:54:57 Artim
- 2007-02-07 22:56:16 Tournel
- 2009-04-25 21:29:02 Category:Memory Alpha images (Ba'ku)
- 2010-08-01 05:20:22 Unnamed Ba'ku
- 2012-06-26 11:26:10 Gallatin
- 2012-06-26 11:45:25 Sojef
- 2012-06-26 12:20:10 Ru'afo
- 2020-11-23 19:57:30 Unnamed Son'a
- order
- decides the sort direction. The value can be descending (default, most recent to oldest) or ascending (oldest to most recent).
<dpl> category = Ba'ku order = ascending </dpl>