summaryrefslogtreecommitdiff
path: root/docutils/FAQ.txt
diff options
context:
space:
mode:
authorgoodger <goodger@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2005-08-26 14:29:20 +0000
committergoodger <goodger@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2005-08-26 14:29:20 +0000
commit73c906fee8239cec187994cf96b13cb72be250a9 (patch)
tree5411e17245c57f4e422a1c43eaa5a0ad1684ac9c /docutils/FAQ.txt
parentccd3e7fb389d00514b9d515d4dbc805d4b5ea173 (diff)
downloaddocutils-73c906fee8239cec187994cf96b13cb72be250a9.tar.gz
added entry on serving XHTML as "Content-type: text/html"
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@3835 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/FAQ.txt')
-rw-r--r--docutils/FAQ.txt32
1 files changed, 32 insertions, 0 deletions
diff --git a/docutils/FAQ.txt b/docutils/FAQ.txt
index c3504e74a..80895e633 100644
--- a/docutils/FAQ.txt
+++ b/docutils/FAQ.txt
@@ -902,6 +902,38 @@ returns a dictionary containing an 'html_body_' entry.
docs/api/publisher.html#html-body
+Why is the Docutils XHTML served as "Content-type: text/html"?
+--------------------------------------------------------------
+
+Full question:
+
+ Docutils' HTML output looks like XHTML and is advertised as such::
+
+ <?xml version="1.0" encoding="utf-8" ?>
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xht ml1/DTD/xhtml1-transitional.dtd">
+
+ But this is followed by::
+
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ Shouldn't this be "application/xhtml+xml" instead of "text/html"?
+
+In a perfect web, the Docutils XHTML output would be 100% strict
+XHTML. But it's not a perfect web, and a major source of imperfection
+is Internet Explorer. Despite it's drawbacks, IE still represents the
+majority of web browsers, and cannot be ignored.
+
+Short answer: if we didn't serve XHTML as "text/html" (which is a
+perfectly valid thing to do), it couldn't be viewed in Internet
+Explorer.
+
+Long answer: see the `"Criticisms of Internet Explorer" Wikipedia
+entry <http://en.wikipedia.org/wiki/Criticisms_of_Internet_Explorer#XHTML>`__.
+
+(Thanks to Martin F. Krafft, Robert Kern and Michael Foord.)
+
+
Python Source Reader
====================