Menu

#516 FAQ says MIME type for rst is text/x-rst but its source page is served as text/prs.fallenstein.rst

open
nobody
None
5
2026-01-11
2025-12-15
No

The Docutils FAQ says in section 2.24 https://docutils.sourceforge.io/FAQ.html#what-s-the-official-mime-type-for-restructuredtext-data:

[...] the "official unofficial" standard MIME type is "text/x-rst".

However, when following the "View document source" at the bottom of the page, I get a different MIME type:

$ curl -I https://docutils.sourceforge.io/FAQ.rst
HTTP/2 200 
date: Mon, 15 Dec 2025 07:20:49 GMT
content-type: text/prs.fallenstein.rst
[...]

Clearly, this is not what the FAQ says.

Discussion

  • Günter Milde

    Günter Milde - 2025-12-15

    Thank you for the information.
    According to the IANA entry, Benja Fallenstein registered the "rst" MIME type because:

    The registrant just happened to have need of a registered media type for it.
    --- https://www.iana.org/assignments/media-types/text/prs.fallenstein.rst

    So the actual error is not the quoted part of the FAQ answer, but

    ... there is no registered MIME type for reStructuredText, ....

    It seems that with the switch of the source file extension from ".txt" to ".rst" in August 2024 some applications started to use the registered MIME type when serving or analysing the source files.

     

    Last edit: Günter Milde 2025-12-16
  • Günter Milde

    Günter Milde - 2026-01-09

    The author/change controller writes in the registration:

    If anybody more intimately involved with ReStructuredText
    wants to take it over, it will be surrendered gladly.

    We may consider taking over as "change controller" and

    • keep the name as text/prs.fallenstein.rst
      (never touch a running system),
    • change the name to text/prs.docutils.rst
      (simple registration in the Personal Registration Tree), or
    • try to register as text/rst
      (official registry, requires publication of an RFC)
     
  • Günter Milde

    Günter Milde - 2026-01-11

    Commit [r10290] updates the FAQ answer to document the 3rd party entry "text/prs.fallenstein.rst"

     

    Related

    Commit: [r10290]


Log in to post a comment.

MongoDB Logo MongoDB