Microformats Wiki - User contributions [en]

hash-examples

2006-12-29T21:02:34Z

Ant: /* Existing Practices */ add Metalink

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
* Charles Iliya Krempeaux
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]). MD5 checksums are 32 digit hexadecimal numbers, while SHA-1 checksums are 40, and SHA-256 checksums are 64.

== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

[http://www.metalinker.org Metalinks] are an XML file format (.metalink) that contain mirrors and checksum information for downloading files. They are used by download programs/managers and mainly open source projects. After a download finishes, the checksum is automatically verified.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

Some HTTP server applications compute a hash over the response body to serve as an effective ETag. The server must still compute the body but can benefit from reduced network utilization and reduced downstream cache thrashing. Such applications must be willing to risk a hash collision, albeit scoped to a single URL.

Including a hash in a URL can lead to great cacheability, since the TTL can likely be set to an infinite value. Such URLs are often referred to as ''versioned URLs''.

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="...">Download OpenOffice.org
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</a>
</span>
</pre>

=== Use with hAtom ===
For example, with RSS and Atom feeds, we have something called an "enclosure". With an "enclosure" you are being told that this file (that the enclosure points to) is "attached" to this item. (And that you might want to go and download it.)

Now, having checksum information (like a MD5 checksum) could be very useful for this. Especially in the context of hAtom -- the Microformat variation of Atom. And the rel-enclosure Microformat.

So, if we combined the two -- combined this semantic HTML for "downloading" and rel-enclosure -- then we might get something like this:

<pre>
<span class="download">
<a rel="bookmark enclosure" href="...">Download OpenOffice.org
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</a>
</span>
</pre>

Note that I've added "enclosure" to the "rel" attribute of the <a> element. This could be used in other Microformats and semantic HTML too.

metalink-examples

2006-09-11T17:10:48Z

Ant: fix link to metalinker.org

'''Please incorporate this into [[alternates-examples]] as it is substantially the same problem. Thanks! Tantek'''

= Metalink Examples =
A microformat similar to the [http://www.metalinker.org Metalink] file format for aggregating the ways to get the same exact file.

== The Problem ==
For downloading some files, mirrors are listed without any way of being used automatically by programs that do segmented downloading (Web browsers or download managers). There are many different ways of downloading a file; we want people's clients to choose the best way and location, rather than them having to.

== Participants ==
* Gervase Markham
* Ant Bryan
== Real-World Examples ==

== Who offers Mirror downloads for software ==
This is only a small sampling.
*[http://sourceforge.net/index.php Sourceforge]

=== Example #1: [http://arklinux.org/index.php?option=com_content&task=view&id=5&Itemid=18 Ark Linux Download] ===
You can download Ark Linux Home 2006.1-rc2 from any of the following locations (you should typically pick one close to your location, unless it is overloaded):
Name

Location Protocols

North Carolina, USA FTP HTTP

Oregon, USA FTP HTTP

Kent, UK FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Dublin, Ireland FTP HTTP

Poland FTP

Thessaloniki, Greece FTP HTTP

The torrent file is here.

== Existing Practices ==
Most solutions are manual (wading through FTP sites on mirrors to find the exact file) or by searching against a filename & size.

== Proposal ==
A microformat for Mirrors could make them more usable. Web browsers or download managers could be modified to use them automatically.

<pre>
<div class="metalink">
<a href="http://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="ftp://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo2.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo.com/foo.torrent">Bittorrent download</a>
<a href="ed2k:/....">EDonkey download</a>
</div>
</pre>

It's pretty simple; the microformat states that all <a> links inside a
<sometag class="metalink"> are alternative ways of reaching the same
resource, and that when the UA sees a page like this it should
automatically pick the best one and begin downloading.

For legacy UAs, a stylesheet can hide the checksum spans if the author
wants to. No semantic information is present in the page text, which can
be freeform, in any language or whatever. The type of the link is
inferred from the scheme (in this case, http:) or the file extension
(e.g. .torrent) of the URL.

The microformat leverages [http://www.gerv.net/security/link-fingerprints/ Link Fingerprints] to embed the checksums where
required (BT, for example, has its own).

Alternatively, [[hash-examples]] could be used for checksums.

Main Page

2006-07-22T21:58:53Z

Ant: /* Exploratory discussions */ add metalink-examples

__NOTOC__
= Microformats Wiki =

'''Please read [[how-to-play]] before making any edits.'''

'''Please read [[process]] before proposing any new microformats.'''

== Introduction ==

[[what-are-microformats|What are microformats]]? And [[what-can-you-do-with-microformats|what can you do with them]]? See the [http://microformats.org/about/ about page] for an overview, and the [[introduction]] page for more info. Recent [[press]], [[presentations]], [[podcasts]], and [[screencasts]] are also a good place for some background reading/listening. Frequently asked questions are answered in the [[faq]]. Want something or want to contribute? Help with things [[to-do]]. Want to learn more in person? Check out microformats [[events]].

One popular definition from our [http://microformats.org/discuss/ mailing list] (see also: [[mailing-lists]]) is "simple conventions for embedding semantics in HTML to enable decentralized development." More precisely, microformats can be defined as:
:simple conventions
:for embedding semantic markup
::for a specific problem domain
:in human-readable (X)HTML/XML documents, Atom/RSS feeds, and "plain" XML
::that normalize existing content usage patterns
::using brief, descriptive class names
::often based on existing interoperable standards
:to enable decentralized development
::of resources, tools, and services

"Or do you just use your browser to browse? That's so 20th century." -- [http://diveintomark.org Mark Pilgrim]

== Specifications ==
[[microformats|Microformats]] open standards specifications (see also: [[implementations]])
* [[hcalendar|hCalendar]]
* [[hcard|hCard]]
* [[rel-license]]
* [[rel-nofollow]]
* [[rel-tag]]
* [[vote-links|VoteLinks]]
* [http://gmpg.org/xfn/ XFN] (see also: [[xfn-implementations]])
* [http://gmpg.org/xmdp/ XMDP]
* [[xoxo|XOXO]]

== Drafts ==
* [[adr|adr]]
* [[geo|geo]]
* [[hatom|hAtom]] {{NewMarker}}
* [[hresume|hResume]] {{NewMarker}}
* [[hreview|hReview]]
* [[rel-directory]]
* [[rel-enclosure]]
* [[rel-home]]
* [[relpayment-research | rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]

== Design Patterns ==

Design patterns give microformat authors a vocabulary for expressing their ideas consistently with what has already been done. ''If you're tempted to try your hand at writing a microformat '''[[process|read this first]]'''!''

* [[abbr-design-pattern]]
* [[class-design-pattern]]
* [[datetime-design-pattern]]
* [[existing-classes|class names defined across all microformats]]
* [[include-pattern]], [[include-pattern-feedback]] {{NewMarker}}
* [[rel-design-pattern]]

== Exploratory discussions ==
Research and analysis of real-world [[examples]], existing formats, and brainstorming to motivate the microformat.
*[[attention]]
* blog description [[blog-description-examples|examples]]
* blog info [[blog-info-examples|examples]]
* blog post [[blog-post-examples|examples]], [[blog-post-formats|formats]], and [[blog-post-brainstorming|brainstorming]] (yielded the [[hatom|hAtom]] draft)
* book [[book-examples|examples]], [[book-formats|formats]], and [[book-brainstorming|brainstorming]]
* chat [[chat-examples|examples]], [[chat-formats|formats]], and [[chat-brainstorming|brainstorming]]
* citation [[citation|effort]], [[citation-examples|examples]], [[citation-formats|formats]], [[citation-brainstorming|brainstorming]], and [[citation-faq|FAQ]]
* comment [[comment-problem|problem]], [[comment-examples|examples]], and [[comments-formats|formats]] (Some stuff needs to be extracted from [[comments-formats]])
* currency [[currency-examples|examples and brainstorming]] {{NewMarker}}
* directions [[directions-examples|examples]] {{NewMarker}}
* directory inclusion [[directory-inclusion-examples|examples]], [[directory-inclusion-formats|formats]]. (see also [[rel-directory]])
* distributed conversation [[distributed-conversation|overview]], [[distributed-conversation-brainstorming|brainstorming]], [[distributed-conversation-examples|examples]], and [[distributed-conversation-formats|formats]]
* forms [[forms-examples|examples]]
* genealogy [[genealogy-formats|examples]]
* hash [[hash-examples|examples]]
* last modified [[last-modified-examples|examples]], [[last-modified-formats|formats]], and [[last-modified-brainstorming|brainstorming]]
* hListing [[hlisting-proposal|proposal]], and [[hlisting-feedback|feedback]] {{NewMarker}}
** Also, listing [[listing-examples|examples]], [[listing-formats|formats]], and [[listing-brainstorming|brainstorming]]
* location [[location-formats|formats]]. (see also [[adr]] and [[geo]])
* media info [[media-info-examples|examples]]
* meeting minutes [[meeting-minutes-examples|examples]], [[meeting-minutes-formats|formats]], and [[meeting-minutes-brainstorming|brainstorming]]
* metalink [[metalink-examples|examples]] {{NewMarker}}
* [[mfo-examples|MFO examples]]
* music [[music-examples|examples]]
* photo note [[photo-note-examples|examples]]
* recipe [[recipe-examples|examples]]
* rel-product [[rel-product-brainstorming|brainstorming]]
* requirements testing [[requirements-testing|overview]], and [[requirements-testing-examples|examples]]
* [[rest-examples|REST examples]]
* resume [[resume-brainstorming|brainstorming]], and [[resume-formats|formats]]
* review [[review-examples|examples]], and [[review-formats|formats]] (yielded the [[hreview|hReview]] draft)
* search results [[search-results-example|example]]
* show [[show-brainstorming|brainstorming]]
* showroll [[showroll-brainstorming|brainstorming]]
* table [[table-examples|examples]]
* tagspeak [[tagspeak-examples|examples]]
* transit table [[transit-table-examples|examples]]
* [[uid]]
* widget [[widget-examples|examples]], and [[widget-brainstorming|brainstorming]]
* [[wiki-formats|wiki formats]]
* work of art [[work-of-art|overview]], [[workofart-examples|examples]], [[workofart-formats|formats]], and [[workofart-brainstorming|brainstorming]] {{NewMarker}}
*[[xmdp-brainstorming|XMDP brainstorming]] (see also [[xmdp-faq]])

== Examples ==
* [[examples]]
* [[zen-garden]]

== Tools & Test Cases & Additional Research ==

The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting tools and services that need to process more than one microformat. This section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[http://hg.microformats.org/ Source code repository]
*[[vcard-implementations]], [[vcard-errata]]
*[[icalendar-implementations]]
*[[faqs-for-rdf]]
*[[why-are-content-standards-hard]]

== shared work areas ==
* [[buttons]] {{NewMarker}}
* [[demo]] - a page with links for quickly demonstrating microformats working in practice.
* [[events]] {{NewMarker}}
* [[to-do]]
* [[user-interface]]
* [[marked-for-deletion]]

== microformats wiki in other languages ==

You may read and edit microformats articles in many other languages:

* languages with over 50 articles
** [[Main_Page-fr|Français (French)]] {{NewMarker-fr}}
* languages with over 2 articles
** [[Main_Page-ja|日本語 (Japanese)]]
** [[Main_Page-es|Español (Spanish)]]
* languages with 2 articles
** [[Main_Page-de|Deutsch (German)]]

==== microformats translations elsewhere ====
These are offsite pages/sites with translations about microformats. If you are working on one of these, please consider translating the main microformats website!
* [http://mikroformate.pbwiki.com/ Deutsch (German) mikroformate.pbwiki.com] {{NewMarker}}

=== Start a microformats wiki in another language ===

Don't see the language you want? Help translate the microformats wiki into another language!

We're still figuring this out.

For now, see the [http://en.wikipedia.org/wiki/Wikipedia:Multilingual_coordination Wikipedia page on Multilingual coordination], and [http://meta.wikimedia.org/wiki/How_to_start_a_new_Wikipedia How to start a new Wikipedia] for some good general tips, advice, and community conventions.

You may want to start with the list of [[stable-pages]], which are pages that are relatively stable, and have only minimal/editorial changes, which makes them much easier to keep in sync with the English versions, by using the [[Special:Watchlist|my watchlist]] feature (use it to watch the pages you've translated for changes).

Page naming: for the translated version of a page, use the same name for the page, and simply add the RFC 3066 language identifier code as a dash suffix. E.g. for the French version, [[Main_Page]] becomes [[Main_Page-fr]], and [[how-to-play]] becomes [[how-to-play-fr]].

==== more languages folks want to see ====

* Chinese: 微格式 (Microformats) (see [http://msittig.blogspot.com/2005/11/since-i-translated-schedule-of.html source of translation])

metalink-examples

2006-07-15T19:09:16Z

Ant:

= Metalink Examples =
A microformat similar to the [http://www.metalinker Metalink] file format for aggregating the ways to get the same exact file.

== The Problem ==
For downloading some files, mirrors are listed without any way of being used automatically by programs that do segmented downloading (Web browsers or download managers). There are many different ways of downloading a file; we want people's clients to choose the best way and location, rather than them having to.

== Participants ==
* Gervase Markham
* Ant Bryan
== Real-World Examples ==

== Who offers Mirror downloads for software ==
This is only a small sampling.
*[http://sourceforge.net/index.php Sourceforge]

=== Example #1: [http://arklinux.org/index.php?option=com_content&task=view&id=5&Itemid=18 Ark Linux Download] ===
You can download Ark Linux Home 2006.1-rc2 from any of the following locations (you should typically pick one close to your location, unless it is overloaded):
Name

Location Protocols

North Carolina, USA FTP HTTP

Oregon, USA FTP HTTP

Kent, UK FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Dublin, Ireland FTP HTTP

Poland FTP

Thessaloniki, Greece FTP HTTP

The torrent file is here.

== Existing Practices ==
Most solutions are manual (wading through FTP sites on mirrors to find the exact file) or by searching against a filename & size.

== Proposal ==
A microformat for Mirrors could make them more usable. Web browsers or download managers could be modified to use them automatically.

<pre>
<div class="metalink">
<a href="http://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="ftp://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo2.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo.com/foo.torrent">Bittorrent download</a>
<a href="ed2k:/....">EDonkey download</a>
</div>
</pre>

It's pretty simple; the microformat states that all <a> links inside a
<sometag class="metalink"> are alternative ways of reaching the same
resource, and that when the UA sees a page like this it should
automatically pick the best one and begin downloading.

For legacy UAs, a stylesheet can hide the checksum spans if the author
wants to. No semantic information is present in the page text, which can
be freeform, in any language or whatever. The type of the link is
inferred from the scheme (in this case, http:) or the file extension
(e.g. .torrent) of the URL.

The microformat leverages [http://www.gerv.net/security/link-fingerprints/ Link Fingerprints] to embed the checksums where
required (BT, for example, has its own).

Alternatively, [[hash-examples]] could be used for checksums.

metalink-examples

2006-07-15T17:44:23Z

Ant: Metalink microformat

= Metalink Examples =
A microformat similar to the [http://www.metalinker Metalink] file format for aggregating the ways to get the same exact file.

== The Problem ==
For downloading some files, mirrors are listed without any way of being used automatically by programs that do segmented downloading (Web browsers or download managers).
== Participants ==
* Gervase Markham
* Ant Bryan
== Real-World Examples ==

== Who offers Mirror downloads for software ==
This is only a small sampling.
*[http://sourceforge.net/index.php Sourceforge]

=== Example #1: [http://arklinux.org/index.php?option=com_content&task=view&id=5&Itemid=18 Ark Linux Download] ===
You can download Ark Linux Home 2006.1-rc2 from any of the following locations (you should typically pick one close to your location, unless it is overloaded):
Name

Location Protocols

North Carolina, USA FTP HTTP

Oregon, USA FTP HTTP

Kent, UK FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Amsterdam, The Netherlands FTP HTTP

Dublin, Ireland FTP HTTP

Poland FTP

Thessaloniki, Greece FTP HTTP

The torrent file is here.

== Existing Practices ==
Most solutions are manual (wading through FTP sites on mirrors to find the exact file) or by searching against a filename & size.

== Proposal ==
A microformat for Mirrors could make them more usable. Web browsers or download managers could be modified to use them automatically.

<pre>
<div class="metalink">
<a href="http://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="ftp://www.foo.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo2.com/foo.zip!md5!FFEEE542543...">HTTP
download</a>
<a href="http://www.foo.com/foo.torrent">Bittorrent download</a>
<a href="ed2k:/....">EDonkey download</a>
</div>
</pre>

It's pretty simple; the microformat states that all <a> links inside a
<sometag class="metalink"> are alternative ways of reaching the same
resource, and that when the UA sees a page like this it should
automatically pick the best one and begin downloading.

For legacy UAs, a stylesheet can hide the checksum spans if the author
wants to. No semantic information is present in the page text, which can
be freeform, in any language or whatever. The type of the link is
inferred from the scheme (in this case, http:) or the file extension
(e.g. .torrent) of the URL.

The microformat leverages [http://www.gerv.net/security/link-fingerprints/ Link Fingerprints] to embed the checksums where
required (BT, for example, has its own).

Alternatively, [[hash-examples]] could be used for checksums.

hash-examples

2006-06-26T05:30:31Z

Ant: /* Proposal */

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
* Charles Iliya Krempeaux
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]). MD5 checksums are 32 digit hexadecimal numbers, while SHA-1 checksums are 40, and SHA-256 checksums are 64.

== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

Some HTTP server applications compute a hash over the response body to serve as an effective ETag. The server must still compute the body but can benefit from reduced network utilization and reduced downstream cache thrashing. Such applications must be willing to risk a hash collision, albeit scoped to a single URL.

Including a hash in a URL can lead to great cacheability, since the TTL can likely be set to an infinite value. Such URLs are often referred to as ''versioned URLs''.

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="...">Download OpenOffice.org
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</a>
</span>
</pre>

=== Use with hAtom ===
For example, with RSS and Atom feeds, we have something called an "enclosure". With an "enclosure" you are being told that this file (that the enclosure points to) is "attached" to this item. (And that you might want to go and download it.)

Now, having checksum information (like a MD5 checksum) could be very useful for this. Especially in the context of hAtom -- the Microformat variation of Atom. And the rel-enclosure Microformat.

So, if we combined the two -- combined this semantic HTML for "downloading" and rel-enclosure -- then we might get something like this:

<pre>
<span class="download">
<a rel="bookmark enclosure" href="...">Download OpenOffice.org
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</a>
</span>
</pre>

Note that I've added "enclosure" to the "rel" attribute of the <a> element. This could be used in other Microformats and semantic HTML too.

hash-examples

2006-02-16T15:08:31Z

Ant: /* Proposal */

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
* Charles Iliya Krempeaux
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]). MD5 checksums are 32 digit hexadecimal numbers, while SHA-1 checksums are 40, and SHA-256 checksums are 64.

== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

Some HTTP server applications compute a hash over the response body to serve as an effective ETag. The server must still compute the body but can benefit from reduced network utilization and reduced downstream cache thrashing. Such applications must be willing to risk a hash collision, albeit scoped to a single URL.

Including a hash in a URL can lead to great cacheability, since the TTL can likely be set to an infinite value. Such URLs are often referred to as ''versioned URLs''.

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="...">Download OpenOffice.org</a>
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

=== Use with hAtom ===
For example, with RSS and Atom feeds, we have something called an "enclosure". With an "enclosure" you are being told that this file (that the enclosure points to) is "attached" to this item. (And that you might want to go and download it.)

Now, having checksum information (like a MD5 checksum) could be very useful for this. Especially in the context of hAtom -- the Microformat variation of Atom. And the rel-enclosure Microformat.

So, if we combined the two -- combined this semantic HTML for "downloading" and rel-enclosure -- then we might get something like this:

<pre>
<span class="download">
<a rel="bookmark enclosure" href="...">Download OpenOffice.org</a>
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

Note that I've added "enclosure" to the "rel" attribute of the <a> element. This could be used in other Microformats and semantic HTML too.

hash-examples

2006-02-16T02:45:28Z

Ant:

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
* Charles Iliya Krempeaux
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]). MD5 checksums are 32 digit hexadecimal numbers, while SHA-1 checksums are 40, and SHA-256 checksums are 64.

== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

Some HTTP server applications compute a hash over the response body to serve as an effective ETag. The server must still compute the body but can benefit from reduced network utilization and reduced downstream cache thrashing. Such applications must be willing to risk a hash collision, albeit scoped to a single URL.

Including a hash in a URL can lead to great cacheability, since the TTL can likely be set to an infinite value. Such URLs are often referred to as ''versioned URLs''.

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="...">Download OpenOffice.org</a>
<span class="hash-md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

=== Use with hAtom ===
For example, with RSS and Atom feeds, we have something called an "enclosure". With an "enclosure" you are being told that this file (that the enclosure points to) is "attached" to this item. (And that you might want to go and download it.)

Now, having checksum information (like a MD5 checksum) could be very useful for this. Especially in the context of hAtom -- the Microformat variation of Atom. And the rel-enclosure Microformat.

So, if we combined the two -- combined this semantic HTML for "downloading" and rel-enclosure -- then we might get something like this:

<pre>
<span class="download">
<a rel="bookmark enclosure" href="...">Download OpenOffice.org</a>
<span class="checksum md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

Note that I've added "enclosure" to the "rel" attribute of the <a> element. This could be used in other Microformats and semantic HTML too.

hash-examples

2006-02-09T19:33:20Z

Ant: /* Real-World Examples */

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]). MD5 checksums are 32 digit hexadecimal numbers, while SHA-1 checksums are 40, and SHA-256 checksums are 64.

== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="http://example.com/OOo_2.0.1_.tar.gz">Download OpenOffice.org</a>
<span class="hash-md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

hash-examples

2006-02-07T17:26:15Z

Ant: /* Who offers MD5/SHA-1 checksums with software */

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]).
== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.gnupg.org/ GnuPG] SHA-1 on web.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssh.com/ OpenSSH] SHA-1 in release announcement.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="http://example.com/OOo_2.0.1_.tar.gz">Download OpenOffice.org</a>
<span class="hash-md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

hash-examples

2006-02-06T23:40:17Z

Ant: /* Who offers MD5/SHA-1 checksums with software */

= Hash Examples =
A microformat for MD5 and SHA-1 hashes.

== The Problem ==
Checksums (MD5 & SHA-1 hashes) are offered for files to prove they haven't been tampered with and to uniquely identify them. They are very useful, but they are not used as much as they could be. The current method involves a manual process of hashing the downloaded file (with programs that are not installed by default on all operating systems) and then comparing the value to the one listed. An easy and automatic way to use them would be preferrable to present methods.
== Participants ==
* Ant Bryan
== Real-World Examples ==
Currently, MD5 and SHA-1 checksums are either listed on a webpage or email (see Example #1) or stored in a separate file such as (filename.ext.md5 or filename.ext.sha1) (see Example #2). There is no standard or automatic way to use them. Verifying a file after you have the hash is not complex, but it is more than the average user is used to doing (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]).
== Who offers MD5/SHA-1 checksums with software ==
This is only a small sampling.
*[http://httpd.apache.org/ Apache HTTP Server] in .md5 file from web.
*[http://www.cisco.com/ Cisco] MD5 for versions of IOS from Software Center on Cisco website.
*[http://developer.apple.com/darwin/ Darwin] MD5 on web.
*[http://fedora.redhat.com/ Fedora Project] SHA-1 on web and SHA1SUM file on ftp.
*[http://www.freebsd.org/ FreeBSD] on web and in CHECKSUM.MD5 and CHECKSUM.SHA256 files.
*[http://gcc.gnu.org/ GCC] on ftp as md5.sum file.
*[http://www.gentoo.org/ Gentoo] as .md5 file on ftp.
*[http://www.gnome.org/ GNOME] as MD5SUMS-for-gz and MD5SUMS-for-bz2 files on ftp.
*[http://www.kde.org/ KDE] on web and on ftp as MD5SUMS file.
*[http://www.knoppix.org/ Knoppix] in .md5 and .sha1 file.
*[http://www.mysql.com/ MySQL] MD5 on web.
*[http://www.openoffice.org/ OpenOffice.org] MD5 on web.
*[http://www.openssl.org/ OpenSSL] .md5 and .sha1 files linked to from web.
*[http://www.perl.org/ Perl] link to .md5 on web.
*[http://www.postgresql.org/ PostgreSQL] in a .md5 file.
*[http://www.python.org/ Python] MD5 on web
*[http://www.ubuntu.com/ Ubuntu] as MD5SUMS on ftp.
*[http://www.x.org/ X.org] md5sums file on ftp.

=== Example #1: [http://download.openoffice.org/2.0.1/md5sums.html OpenOffice.org MD5 sums] ===
<pre>
English Application Binaries

e0d123e5f316bef78bfdf5a008837577 OOo_2.0.1_LinuxIntel_install.tar.gz
35d91262b3c3ec8841b54169588c97f7 OOo_2.0.1_LinuxIntel_install_wJRE.tar.gz
cc273fe9d442850fa18c31c88c823e07 OOo_2.0.1_SolarisSparc_install.tar.gz
ff6626c69507a6f511cc398998905670 OOo_2.0.1_SolarisSparc_install_wJRE.tar.gz
ce099d7e208dc921e259b48aadef36c1 OOo_2.0.1_Solarisx86_install.tar.gz
4fb319211b2e85cace04e8936100f024 OOo_2.0.1_Solarisx86_install_wJRE.tar.gz
66bd00e43ff8b932c14140472c4b8cc6 OOo_2.0.1_Win32Intel_install.exe
2d86c4246f3c0eb516628bf324d6b9a3 OOo_2.0.1_Win32Intel_install_wJRE.exe
</pre>

=== Example #2: [http://mirrors.csol.org/knoppix/ Knoppix MD5 and SHA-1 sums in separate files ] ===
<pre>
KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.md5:

1188f67d48c9f11afb8572977ef74c5e *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

KNOPPIX_V4.0.2CD-2005-09-23-EN.iso.sha1:

56857cfc709d3996f057252c16ec4656f5292802 *KNOPPIX_V4.0.2CD-2005-09-23-EN.iso

</pre>
Note: This directory also contains filename.ext.md5.asc and filename.ext.sha1.asc files containing the same checksums and PGP signatures in one file.

== Existing Practices ==
As described above, I believe almost all solutions are manual (see [http://www.openoffice.org/dev_docs/using_md5sums.html OpenOffice.org: Using MD5 sums]), an 8 step process on Windows and 3 steps on Linux. [http://mdhashtool.mozdev.org/lfinfo.html Link Fingerprints] which are used by [http://mdhashtool.mozdev.org/index.html MD Hash Tool], a Firefox extension, is one exception. Here is a Link Fingerprint example:

<pre>
http://example.org/OOo_2.0.1_LinuxIntel_install.tar.gz#!md5!e0d123e5f316bef78bfdf5a008837577
</pre>
A Link Fingerprint begins with a traditional URL, then #!md5!, then the MD5 hash.

Brad Fitzpatrick also [http://brad.livejournal.com/2162507.html suggested referring to "files/patches/changesets" by their unique digest.]

== Proposal ==
A microformat for MD5 and SHA-1 hashes could make them more usable. [http://mdhashtool.mozdev.org/index.html MD Hash Tool], another extension, or download managers could be modified to use them automatically.

<pre>
<span class="download">
<a rel="bookmark" href="http://example.com/OOo_2.0.1_.tar.gz">Download OpenOffice.org</a>
<span class="hash-md5">e0d123e5f316bef78bfdf5a008837577</span>
</span>
</pre>

hash-examples

2006-02-06T23:31:35Z

Ant: /* Who else offers MD5/SHA-1 checksums with software */

hash-examples

2006-02-06T23:27:54Z

Ant: /* Who else offers MD5/SHA-1 checksums with software */

hash-examples

2006-02-06T23:00:17Z

Ant: add Who else offers MD5/SHA-1 checksums with software

chat-examples

2006-02-02T00:09:20Z

Ant: revert to before I duplicated the page

chat-examples

2006-02-02T00:06:15Z

Ant: added Trillian & Google Talk formats

= chat examples =

Examples of how chat transcripts are marked up currently, with the idea of moving towards a

== Authors ==
* [http://epeus.blogspot.com Kevin Marks]
* [http://rcboyce.com Robert Boyce]
* [http://artofsystems.blogspot.com Christopher St. John]

== IRC transcripts ==

These are plaintext logs with space separated fields, so are posted wrapped in <pre>

<pre>12:06 Tantek: what does the datetime stamp represent?
12:07 KevinMarks: in iRC, when it was said
12:07 Tantek: is it a point in time *before* they started speaking?
12:07 Tantek: or *after*?
12:07 Tantek: or somewhere in the *middle*?
12:07 KevinMarks: usually it is quantised to seconds
12:07 KevinMarks: and it is time the msg was received
12:07 Tantek: but the second they started typing or pressed return?
12:08 KevinMarks: prssed return i think</pre>

Or as plaintext + <br> (eg http://chocnvodka.blogware.com/blog/_archives/2005/8/25/1169654.html)

(22:20) gturneruk: oh, i just remembered. windows 95 is ten years old today<br>
(22:22) Suw: good god. i mean, i shouldn't be surprised, it being 2005 and all. but still, where did that time go?<br>
(22:22) gturneruk: lost clusters<br>
(22:23) Suw: i obviously need to defrag

xChat2 log format

<pre>
**** BEGIN LOGGING AT Wed May 14 04:36:29 2003

May 14 04:36:29 --> You are now talking on #test
May 14 04:36:29 --- Topic for #test is Test Topic
May 14 04:36:29 --- Topic for #test set by nick1 at Thu May 8 18:45:05
May 14 04:58:45 --- You are now known as nick1
May 14 05:03:44 --> nick1 (~nick1@2.1.3.narf-42905) has joined #test
May 14 05:05:48 <nick1> test message
May 14 05:10:24 * nick1 test action
May 14 05:11:19 <-- nick1 has quit (quit)

**** ENDING LOGGING AT Fri Jul 4 00:28:22 2003
</pre>

Snak log format

<pre>
Log file opened at: 5/26/04 12:00:11 AM
[12:00:11:] nick1: test message
[12:10:29:] * nick1 test action
[12:13:16:] ***: nick2 (~nick2@test.net) has joined the channel
[12:20:35:] ***: nick2 has quit IRC ("Computer going to sleep...")
[12:21:31:] ***: You have joined the channel
Log file closed at: 5/26/04 2:29:08 AM
</pre>

== iChat transcripts ==

iChat handles timestamps differently, inserting them between statement blocks, every 5 minutes.

<pre>12:25 AM
Reconnecting to tantekatwork…
Kevin Marks: So, iChat shows timestamps between entries
Tantek: yes
Tantek: what about Adium?
12:30 AM
Kevin Marks: my copy is 230 days old...</pre>

== Bash.org ==
[http://bash.org Bash.org] and [http://qdb.us other QDBs] collect funny IRC transcripts and let people vote on them.
They use plaintext + <br />, wrapped in <p>
http://bash.org/?23396
<p class="qt"><Donut[AFK]> HEY EURAKARTE<br />
<Donut[AFK]> INSULT<br />
<Eurakarte> RETORT<br />
<Donut[AFK]> COUNTER-RETORT<br />
<Eurakarte> QUESTIONING OF SEXUAL PREFERENCE<br />
<Donut[AFK]> SUGGESTION TO SHUT THE FUCK UP<br />
<Eurakarte> NOTATION THAT YOU CREATE A VACUUM<br />
<Donut[AFK]> RIPOSTE<br />
<Donut[AFK]> ADDON RIPOSTE<br />
<Eurakarte> COUNTER-RIPOSTE<br />
<Donut[AFK]> COUNTER-COUNTER RIPOSTE<br />
<Eurakarte> NONSENSICAL STATEMENT INVOLVING PLANKTON<br />
<Miles_Prower> RESPONSE TO RANDOM STATEMENT AND THREAT TO BAN OPPOSING SIDES<br />
<Eurakarte> WORDS OF PRAISE FOR FISHFOOD<br />
<Miles_Prower> ACKNOWLEDGEMENT AND ACCEPTENCE OF TERMS</p>

== Log Library ==
[http://www.loglibrary.com Log Library] displays a tabular format with divs
<pre>
<div class="row" name="GusVanNos">
<div class="timestamp">18:36:28</div>
<div class="nick"><GusVanNos></div>
<div class="message">.+. is a lazy way of saying .{2,}</div>
</div>

<div class="row" name="jawong">
<div class="timestamp">18:36:48</div>
<div class="nick"><jawong></div>
<div class="message">your model is waaaay better, xal.</div>
</div>
</pre>

== Adium X ==
[http://adiumx.com Adium X] is currently developing an XML-based log format.
This is version 0.3:
<pre>
<chat date="2005-11-20" account="mactigerz" service="AIM" version="0.3">
<event type="windowOpened" time=""/>
<message sender="chz16" time="">'sup?</message>
<message sender="mactigerz" time="">trying to get to work on the the new XML log format</message>
<message sender="chz16" time="">Doesn't sound bad.</message>
<message sender="chz16" time="">Providing you have the log specs, of course.</message>
<message sender="mactigerz" time="">that's what I'm creating.</message>
<status type="offline" sender="chz16" time=""/>
<status type="online" sender="chz16" time=""/>
<status type="away" sender="mactigerz" time="">brb, working on the XML log format</status>
<event type="windowClosed" time=""/>
</chat>
</pre>
This format remains [http://trac.adiumx.com/wiki/XMLLogFormat under development], so this page may not reflect the current version of the format.

== JWZ ==
http://www.jwz.org/hacks/irc2html.pl was used to generate the irc logs for Bar Camp Dallas : http://barcamp.org/f/barcampdallas-irc.html
<pre>
<table bgcolor="#ffffff">
<tbody>
<tr>
<td bgcolor="#eeeeee" nowrap="nowrap" valign="top">
<font color="#000000">
<i>[2006/01/28 11:21:34] </i>
</font>
</td>
<td bgcolor="#eeeeee" valign="top">
<font color="#000000">
<i>@ jdunck joined channel #barcampdallas</i>
</font>
</td>
</tr>
<tr>
<td nowrap="nowrap" valign="top">
<font color="#000000">
<i>[2006/01/28 11:21:40] </i>
</font>
</td>
<td valign="top">
<font color="#000000">
<i><tantek> is there a subethaedit-compatible client on windows?</i>
</font>
</td>
</tr>
...
</pre>

==ChatZilla Internal Format==
Note that there is no proof that this format is being used "in the wild." ChatZilla uses HTML as its presentation layer. This heavily elided excerpt shows two lines from a chat. It gives the flavor (a very big table with each row a chat message divided up into three columns: timestamp, user name and the message itself) but there are many more classes in use in a full log.

<pre>
<div id="messages-outer">
...
<div id="output">
...
<table view-type="IRCChannel" class="msg-table">
<tbody>
<tr mark="even" msg-user="cks_ ME!"
statusText="01/31/2006 01:39 PM, cks_!n=chatzill@ppp-70-248-121-149.dsl.rcsntx.swbell.net"
view-type="IRCChannel" dest-type="IRCChannel" msg-dest="#microformats"
msg-type="PRIVMSG" class="msg">
<td time-s="57" time-n="39" time-h="13" time-d="31" time-m="01" time-y="2006" class="msg-timestamp">
</td>
<td class="msg-user">
<span>cks_</span>
</td>
<td class="msg-data">
<span>so, using chatzilla for just a minute so i can extract the logs.</span>
</td>
</tr>
<tr mark="odd" msg-user="Atamido" statusText="01/31/2006 01:43 PM, Atamido!n=atamido@cpe-67-9-173-252.austin.res.rr.com"
view-type="IRCChannel" dest-type="IRCChannel" msg-dest="#microformats"
msg-type="PRIVMSG" class="msg">
<td time-s="25" time-n="43" time-h="13" time-d="31" time-m="01" time-y="2006" class="msg-timestamp">
</td>
<td class="msg-user">
<a href="irc://irc.freenode.net/Atamido,isnick" class="chatzilla-link">
<span>Atamido</span>
</a>
</td>
<td class="msg-data">
<span>
Here are some examples.
<a target="_content" class="chatzilla-link" href="http://www.hacksrus.com/%7Eginda/chatzilla/motifs.html">
http://www.hacksrus.<wbr>
com/~ginda/chatzilla/<wbr>
motifs.html<wbr>
</a>
</span>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</pre>

==MSN Messenger XML Format Logs==
Examples at: http://stupidpeople.commo.de/logs/After%20August%202004/, there are a bunch there but not sure how widespread it is. General structure appears to be a Log element wrapper, with toplevel Join and Message elements. It's a little strange how the To element has children indicating all the recepients, normally that would be implicit, but there may be a reason that isn't clear just from this example. Original posting for example: http://microformats.org/discuss/mail/microformats-discuss/2006-February/002937.html

<pre>
<Log FirstSessionID="1" LastSessionID="1">
<Join Date="9/12/2004" Time="6:48:20 PM" DateTime="2004-09-12T23:48:20.716Z" SessionID="1">
<User FriendlyName="'' Quando nÃ£o tem oq se ama...Ã preciso amar oq se tem!!! ''"/>
<Text Style="color:#008000; ">
'' Quando nÃ£o tem oq se ama...Ã preciso amar oq se tem!!! '' has been added to the conversation.
</Text>
</Join>
<Message Date="9/12/2004" Time="6:48:20 PM" DateTime="2004-09-12T23:48:20.846Z" SessionID="1">
<From>
<User FriendlyName="VocÃª vive inventando maneiras pra dizer semp pra dizer que me quer!!"/>
</From>
<To>
<User FriendlyName="http://commo.de/StupidPeople/"/>
<User FriendlyName=":@TE ODEIO:@"/>
<User FriendlyName="|I{â¢------Â»VictorÂ«------â¢}I|1 2 3 o corh fregueis! -LLUSSAA EOOOO"/>
<User FriendlyName=""TÃ´ com sono!!! Acho que vo durmi!!!""/>
<User FriendlyName="||||Gabriel||||| A Clockwork Orange.."/>
<User FriendlyName="Pensar para acertar, Calar para resistir, Agir para vencer"/>
<User FriendlyName="*>.Jessy.<*genteeeeeeeemmmmmmm..trokeiser tÃ¡ aqui:09098217635!!!"/>
</To>
<Text Style="font-family:Sylfaen; color:#ff0000; ">
nossa qnta gente
</Text>
</Message>
</Log>
</pre>

==ILRT Logger Bot Format==
Found at: http://chatlogs.planetrdf.com/swig/, generated by: http://cvs.ilrt.org/cvsweb/redland/logger/, there are three formats: HTML, plain text, and RDF.

Taking RDF first just because that's kind of fun and is presumably 100% semantics. Pretty straightforward RDF Sequence with date/description/creator, except for the line with a Dublin Core relation stuck in there. As is normal with RDF, semantics are reused, so to fully grok it there's some followon work to do, see: http://www.w3.org/2004/Talks/0522-rrs/ The foaf group got involved with IRC chat since IRC names are one of the ways to identify people, looks like it snowballed, not sure if the ChatChannel stuff is official or not. The Dublin Core and WordNet stuff is mentioned in the FOAF spec index, but seems to be missing from the actual text, I might have been looking at an old version.

<pre>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:wn="http://xmlns.com/wordnet/1.6/"
xmlns:foaf="http://xmlns.com/foaf/0.1/">
<foaf:ChatChannel rdf:about="irc://irc.freenode.net/swig">
<foaf:chatEventList>
<rdf:Seq>
<rdf:li>
<foaf:chatEvent rdf:ID="T00-01-19">
<dc:date>2006-02-01T00:01:19Z</dc:date>
<dc:description>keithalexander has quit</dc:description>
<dc:creator><wn:Person foaf:nick="keithalexander"/></dc:creator>
</foaf:chatEvent>
</rdf:li>
<rdf:li>
<foaf:chatEvent rdf:ID="T00-27-42">
<dc:date>2006-02-01T00:27:42Z</dc:date>
<dc:description>Gromgull: nice quote re. x years later</dc:description>
<dc:creator><wn:Person foaf:nick="CaptSolo"/></dc:creator>
</foaf:chatEvent>
</rdf:li>
<rdf:li>
<foaf:chatEvent rdf:ID="T01-38-49">
<dc:date>2006-02-01T01:38:49Z</dc:date>
<dc:description>A: http://aaronland.info/python/pyupcoming/ from karlUshi</dc:description>
<dc:creator><wn:Person foaf:nick="dc_swig"/></dc:creator>
<dc:relation rdf:resource="http://aaronland.info/python/pyupcoming/"/>
</foaf:chatEvent>
</rdf:li>
</rdf:Seq>
</foaf:chatEventList>
</foaf:ChatChannel>
</rdf:RDF>
</pre>

= chat examples =

Examples of how chat transcripts are marked up currently, with the idea of moving towards a

== Authors ==
* [http://epeus.blogspot.com Kevin Marks]
* [http://rcboyce.com Robert Boyce]
* [http://artofsystems.blogspot.com Christopher St. John]

== IRC transcripts ==

These are plaintext logs with space separated fields, so are posted wrapped in <pre>

<pre>12:06 Tantek: what does the datetime stamp represent?
12:07 KevinMarks: in iRC, when it was said
12:07 Tantek: is it a point in time *before* they started speaking?
12:07 Tantek: or *after*?
12:07 Tantek: or somewhere in the *middle*?
12:07 KevinMarks: usually it is quantised to seconds
12:07 KevinMarks: and it is time the msg was received
12:07 Tantek: but the second they started typing or pressed return?
12:08 KevinMarks: prssed return i think</pre>

Or as plaintext + <br> (eg http://chocnvodka.blogware.com/blog/_archives/2005/8/25/1169654.html)

(22:20) gturneruk: oh, i just remembered. windows 95 is ten years old today<br>
(22:22) Suw: good god. i mean, i shouldn't be surprised, it being 2005 and all. but still, where did that time go?<br>
(22:22) gturneruk: lost clusters<br>
(22:23) Suw: i obviously need to defrag

xChat2 log format

<pre>
**** BEGIN LOGGING AT Wed May 14 04:36:29 2003

May 14 04:36:29 --> You are now talking on #test
May 14 04:36:29 --- Topic for #test is Test Topic
May 14 04:36:29 --- Topic for #test set by nick1 at Thu May 8 18:45:05
May 14 04:58:45 --- You are now known as nick1
May 14 05:03:44 --> nick1 (~nick1@2.1.3.narf-42905) has joined #test
May 14 05:05:48 <nick1> test message
May 14 05:10:24 * nick1 test action
May 14 05:11:19 <-- nick1 has quit (quit)

**** ENDING LOGGING AT Fri Jul 4 00:28:22 2003
</pre>

Snak log format

<pre>
Log file opened at: 5/26/04 12:00:11 AM
[12:00:11:] nick1: test message
[12:10:29:] * nick1 test action
[12:13:16:] ***: nick2 (~nick2@test.net) has joined the channel
[12:20:35:] ***: nick2 has quit IRC ("Computer going to sleep...")
[12:21:31:] ***: You have joined the channel
Log file closed at: 5/26/04 2:29:08 AM
</pre>

== iChat transcripts ==

iChat handles timestamps differently, inserting them between statement blocks, every 5 minutes.

<pre>12:25 AM
Reconnecting to tantekatwork…
Kevin Marks: So, iChat shows timestamps between entries
Tantek: yes
Tantek: what about Adium?
12:30 AM
Kevin Marks: my copy is 230 days old...</pre>

== Bash.org ==
[http://bash.org Bash.org] and [http://qdb.us other QDBs] collect funny IRC transcripts and let people vote on them.
They use plaintext + <br />, wrapped in <p>
http://bash.org/?23396
<p class="qt"><Donut[AFK]> HEY EURAKARTE<br />
<Donut[AFK]> INSULT<br />
<Eurakarte> RETORT<br />
<Donut[AFK]> COUNTER-RETORT<br />
<Eurakarte> QUESTIONING OF SEXUAL PREFERENCE<br />
<Donut[AFK]> SUGGESTION TO SHUT THE FUCK UP<br />
<Eurakarte> NOTATION THAT YOU CREATE A VACUUM<br />
<Donut[AFK]> RIPOSTE<br />
<Donut[AFK]> ADDON RIPOSTE<br />
<Eurakarte> COUNTER-RIPOSTE<br />
<Donut[AFK]> COUNTER-COUNTER RIPOSTE<br />
<Eurakarte> NONSENSICAL STATEMENT INVOLVING PLANKTON<br />
<Miles_Prower> RESPONSE TO RANDOM STATEMENT AND THREAT TO BAN OPPOSING SIDES<br />
<Eurakarte> WORDS OF PRAISE FOR FISHFOOD<br />
<Miles_Prower> ACKNOWLEDGEMENT AND ACCEPTENCE OF TERMS</p>

== Log Library ==
[http://www.loglibrary.com Log Library] displays a tabular format with divs
<pre>
<div class="row" name="GusVanNos">
<div class="timestamp">18:36:28</div>
<div class="nick"><GusVanNos></div>
<div class="message">.+. is a lazy way of saying .{2,}</div>
</div>

<div class="row" name="jawong">
<div class="timestamp">18:36:48</div>
<div class="nick"><jawong></div>
<div class="message">your model is waaaay better, xal.</div>
</div>
</pre>

== Adium X ==
[http://adiumx.com Adium X] is currently developing an XML-based log format.
This is version 0.3:
<pre>
<chat date="2005-11-20" account="mactigerz" service="AIM" version="0.3">
<event type="windowOpened" time=""/>
<message sender="chz16" time="">'sup?</message>
<message sender="mactigerz" time="">trying to get to work on the the new XML log format</message>
<message sender="chz16" time="">Doesn't sound bad.</message>
<message sender="chz16" time="">Providing you have the log specs, of course.</message>
<message sender="mactigerz" time="">that's what I'm creating.</message>
<status type="offline" sender="chz16" time=""/>
<status type="online" sender="chz16" time=""/>
<status type="away" sender="mactigerz" time="">brb, working on the XML log format</status>
<event type="windowClosed" time=""/>
</chat>
</pre>
This format remains [http://trac.adiumx.com/wiki/XMLLogFormat under development], so this page may not reflect the current version of the format.

== JWZ ==
http://www.jwz.org/hacks/irc2html.pl was used to generate the irc logs for Bar Camp Dallas : http://barcamp.org/f/barcampdallas-irc.html
<pre>
<table bgcolor="#ffffff">
<tbody>
<tr>
<td bgcolor="#eeeeee" nowrap="nowrap" valign="top">
<font color="#000000">
<i>[2006/01/28 11:21:34] </i>
</font>
</td>
<td bgcolor="#eeeeee" valign="top">
<font color="#000000">
<i>@ jdunck joined channel #barcampdallas</i>
</font>
</td>
</tr>
<tr>
<td nowrap="nowrap" valign="top">
<font color="#000000">
<i>[2006/01/28 11:21:40] </i>
</font>
</td>
<td valign="top">
<font color="#000000">
<i><tantek> is there a subethaedit-compatible client on windows?</i>
</font>
</td>
</tr>
...
</pre>

==ChatZilla Internal Format==
Note that there is no proof that this format is being used "in the wild." ChatZilla uses HTML as its presentation layer. This heavily elided excerpt shows two lines from a chat. It gives the flavor (a very big table with each row a chat message divided up into three columns: timestamp, user name and the message itself) but there are many more classes in use in a full log.

<pre>
<div id="messages-outer">
...
<div id="output">
...
<table view-type="IRCChannel" class="msg-table">
<tbody>
<tr mark="even" msg-user="cks_ ME!"
statusText="01/31/2006 01:39 PM, cks_!n=chatzill@ppp-70-248-121-149.dsl.rcsntx.swbell.net"
view-type="IRCChannel" dest-type="IRCChannel" msg-dest="#microformats"
msg-type="PRIVMSG" class="msg">
<td time-s="57" time-n="39" time-h="13" time-d="31" time-m="01" time-y="2006" class="msg-timestamp">
</td>
<td class="msg-user">
<span>cks_</span>
</td>
<td class="msg-data">
<span>so, using chatzilla for just a minute so i can extract the logs.</span>
</td>
</tr>
<tr mark="odd" msg-user="Atamido" statusText="01/31/2006 01:43 PM, Atamido!n=atamido@cpe-67-9-173-252.austin.res.rr.com"
view-type="IRCChannel" dest-type="IRCChannel" msg-dest="#microformats"
msg-type="PRIVMSG" class="msg">
<td time-s="25" time-n="43" time-h="13" time-d="31" time-m="01" time-y="2006" class="msg-timestamp">
</td>
<td class="msg-user">
<a href="irc://irc.freenode.net/Atamido,isnick" class="chatzilla-link">
<span>Atamido</span>
</a>
</td>
<td class="msg-data">
<span>
Here are some examples.
<a target="_content" class="chatzilla-link" href="http://www.hacksrus.com/%7Eginda/chatzilla/motifs.html">
http://www.hacksrus.<wbr>
com/~ginda/chatzilla/<wbr>
motifs.html<wbr>
</a>
</span>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</pre>

==MSN Messenger XML Format Logs==
Examples at: http://stupidpeople.commo.de/logs/After%20August%202004/, there are a bunch there but not sure how widespread it is. General structure appears to be a Log element wrapper, with toplevel Join and Message elements. It's a little strange how the To element has children indicating all the recepients, normally that would be implicit, but there may be a reason that isn't clear just from this example. Original posting for example: http://microformats.org/discuss/mail/microformats-discuss/2006-February/002937.html

<pre>
<Log FirstSessionID="1" LastSessionID="1">
<Join Date="9/12/2004" Time="6:48:20 PM" DateTime="2004-09-12T23:48:20.716Z" SessionID="1">
<User FriendlyName="'' Quando nÃ£o tem oq se ama...Ã preciso amar oq se tem!!! ''"/>
<Text Style="color:#008000; ">
'' Quando nÃ£o tem oq se ama...Ã preciso amar oq se tem!!! '' has been added to the conversation.
</Text>
</Join>
<Message Date="9/12/2004" Time="6:48:20 PM" DateTime="2004-09-12T23:48:20.846Z" SessionID="1">
<From>
<User FriendlyName="VocÃª vive inventando maneiras pra dizer semp pra dizer que me quer!!"/>
</From>
<To>
<User FriendlyName="http://commo.de/StupidPeople/"/>
<User FriendlyName=":@TE ODEIO:@"/>
<User FriendlyName="|I{â¢------Â»VictorÂ«------â¢}I|1 2 3 o corh fregueis! -LLUSSAA EOOOO"/>
<User FriendlyName=""TÃ´ com sono!!! Acho que vo durmi!!!""/>
<User FriendlyName="||||Gabriel||||| A Clockwork Orange.."/>
<User FriendlyName="Pensar para acertar, Calar para resistir, Agir para vencer"/>
<User FriendlyName="*>.Jessy.<*genteeeeeeeemmmmmmm..trokeiser tÃ¡ aqui:09098217635!!!"/>
</To>
<Text Style="font-family:Sylfaen; color:#ff0000; ">
nossa qnta gente
</Text>
</Message>
</Log>
</pre>

==Trillian Internal Format==
This is for an AIM chat, but one for a Yahoo! chat looks the same. It is saved as plaintext as well as XML. (user1 is local).

Plaintext:
<pre>
Session Start (user1:user2): Fri Apr 01 17:43:06 2005
[17:43] user2: ping
[17:43] *** Auto-response sent to user2: My hovercraft is full of eels.
[17:46] user1: hey
Session Close (user2): Fri Apr 01 17:47:00 2005
</pre>

The same in XML:
<pre>
<session type="start" time="1112395386" medium="AIM" to="user2" from="user1"/>
<message type="incoming_privateMessage" time="1112395386" medium="AIM" to="user1" from="user2" from_display="user2" text="ping"/>
<message type="information_standard" time="1112395387" medium="AIM" text="Auto%2Dresponse%20sent%20to%20user2%3A%20My%20hovercraft%20is%20full%20of%20eels%2E"/>
<message type="outgoing_privateMessage" time="1112395573" medium="AIM" to="user2" from="user1" from_display="user1" text="hey"/>
<session type="stop" time="1112395619" medium="AIM" to="user2" from="user1"/>
</pre>

There is also a "user2-assets.xml" file for stuff like Buddy icons & file transers:

<pre>
<asset medium="AIM" name="user2" link="C%3A%5CProgram%20Files%5CTrillian%5Cusers%5Cdefault%5Cbuddyicons%5Cassets%5CAIM%2Duser2%2D1118046544%2Ejpg"/>
<asset medium="AIM" name="user2" link="D%3A%5CPIX%5CY2005%5C0619%5CMOV02050%2EMPG"/>
<asset medium="AIM" name="user2" link="C%3A%5CDocuments%20and%20Settings%5Cant%5CDesktop%5CDSCN0372_resize%2EJPG"/>
<asset medium="AIM" name="user2" link="C%3A%5CProgram%20Files%5CTrillian%5Cusers%5Cdefault%5Cbuddyicons%5Cassets%5CAIM%2Duser2%2D1133932754%2Ejpg"/>
</pre>

==Google Talk Format Logs==
Again, user1 is local.

<pre>
3
17b5df8a
01c61af0
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v66EC7D7137%22+to%3D%22user2%40gmail.com%2FTalk.v66EC841CB6%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Esome+but+not+much%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
incoming
%3Ccli%3Amessage+from%3D%22user2%40gmail.com%2FTalk.v66EC841CB6%22+to%3D%22user1%40gmail.com%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3EI'm+ready+to+crawl+in+bed+and+read.++Do+well+on+your+paper.++Love++Mom%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v66EC7D7137%22+to%3D%22user2%40gmail.com%2FTalk.v66EC841CB6%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Ethanks%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Emom%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
incoming
%3Ccli%3Amessage+from%3D%22user2%40gmail.com%2FTalk.v687050428D%22+to%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3EHi%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%2FTalk.v687050428D%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Ei+totally+forgot+about+the+awning%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%2FTalk.v687050428D%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Edo+you+want+me+to+come+over%3F%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
incoming
%3Ccli%3Amessage+from%3D%22user2%40gmail.com%2FTalk.v687050428D%22+to%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3EI+have+tomorrow+off.++Is+the+wind+supposed+to+get+bad+before+then%3F%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%2FTalk.v687050428D%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Enot+sure.+its+stormy+now%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
incoming
%3Ccli%3Amessage+from%3D%22user2%40gmail.com%2FTalk.v687050428D%22+to%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3EI'm+ready+if+yo+are.++I+thought+you+would+be+here+anyway+about+the+boat+or+I+would+have+called.%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%2FTalk.v687050428D%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3EI+think+we+decided+to+do+the+boat+on+a+dry+night%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
outgoing
%3Ccli%3Amessage+from%3D%22user1%40gmail.com%2FTalk.v68701EBF07%22+to%3D%22user2%40gmail.com%2FTalk.v687050428D%22+type%3D%22chat%22+xmlns%3Acli%3D%22jabber%3Aclient%22%3E%3Ccli%3Abody%3Ei'll+come+over+now%3C%2Fcli%3Abody%3E%3Cactive+xmlns%3D%22http%3A%2F%2Fjabber.org%2Fprotocol%2Fchatstates%22%2F%3E%3C%2Fcli%3Amessage%3E
</pre>

chat-examples

2006-02-01T23:36:21Z

Ant: /* IRC transcripts */ plantext -> plaintext

hash-examples

2006-02-01T07:06:59Z

Ant: /* Proposal */ change checksum to hash

hash-examples

2006-02-01T03:37:42Z

Ant: /* Proposal */ add example from Charles Iliya Krempeaux

hash-examples

2006-01-31T19:37:48Z

Ant: /* Existing Practices */ add Brad Fitzpatrick sentence & link

Main Page

2006-01-31T19:21:37Z

Ant: /* Exploratory discussions */ added hash-examples

__NOTOC__
__NOTOC__
= Microformats Wiki =

'''Please read [[how-to-play]] before making any edits.'''

'''Please read [[process]] before proposing any new microformats.'''

== Introduction ==

What are microformats? See the [http://microformats.org/about/ about page] for an overview, and the [[introduction]] page for more info. Recent [[press]] and [[presentations]] are also a good place for some background reading as well. Frequently asked questions are answered in the [[faq]].

One popular definition from our [http://microformats.org/discuss/ mailing list] is "simple conventions for embedding semantics in HTML to enable decentralized development." More precisely, microformats can be defined as:
:simple conventions
:for embedding semantic markup
::for a specific problem domain
:in human-readable (X)HTML/XML documents, Atom/RSS feeds, and "plain" XML
::that normalize existing content usage patterns
::using brief, descriptive class names
::often based on existing interoperable standards
:to enable decentralized development
::of resources, tools, and services

"Or do you just use your browser to browse? That's so 20th century." -- [http://diveintomark.org Mark Pilgrim]

== Specifications ==
[[microformats|Microformats]] open standards specifications (see also: [[implementations]])
* [[hcalendar|hCalendar]]
* [[hcard|hCard]]
* [[rel-license]]
* [[rel-nofollow]]
* [[rel-tag]]
* [[vote-links|VoteLinks]]
* [http://gmpg.org/xfn/ XFN] (see also: [[xfn-implementations]])
* [http://gmpg.org/xmdp/ XMDP]
* [[xoxo|XOXO]]

== Drafts ==
* [[adr|adr]]
* [[geo|geo]]
* [[hreview|hReview]]
* [[rel-directory]]
* [[rel-enclosure]]
* [[relpayment-research | rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]
* [[rel-home]] {{NewMarker}}
* [[hatom|hAtom]] {{NewMarker}}

== Design Patterns ==

Design patterns give microformat authors a vocabulary for expressing their ideas consistently with what has already been done. ''If you're tempted to try your hand at writing a microformat '''[[process|read this first]]'''!''

* [[datetime-design-pattern]]
* [[class-design-pattern]]
* [[rel-design-pattern]]
* [[abbr-design-pattern]]
* [[existing-classes|class names defined across all microformats]]

== Exploratory discussions ==
Research and analysis of real-world [[examples]], existing formats, and brainstorming to motivate the microformat.
*[[attention]]
*[[blog-description-format]]
*[[blog-post-examples]], [[blog-post-formats]], [[blog-post-brainstorming]] (yields [[hatom|hAtom]])
*[[book-examples]], [[book-formats]], [[book-brainstorming]]
*[[chat-examples]]
*[[citation|citation microformat overview]], [[citation-examples]], [[citation-formats]], [[citation-brainstorming]]
*[[comments-formats]]
*[[directory-inclusion-examples]], [[directory-inclusion-formats]]. (see also [[rel-directory]])
*[[distributed-conversation]], [[distributed-conversation-brainstorming]], [[distributed-conversation-examples]], [[distributed-conversation-formats]]
*[[forms-examples]]
*[[genealogy-formats]]
*[[hash-examples]]
*[[last-modified-examples]], [[last-modified-formats]], [[last-modified-brainstorming]]
*[[listing-examples]], [[listing-formats]], [[listing-brainstorming]]
*[[location-formats]]. (see also [[adr]] and [[geo]])
*[[media-info-examples]]
*[[mfo-examples]]
*[[other-formats]]
*[[photo-note-examples]]
*[[recipe-examples]]
*[[requirements-testing]], [[requirements-testing-examples]]
*[[rest-examples]]
*[[resume-brainstorming]], [[resume-formats]]
*[[review-examples]], [[review-formats]] (yielded the [[hreview|hReview]] draft)
*[[search-results-example]]
*[[show-brainstorming]]
*[[showroll-brainstorming]]
*[[table-examples]]
*[[tagspeak-examples]]
*[[transit-table-examples]]
*[[widget-examples]], [[widget-brainstorming]]
*[[wiki-formats]]
*[[xmdp-brainstorming]] (see also [[xmdp-faq]])

== Examples ==
* [[examples]]
* [[zen-garden]] {{NewMarker}}

== Tools & Test Cases & Additional Research ==

The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting tools and services that need to process more than one microformat. This section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[[vcard-implementations]], [[vcard-errata]]
*[[icalendar-implementations]]
*[[faqs-for-rdf]]
*[[why-are-content-standards-hard]]

== shared work areas ==
* [[buttons]] {{NewMarker}}
* [[demo]] - a page with links for quickly demonstrating microformats working in practice.
* [[events]] {{NewMarker}}
* [[to-do]]
* [[marked-for-deletion]]

== microformats wiki in other languages ==

You may read and edit microformats articles in <del>many different</del> other languages

=== microformats wiki languages with over 2 articles ===

* [[Main_Page-fr|Français (French)]]
* [[Main_Page-jp|日本語 (Japanese)]] {{NewMarker}}

=== Start a microformats wiki in another language ===

Don't see the language you want? Help translate the microformats wiki into another language!

We're still figuring this out.

For now, see the [http://en.wikipedia.org/wiki/Wikipedia:Multilingual_coordination Wikipedia page on Multilingual coordination], and [http://meta.wikimedia.org/wiki/How_to_start_a_new_Wikipedia How to start a new Wikipedia] for some good general tips, advice, and community conventions.

You may want to start with the list of [[stable-pages]], which are pages that are relatively stable, and have only minimal/editorial changes, which makes them much easier to keep in sync with the English versions, by using the [[Special:Watchlist|my watchlist]] feature (use it to watch the pages you've translated for changes).

Page naming: for the translated version of a page, use the same name for the page, and simply add the RFC 3066 language identifier code as a dash suffix. E.g. for the French version, [[Main_Page]] becomes [[Main_Page-fr]], and [[how-to-play]] becomes [[how-to-play-fr]].

==== more languages folks want to see ====

* Chinese: 微支付 (Microformats) (see [http://msittig.blogspot.com/2005/11/since-i-translated-schedule-of.html source of translation])

hash-examples

2006-01-31T19:20:57Z

Ant: initial creation of page

faq

2006-01-31T16:50:49Z

Ant: changed logic to logical

= Microformats wiki FAQ =

== wiki specific questions ==

Q: ''How do I create a username? Why won't it let me use my preferred username?''

A: First, read this: http://en.wikipedia.org/wiki/Wikipedia:Username . Second, real names are preferred to pseudonyms/handles etc. Real names encourage better transparency and accountability. Third, the most common problem creating a user name is forgetting to caplitalize the first letter of the user name.

== Basic Microformat Questions ==

Q: ''Are microformats dependent upon (X)HTML?''

A: Microformats are made to be embeddable. They can be embedded in (X)HTML, RSS, Atom or anywhere (X)HTML is allowed.

Q: ''Microformats sound great. How can I help?''

A: First of all, take a look at http://microformats.org/discuss to see some ways to join the conversations about microformats.

Q: ''I'd like to make a donation to the microformat cause. How can I do this?''

A: Thank you for your willingness to support microformats. We've only recently started this site and have decided that while we are figuring out exactly how to accept donations, we will be passing along donations to other good causes. Please consider donating to another cause like Red Cross, perhaps directed to help victims of recent natural disasters.

Q: ''Which microformats have been implemented?''

See the [[implementations]] page.

Q: ''Which microformats should I implement?''

A: Chances are you that your website already has data very similar to several microformats. For example, you probably have people and/or their contact information somewhere. That information could be marked up with [[hcard]]. If you are publishing press releases, try using [[hatom]].

Q: ''Do you have any link badges I can add to my website/blog?''

A: Not yet, but we'll post them when we do...

Q. ''Are there any tools that support microformats?''

A. Yes... [[implementations]].

Q. ''What about using new URI schemes instead of class names, e.g. for geo information?''

A. In general, it is more work, and less content-publisher friendly, to ask them to use URI schemes instead of class names.

Authors aren't publishing links to geo information.

They're publishing *visible text* of [[geo]] information.

So the easiest thing to do, for the author, is to leave it as visible text.

Thus, it makes the most sense to do the simple thing of just wrapping that
visible text with a little bit of markup, rather than asking the author to
move (or copy) it into an attribute, which may or may not require a
reformatting of the data as well.

It would make sense from a usability persepective to hyperlink geo information to a maps page or something, so that clicking it actually does something. If you forced them to use a hypothetical "geo:" protocol instead, then that would interfere, since you can only hyperlink something to one destination.

== Class interactions ==

Q. ''Are there issues with page styling when specific class values are used?''

A. There might be. However, any such issues can be easily (trivially) worked around by using contextual selectors.

Q. ''How does the use of class values for semantics interact with the use of class values for attaching CSS styles?''

A. The class attribute takes a space separated set of class names [http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2 HTML4 reference]. Thus both author and microformat defined class names may be used in the same class attribute. In addition, microformat class names provide the author with a consistent set of class names to use for styling. If the author is already using using specific class names, they can continue to do so, and include microformat class names. If the author is already using a class name that happens to also be a microformat class name, then the author may want to consider using contextual CSS class selectors to make sure that avoid any unintentional styling effects.

See also:
* [http://tantek.com/log/2002/12.html#L20021216 A Touch Of Class]
* [http://tantek.com/log/2004/07.html#classmeaningnotshow Class For Meaning Not For Show]
* [http://www.meyerweb.com/eric/thoughts/2004/07/18/competent-classing Competant Classing], by Eric Meyer for discussion of choosing class names in (X)HTML
* [http://www.microformats.org/blog/2005/10/19/more-than-styling/ Class attributes are about more than styling] - Ryan King dispells common misconceptions about the ''HTML'' class attribute.

== <code><div></code> and <code><span></code> semantics ==

Q. Is it semantically meaningless to use divs?

A. Yes, both <code><div></code> and <code><span></code> have nearly no semantics. <code><div></code> can be used to represent a "division" of the page content. Similarly <code><span></code> can be used to reperesent that that "span" of text has some meaning, but the specifics of what that meaning is undefined by the <code><span></code>.

Q. Does the use of <code><div></code> and <code><span></code> elements add any semantics to web pages?

A. According to the [http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.4 spec], <code><div></code> and <code><span></code> "offer a generic mechanism for adding structure to documents." Their only meaning is in dividing documents into sections, and as such, their presence implies that the content within has a specific, but undefined by the element markup, semantic. Thus they are nearly semantic-free.

== Class semantics ==

Q. ''Do (X)HTML class names have semantics?''

A. The HTML4 specification does not define any particular class values [http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2 REF], nor does it define any particular semantic for class values [http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2 REF], except that they "may be used for general user agent processing" [http://www.w3.org/TR/REC-html40/struct/global.html#h-7.5.2 REF]. However, the [http://www.w3.org/TR/WD-htmllink-970328#profile" draft of "Hypertext Links in HTML"], allows for a "profile" to define meanings for those classes. [http://gmpg.org/xmdp/ XMDP] is a format for defining meta data profiles for (X)HTML, and thus an XMDP profile can be used to define the meanings of class names.

See also:
* [http://tantek.com/log/2002/12.html#L20021216 A Touch Of Class]
* [http://www.w3.org/TR/WD-htmllink-970328 Hypertext Links in HTML]

== Microformats and Spam ==

Q. Given that Google now looks at hidden content as potential spam, will microformats be considered spam?

A. Microformats aren't meant to disguise semantics -- only provide a mechanism for marking up the content you intend to make visible on a page, typically no more and no less. Where we embed semantic equivalents in the tags themselves (i.e. GMT times in abbr tags for times), it doesn't seem logical that such data could be considered spam.