h-resume

2016-09-19T18:02:01Z

Lejenome: add moez bouhlel resume to examples

<entry-title>h-resume</entry-title>
[[User:Tantek|Tantek Çelik]] (Editor)
----
<dfn style="font-style:normal;font-weight:bold">h-resume</dfn> is a simple, open format for publishing resumes and CVs on on the web. h-resume is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML/HTML5.

h-resume is the [[microformats2]] update to [[hResume]].

{{cc0-owfa-license}}

== Example ==
Here is a simple resume example:

<source lang=html4strict>
<div class="h-resume">

<a class="p-contact h-card" href="http://example.org">
<img src="http://example.org/photo.png" alt="" />
Joe Bloggs
</a>
resume


Joe is a top-notch llama farmer with a degree in Llama husbandry and a thirst to produce the finest wool known to man
</div>
</source>

Parsed JSON:
<source lang=javascript>
{
"items": [
{
"type": [
"h-resume"
],
"properties": {
"name": [
"Joe Bloggs resume"
],
"contact": [
{
"value": "Joe Bloggs",
"type": [
"h-card"
],
"properties": {
"name": [
"Joe Bloggs"
],
"photo": [
"http://example.org/photo.png"
],
"url": [
"http://example.org"
]
}
}
],
"summary": [
"Joe is a top-notch llama farmer with a degree in Llama husbandry and a thirst to produce the finest wool known to man"
],
"skill": [
"Llama husbandry"
]
}
}
]
}
</source>

=== Get started ===
The class '''<code>h-resume</code>''' is a ''root class name'' that indicates the presence of an h-resume.

See [[microformats2-parsing]] to learn more about property classnames.

== Properties ==
h-resume properties, inside an element with class '''h-resume''':
* '''<code>p-name</code>''' - brief name of the resume
* '''<code>p-summary</code>''' - overview of qualifications and objectives
* '''<code>p-contact</code>''' - current contact info in an <code>[[h-card]]</code>
* '''<code>p-education</code>''' - an education <code>[[h-event]]</code> event, years, embedded <code>[[h-card]]</code> of the school, location. {{main|h-event}} {{main|h-card}}
* '''<code>p-experience</code>''' - a job or other professional experience <code>[[h-event]]</code> event, years, embedded <code>[[h-card]]</code> of the organization, location, job-title. {{main|h-event}} {{main|h-card}}
* '''<code>p-skill</code>''' - a skill or ability, optionally including level and/or duration of experience
* '''<code>p-affiliation</code>''' - an affiliation with an <code>[[h-card]]</code> organization

All properties are optional.

== Status ==

'''h-resume''' is a microformats.org draft specification. Public discussion on h-resume takes place on [[h-resume-feedback]] and the #microformats [[irc]] channel on irc.freenode.net.

h-resume is ready to use and implemented in the wild, but for backwards compatibility you should also mark h-resumes up with classic [[hResume]] classnames.

== Property Details ==

(stub, add any property explanations here)

'''p-skill''' has a [[hresume-skill-brainstorm|proposed expansion into competency]] with explicit summary, rating and/or duration components. Based on existing real world adoption, we should consider an h-skill vocabulary with p-name, p-rating, and dt-duration properties.

== Examples in the Wild ==
* [[User:Csarven|Sarven Capadisli]] has marked up his [http://csarven.ca/cv Curriculum Vitae] as an h-resume.
* [https://lejenome.github.io/ Moez Bouhlel] has marked up his [https://lejenome.github.io/resume résumé] using h-resume.
* … add any h-resume examples you find in the wild

== Validating ==
{{h-spec-section-validating}}

== Backward Compatibility ==
=== Publisher Compatibility ===
(stub)
=== Parser Compatibility ===
Microformats parsers {{should}} detect the following root class name and property names. A microformats2 parser may use existing microformats [[parsers]] to extract these properties. If an "h-resume" is found, don't look for an "hresume" on the same element.

compat root class name: <code id="hresume">hresume</code> 
properties: (parsed as '''p-''' plain text unless otherwise specified)
* <code>summary</code>
* <code>contact</code> - including compat root <code>vcard</code> in the absence of <code>h-card</code>
* <code>education</code> - including compat root <code>vevent</code> in the absence of <code>h-event</code>
* <code>experience</code> - including compat root <code>vevent</code> in the absence of <code>h-event</code>
* <code>skill</code>
* <code>affiliation</code> - including compat root <code>vcard</code> in the absence of <code>h-card</code>

== Background ==

h-resume is based on the existing [[hResume]] specification.

== See Also ==

* [[microformats2]]
* [[h-card]] and [[h-event]] are both embedded in h-resume
* The [[include-pattern]] is likely to be useful to avoid repeating information in any embedded h-cards
* [[hResume]] is the classic microformat replaced by h-resume

[[Category:Draft Specifications]]

Microformats Wiki - User contributions [en]

h-resume