diff options
Diffstat (limited to 'doc/tdeioslave/data/index.docbook')
| -rw-r--r-- | doc/tdeioslave/data/index.docbook | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/doc/tdeioslave/data/index.docbook b/doc/tdeioslave/data/index.docbook new file mode 100644 index 000000000..e88f4d5a1 --- /dev/null +++ b/doc/tdeioslave/data/index.docbook @@ -0,0 +1,73 @@ +<?xml version="1.0" ?> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE" > <!-- change language only here --> +]> + +<article lang="&language;" id="data"> +<title>Data URLs</title> + +<articleinfo> + +<authorgroup> +<author><personname><firstname>Leo</firstname><surname>Savernik</surname></personname> +</author> +<author>&tde-authors;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<releaseinfo>&tde-release-version;</releaseinfo> +<date>Reviewed: &tde-release-date;</date> + +<copyright> +<year>2003</year> +<holder>Leo Savernik</holder> +</copyright> +<copyright> +<year>&tde-copyright-date;</year> +<holder>&tde-team;</holder> +</copyright> + +<abstract> +<para> +This handbook describes the data protocol. +</para> +</abstract> + +<keywordset> +<keyword>TDE</keyword> +<keyword>data</keyword> +<keyword>protocol</keyword> +</keywordset> +</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> |