#microformats 2012-04-10

2012-04-10 UTC
#
Loqi
[http://twitter.com/AymanAboulnasr] Previously from LatestWP: Make your Review Articles Stand out in Google Search Results Pages with hReview... http://t.co/ByaKS5pE #wordpress
#
tianshishiabn
edited /hcard-examples-in-wild (+110) "/* related pages */"
(view diff)
#
tantek
edited /Special:Log/block () "blocked [[User:Tianshishiabn]] with an expiry time of infinite (account creation disabled): Spamming links to external sites"
(view diff)
#
tantek
edited /hcard (-1) "/* Properties */ "use Ms for women... unless they have expressed a preference for Miss or Mrs" per http://en.wikipedia.org/wiki/Ms. / The Guardian"
(view diff)
#
tantek
edited /hcard (+0) "re-order n subproperties in common properties summary by order commonly published"
(view diff)
Soopaman and manu1 joined the channel
#
tantek
edited /hcard (+2328) "/* Properties */ longer example hCard demonstrating list of common properties"
(view diff)
#
tantek
edited /hcard (+121) "fix some alignment, simpler intro, shorter descriptions, nowrap so they align even when narrower, float both to avoid text overlapping"
(view diff)
#
tantek
edited /hcard (+3) "/* Properties */ use time element for bday"
(view diff)
#
tantek
ok another update to the list of common hCard properties - added a line-by-line example adjacent to the list: http://microformats.org/wiki/hcard#Properties
#
tantek
please take a look and see if that helps with the introduction of common properties (which I think is the 2nd most common thing people will look for after the very simple examples at the top) http://microformats.org/wiki/hcard - cc: Phae aaronpk hober mkowens singpolyma
#
Loqi
[http://twitter.com/StepUpWeb] hCard Как использовать для сайта? Советы http://t.co/b3EUzgC2
jkridner_ joined the channel
#
ChiefRA
hi tantek I'll have a look
voxpelli joined the channel
#
tantek
thanks ChiefRA
Chel and barnabywalters joined the channel
#
tantek
edited /hcard (-1) "/* Properties */ left left floats for more predictable layout"
(view diff)
#
tantek
ok with that minor styling tweak the new common "properties" section and line-by-line example should be good to go
#
tantek
good morning Phae, would appreciate your review/thoughts of the usability/readability of the new section I added to the hCard spec, in terms of how it reads from the beginning: microformats.org/wiki/hcard
#
Loqi
*yawn* it looks like overcast
#
neuro`
Morning
#
tantek
morning neuro - take a look at microformats.org/wiki/hcard and let me know what you think of the new list of common properties and example next to it
#
neuro`
tantek: I was reading it
#
barnabywalters
IMO that is a significant improvement — much clearer and more useful
#
neuro`
I like it. Would have probably put the code part on the left though
#
neuro`
Plus no vertical separator between the code and its explanation makes it a little harder to read.
#
tantek
neuro - I've heard the opposite (about left vs right) - I think having the more english readable list on the left is a nicer reference for most folks
#
tantek
and the code on the right provides a good learning reminder for newer folks
#
tantek
when you say no vertical separator - are you saying the two columns are next to each other?
#
tantek
like too close to each other?
#
tantek
and thanks barnabywalters!
nonge_ joined the channel
#
barnabywalters
anything that makes microformats easier to implement and understand is good in my book
#
neuro`
tantek: just did some tests, and a visual separator doesn't add any readability, so forget about it. And yes, for normal people, English first, code second makes sense.
adactio and barnabywalters joined the channel
#
Phae
hey tantek. i'll get to it. first day back after time away, so i'm a bit swamped this morn. should have some time this evening.
elf-pavlik, globbot and comkee joined the channel
#
ChiefRA
tantek: a) I would somehow combine the "Property list" section with "Properties" one-on-one (making only one section) b) I would of placed "Properties" 1st, then "Property list" 2nd and then "Property notes" sections first and then the "Example" one for usability.
Soopaman joined the channel
#
Loqi
[http://twitter.com/tadayoshinori] @hatom_ne せやで!!
MacTed joined the channel
#
Loqi
[http://twitter.com/glennjones] Nice use of hCard and OpenGraph data ‘Save to foursquare’ button https://t.co/Qs4MesnI
Soopaman, Rasifiel and barnabywalters joined the channel
#
tantek
ChiefRA - I had considered including all the properties in the "Properties" section at the top, but decided not to for usability reasons.
#
tantek
The vast majority of authors using hCard don't care about *all* the properties
#
tantek
In addition, I've had the suggestion from folks that they want/need to see very simple a markup example of each property as they're reading the simple list, and as such the side-by-side layout is the most compact I could come up with (being able to see as much of that on the screen at once also improves usability)
#
tantek
Finally, the decision to do the markup example of each property next to the list of common properties led to realizing it should all make sense as part of a single composite example which you could copy/paste (which people *will* do because that's what they do with example) and thus it made sense to reduce the common properties set down to what people actually *do* commonly publish.
#
tantek
Thus a) we still need a "property list" section with the full list of properties *somewhere else* (that I'm still figuring out how to best design), and b) keeping the example of the common properties adjacent to the list of common properties themselves is *better* for usability, than separating them into different sections where people would have to scroll back/forth to look at a property definition vs. use in markup.
#
tantek
Alternatively, if you think you've figured out a better content design for that section, try a sample edit of it on your user page, and show some folks in comparison to what's on hCard right now and see what feedback you get.
#
tantek
Every one of these recent content design iterations on the hCard spec has been based directly on feedback from multiple individuals.
#
tantek
Phae, welcome back, and whenever you can get to it would be great. Hopefully it won't take more than 5-10 min to review and get a feeling for.
#
tantek
hmm, I wonder if Loqi has a pattern match for verb all the nouns and then turns it into an image.
#
Loqi
is done
#
mkowens
tantek: I feel like there's probably two sets of properties, sort of like "Core" and "Extended" properties. I don't exactly know how to delineate them, but the current list seems fine as of right now, in my opinion (at least with the limitations of the wiki format).
#
tantek
mkowens - yeah, in theory there shouldn't need to be such a delineation, due to the process and 80/20 rule, but in practice with hCard and hCalendar I took all of vCard and iCalendar and that was probably a mistake.
#
tantek
that being said, even some of the presumably 80/20 properties from research end up not being used as often as the data would have led us to expect
#
tantek
btw I despise the term "core" because it's almost always just a replacement for a "pure judgment call"
#
mkowens
Actually, I don't think that was a mistake.
#
tantek
"common" to me implies at least there's some data/experience with actual usage in the wild
#
tantek
mkowens, fair enough. including all of vCard and iCalendar EVENT object was perhaps not so much a mistake as a "best first guess" that I should have iterated further on and dropped various properties accordingly.
#
mkowens
And yes, "Core" is sometimes a "pure judgement call" but "Common" and "Uncommon" doesn't feel right for defining spec. :-\
#
mkowens
Anyway, standup. I'll be back in a bit.
#
tantek
re: defining a spec, that's the irony, the use of "core" is in practice less precise than the use of "common"
#
tantek
ooh standups - you know my opinion/experience on those.
#
Loqi
[http://twitter.com/mefiblogger] Hirtelen beindult a mezÅ‘ny, már csak hátom ember a sorban!!
#
mkowens
Yeah. I'm not a fan. And you're probably right regarding the use of "Common" versus "Core." I just feel like the connotation of "Core" and "Common" are both different. "Common" feels—to me, at least—not definitive, but rather entirely observational.
#
tantek
observational tends to be better than a priori
#
tantek
I've yet to see someone good at defining "core"
patcito joined the channel
#
mkowens
tantek: what about the DOM Core? Doesn't that represent a pretty good definition of "core"?
#
tantek
mkowens - no it practice it was a disaster
#
tantek
originally, DOM Core meant "stuff from XML that no one actually uses when writing JS on the web"
#
tantek
vs. DOM HTML
#
tantek
it was a political split
#
mkowens
Oh. Okay.
#
tantek
DOM Core was the clean based on XML/Java and nearly useless/unusable part of the DOM
#
tantek
perfect example to prove my point
#
mkowens
I guess that's why DOM4 dropped the "Core" in the title (even though it's still in the URL)?
#
tantek
yeah that would make sense
#
mkowens
Point conceded.
#
tantek
so yes, any time you see someone refer to "core", in a spec, ask them, what makes it "core"? what are the practical distinctions between "core" and other parts?
danbri and Soopaman joined the channel
#
tantek
edited /hcard (-44) "/* Properties */ tighten up the columns so they're closer together"
(view diff)
#
dchavez
created /air_conditioning_repair_katy_tx (+1245) "local home service company in Katy, Texas offering air conditioning repair."
(view diff)
#
tantek
edited /Special:Log/block () "blocked [[User:Dchavez]] with an expiry time of infinite (account creation disabled): Spamming links to external sites"
(view diff)
#
tantek
deleted /air_conditioning_repair_katy_tx "content was spam"
#
tantek
edited /hcard (-59) "move the "want to get started" to just after the list/example of common properties"
(view diff)
#
tantek
edited /hcard (-3) "bit more space after common properties list, copy edit want to get started points"
(view diff)
#
tantek
edited /hcard (-1) "a bit more spacing"
(view diff)
jkridner_ joined the channel
#
anneliviasimoes
edited /hlisting (+184) "/* Examples in the Wild */"
(view diff)
barnabywalters, tantek and kennyluck_ joined the channel
#
Loqi
[http://twitter.com/GlennF] Does Apple support any microformats in Mail? Its own or hCalendar or what have you? I thought so. Docs are horrible.
#
Loqi
[http://twitter.com/BarnabyWalters] @idiot Why have you made a vcard style site without marking it up with hcard? Surely that's the… purpose?
#
tantek
barnabywalters - good point. he could use hCard and rel=me both on his "vcard style site" as well as on his blog home page where he links to several other profiles: http://visualidiot.com/
#
barnabywalters
ARGH!! TOO MANY PROFILE PAGES! How does he justify the expenses for all the random domains he manages?!
#
tantek
hah - maybe he's addicted to domains? ;)
#
tantek
I don't understand his latest tweet - does he dislike semantic class names?
#
barnabywalters
he owns upsidedownkittens.com for god's sake
#
barnabywalters
and there's nothing on it!
#
barnabywalters
I think he means the vCard style sites
#
Loqi
[http://twitter.com/idiot] @BarnabyWalters Trouble is, though, I try to give as little info away as possible, which means it probably fails hCard validation.
#
barnabywalters
I hadn't heard of them before he mentioned them
#
tantek
all an hCard needs to be valid is an 'fn' - the examples are right there at the top of the spec! http://microformats.org/wiki/hcard
#
singpolyma
hCard validation :P part of the problem with microformats listing "required attributes" is people get the dumb idea that if they don't have those attributes, they shouldn't use the microformat
#
tantek
singpolyma - agreed - hence why everything is optional in microformats-2 - we've learned our lesson.
#
singpolyma
that was a fight I used to have with people over hAtom all the time
#
tantek
which side of the fight?
#
singpolyma
I just publish "invalid" microformats, because I consider microformats useful guidelines on taxonomy, not stone tablets :)
#
barnabywalters
I think he's just trying to make some point about vCard sites… trouble is, I'm not sure exactly what :|
#
tantek
invalid how?
#
tantek
also - note that the "required" properties in hCard/hCalendar/hAtom came directly from the requirements in vCard/iCalendar/Atom - and carrying that "required" semantic forward was a mistake (I'll take responsibility for that)
#
tantek
whereas what I should have simply done is describe how to generate any such required other-format properties from the respective microformats
#
singpolyma
invalid in that I was either missing a required attribute (I think author is "required" in hAtom, or was). or the wrong format (I used to publish hAtom with wrong-formatted dates all the time)
#
tantek
well the author requirement is going away - so you're fine there (and helped shape the evolution/iteration)
#
tantek
what kind of dates do you publish?
#
singpolyma
yes, I know :) I'm not complaining, just saying
#
barnabywalters
I initially published Atom feeds with normal datetimes
#
singpolyma
I publish valid <time> these days :) Back in the day I would just dump whatever the default format on my Blogger system was, because that used to be the only option.
#
barnabywalters
YYYY-MM-DD HH-MM-SS and the like
#
tantek
"normal" ?!? (according to what cultural norms? ;) )
#
Loqi
[http://twitter.com/idiot] @BarnabyWalters Using http://t.co/csbtVbwG generates some awful markup. Plus, semantics are bad: did you not see Terminator?
#
tantek
barnabywalters - perhaps we could help him out with some example markup
#
barnabywalters
Somehow I don't think it's worth it. But we can but try
#
tantek
ah, he doesn't like the hCard generator - interesting
#
singpolyma
because my hAtom parsers can happily handle any date format (and that's all I ever parsed it with) and also because I consider some semantics ("this is the date") better than none ("this is some text")
#
tantek
any date format?
#
tantek
like 4/10/12 ?
#
singpolyma
well, "any sensible" :P
#
singpolyma
I use fuzzy date parsers for everything
#
tantek
fuzzy means different things to different people
#
tantek
fuzzy itself is fuzzy
#
singpolyma
I've never liked the hCard/hCal creators either, but I just ignore them and make my own stuff happily :)
#
Loqi
[http://twitter.com/BarnabyWalters] @idiot No, I haven't see terminator. And I dislike that generator too, there's a better guide at http://t.co/E8IZqb2F
#
tantek
singpolyma - the creators are better than nothing
#
singpolyma
again, I'm not complaining
#
singpolyma
I like microformats :)
#
barnabywalters
I prefer working from examples than generators, but low barrier of entry is good
#
tantek
and they're open source to encourage folks to make better versions :)
#
tantek
so if you don't like them, make better ones!
#
barnabywalters
Okay, I will
#
barnabywalters
for me the key is making one that you can customise to fit with your code layout style
#
singpolyma
I don't know if something like the hCard creator can be made very good, but I'm willing to be proven wrong :) Usually CMS plugins work well IME
#
tantek
barnabywalters - it wouldn't take many code changes to hCard-ify @idiot's .vc site
#
tantek
e.g. <div class="vcard">
#
barnabywalters
heh. perhaps 25 characters to make it a 'valid' hcard?
#
tantek
<h2>The name&rsquo;s <span class="fn nickname">Idiot</span>.</h2>
#
singpolyma
is the whole site just one hCard? could put class="vcard" on <body> ;)
#
tantek
(this is on idiot.vc)
#
tantek
<a class="url" rel="me" href="//visualidiot.com">anything off my blog</a>
#
tantek
<a class=url rel=me href="//twitter.com/idiot">Twitter</a>, <a class=url rel=me href="//forrst.me/vi">Forrst</a>, or <a class=url rel=me href="//dribbble.com/vi">Dribbble</a>
#
tantek
that should do it
#
singpolyma
oh, gross, that site's links animate when I hover them
#
singpolyma
yeah, looks pretty simple
#
barnabywalters
*Tries hovering ARGH! the jaggies have come. That's hideous
#
singpolyma
it's the 90s again!
#
singpolyma
90s happy dance
#
barnabywalters
but this time, it's 'tasteful'. With blue and sans serif and all
#
barnabywalters
tantek - reckon you could fit all the markup he needs in a single tweet?
#
mkowens
On Mac in Chrome, I see no jaggies. I bet in Windows on IE it does.
#
mkowens
^.^
#
barnabywalters
mac safari. I doubt there'd be any jaggies in IE… unless he's using some kind of -ms-transform
#
tantek
barnabywalters, since this channel is logged, you could just send him an IRC log link like this: http://krijnhoetmer.nl/irc-logs/microformats/20120410#l-199
#
tantek
(i've highlighted the relevant markup lines)
#
mkowens
Nah. I was referring to the fact that any sort of text-shadow or -ms-animation (both of which are made use of) cause jaggies in IE.
#
barnabywalters
not sure that'd have the same sort of impact factor as 'here it is, all in a tweet' :)
danbri joined the channel
#
Loqi
[http://twitter.com/c2lexbx] @wenyunchao Category:Articles with hCards - WikiMommy