Microformats Wiki - User contributions [en]

irc

2007-04-30T23:50:14Z

JasonClark: Updated Freenode instructions

Microformats IRC

We have an IRC channel, [irc://irc.freenode.net/microformats #microformats on the freenode network].

There's typically someone there at any point during the day, though there isn't always active discussion. Sometimes, though this is the best place to debate issues that need lots of back and forth discussion.

__TOC__

= #microformats on freenode =

The microformats channel is hosted on the freenode.net server. See [[irc#Joining_a_server_and_channel|Joining a server and channel]] help for further information.

== Logs ==

Logs are available here: http://rbach.priv.at/Microformats-IRC/

Atom feed of logs available here: http://microformat.makedatamakesense.com/log_feed/

== People on irc ==

See our [[irc-people|list of IRC regulars]] and their normal timezones.

=== Admins ===

Our channel has some admins, who are also mailing list and wiki admins. If you want to get their attention, just say "adminhelp".

== Greetings ==

To display a brief description of who you are each time you join the channel, you can create a definition for your username. To do so pass the <tt>?def</tt> command using something like the following convention (be brief):

<code>?def jdoe is John Doe and can be found online at <nowiki>http://www.example.com</nowiki></code>

More information about using JiBot commands can be found on the [http://joiwiki.ito.com/joiwiki/index.cgi?jibot jibot website]

==Bots==

The IRC channel uses these bots:

* [[mfbot]] - logs all edits to this wiki.
* [[mflogbot]]
* [http://joiwiki.ito.com/joiwiki/index.cgi?jibot jibot]

==Meetups==

The idea of having IRC meetups (that is, a set time for meeting on IRC) has been suggested by [[User:RyanKing|Ryan King]], as it appears to work well for the WordPress community and may help us from time-to-time. As of yet, there are no plans to have meetups, though.

= Getting started with IRC =

==Basic commands==
'''Please note:''' These directions relate specifically to the services that [http://freenode.net/ Freenode] offers. Other IRC servers may differ with the services they offer and how to operate them.

===Joining a server and channel===
Most clients will offer you a connection dialogue showing the required fields for connection. The details to connect to the server are:

*Server: <code>irc.freenode.net</code>
*Port: <code>6667</code> (usually default)

You should also fill in any fields to set your alias, real name and email address. If available, save these settings for later to speed up connecting in future.

More on setting a password protected alias can be [[irc#Creating_a_registered_nickname|read here]].

Once connected, you will most likely be presented with the "MOTD" (message of the day). For the first visit, it is advisable to read this to find out about the server's policies and other important pieces of news and help, otherwise it can be ignored and you can either [[irc#Creating_a_registered_nickname|authenticate your alias]] or join a channel.

Your client may display to you a listing of all available channels. Locate <code>#microformats</code> and select to join, or type <code>'''/join #microformats'''</code> into the command line available to you in your client (where you've just been shown your connection).

Assuming you've connected correctly, you should now find youself in the microformats channel!

More detailed, but general, advice can be [http://www.irchelp.org/irchelp/irctutorial.html#intro read here].

===Creating a registered nickname===
Registration means that a password becomes associated with your alias/nickname/sign-in name and from the point of registration authorisation is required to communicate using that alias.

Registration of a nickname is required for some channels, and should be done to protect your identity.

To register with [http://freenode.net Freenode], you must communicate with their service known as NickServ. The two basic command you will need to get started are:

For registration: <code>/msg nickserv register ''password''</code>

For authentication (login): <code>/msg nickserv identify ''password''</code>

With <code>''password''</code> being a value of your choice. You can also associate an email address with your nickname, which is optional, but advisable, should you want to request a password retrieval:

To add your email address: <code>/msg nickserv set email ''email''</code>

Where <code>''email''</code> is your email address.

Your client may offer you an option to set your alias and password, so that you will not have to manually enter this information on each join. Refer to your client's help files for more on this.

These commands can be typed directly into the server window upon join, or whilst in a channel, just as you would normally send a message.

More detailed user registration command information can be found in [http://freenode.net/faq.shtml#userregistration Freenode's FAQ]

===Communicating===

Sending a message to a channel may be as simple as joining the channel and typing into the window, just as you would with an Instant Messenger. You can refer to your client's help files for quicker/alternative methods of doing the following. For all clients the following commands are available (the parts in bold must be used, but are not seen by others):

'''Sending a message to the entire channel you are currently in:'''

Command: '''/msg''' ''Hello world!''

Result: '''<Bill> Hello world!'''

'''Sending an action/emotive/3rd person statement:'''

Command: <code>'''/me''' ''dances a code jig''</code>

Result: '''''Bill dances a code jig'''''

'''Sending a message to one person only (private chat):'''

Command: <code>'''/msg Bob''' ''Hi, would you like to code jig?''</code>

Result (for Bob only): '''<Bill> Hi, would you like to code jig?'''

===Advanced===
...working on...

==Clients==

The following clients are recommended by #microformats participants:

===Windows===

* [http://www.mirc.com/ mIRC] - Popular Windows client. Trial version only.
* [http://xchat.org/ X-Chat] - Popular cross-platform client. [http://www.silverex.org/download/ Free Windows version] available.
* [http://www.adiirc.com/ AdiIRC] - Simple C# based IRC client.
* [http://www.miranda-im.org/ Miranda] - Lightweight, muti-protocol instant messenger.

===Mac===

* [http://colloquy.info Colloquy] -- open source, free
* [http://sourceforge.net/projects/fire Fire] -- open source, free
* [http://www.snak.com/ Snak]
* [http://xchataqua.sourceforge.net/twiki/bin/view/Main/WebHome XChat Aqua] -- X11 based IRC chat
* [http://homepage.mac.com/philrobin/conversation/ Conversation]
* [http://www.chipersoft.com/minerva/ Minerva]
* [http://www.aquaticx.com/ Xirc]

===Cross-platform===
* [http://www.hacksrus.com/~ginda/chatzilla/ Chatzilla] - Cross-platform IRC extension for Firefox
* [http://irssi.org/ Irssi] - Unix client, often run from a shell, sometimes [http://f0rked.com/articles/irssi in conjunction with 'screen'].
* [http://gaim.sourceforge.net/ Gaim] - Cross-platform multi-protocol instant messenger.
* [http://jirc.hick.org/jirc/ jIRCii]

=IRC and microformats=
== hCard ==
''How do we maintain info about ircing in our hCards (nick, network, fav-channels?)?''

== Related discussions ==

* chat [[chat-examples|chat examples]], [[chat-formats|chat formats]], and [[chat-brainstorming|chat brainstorming]]

User:JasonClark

2007-04-30T14:24:11Z

JasonClark:

[http://jclark.org/weblog/ My weblog]

books

2007-04-30T14:21:34Z

JasonClark: Removed spam

<h1> Books </h1>

This page lists books which provide description and documentation of microformats. Most recent first, grouped by year.

== Errata ==
For errata in any of the following, if any, see '''<nowiki>http://en.wikibooks.org/wiki/Errata/[ISBN]</nowiki>''', where [ISBN] is the ISBN with no hyphens or spaces. (Perhaps this could be added to [[Special:Booksources]]?)

== 2007 ==

*"[http://www.friendsofed.com/book.html?isbn=1590598148 Microformats: Empowering Your Markup for Web 2.0]" by John Allsopp
** Friends of Ed, ISBN 9781590598146, March 2007
** Read [http://www.friendsofed.com/extras/1590598148/Appendices.pdf Allsopp's Appendix (PDF)].

== 2006 ==

* ''[http://www.oreilly.com/catalog/neogeography/ Introduction to Neogeography]'' by Andrew Turner
**O'Reilly, ISBN 9780596529956, December 2006
** This is a PDF book, part of the O'Reilly Short Cuts series. Covers the ADR and GEO microformats.

* ''[http://www.oreilly.com/catalog/microformats/ Using Microformats]'' by Brian Suda
**O'Reilly, ISBN 9780596528218, 2006
** This is a PDF book, part of the O'Reilly Short Cuts series. It is a solid introduction to all the established microformats, the history, philosophy and a look at where microformats are headed.

* ''[http://www.amazon.com/gp/product/0596009879 Web Design In A Nutshell, Third Edition]'' by Jennifer Niederst Robbins. '''IMPORTANT: This applies to the THIRD EDITION only!'''
** O'Reilly Media, ISBN 9780596009878, 2006
** Provides an excellent modern standards based foundation for web design that is ideal for understanding microformats, and a whole introductory chapter on microformats as well.
** See also [http://www.oreilly.com/catalog/wdnut3/ Web Design in a Nutshell, Third Edition] (on oreilly.com).

*''[http://www.friendsofed.com/book.html?isbn=1590597656 HTML Mastery]'' by Paul Haine
**Friends of Ed, ISBN 9781590597651, 2006
**Chapter 5, <abbr title="pages">pp.</abbr> 117-154: ''Purpose Built Semantics: Microformats and Other Stories.''

== 2005 ==

* ''[http://www.amazon.com/gp/product/0764597582 Hacking RSS and Atom]'' by Leslie M. Orchard
** Wiley, ISBN 9780764597589, 2005
** The last chapter has a nice section on both publishing and consuming [[hcalendar|hCalendar]] events in either a feed or as part of a page. Les has implemented various microformats (hCalendar entry form as a greasemonkey script, [[xoxo|XOXO]] dynamic editing).
** You can find source code for the [[hcalendar|hCalendar]] scripts from my book [http://decafbad.com/trac/wiki/HackingRssAndAtom at my site]. Look for the files starting with <code>ch18</code>. Buy the book if you like it! [[User:LesOrchard|LesOrchard]] 20:11, 25 Mar 2006 (PST)

Main Page

2007-04-30T14:20:17Z

JasonClark: Removed spam

__NOTOC__
<h1>Microformats Wiki</h1>

'''Hello!''' Welcome to the microformats wiki. If you haven't already done so, please see the [[introduction]] page.

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

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

__TOC__

==Getting Started==

First, read up on what it means to be [[posh]] {{NewMarker}}.

[[what-are-microformats|What are microformats]]? [[what-can-you-do-with-microformats|What can you do with them]]?

The [http://microformats.org/about/ about page], [http://microformats.org/ latest news], plus recent [[press]], [[presentations]], [[books]], [[podcasts]], and [[screencasts]] are also good places for some background information. Our [[cheatsheets]] are handy if you need a quick reminder about a particular microformat. We even have a [[spellcheck|spell-check dictionary]] of microformat-related terms.

Frequently asked questions about this wiki and microformats in general are answered in the [[faq|FAQ]], and there is a [[glossary]].

Want to learn more in person? Check out microformats [[events]].

==Definition==

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

Simply put: "Microformats are a codification of convention." -- [http://easy-reader.net Aaron Gustafson]

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

== How to contribute ==

Do you want to help take microformats to the next level? You can:

*Check out our open [[to-do|to do list]] for things to help get done.
*Join the [http://microformats.org/discuss mailing lists] and [[irc|IRC Channel]] to learn and help answer questions about microformats.
*[[advocacy|Advocate]] the use of microformats.
*help to [[Main_Page#microformats_wiki_in_other_languages|translate this microformats wiki into other languages]] to make microformats globally accessible.
*Find [[orphans|orphaned]] pages, and add links to them.

== Specifications ==
[[microformats|Microformats]] open standards specifications (see also: [[implementations]], [[examples-in-the-wild]])
* [[hcalendar|hCalendar]] - [http://microformats.org/code/hcalendar/creator hcalendar creator]
* [[hcard|hCard]] - [http://microformats.org/code/hcard/creator hcard creator]
* [[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]]
* [[hresume|hResume]]
* [[hreview|hReview]] - [http://microformats.org/code/hreview/creator hreview creator]
* [[rel-directory]]
* [[rel-enclosure]]
* [[rel-home]]
* [[rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]

== Design Patterns ==

{{design_patterns}} 

== Exploratory Discussions ==
Per the microformats [[process]]: research and analysis of real-world [[examples]], existing formats, and brainstorming to motivate the microformat. Please check [[rejected-formats]] before making additions.

* alternates [[alternates-brainstorming|alternates brainstorming]], [[alternates-examples|alternates examples]]
*[[attention]]
* audio-info ([[audio-info-examples|examples]], [[audio-info-formats|formats]], [[audio-info-brainstorming|brainstorming]], [[audio-info-proposal|proposal]]) - Marking up information and metadata related to audio (speech, music, and sound in general). {{NewMarker}}
* blog description [[blog-description-examples|blog description examples]]
* blog info [[blog-info-examples|blog info examples]]
* blog post [[blog-post-examples|examples]], [[blog-post-formats|blog post formats]], and [[blog-post-brainstorming|blog post brainstorming]] (yielded the [[hatom|hAtom]] draft)
* book [[book-examples|book examples]], [[book-formats|book formats]], and [[book-brainstorming|book brainstorming]]
* chat [[chat-examples|chat examples]], [[chat-formats|chat formats]], and [[chat-brainstorming|chat brainstorming]]
* citation [[citation|citation effort]], [[citation-examples|citation examples]], [[citation-formats|citation formats]], [[citation-brainstorming|citation brainstorming]], and [[citation-faq|citation FAQ]]
* code [[code-examples| code examples]], [[code-brainstorming|code brainstorming]] {{NewMarker}}
* comment [[comment-problem|comment problem]], [[comment-examples|comment examples]], and [[comments-formats|comment formats]] (Some stuff needs to be extracted from [[comments-formats]])
* [[collection-description|collection description]] - for describing collections in libraries {{NewMarker}}
* [[course-catalog]]; [[course-catalog-examples]] {{NewMarker}}
* [[currency]]; [[currency-examples]]; [[currency-brainstorming]]; [[currency-proposal]]; [[currency-issues]]
* [[depend-examples]]: examples of dependency graphs, especially as they relate to software {{NewMarker}}
* [[digital-signatures]]: incorporation of digital signatures in Microformatted data; ([[digitalsignature-examples|digital-signature examples]], [[digitalsignature-brainstorming|digital-signatures brainstorming]]) {{NewMarker}}
* directions [[directions-examples|directions examples]] {{NewMarker}}
* directory inclusion [[directory-inclusion-examples|directory inclusion examples]], [[directory-inclusion-formats|directory inclusion formats]]. (see also [[rel-directory]])
* distributed conversation [[distributed-conversation|distributed conversation overview]], [[distributed-conversation-brainstorming|distributed conversation brainstorming]], [[distributed-conversation-examples|distributed conversation examples]], and [[distributed-conversation-formats|distributed conversation formats]]
* forms [[forms-examples|forms examples]]
* file-format ([[file-format-examples|examples]], formats, brainstorming) - for the mark-up of file format information (size, type, codecs, bitrate, etc.) {{NewMarker}}
* genealogy [[genealogy-formats|genealogy exploration]]
* geo extensions
** [[geo-extension-strawman]] - extend geo for moons, other planets, etc.
** [[geo-elevation-examples]] - extend geo for representing altitude {{NewMarker}}
** [[geo-waypoint-examples]] - extend geo for representing routes and boundaries, using waypoints {{NewMarker}}
* group [[group-brainstorming|group brainstorming]] and [[group-examples|group examples]]
* grouping ([[grouping-examples|examples]], [[grouping-formats|formats]], [[grouping-brainstorming|brainstorming]], [[grouping-proposal|proposal]]) - Metadata markup of items that should be grouped together. {{NewMarker}}
* items [[items-brainstorming|items brainstorming]] and [[items-examples|items examples]]
* hash [[hash-examples|hash examples]]
* job listing [[job-listing-examples|job listing examples]] and [[job-listing-brainstorming|job listing brainstorming]]
* last modified [[last-modified-examples|last modified examples]], [[last-modified-formats|last modified formats]], and [[last-modified-brainstorming|last modified brainstorming]]
* hListing [[hlisting-proposal|hListing proposal]], and [[hlisting-feedback|hListing feedback]]
** Also, listing [[listing-examples|examples]], [[listing-formats|formats]], and [[listing-brainstorming|brainstorming]]
* [[product|hProduct]] - [[product-brainstorming|hProduct brainstorming]] | [[product-examples|hProduct examples]]
* [[htodo|hToDo]]
* location [[location-formats|location formats]]. (see also [[adr]] and [[geo]])
* measures and measurement units [[measure]]
* [[media-info]] ([[media-info-examples|media-info examples]], [[media-info-formats|media-info formats]], [[media-info-brainstorming|media-info brainstorming]]) {{UpdateMarker}}
* meeting minutes [[meeting-minutes-examples|meeting minutes examples]], [[meeting-minutes-formats|meeting minutes formats]], and [[meeting-minutes-brainstorming|meeting minutes brainstorming]]
* metalink [[metalink-examples|metalink examples]] {{NewMarker}}
* microsummary [[microsummary-brainstorming|microsummary brainstorming]]
* [[mfo-examples|MFO examples]]
* music [[music-examples|music examples]] {{UpdateMarker}}
* [[operating-hours]]: [[operating-hours-examples]] ..of stores, restaurants, etc. {{UpdateMarker}}
* [[payment]]
* photo note [[photo-note-examples|photo note examples]]
*[[question-answer]], [[question-answer-brainstorming]]; [[question-answer-examples]] {{NewMarker}}
* recipe [[recipe-examples|recipe examples]], [[recipe-brainstorming]] {{UpdateMarker}}
* rel-product [[rel-product-brainstorming|rel-product brainstorming]]
* requirements testing [[requirements-testing|requirements testing overview]], and [[requirements-testing-examples|requirements testing examples]]
* [[rest-examples|REST examples]]
* resume [[resume-brainstorming|resume brainstorming]], and [[resume-formats|resume formats]]
* review [[review-examples|review examples]], and [[review-formats|review formats]] (yielded the [[hreview|hReview]] draft)
* search results [[search-results-example|search results example]]
* show [[show-brainstorming|show brainstorming]]
* showroll [[showroll-brainstorming|brainstorming]]
* [[species]] - for the marking up of the scientific names of living things: [[species-examples]]; [[species-brainstorming]] {{UpdateMarker}}
* table [[table-examples|examples]]
* tagspeak [[tagspeak-examples|tagspeak examples]]
* tagcloud [[tagcloud-examples|tagcloud examples]], and [[tagcloud-brainstorming|tagcloud brainstorming]].
* transit table [[transit-table-examples|transit table examples]]
* [[uid]]
* widget [[widget-examples|widget examples]], and [[widget-brainstorming|widget brainstorming]]
* [[wiki-formats|wiki formats]]
* work of art [[work-of-art|work of art overview]], [[workofart-examples|work of art examples]], [[workofart-formats|work of art formats]], and [[workofart-brainstorming|work of art brainstorming]]
*[[xmdp-brainstorming|XMDP brainstorming]] (see also [[xmdp-faq]])
*[[realestate-propertydetail|realestate-propertydetail brainstorming]]

== Examples ==
* [[examples-in-the-wild]]
* [[implementations]]
* [[zen-garden]]

== Tools, Test Cases and 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.

*[[accessibility]]
*[[faqs-for-rdf]]
*[[icalendar-implementations]]
*[[internationalization]]
*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[http://hg.microformats.org/ Source code repository] -- [[mercurial-quick-start|HowTo: Download code from the repository]]
*[[vcard-implementations]], [[vcard-errata]], [[vcard-suggestions]]
*[[why-are-content-standards-hard]]
* [[profile-examples-in-wild|Profile examples, in the wild]]

== shared work areas ==
* [[buttons]]
* [[icons]]
* [[spread-microformats]]
* [[demo]] - a page with links for quickly demonstrating microformats working in practice.
* [[events]]
* [[to-do]]
* [[microformats-issues]] - issues related to more than one microformat.
* [[external-issues]]
* [[user-interface]]
* [[shortcuts]] to wiki pages with long names
* [[marked-for-deletion]]

== microformats wiki translations in other languages ==

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

* languages with over 100 articles
** [[Main_Page-fr|Français (French)]] {{UpdateMarker-fr}}
* languages with over 10 articles
** [[Main_Page-pt-br| Português (Brazilian Portuguese)]]
** [[Main_Page-ja|日本語 (Japanese)]]
* languages with over 2 articles
** [[Main_Page-es|Español (Spanish)]]
** [[Main_Page-de|Deutsch (German)]]

See also [[other-languages]], and [[how-to-start-new-translation|how-to-start-a-new-translation]].