Microformats Wiki - User contributions [en]

hkit-issues

2009-07-27T00:39:56Z

Beaulebens: create page, add 2 new issues.

== hKit Issues ==
* [http://getsatisfaction.com/satisfaction/topics/hcard_profile_import_is_erratic hCard profile import is erratic]
* If your hCard contains multiple emails or phone numbers, it will drop all of them from the output (e.g. you will have no emails/phone numbers in your output)
* The scheme-detection in $hKit::resolvePath() cause non-http URIs to be resolved as absolute paths. That can be fixed by replacing that method with this:
<pre><nowiki>
private function resolvePath($filepath)
{ // ugly code ahoy: needs a serious tidy up

$filepath = $filepath[0];

$bits = parse_url( $filepath );
if ( !empty( $bits['scheme'] ) ) {
return $filepath;
}

$base = $this->base;
$url = $this->url;

$bits = parse_url( $base );
if ( !empty( $bits['scheme'] ) )
$url = $base;

$r = parse_url($url);
$domain = $r['scheme'] . '://' . $r['host'];

if (!isset($r['path'])) $r['path'] = '/';
$path = explode('/', $r['path']);
$file = explode('/', $filepath);
$new = array('');

if ($file[0] == ''){
// absolute path
return ''.$domain . implode('/', $file);
}else{
// relative path
if ($path[sizeof($path)-1] == '') array_pop($path);
if (strpos($path[sizeof($path)-1], '.') !== false) array_pop($path);

foreach ($file as $segment){
if ($segment == '..'){
array_pop($path);
}else{
$new[] = $segment;
}
}
return ''.$domain . implode('/', $path) . implode('/', $new);
}
}
</nowiki></pre>

hkit

2009-07-27T00:26:28Z

Beaulebens: /* issues */

{{TOC-right}}
<h1>hKit</h1>

hKit is an open source library and web service written by [http://allinthehead.com/ Drew McLellan] that [[implementations#hKit_Microformats_Toolkit_for_PHP5|implements parsing of hCards]] into a PHP or JSON data structure.

== open source ==
* [http://hkit.googlecode.com/ hKit Microformats Toolkit for PHP5] as [http://allinthehead.com/retro/291/hkit-microformats-toolkit-for-php announced by Drew McLellan]

== web service ==
* [http://tools.microformatic.com/help/xhtml/hkit/ hKit parser web service]
* Example: http://tools.microformatic.com/query/plain/hkit/microformats.org

== how to call ==
See [[representative-hcard-parsing]] for open source PHP to call hKit and extract the representative hCard from a page that has multiple hCards.

== implementations ==
Services that use hKit:
* [http://getsatisfaction.com/people/new GetSatisfaction.com] (as blogged: http://microformats.org/blog/2007/06/21/microformatsorg-turns-2/ )

== issues ==
[[hkit-issues]]

== related ==
* [[hcard|hCard]]
* [[implementations]]
* [[social-network-portability]]

hcard-user-interface

2009-07-26T02:17:43Z

Beaulebens: /* data export */

<h1> hCard User Interface </h1>
{{TOC-right}}
This page is for techniques and issues surrounding [[user-interface|user-interfaces]] to author, publish, and display [[hcard|hCards]].

== Authors ==
* [http://allinthehead.com/ Drew McLellan]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc]

== Single Input Field for Names ==
When capturing name data that is later to be presented as a hCard, it's important that the data is collected at the highest fidelity possible. As not all names are suitable for hCard's implied-n optimisation (and therefore can't be output as <code>fn</code>, with <code>n</code> omitted), capturing component parts of the name individually enables the proper construction on <code>n</code> when generating the hCard.

Sometimes, however, constraints require a name be collected with a single field. Once such example is common blog CMSs (WordPress, TextPattern) that use a single database field to store the name against each post comment. In such cases it is always desirable to find a way to collect the name with higher fidelity. However, if this simply cannot be done, the implementer could chose to attempt to best-guess the component parts of the name to form a valid <code>n</code>.

One suggested 'best-guess' algorithm might be:

# If the name is one word, attempt [[hcard#Implied_.22nickname.22_Optimization|implied nickname optimization]]
# If the name is two words, attempt [[hcard#Implied_.22n.22_Optimization|implied n optimization]]
# For three or more words
## Perform a lookup against known sub-name combinations (e.g. 'Sarah Jane', 'Vander Wal')
## Apply the grammar "(honorific-prefix) given-name additional-name(s) family-name (honorific-suffix)"

The principal behind this suggestion is that it's better to make a good guess and potentially miscategorise an ambiguous name component than to generate an invalid hCard.

== Additional user interface ==
Some examples of additional user interface for hCard. Note that most of these actions should be applicable to all instances of the microformat on the page at once (e.g. export all contacts), of for a selection of instances (e.g. export selected contacts), or one just one specific instance (e.g. export contact XYZ).

=== address book integration ===
* "Add to Address Book" (convert the hCard to a vCard (.vcf) and pass it onto the OS to automatically open/incorporate into the user's preferred local address book application)
* add to Gmail, Yahoo Mail, Hotmail address book (etc.)
=== desktop to phone transfer ===
* send to Bluetooth, for quick transfer of contact info from the web to a cell phone.
* display contact details in an on-screen or downloadable [[semacode]], [[qr_code]] or other [[2d_barcodes]] (to allow them to be read by mobile devices)

=== telephony integration ===
* If a <code>tel</code> (phone number) having type <code>home</code>, <code>work</code> or <code>cell</code> is present, provide options to dial it (NB applies to one number at a time only; except for possible conference-call uses) directly, or via
** built-in modem
** bluetooth command to a paired device (e.g. cell phone)
** default telephony app (e.g. skype-out)
* If a <code>tel</code> (phone number) having type <code>home</code>, <code>work</code> or <code>cell</code> is present, provide options to send MMS:
**directly
**using on-line service
** bluetooth command to a paired device (e.g. cell phone)
=== fax integration ===
* If a <code>tel</code> of type <code>fax</code> is present, provide options to send a fax to it via:
** efax online service
** built-in fax modem
=== birthday planning ===
* If a birth-date is present, treat it as a recurring hCalendar event.
=== address canonicalization ===
* Given a postal code (or other partial address) fetch the full, canonical postal address for the relevant authority's website (e.g. [http://postcode.royalmail.com/portal/rm/postcodefinder]). If no country is defined, used the user's locality as the default.

=== data export ===
* export as text/ [[csv|comma-separated-variables]] (CSV) to allow editing, sorting and/ or import into spreadsheets/ databases, etc. (or concatenate to existing file)

=== data import ===
* load hCard data from a URL using Yahoo's YQL via jQuery http://shapeshed.com/journal/populating_forms_with_yql_jquery_and_microformats

==see also==
{{hcard-related-pages}}

self-updating-address-book

2009-07-25T22:48:04Z

Beaulebens: New page: == Self Updating Address Book == Basic Idea: an online address book/contact system, accessible via LDAP, which updates its records by periodically crawling/parsing URLs containing hCards....

== Self Updating Address Book ==

Basic Idea: an online address book/contact system, accessible via LDAP, which updates its records by periodically crawling/parsing URLs containing hCards.

=== Participants ===
* Beau Lebens
* Matt Wilkinson
* Mark Ng
* Tantek Celik
* Chad Weider

User:BeauLebens

2009-07-16T18:04:48Z

Beaulebens: New page: <div class="vcard">Beau Lebens (http://dentedreality.com.au/,http://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c...

<div class="vcard">Beau Lebens (http://dentedreality.com.au/,http://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50.jpg?s=256&r=X)</div>
----
{{cc-public-domain-release}}

events/2009-07-25-dev-camp

2009-07-16T18:02:50Z

Beaulebens: Added myself, updated address to include Pier 38 and added a session (hCard->address book)

<entry-title>microformatsDevCamp</entry-title>
http://farm3.static.flickr.com/2460/3726302070_7b834b9443_o.jpg

<div class="event-page vevent">
;When
:2009-07-25 from 12:00 to 2009-07-26 at 17:00
;Where
:Automattic, Pier 38, The Embarcadero between Brannan and Townsend, San Francisco, CA, 94107. [http://maps.google.com/maps?f=q&source=s_q&hl=en&geocode=&view=map&q=%2BAutomattic,+The+Embarcadero,+San+Francisco,+CA+94107&sll=37.752736,-122.402826&sspn=0.13844,0.217667&gl=us&ie=UTF8&t=h&layer=c&cbll=37.782877,-122.388062&panoid=kB1DhzPP5DYl5pgHBRxdPg&cbp=12,123.84,,0,2.44&ll=37.783053,-122.388044&spn=0,359.996599&z=18 View location at latitude:37.782769, longitude:-122.387837]
:'''MUNI''': [http://playfoursquare.com/venue/72202 Brannan] (N,T)
:'''BART''': Embarcadero station, then [http://www.nextmuni.com/predictor/prediction.shtml?a=sf-muni&r=N&d=N__IB3&s=6992&ts=4506 take MUNI N-Judah inbound] or T-Third inbound to Brannan stop.
:'''Caltrain''': 4th & King st., then [http://www.nextmuni.com/predictor/prediction.shtml?a=sf-muni&r=N&d=N__OB2&s=5240&ts=7145 take MUNI N-Judah outbound] or T-Third outbound to Brannan stop.
;What
:microformatsDevCamp! The first ever microformatsDevCamp, for authors, designers, publishers, developers, engineers building pages, sites, and tools with microformats.
;URLs
:http://microformats.org/wiki/events/2009-07-25-dev-camp
:http://upcoming.yahoo.com/event/2888376/
;short URL
:http://tr.im/ufdevcamp

'''[http://suda.co.uk/projects/microformats/hcalendar/get-cal.php?uri=http://microformats.org/wiki/events/2009-07-25-dev-camp Add this event to your calendar]''' http://www.boogdesign.com/images/buttons/microformat_hcalendar.png

== attendees ==
microformatsDevCamp, like any BarCamp, needs you!

Sign up to volunteer, attend, design, code, and build with microformats!

=== planners ===
Want to help organize and plan the first microformatsDevCamp? Sign up and be sure to pick up a planner role (see below).
* [[User:Tantek|Tantek Çelik]] - '''organizing, venue acquisition'''
* [[User:Rohit|Rohit Khare]] - '''venue acquisition'''
* Chris Messina - '''intro and kickoff'''- run the introductory session and help start the microformatsDevCamp with traditional BarCamp intros/3tags and explanation of the BarCamp format.
* [[User:EdwardOConnor |Edward O'Connor]] (Ted) - '''volunteer coordinator, cleanup'''
* [[User:Pseudowish|Lauren Scime]]
* ...

Planners: please see and keep up with the [[#planner_to_do]] section!

=== volunteers ===
Like all [http://barcamp.org BarCamps], this event is what it is because of what everyone puts into it. Volunteer to help setup, check people in, get them setup with a name badge, clean up, and help people in general have a good time and get things done.
* Cindy Li - designer, helping with microformatsDevCamp logo design. done!
** full resolution logo: <nowiki>http://farm3.static.flickr.com/2460/3726302070_7b834b9443_o.jpg</nowiki>
** on Flickr: http://www.flickr.com/photos/cindyli/3726302070/
* [[User:BeauLebens|Beau Lebens]] - developer, Automattic, [[http://dentedreality.com.au/ Dented Reality]]. I know my way around the venue, so can help sort out power strips, projectors etc
* ...

=== participants ===
Not sure what is going on but want to design interfaces or build stuff with microformats and want help doing it? Sign up! Add yourself alphabetically sorted by family name. Note your site (with [[hCard]] if you have it), interests/projects, and tag yourself as a web '''author''', '''designer''', '''publisher''', '''developer''', or several.
* ...

==venue==
Automattic has very graciously agreed to host microformatsDevCamp. The venue has:
* wifi
* power. power outlets, extension cords, power strips
* 4-5 rooms/meeting areas.
* 3 projectors
* 1 whiteboard.
* sink, water.

As Automattic is donating the venue, as participants it is our responsibility to take excellent care of the venue, leaving it as good or better than we found it.

Some amount of camping overnight at the venue will be possible.

== tags ==
Please use the following tags when tagging related content (blog posts, photos, videos):

tags:
<kbd class="tags" style="display:block">
'''#ufdevcamp'''
ufdevcampsf
microformats
microformatsDevCamp
microformatsDevCampSF
microformats-meetup
BarCamp
BarCamp2009
Automattic
The-Embarcadero
san-francisco
upcoming:event=2888376
</kbd>

Track:
* [http://search.twitter.com/search?q=ufdevcamp #ufdevcamp on Twitter Search].
* [http://identi.ca/tag/ufdevcamp #ufdevcamp] tagspace on identi.ca.

Groups:
* [http://identi.ca/group/microformats !microformats Identi.ca group] (aliases: !mf and !uf). Join and address the whole group. Notices to this group can also be tracked from [http://identi.ca/tag/microformats #microformats]

== notes ==
topics discussed:
* ...

== session ideas ==
Have an idea for a session? Please read <cite>[http://factoryjoe.com/blog/2007/07/13/what-is-a-devcamp/ What is a DevCamp?]</cite> and then suggest something or add a "+1" to existing suggestions, and sign your suggestion or opinion with your Username with <nowiki>~~~</nowiki>
* '''microformats and user sign-up user interface''' - how can importing and subscribing to hCards help make user sign-up easier and thus get more users signed up quicker? [[User:Tantek|Tantek]]
* '''using hCard to build a self-updating address book''' - in the search for an address book/contact list that actually stays up to date, hCard may be the key. [[User:Beaulebens|Beau Lebens]]
* ...

== sessions ==
Please create a wiki page for any session you lead or attend and link to it from here.
* ...

== photographs ==
* ...

== blog posts ==
Blog posts about the meetup. Newest first.
* ...

== see also ==
* [http://factoryjoe.com/blog/2007/07/13/what-is-a-devcamp/ Chris Messina: What is a DevCamp?]
* ...

</div> 

== Related Pages==
microformatsDevCamp is one of several microformats [[events]].

{{events-related-pages}}

== planner to-do ==
<div class="discussion">
* I'm free most weekends through till the end of August. --[[User:Pseudowish|Lauren Scime]] 17:20, 10 July 2009 (UTC-7)
** Please see [[#planner_roles|planner roles]] section and grab 1-2 roles that you want to help out with and add them next to your name in the planners list as Rohit, Chris, Ted, and I have done. --[[User:Tantek|Tantek]] 17:36, 14 July 2009 (UTC)
</div>

=== planner roles ===
We need the following roles and responsibilities to be picked up by planners!
* '''sponsors''' - for food, t-shirts
* '''t-shirts''' (get estimate, make sure to order in time for the event, I think Ben Ward may be working on this - check with him)
* '''food''' - coordinate / match up sponsors with meals and make sure the meals arrive and are setup for the attendees
* '''setup''' - be in charge of setup the day of, coordinate with venue on setup plenty of time *before* the start of the camp! setup: power cords, power strips, calendar grid for sessions, tables and chairs in rooms/meeting areas, projectors
* '''volunteer coordinator''' - recruit and organize volunteers the day of the event to help out with food, setup
* '''cleanup''' - enlist help of volunteers and all devCamp participants to help with cleanup

If you're a planner, please pick up and move one or more of these roles/responsibilities to your name above. Thanks!

===T-shirts===
* Make design
* Print

===Sponsors===
* collecting some donations for microformatsDevCamp at [[events/2009-06-26-microformats-4th-bday]]
* Figure out rough budget
* Find sponsors for each item

===Food and drink===
* Lunch Saturday - sponsored by ____________
* Dinner Saturday - sponsored by ____________
* Social Event (Sat. night)? - sponsored by __________
* Breakfast Sunday - sponsored by __________
* Lunch Sunday - sponsored by ___________
* ...