• Anzeigen
• Bearbeiten
• Versionen
• Druckansicht
• Rückverweise

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

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

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

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.

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}.

Ú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:

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:

• 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.

Ús de les variables de text a les plantilles

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

Ús de variables de text amb ConditionalMarkup

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 - Rückverweise