MimeTypes.rdf: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
m (Removed redundancy between introductory paragraphs by my last edit)
(→‎Editing: added example from http://forums.mozillazine.org/viewtopic.php?t=580229#3033038)
Line 4: Line 4:


==Editing==
==Editing==
In general, it is not advisable to edit this file manually because of its complexity and the fact that interfaces are provided to edit it in Firefox and SeaMonkey. In Thunderbird, you ''may'' need to edit it manually if an entry is not shown due to [https://bugzilla.mozilla.org/show_bug.cgi?id=311138 bug 311138]).
In general, it is not advisable to edit this file manually because of its complexity and the fact that interfaces are provided to edit it in Firefox and SeaMonkey. In Thunderbird, you ''may'' need to edit it manually if an entry is not shown due to [https://bugzilla.mozilla.org/show_bug.cgi?id=311138 bug 311138]. Note that build-in handlers or plug-ins may have precedence over the settings in mimeTypes.rdf.


The file is an RDF document containing one RDF:Seq and many RDF:Descriptions (one for each [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types MIME type]). Each entry has an identifier - the attribute RDF:about. To delete an entry, delete both its RDF:li in the RDF:Seq and its RDF:Description. To change an entry, simply change the RDF:Description's attributes (do not change RDF:about). To add an entry, insert a new RDF:li into the RDF:Seq and create a new RDF:Description, making sure their identifiers match.
The file is an RDF document containing one RDF:Seq and many RDF:Descriptions (one for each [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types MIME type]). Each entry has an identifier - the attribute RDF:about. To delete an entry, delete both its RDF:li in the RDF:Seq and its RDF:Description. To change an entry, simply change the RDF:Description's attributes (do not change RDF:about). To add an entry, insert a new RDF:li into the RDF:Seq and create a new RDF:Description, making sure their identifiers match.
Line 23: Line 23:
** NC:editable
** NC:editable
** NC:prettyName
** NC:prettyName
===Example===
These entries result in "Paint" always to be used as the application to open PNG images on Windows. While this works with Thunderbird, it wouldn't have any effect in SeaMonkey as it has an internal mechanism to handle PNG files.
<pre>
<?xml version="1.0"?>
<RDF:RDF xmlns:NC="http://home.netscape.com/NC-rdf#"
        xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
  <RDF:Seq RDF:about="urn:mimetypes:root">
...
    <RDF:li RDF:resource="urn:mimetype:image/png"/>
...
  </RDF:Seq>
  <RDF:Description RDF:about="urn:mimetype:image/png"
                  NC:fileExtensions="png"
                  NC:description="PNG Image"
                  NC:value="image/png"
                  NC:editable="true">
    <NC:handlerProp RDF:resource="urn:mimetype:handler:image/png"/>
  </RDF:Description>
  <RDF:Description RDF:about="urn:mimetype:handler:image/png"
                  NC:alwaysAsk="false"
                  NC:saveToDisk="false"
                  NC:useSystemDefault="false"
                  NC:handleInternal="false">
    <NC:externalApplication RDF:resource="urn:mimetype:externalApplication:image/png"/>
  </RDF:Description>
  <RDF:Description RDF:about="urn:mimetype:externalApplication:image/png"
                  NC:path="C:\WINDOWS\system32\mspaint.exe"
                  NC:prettyName="mspaint.exe" />
</RDF:RDF>
</pre>


==Moving==
==Moving==

Revision as of 14:14, 30 August 2007

mimeTypes.rdf stores information about which action is to be performed when downloading certain types of files, such as opening the file in a specific program or saving it to disk. In Firefox and Thunderbird, this information can be viewed in Tools -> Options -> Downloads -> View & Edit Actions; in Mozilla Suite and SeaMonkey, in Edit -> Preferences -> Navigator -> Helper Applications.

Editing

In general, it is not advisable to edit this file manually because of its complexity and the fact that interfaces are provided to edit it in Firefox and SeaMonkey. In Thunderbird, you may need to edit it manually if an entry is not shown due to bug 311138. Note that build-in handlers or plug-ins may have precedence over the settings in mimeTypes.rdf.

The file is an RDF document containing one RDF:Seq and many RDF:Descriptions (one for each MIME type). Each entry has an identifier - the attribute RDF:about. To delete an entry, delete both its RDF:li in the RDF:Seq and its RDF:Description. To change an entry, simply change the RDF:Description's attributes (do not change RDF:about). To add an entry, insert a new RDF:li into the RDF:Seq and create a new RDF:Description, making sure their identifiers match.

Attributes

  • General
    • RDF:about - identifier
    • NC:description - the name of the file type that will be displayed on the download prompt
  • Choosing what to handle
    • NC:fileExtension - file extensions to handle (note that content downloaded from the Internet will go by MIME type, not by file extension)
    • NC:value - MIME type to handle
  • Choose how to handle it (absence of the following options means "download to disk")
    • NC:path - path of the application to use to open this file
    • NC:useSystemDefault - true (use the system default for this MIME type) or false (define a different action)
  • Additional options
    • NC:alwaysAsk - true (always ask which action to perform) or false (don't ask which action to perform)
  • Unknown
    • NC:editable
    • NC:prettyName

Example

These entries result in "Paint" always to be used as the application to open PNG images on Windows. While this works with Thunderbird, it wouldn't have any effect in SeaMonkey as it has an internal mechanism to handle PNG files.

<?xml version="1.0"?>
<RDF:RDF xmlns:NC="http://home.netscape.com/NC-rdf#"
         xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

  <RDF:Seq RDF:about="urn:mimetypes:root">
...
    <RDF:li RDF:resource="urn:mimetype:image/png"/>
...
  </RDF:Seq>

  <RDF:Description RDF:about="urn:mimetype:image/png"
                   NC:fileExtensions="png"
                   NC:description="PNG Image"
                   NC:value="image/png"
                   NC:editable="true">
    <NC:handlerProp RDF:resource="urn:mimetype:handler:image/png"/>
  </RDF:Description>

  <RDF:Description RDF:about="urn:mimetype:handler:image/png"
                   NC:alwaysAsk="false"
                   NC:saveToDisk="false"
                   NC:useSystemDefault="false"
                   NC:handleInternal="false">
    <NC:externalApplication RDF:resource="urn:mimetype:externalApplication:image/png"/>
  </RDF:Description>

  <RDF:Description RDF:about="urn:mimetype:externalApplication:image/png"
                   NC:path="C:\WINDOWS\system32\mspaint.exe"
                   NC:prettyName="mspaint.exe" />
</RDF:RDF>

Moving

This file can be moved to a different profile. If some MIME types specify a path for a program to use, this path must be correct on the destination profile's system.

Deleting

Deleting mimeTypes.rdf will clear the associations between MIME types and programs. A new file will be created on start up or when the application first needs to write to the file.

Related bugs

See also