70 lines
2.5 KiB
Plaintext
70 lines
2.5 KiB
Plaintext
|
head 1.2;
|
||
|
|
access;
|
||
|
|
symbols;
|
||
|
|
locks; strict;
|
||
|
|
comment @# @;
|
||
|
|
|
||
|
|
|
||
|
|
1.2
|
||
|
|
date 2007.01.16.04.11.56; author TWikiContributor; state Exp;
|
||
|
|
branches;
|
||
|
|
next 1.1;
|
||
|
|
|
||
|
|
1.1
|
||
|
|
date 2006.06.25.16.26.28; author TWikiContributor; state Exp;
|
||
|
|
branches;
|
||
|
|
next ;
|
||
|
|
|
||
|
|
|
||
|
|
desc
|
||
|
|
@buildrelease
|
||
|
|
@
|
||
|
|
|
||
|
|
|
||
|
|
1.2
|
||
|
|
log
|
||
|
|
@buildrelease
|
||
|
|
@
|
||
|
|
text
|
||
|
|
@%META:TOPICINFO{author="TWikiContributor" date="1167874036" format="1.2" version="2"}%
|
||
|
|
%META:TOPICPARENT{name="TWikiVariables"}%
|
||
|
|
#VarENCODE
|
||
|
|
|
||
|
|
---+++ ENCODE{"string"} -- encodes a string to HTML entities
|
||
|
|
* Encode "special" characters to HTML numeric entities. Encoded characters are:
|
||
|
|
* all non-printable ASCII characters below space, except newline (="\n"=) and linefeed (="\r"=)
|
||
|
|
* HTML special characters ="<"=, =">"=, ="&"=, single quote (='=) and double quote (="=)
|
||
|
|
* TWiki special characters ="%"=, ="["=, ="]"=, ="@@"=, ="_"=, ="*"=, ="="= and ="|"=
|
||
|
|
* Syntax: =%<nop>ENCODE{"string"}%=
|
||
|
|
* Supported parameters:
|
||
|
|
| *Parameter:* | *Description:* | *Default:* |
|
||
|
|
| ="string"= | String to encode | required (can be empty) |
|
||
|
|
| =type="entity"= | Encode special characters into HTML entities, like a double quote into =&#034;=. Does *not* encode =\n= or =\r=. | =type="url"= |
|
||
|
|
| =type="html"= | As =type="entity"= except it also encodes =\n= and =\r= | =type="url"= |
|
||
|
|
| =type="quote"= | Escape double quotes with backslashes (=\"=), does not change other characters | =type="url"= |
|
||
|
|
| =type="url"= | Encode special characters for URL parameter use, like a double quote into =%22= | (this is the default) |
|
||
|
|
* Example: =%<nop>ENCODE{"spaced name"}%= expands to =%ENCODE{"spaced name"}%=
|
||
|
|
* __%X% Note:__ Values of HTML input fields must be entity encoded.%BR% Example: =<input type="text" name="address" value="%<nop>ENCODE{ "any text" type="entity" }%" />=
|
||
|
|
* __%X% Note:__ Double quotes in strings must be escaped when passed into other TWiki variables.%BR% Example: =%<nop>SEARCH{ "%<nop>ENCODE{ "string with "quotes"" type="quotes" }%" noheader="on" }%=
|
||
|
|
|
||
|
|
* Related: [[#VarURLPARAM][URLPARAM]]
|
||
|
|
|
||
|
|
@
|
||
|
|
|
||
|
|
|
||
|
|
1.1
|
||
|
|
log
|
||
|
|
@buildrelease
|
||
|
|
@
|
||
|
|
text
|
||
|
|
@d1 1
|
||
|
|
a1 1
|
||
|
|
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.2" version="1"}%
|
||
|
|
d14 3
|
||
|
|
a16 1
|
||
|
|
| =type="entity"= | Encode special characters into HTML entities, like a double quote into =&#034;= | URL encoding |
|
||
|
|
d19 3
|
||
|
|
a21 1
|
||
|
|
* __%X% Note:__ Values of HTML input fields must be entity encoded, for example:%BR% =<input type="text" name="address" value="%<nop>ENCODE{ "any text" type="entity" }%" />=
|
||
|
|
@
|