Template:FormatInfo
From Just Solve the File Format Problem
(Difference between revisions)
m |
Dan Tobias (Talk | contribs) |
||
(83 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
− | <table class="infobox formatinfo" border="0" style="float: right; border: 1px solid #666666; max-width: | + | <table class="infobox formatinfo" border="0" style="float: right; border: 1px solid #666666; max-width: 25%; overflow: hidden; background-color:{{#switch: {{{formattype}}} |
− | {{FormatInfo/row|Name|{{{name|<includeonly>{{PAGENAME}}</includeonly>}}}}} | + | |electronic=#F8E0F7 |
− | {{#if:{{{extensions|}}}| | + | |physical=#F6E3CE |
− | {{FormatInfo/row|Extension(s)|{{{extensions}}}}} | + | |organic=#CEF6CE |
− | }}{{#if:{{{mimetypes|}}}| | + | |Languages=#CEE3F6 |
− | {{FormatInfo/row|MIME Type(s)|{{{mimetypes}}}}} | + | |#F8E0F7 |
+ | }}; | ||
+ | padding: 0.25em; margin: 0.25em 1em;"> | ||
+ | <tr> | ||
+ | <th colspan="2">[[File Formats|File Format]]<includeonly>[[Category:File Formats]]</includeonly></th> | ||
+ | </tr> | ||
+ | {{FormatInfo/row|Name|{{{name|{{PAGENAME}}}}}{{DEFAULTSORT:{{{name|{{PAGENAME}}}}}}}}} | ||
+ | {{FormatInfo/row | ||
+ | | Ontology | ||
+ | | | ||
+ | <ul><li> | ||
+ | {{#switch: {{{formattype}}} | ||
+ | |electronic=[[Electronic File Formats]]<includeonly>[[Category:Electronic File Formats]]</includeonly> | ||
+ | |physical=[[Physical File Formats]]<includeonly>[[Category:Physical File Formats]]</includeonly> | ||
+ | |organic=[[Organic File Formats]]<includeonly>[[Category:Organic File Formats]]</includeonly> | ||
+ | |[[{{{formattype|Electronic File Formats}}}]]<includeonly>[[Category:{{{formattype|Electronic File Formats}}}]]</includeonly> | ||
+ | }} | ||
+ | <ul><li> | ||
+ | {{#if:{{{subcat|}}} | ||
+ | |[[{{{subcat}}}]]<includeonly>[[Category:{{{subcat}}}]]</includeonly> | ||
+ | <ul><li> | ||
+ | {{#if:{{{subcat2|}}} | ||
+ | |[[{{{subcat2}}}]]<includeonly>[[Category:{{{subcat2}}}]]</includeonly> | ||
+ | <ul><li> | ||
+ | {{#if:{{{subcat3|}}} | ||
+ | |[[{{{subcat3}}}]]<includeonly>[[Category:{{{subcat3}}}]]</includeonly> | ||
+ | <ul><li> | ||
+ | {{#if:{{{subcat4|}}} | ||
+ | |[[{{{subcat4}}}]]<includeonly>[[Category:{{{subcat4}}}]]</includeonly> | ||
+ | <ul><li> | ||
+ | {{#if:{{{subcat5|}}} | ||
+ | |[[{{{subcat5}}}]]<includeonly>[[Category:{{{subcat5}}}]]</includeonly> | ||
+ | <ul><li> | ||
+ | {{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | </li></ul> | ||
+ | |{{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | }} | ||
+ | </li></ul> | ||
+ | |{{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | }} | ||
+ | </li></ul> | ||
+ | |{{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | }} | ||
+ | </li></ul> | ||
+ | |{{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | }} | ||
+ | </li></ul> | ||
+ | |{{#if:{{{thiscat|}}}|[[{{{thiscat}}}]]<includeonly>[[Category:{{{thiscat}}}| ]]</includeonly>|[[{{{name|{{PAGENAME}}}}}]]}} | ||
+ | }} | ||
+ | </li></ul> | ||
+ | </li></ul> | ||
+ | }}{{#if:{{{extensions|{{{extension|}}}}}}| | ||
+ | {{FormatInfo/row|[[Filename extension|Extension(s)]]|{{{extensions|{{{extension}}}}}}}} | ||
+ | }}{{#if:{{{mimetypes|{{{mimetype|}}}}}}| | ||
+ | {{FormatInfo/row|[[MIME types|MIME Type(s)]]|{{{mimetypes|{{{mimetype}}}}}}}} | ||
+ | }}{{#if:{{{locfdd|}}}| | ||
+ | {{FormatInfo/row|LoCFDD|{{{locfdd}}}}} | ||
}}{{#if:{{{fourccs|}}}| | }}{{#if:{{{fourccs|}}}| | ||
− | {{FormatInfo/row|FourCC|{{{fourccs}}}}} | + | {{FormatInfo/row|[[FourCC]]|{{{fourccs}}}}} |
}}{{#if:{{{pronom|}}}| | }}{{#if:{{{pronom|}}}| | ||
− | {{FormatInfo/row|PRONOM|[http:// | + | {{FormatInfo/row|[[PRONOM]]|{{{pronom}}}}} |
+ | }}{{#if:{{{type code|}}}| | ||
+ | {{FormatInfo/row|[[Macintosh type/creator code|Type Code]]|{{{type code}}}}} | ||
+ | }}{{#if:{{{uniform type|}}}| | ||
+ | {{FormatInfo/row|[[Uniform Type Identifier|UTI]]|{{{uniform type}}}}} | ||
+ | }}{{#if:{{{wikidata|}}}| | ||
+ | {{FormatInfo/row|[[Wikidata identifier|Wikidata ID]]|{{{wikidata}}}}} | ||
+ | }}{{#if:{{{compression|}}}| | ||
+ | {{FormatInfo/row|[[Compression]]|{{{compression}}}}} | ||
+ | }}{{#if:{{{extended from|}}}| | ||
+ | {{FormatInfo/row|Extended From|[[{{{extended from}}}]]}} | ||
+ | }}{{#if:{{{extended to|}}}| | ||
+ | {{FormatInfo/row|Extended To|[[{{{extended to}}}]]}} | ||
+ | }}{{#if:{{{magic|}}}| | ||
+ | {{FormatInfo/row|[[Magic]] Bytes|{{{magic}}}}} | ||
+ | }}{{#if:{{{kaitai struct|}}}| | ||
+ | {{FormatInfo/row|[[Kaitai Struct|Kaitai Struct Spec]]|[http://formats.kaitai.io/{{{kaitai struct}}}/index.html {{{kaitai struct}}}.ksy]}} | ||
+ | }}{{#if:{{{spec|}}}| | ||
+ | {{FormatInfo/row|Spec|{{{spec}}}}} | ||
+ | }}{{#if:{{{spec availability|}}}| | ||
+ | {{FormatInfo/row|Spec Availability|{{{spec availability}}}}} | ||
+ | }}{{#if:{{{reference impl|}}}| | ||
+ | {{FormatInfo/row|Reference Implementation|{{{reference impl}}}}} | ||
+ | }}{{#if:{{{conforms to|}}}| | ||
+ | {{FormatInfo/row|Conforms To|{{{conforms to}}}}} | ||
+ | }}{{#if:{{{charset|}}}| | ||
+ | {{FormatInfo/row|[[IANA character set name|IANA charset]]|[http://www.iana.org/assignments/charset-reg/{{{charset}}} {{{charset}}}]}} | ||
+ | }}{{#if:{{{charsetaliases|}}}| | ||
+ | {{FormatInfo/row|IANA aliases|{{{charsetaliases}}}}} | ||
+ | }}{{#if:{{{mibenum|}}}| | ||
+ | {{FormatInfo/row|IANA MIBenum|{{{mibenum}}}}} | ||
+ | }}{{#if:{{{codepage|}}}| | ||
+ | {{FormatInfo/row|[[Code page identifier|Code Page]]|{{{codepage}}}}} | ||
+ | }}{{#if:{{{cfstringencoding|}}}| | ||
+ | {{FormatInfo/row|CFStringEncoding|{{{cfstringencoding}}}}} | ||
+ | }}{{#if:{{{nsstringencoding|}}}| | ||
+ | {{FormatInfo/row|NSStringEncoding|{{{nsstringencoding}}}}} | ||
+ | }}{{#if:{{{endianness|}}}| | ||
+ | {{FormatInfo/row|[[Endianness]]|{{{endianness}}}}} | ||
+ | }}{{#if:{{{tpm|}}}| | ||
+ | {{FormatInfo/row|TPM|{{{tpm}}}}} | ||
+ | }}{{#if:{{{error resilience|}}}| | ||
+ | {{FormatInfo/row|Error Resilience|{{{error resilience}}}}} | ||
+ | }}{{#if:{{{patent license|}}}| | ||
+ | {{FormatInfo/row|Patent License|{{{patent license}}}}} | ||
+ | }}{{#if:{{{developed by|}}}| | ||
+ | {{FormatInfo/row|Developed By|{{{developed by}}}}} | ||
+ | }}{{#if:{{{maintained by|}}}| | ||
+ | {{FormatInfo/row|Maintained By|{{{maintained by}}}}} | ||
+ | }}{{#if:{{{released|}}}| | ||
+ | {{FormatInfo/row|Released|{{{released}}}}} | ||
+ | }} | ||
+ | {{#if:{{{image|}}}| | ||
+ | <tr><td align="center" colspan="2"> | ||
+ | [[Image:{{{image}}}|200px|{{{caption}}}]] | ||
+ | </td></tr> | ||
+ | }} | ||
+ | {{#if:{{{caption|}}}| | ||
+ | <tr><td align="center" colspan="2"> | ||
+ | <small>{{{caption}}}</small> | ||
+ | </td></tr> | ||
}} | }} | ||
</table> | </table> | ||
+ | <includeonly>{{#if:{{{formattype|}}}||[[Category:FormatInfo without formattype]]}}{{#if:{{{subcat|}}}||[[Category:FormatInfo without subcat]]}}{{#ifeq:{{{formattype|electronic}}}|electronic|{{#if:{{{extensions|}}}||[[Category:FormatInfo without extensions]]}}{{#if:{{{mimetypes|}}}||[[Category:FormatInfo without mimetypes]]}}|}}</includeonly><noinclude> | ||
+ | == Usage == | ||
+ | <pre> | ||
+ | {{FormatInfo | ||
+ | | name = | ||
+ | | formattype = | ||
+ | | subcat = | ||
+ | | subcat2 = | ||
+ | | subcat3 = | ||
+ | | subcat4 = | ||
+ | | subcat5 = | ||
+ | | thiscat = | ||
+ | | extensions = | ||
+ | | mimetypes = | ||
+ | | locfdd = | ||
+ | | fourccs = | ||
+ | | pronom = | ||
+ | | type code = | ||
+ | | uniform type = | ||
+ | | wikidata = | ||
+ | | compression = | ||
+ | | extended from = | ||
+ | | extended to = | ||
+ | | magic = | ||
+ | | kaitai struct = | ||
+ | | spec = | ||
+ | | spec availability= | ||
+ | | reference impl = | ||
+ | | conforms to = | ||
+ | | charset = | ||
+ | | charsetaliases = | ||
+ | | codepage = | ||
+ | | mibenum = | ||
+ | | cfstringencoding = | ||
+ | | nsstringencoding = | ||
+ | | endianness = | ||
+ | | tpm = | ||
+ | | error resilience = | ||
+ | | patent license = | ||
+ | | developed by = | ||
+ | | maintained by = | ||
+ | | released = | ||
+ | | image = | ||
+ | | caption = | ||
+ | }} | ||
+ | </pre> | ||
+ | |||
+ | ===Parameters=== | ||
+ | ;name: '''(optional)''' The name of the file format. ''Default: <nowiki>{{PAGENAME}}</nowiki>'' | ||
+ | ;formattype: '''(optional)''' The [[File Formats|type]] of the file format. Choose 'electronic', 'physical', or 'organic', or specify your own. ''Default: electronic'' | ||
+ | ;subcat: '''(optional)''' The subcategory of the file format. | ||
+ | ;subcat2: '''(optional)''' An additional subcategory of the file format. | ||
+ | ;subcat3: '''(optional)''' An additional subcategory of the file format. | ||
+ | ;subcat4: '''(optional)''' An additional subcategory of the file format. | ||
+ | ;subcat5: '''(optional)''' An additional subcategory of the file format. | ||
+ | ;thiscat: '''(optional)''' Special parameter for indicating ontology of a non-terminal subcategory page. | ||
+ | ;extensions: '''(optional)''' The format's known filename extensions. Use [[Template:ext|<nowiki>{{ext}}</nowiki>]], or [[Template:Noext|<nowiki>{{Noext}}</nowiki>]] if it is known to be extensionless. | ||
+ | ;mimetypes: '''(optional)''' The MIME type of the format. Use [[Template:mimetype|<nowiki>{{mimetype}}</nowiki>]]. | ||
+ | ;locfdd: '''(optional)''' Identifier for this format from the Library of Congress Sustainability of Digital Formats, e.g. "fdd000314". Use [[Template:LoCFDD|<nowiki>{{LoCFDD}}</nowiki>]]. | ||
+ | ;fourccs: '''(optional)''' FourCC code | ||
+ | ;pronom: '''(optional)''' The [[Sources/PRONOM|PRONOM]] ID of the format, e.g. "fmt/45". Use [[Template:PRONOM|<nowiki>{{PRONOM}}</nowiki>]]. | ||
+ | ;type code: '''(optional)''' The Type Code of the file, used by Mac OS Classic. Use [[Template:Type Code|<nowiki>{{Type Code}}</nowiki>]]. | ||
+ | ;uniform type: '''(optional)''' The Uniform Type Identifier (UTI), used by Mac OS X and iOS. Use [[Template:UTI|<nowiki>{{UTI}}</nowiki>]]. | ||
+ | ;wikidata: '''(optional)''' Wikidata title ID. Use [[Template:wikidata|<nowiki>{{wikidata}}</nowiki>]]. | ||
+ | ;compression: Types of compression. Whether Lossy, Lossless, or Both, and whether Optional or Always compressed. i.e. JPEG is Always Lossy. | ||
+ | ;extended from: Any formats this one was based upon. | ||
+ | ;extended to: Any formats that have been derived from this one. | ||
+ | ;magic: A sequence of byte values that can be used to identify the file contents, usually located close to the start of the file. | ||
+ | ;kaitai struct: '''(optional)''' An identifier of a format at [http://formats.kaitai.io Kaitai Struct] project, e.g. "ico" would result in a link to http://formats.kaitai.io/ico/index.html generated. | ||
+ | ;spec: URL of the format specification. | ||
+ | ;spec availability: Type of availability the specification, e.g. commercial, free. | ||
+ | ;reference impl: Link to page about the reference implementation of this format, if any. | ||
+ | ;conforms to: '''(optional)''' The UTI of the parent format in the conformance hierarchy. | ||
+ | ;charset: '''(optional)''' For character encodings: IANA charset parameter value. | ||
+ | ;charsetaliases: '''(optional)''' For character encodings: Variant IANA charset parameter values. | ||
+ | ;codepage: '''(optional)''' For character encodings: Code page number (IBM/MS). | ||
+ | ;mibenum: '''(optional)''' For character encodings: IANA MIBenum. | ||
+ | ;cfstringencoding: '''(optional)''' For character encodings: CFStringEncoding. | ||
+ | ;nsstringencoding: '''(optional)''' For character encodings: NSStringEncoding. | ||
+ | ;endianness: Big-endian or Little-endian byte ordering. | ||
+ | ;tpm: Technical Protection Mechanisms supported by the format, e.g. encryption. | ||
+ | ;error resilience: Is this format able to detect damage or recover from damage to the bitstream. | ||
+ | ;patent license: Unknown, Disputed, Encumbered, (F)RAND, Royalty-Free, Unencumbered. | ||
+ | ;developed by: Who developed the format. | ||
+ | ;maintained by: Who now maintains the format. | ||
+ | ;released: '''(optional)''' The date the format was publicly released. | ||
+ | ;image: '''(optional)''' Illustration to show in infobox. | ||
+ | ;caption: '''(optional)''' Caption for image | ||
+ | |||
+ | ===Potential Parameters=== | ||
+ | This is a list of parameters that could be included in this template. | ||
+ | |||
+ | ;mime & mime aliases: Split mimetypes into primary type and known aliases. | ||
+ | ;version: The version of the format, e.g. "1.4" for PDF 1.4 | ||
+ | ;previous version: Link to page about the previous version of this format. | ||
+ | ;next version: Link to page about the next version of this format. | ||
+ | ;back compat: Whether this version is backwards compatible with the previous version. | ||
+ | ;wikipedia: Name of the Wikipedia page that describes this format, e.g. "JPEG 2000" will be rendered as [[Wikipedia:JPEG 2000|JPEG 2000]] | ||
+ | ;container for: A list of formats this format can contain. | ||
+ | ;contained by: A list of formats that may contain this format. | ||
+ | ;embeddable metadata: Kinds of metadata that can be embedded in this format. | ||
+ | ;dependencies: External resources that files in this format may depend upon, e.g. fonts, or even hardware. | ||
+ | ;namespace: The namespace-uri that defines the file format if it is XML-based. | ||
+ | |||
+ | ==Examples== | ||
+ | |||
+ | |||
+ | [[Category:File Formats| ]] | ||
+ | </noinclude> |
Latest revision as of 06:18, 12 June 2021
Contents |
[edit] Usage
{{FormatInfo | name = | formattype = | subcat = | subcat2 = | subcat3 = | subcat4 = | subcat5 = | thiscat = | extensions = | mimetypes = | locfdd = | fourccs = | pronom = | type code = | uniform type = | wikidata = | compression = | extended from = | extended to = | magic = | kaitai struct = | spec = | spec availability= | reference impl = | conforms to = | charset = | charsetaliases = | codepage = | mibenum = | cfstringencoding = | nsstringencoding = | endianness = | tpm = | error resilience = | patent license = | developed by = | maintained by = | released = | image = | caption = }}
[edit] Parameters
- name
- (optional) The name of the file format. Default: {{PAGENAME}}
- formattype
- (optional) The type of the file format. Choose 'electronic', 'physical', or 'organic', or specify your own. Default: electronic
- subcat
- (optional) The subcategory of the file format.
- subcat2
- (optional) An additional subcategory of the file format.
- subcat3
- (optional) An additional subcategory of the file format.
- subcat4
- (optional) An additional subcategory of the file format.
- subcat5
- (optional) An additional subcategory of the file format.
- thiscat
- (optional) Special parameter for indicating ontology of a non-terminal subcategory page.
- extensions
- (optional) The format's known filename extensions. Use {{ext}}, or {{Noext}} if it is known to be extensionless.
- mimetypes
- (optional) The MIME type of the format. Use {{mimetype}}.
- locfdd
- (optional) Identifier for this format from the Library of Congress Sustainability of Digital Formats, e.g. "fdd000314". Use {{LoCFDD}}.
- fourccs
- (optional) FourCC code
- pronom
- (optional) The PRONOM ID of the format, e.g. "fmt/45". Use {{PRONOM}}.
- type code
- (optional) The Type Code of the file, used by Mac OS Classic. Use {{Type Code}}.
- uniform type
- (optional) The Uniform Type Identifier (UTI), used by Mac OS X and iOS. Use {{UTI}}.
- wikidata
- (optional) Wikidata title ID. Use {{wikidata}}.
- compression
- Types of compression. Whether Lossy, Lossless, or Both, and whether Optional or Always compressed. i.e. JPEG is Always Lossy.
- extended from
- Any formats this one was based upon.
- extended to
- Any formats that have been derived from this one.
- magic
- A sequence of byte values that can be used to identify the file contents, usually located close to the start of the file.
- kaitai struct
- (optional) An identifier of a format at Kaitai Struct project, e.g. "ico" would result in a link to http://formats.kaitai.io/ico/index.html generated.
- spec
- URL of the format specification.
- spec availability
- Type of availability the specification, e.g. commercial, free.
- reference impl
- Link to page about the reference implementation of this format, if any.
- conforms to
- (optional) The UTI of the parent format in the conformance hierarchy.
- charset
- (optional) For character encodings: IANA charset parameter value.
- charsetaliases
- (optional) For character encodings: Variant IANA charset parameter values.
- codepage
- (optional) For character encodings: Code page number (IBM/MS).
- mibenum
- (optional) For character encodings: IANA MIBenum.
- cfstringencoding
- (optional) For character encodings: CFStringEncoding.
- nsstringencoding
- (optional) For character encodings: NSStringEncoding.
- endianness
- Big-endian or Little-endian byte ordering.
- tpm
- Technical Protection Mechanisms supported by the format, e.g. encryption.
- error resilience
- Is this format able to detect damage or recover from damage to the bitstream.
- patent license
- Unknown, Disputed, Encumbered, (F)RAND, Royalty-Free, Unencumbered.
- developed by
- Who developed the format.
- maintained by
- Who now maintains the format.
- released
- (optional) The date the format was publicly released.
- image
- (optional) Illustration to show in infobox.
- caption
- (optional) Caption for image
[edit] Potential Parameters
This is a list of parameters that could be included in this template.
- mime & mime aliases
- Split mimetypes into primary type and known aliases.
- version
- The version of the format, e.g. "1.4" for PDF 1.4
- previous version
- Link to page about the previous version of this format.
- next version
- Link to page about the next version of this format.
- back compat
- Whether this version is backwards compatible with the previous version.
- wikipedia
- Name of the Wikipedia page that describes this format, e.g. "JPEG 2000" will be rendered as JPEG 2000
- container for
- A list of formats this format can contain.
- contained by
- A list of formats that may contain this format.
- embeddable metadata
- Kinds of metadata that can be embedded in this format.
- dependencies
- External resources that files in this format may depend upon, e.g. fonts, or even hardware.
- namespace
- The namespace-uri that defines the file format if it is XML-based.