Variables de text d'una pàgina

Les variables de text d'una pàgina són variables de tipus cadena que es creen al text d'una pàgina (el que normalment s'edita), i es poden oferir automàticament per a ser incloses a altres pàgines.

Definició de Variables de Text d'una Pàgina

Hi ha tres modes per a definir Variables de Text d'una Pàgina automàticament:

• useu una llista de definicions - la sintaxis normal de les llistes de definicions crea una variable de text

:Nom: Definició del nom
"{$:Nom}"

• useu únicament el caràcter de dos punts (:) com a separador al text

Correu: meu@exemple.com

"{$:Correu}"

• amb el format d'una directiva oculta - etiquetes de PmWiki que no es renderitzen a la pàgina, però creen la variable

(:Pais: Països Catalans:)
"{$:Pais}"

Nota: Es desencoratja l'ús de caràcters fora de l'alfabet ASCII, per tant, no s'han d'usar caracters accentuats, la ce trencada, etc.

Ús

Ús a la mateixa pàgina

Quan esteu a la mateixa pàgina, podeu accedir a les variables de text mitjançant el format {$:Var} (mostrat a dalt).

Ús a les capçaleres i els peus de pàgina: referències especials

Si voleu que una pàgina del tipus GroupHeader, GroupFooter, SideBar, etc. accedeixi a una variable de text de la pàgina principal, heu d'incloure una informació de referència especial. Per a referir-vos explícitament a la variable de text de la pàgina que s'està mostrant afegiu un asterisc a l'etiqueta de la variable de text: {*$:Correu} a la pàgina GroupFooter o GroupHeader.

{*$:Ciutat}

Per a incloure una variable de text de la capçalera o del peu de pàgina vegeu més abaix l'ús des d'altres pàgines.

Ús des d'altres pàgines

Si voleu extreure les dades d'un altra pàgina, useu el format {Grup/NomPagina$:Var}.

Poble: Alcoi
(:Llac:L'estany pudent:)
:Muntanya:Penyagolosa

->"{PmWikiCa/PageTextVariables$:Poble}"
->"{{$FullName}$:Llac}"
->"{PmWikiCa/PageTextVariables$:Muntanya}"

Ús des de pàgines incloses

Les variables de text d'una pàgina mai s'inclouen des de la pàgina font. Vegeu dalt l'ús des d'altres pàgines per a fer referència a les variables de text d'altres pàgines.

Ús amb llistats de pàgines

Els Llistats de pàgines també poden accedir a les variables de text:

(:pagelist group=PmWikiCa order=$:Summary count=6 fmt=#singleline:)

I per a crear nous formats de llistats (com els que hi ha documentats a Site.Page List Templates, Page Lists, Page List Templates?, Page Variables?. Deseu-los a Site.Local Templates?).

Els Llistats de pàgines també poden usar variables de text d'una pàgina per a seleccionar les pàgines:

(:pagelist group=PmWiki $:Ciutat=Paris count=8 fmt=#singleline order=-name:)

(:pagelist group=PmWiki $:Ciutat="Addis Ababa,Paris" order=-$:Version count=8 fmt=#singleline:)

• Quan s'usen les variables de text per a la selecció o ordenació de pàgines, no cal ficar les claus ({,}) al voltant del nom de la variable. Les claus provoquen la substitució abans que s'avaluï l'ordre per a generar el llistat de pàgines.

Provar si la variable està definida o no

Consell : (:if ! equal "{$:PTV}" "":) comprovarà si PTV és buida/no-definida o no.

(:pagelist group=PmWikiCa $:Summary=-?* count=6  fmt=#singleline:)

Ús de les variables de text a les plantilles

Mostra les pàgines per la variable de text Audience.

>>comment<<
[[#byaudience]]
(:if ! equal '{=$:Audience}' '{<$:Audience}':)
-<'''{=$:Audience}''':  
(:ifend:)
[[{=$Name}]]
[[#byaudienceend]]
>><<
(:pagelist group=PmWikiCa count=10 fmt=#byaudience order=-$:Audience:)

Ús de variables de text amb Conditional Markup

Les variables de text d'una pàgina s'assignaran/avaluaran abans que s'avalui cap sentència condicional. Això vol dir que no es pot declarar un variable de text a dintre d'una condició if...else; i també que una variable tindrà un valor tot i haver estat definida dintre d'una sentència condicional (:if false:)....(:if:).

Ús - des de dintre de codi (només per a desenvolupadors)

La funció estàndard PageVar($pagename,$varname) pot tornar variables de text d'una pàgina, però recordeu incloure els dos punts i el símbol de dolar així:

Funciona llegint totes les variables (de text) que troba a una pàgina (a $PCache) i tornant la que s'ha demanat.

Traducció de PmWiki.PageTextVariables - Pàgina original a PmWikiCa.PageTextVariables - Backlinks