PmWiki.PageTextVariables History
Hide minor edits - Show changes to markup
(:Summary:Page variables automatically made available through natural or explicit page markup:)
Page text variables are string variables created in the wiki text of a page, and can be automatically made available for inclusion in other pages.
Defining Page Text Variables
There are three ways to define automated Page Text Variables:
- use a definition list - the normal pmwiki markup for a definition list will create a page text variable
(:markup caption='Example definition list:' class="horiz":)
- Name
- Crisses
"Crisses" (:markupend:)
{$:Name} (becomes: "Crisses") in the page.
- use a simple colon delimiter in normal text
(:markup caption='Example colon delimited:' class="horiz":) Address: 1313 Mockingbird Lane
"1313 Mockingbird Lane" (:markupend:)
{$:Address} variable (variable markup becomes: "1313 Mockingbird Lane") in the page.
(:markup caption='Example directive:' class="horiz":) (:Country: Transylvania :) "Transylvania " (:markupend:)
{$:Country} variable (variable markup becomes: "Transylvania ") in the page.
Usage
Usage on the same page
On the same page you can resolve page text variables through the {$:Var} format (shown above).
Usage in headers and footers: special references
If you want a Group Header, Group Footer, Side Bar?, etc to call on page text variable in the main page, you need to include special reference information.
To explicitly reference the page text variable from the page being displayed add an asterisk to the page text variable's markup: {*$:Address} on the Group Footer or Group Header page.
(:markup caption='Example' class=horiz:)
(:markupend:)
To include a page text variable from a header or footer see usage from other pages below.
Usage from other pages
If you want to pull the data from another page, use the {Group/PageName$:Var} format.
(:markup caption='Example:' class="horiz":)
Suburb: Khandallah
(:Lake:Taupo:)
- Mountain
- Mt Ruapehu
(:markupend:)
Usage from included pages
Page text variables are never included from their source page. See Usage from other pages above to refer to a page text variable on another page.
Usage with pagelists
Page lists can also access the page text variables: (:markup caption='Example:' class="horiz":) (:pagelist group=PmWiki order=$:Summary count=6 fmt=#singleline:) (:markupend:)
And to create pagelist formats (such as those documented at Site.Page List Templates, Page Lists, Page List Templates, Page Variables. Store custom pagelists at Site.Local Templates?).
Page lists can also use page text variables to select pages : (:markup caption='Example:' class="horiz":) (:pagelist group=PmWiki $:City=Paris count=8 fmt=#singleline order=-name:) (:markupend:)
(:markup caption='Example: multiple selections with spaces' class="horiz":) (:pagelist group=PmWiki $:City="Addis Ababa,Paris" order=-$:Version count=8 fmt=#singleline:) (:markupend:)
- When using page text variables for selection or ordering, don't put the curly braces around the variable name. The curly forms do a replacement before the pagelist command is evaluated.
Testing if set or not set
| =- | PTV is set (is not empty), eg (:pagelist $:Var=- :) |
| =-?* | PTV is not set (is empty), ie not one character followed by 0 or more characters, eg. (:pagelist $:Var=-?* :) |
| =* | display all pages, regardless of the page text variable (slow) |
| =-* | display no pages, regardless of the page text variable (slow) |
Tip : (:if ! equal "{$:PTV}" "":) will test if PTV is empty/unset or not.
(:markup caption='Example: Pages without a summary' class="horiz":) (:pagelist group=PmWiki $:Summary=-?* count=6 fmt=#singleline:) (:markupend:)
Use page text variable in a template
Display pages by Audience page text variable. (:markup caption='Example:' class="horiz":)
(:pagelist group=PmWiki count=10 fmt=#byaudience order=-$:Audience:) (:markupend:)
Use page text variables in conditional markup
Page text variables will be assigned/evaluated before any conditional markup is evaluated. This effectively means that you cannot declare a PTV within an if...else condition; and also that a PTV will have a value even if it is set within a (:if false:)....(:if:) condition.
Usage - from within code (developers only)
The standard Page Var?($pagename,$varname) function can return page text variables, but remember to include the dollar and colon like this:
It works by caching all page (text) variables it finds in a page (in $PCache) and returns the one requested.
Cool how an Ardent 2.4 fits out back !Big tick for a dually.Got some of the Ardents after ctoemnms here and very pleased. Nice soft and damped compound and both grippy and fast enough for me.Also great to see R1 specced OEM. Apart from tiny and soft clamp bolts their quality of manuafcture and performance outsines old Avid juicy ultimates at least. I rekon similar performance to new Elixir's but better finish.
(:Summary:Page variables automatically made available through natural or explicit page markup:)
Page text variables are string variables created in the wiki text of a page, and can be automatically made available for inclusion in other pages.
Defining Page Text Variables
There are three ways to define automated Page Text Variables:
- use a definition list - the normal pmwiki markup for a definition list will create a page text variable
(:markup caption='Example definition list:' class="horiz":)
- Name
- Crisses
"Crisses" (:markupend:)
{$:Name} (becomes: "Crisses") in the page.
- use a simple colon delimiter in normal text
(:markup caption='Example colon delimited:' class="horiz":) Address: 1313 Mockingbird Lane
"1313 Mockingbird Lane" (:markupend:)
{$:Address} variable (variable markup becomes: "1313 Mockingbird Lane") in the page.
(:markup caption='Example directive:' class="horiz":) (:Country: Transylvania :) "Transylvania " (:markupend:)
{$:Country} variable (variable markup becomes: "Transylvania ") in the page.
Usage
Usage on the same page
On the same page you can resolve page text variables through the {$:Var} format (shown above).
Usage in headers and footers: special references
If you want a Group Header, Group Footer, Side Bar?, etc to call on page text variable in the main page, you need to include special reference information.
To explicitly reference the page text variable from the page being displayed add an asterisk to the page text variable's markup: {*$:Address} on the Group Footer or Group Header page.
(:markup caption='Example' class=horiz:)
(:markupend:)
To include a page text variable from a header or footer see usage from other pages below.
Usage from other pages
If you want to pull the data from another page, use the {Group/PageName$:Var} format.
(:markup caption='Example:' class="horiz":)
Suburb: Khandallah
(:Lake:Taupo:)
- Mountain
- Mt Ruapehu
(:markupend:)
Usage from included pages
Page text variables are never included from their source page. See Usage from other pages above to refer to a page text variable on another page.
Usage with pagelists
Page lists can also access the page text variables: (:markup caption='Example:' class="horiz":) (:pagelist group=PmWiki order=$:Summary count=6 fmt=#singleline:) (:markupend:)
And to create pagelist formats (such as those documented at Site.Page List Templates, Page Lists, Page List Templates, Page Variables. Store custom pagelists at Site.Local Templates?).
Page lists can also use page text variables to select pages : (:markup caption='Example:' class="horiz":) (:pagelist group=PmWiki $:City=Paris count=8 fmt=#singleline order=-name:) (:markupend:)
(:markup caption='Example: multiple selections with spaces' class="horiz":) (:pagelist group=PmWiki $:City="Addis Ababa,Paris" order=-$:Version count=8 fmt=#singleline:) (:markupend:)
- When using page text variables for selection or ordering, don't put the curly braces around the variable name. The curly forms do a replacement before the pagelist command is evaluated.
Testing if set or not set
| =- | PTV is set (is not empty), eg (:pagelist $:Var=- :) |
| =-?* | PTV is not set (is empty), ie not one character followed by 0 or more characters, eg. (:pagelist $:Var=-?* :) |
| =* | display all pages, regardless of the page text variable (slow) |
| =-* | display no pages, regardless of the page text variable (slow) |
Tip : (:if ! equal "{$:PTV}" "":) will test if PTV is empty/unset or not.
(:markup caption='Example: Pages without a summary' class="horiz":) (:pagelist group=PmWiki $:Summary=-?* count=6 fmt=#singleline:) (:markupend:)
Use page text variable in a template
Display pages by Audience page text variable. (:markup caption='Example:' class="horiz":)
(:pagelist group=PmWiki count=10 fmt=#byaudience order=-$:Audience:) (:markupend:)
Use page text variables in conditional markup
Page text variables will be assigned/evaluated before any conditional markup is evaluated. This effectively means that you cannot declare a PTV within an if...else condition; and also that a PTV will have a value even if it is set within a (:if false:)....(:if:) condition.
Usage - from within code (developers only)
The standard Page Var?($pagename,$varname) function can return page text variables, but remember to include the dollar and colon like this:
It works by caching all page (text) variables it finds in a page (in $PCache) and returns the one requested.
Cool how an Ardent 2.4 fits out back !Big tick for a dually.Got some of the Ardents after ctoemnms here and very pleased. Nice soft and damped compound and both grippy and fast enough for me.Also great to see R1 specced OEM. Apart from tiny and soft clamp bolts their quality of manuafcture and performance outsines old Avid juicy ultimates at least. I rekon similar performance to new Elixir's but better finish.