Ihor Radchenko <yanta...@posteo.net> writes:

> Joseph Turner <jos...@ushin.org> writes:
>
>>> I think, text/org may be added as well (without removing of
>>> text/x-org).
>>
>> Shall we consider this this after we find a way for these low-preference
>> mappings to be useful?
>
> If you mean "negotiate... to override "applicaion/vnd.lotus-organizer"
> with "text/org"", I have no objections.
>
>>> Perhaps a worg page may be created to clarify current state of media
>>> type for org files. The question is what is the appropriate directory.
>>
>> I agree that it would be good to track this information in one place so
>> we don't repeat ourselves ;)
>
> We can put such a page alongside /org-syntax.org, maybe even linked from
> there. Feel free to create such a page.

Would the following patch be appropriate?

Thanks!

Joseph

>From c898ba723faeb67929f52728c67e2b8858f99738 Mon Sep 17 00:00:00 2001
From: Joseph Turner <jos...@breatheoutbreathe.in>
Date: Fri, 9 Aug 2024 05:55:52 -0700
Subject: [PATCH] org-media-type.org: New file; Describe state of NodeJS MIME
 database

---
 org-media-type.org | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 org-media-type.org

diff --git a/org-media-type.org b/org-media-type.org
new file mode 100644
index 00000000..f5d69b7c
--- /dev/null
+++ b/org-media-type.org
@@ -0,0 +1,37 @@
+#+title: Org Media Type
+#+author: Joseph Turner
+#+options: toc:t ':t author:nil
+#+language: en
+#+category: worg
+#+bind: sentence-end-double-space t
+#+html_link_up:    index.html
+#+html_link_home:  https://orgmode.org/worg/
+
+#+begin_comment
+This file is released by its authors and contributors under the GNU
+Free Documentation license v1.3 or later, code examples are released
+under the GNU General Public License v3 or later.
+#+end_comment
+
+* Introduction
+
+This page tracks information about the ~.org~ extension media type.
+
+Based on [[https://yhetil.org/orgmode/6d94fff4-4d30-4121-bfd1-f267cb5b6...@gmail.com/][this thread on the Org mode mailing list]], the consensus is
+that the ~.org~ file extension should map to the ~text/org~ MIME type.
+
+Until the [[file:org-syntax.org][Org syntax spec]] is complete and a proposal submitted to and
+approved by IANA, we can ask downstream MIME libraries to override
+~applicaion/vnd.lotus-organizer~ with ~text/org~.
+
+* Downstream MIME Libraries
+
+** jshttp/mime-db - NodeJS
+
+[[https://github.com/jshttp/mime-db][jshttp/mime-db]] is the de facto standard MIME database for NodeJS.
+[[https://github.com/jshttp/mime-db/commit/5797174e5434a8d2978d9fdc13ec6a47ba20a02f][This commit]] adds a mapping from ~.org~ to ~text/x-org~, but the two
+popular NodeJS utilities for getting a MIME type from a file
+extension, [[https://github.com/jshttp/mime-types][jshttp/mime-types]] and [[https://github.com/broofa/mime][broofa/mime]], return
+~applicaion/vnd.lotus-organizer~.  Both libraries return only the
+highest preference media type, and IANA-sourced media types are
+preferred over other types.
-- 
2.41.0

Reply via email to