diff options
Diffstat (limited to 'doc/kioslave/data.docbook')
| -rw-r--r-- | doc/kioslave/data.docbook | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/kioslave/data.docbook b/doc/kioslave/data.docbook new file mode 100644 index 000000000..ca0e4e9a5 --- /dev/null +++ b/doc/kioslave/data.docbook @@ -0,0 +1,47 @@ +<article lang="&language;" id="data"> +<title>Data URLs</title> + +<articleinfo> +<authorgroup> +<author><personname><firstname>Leo</firstname><surname>Savernik</surname></personname> +<address><email>[email protected]</email></address> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2003-02-06</date> +<!--releaseinfo>2.20.00</releaseinfo--> + +</articleinfo> + +<para>Data URLs allow small document data to be included in the URL itself. +This is useful for very small HTML testcases or other occasions that do not +justify a document of their own.</para> + +<para><userinput>data:,foobar</userinput> +(note the comma after the colon) will deliver a text document that contains +nothing but <literal>foobar</literal> +</para> + +<para>The last example delivered a text document. For HTML documents one +has to specify the MIME type <literal>text/html</literal>: +<userinput>data:text/html,<title>Testcase</title><p>This +is a testcase</p></userinput>. This will produce exactly the same +output as if the content had been loaded from a document of its own. +</para> + +<para>Specifying alternate character sets is also possible. Note that 8-Bit +characters have to be escaped by a percentage sign and their two-digit +hexadecimal codes: +<userinput>data:;charset=iso-8859-1,Gr%FC%DFe aus Schl%E4gl</userinput> +results in +<literal>Grüße aus Schlägl</literal> +whereas omitting the charset attribute might lead to something like +<literal>Gr??e aus Schl?gl</literal> +</para> + +<para><ulink url="http://www.ietf.org/rfc/rfc2397.txt">IETF +RFC2397</ulink> provides more information.</para> + +</article> + |