Difference between revisions of "h-resume"

From Microformats Wiki
Jump to navigation Jump to search
m (Reverted edits by Gowrvw (Talk) to last version by Tantek)
Line 1: Line 1:
HOW THING THROUGH
+
<entry-title>h-resume</entry-title>
HOW MAKE THING THROUGH
+
<span class="h-card vcard"><span class="p-name fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="p-role role">Editor</span>)</span>
HOW THING BE THROUGH
+
----
HOW MAKE THING BE THROUGH
+
<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.
HOW ANYTHING THROUGH
+
 
HOW MAKE ANYTHING THROUGH
+
h-resume is the [[microformats2]] update to [[hResume]].
HOW ANYTHING BE THROUGH
+
 
HOW MAKE ANYTHING BE THROUGH
+
{{cc0-owfa-license}}
HOW EVERYTHING THROUGH
+
 
HOW MAKE EVERYTHING THROUGH
+
== Example ==
HOW EVERYTHING BE THROUGH
+
Here is a simple resume example:
HOW MAKE EVERYTHING BE THROUGH
+
 
HOW UNIVERSE THROUGH
+
<source lang=html4strict>
HOW MAKE UNIVERSE THROUGH
+
<div class="h-resume">
HOW UNIVERSE BE THROUGH
+
  <a class="p-contact h-card" href="http://example.org">
HOW MAKE UNIVERSE BE THROUGH
+
    <img src="http://example.org/photo.png" alt="" />
HOW THING OUT
+
    Joe Bloggs
HOW MAKE THING OUT
+
  </a>
HOW THING BE OUT
+
 
HOW MAKE THING BE OUT
+
  <p class="p-summary">Joe is a top-notch llama farmer with a degree in <span class="p-skill">Llama husbandry</span> and a thirst to produce the finest wool known to man</p>
HOW ANYTHING OUT
+
</div>
HOW MAKE ANYTHING OUT
+
</source>
HOW ANYTHING BE OUT
+
 
HOW MAKE ANYTHING BE OUT
+
=== Get started ===
HOW EVERYTHING OUT
+
The class '''<code>h-resume</code>''' is a ''root class name'' that indicates the presence of an h-resume.
HOW MAKE EVERYTHING OUT
+
 
HOW EVERYTHING BE OUT
+
See [[microformats2-parsing]] to learn more about property classnames.
HOW MAKE EVERYTHING BE OUT
+
 
HOW UNIVERSE OUT
+
== Properties ==
HOW MAKE UNIVERSE OUT
+
h-resume properties, inside an element with class '''h-resume''':
HOW UNIVERSE BE OUT
+
* '''<code>p-summary</code>''' - overview of qualifications and objectives
HOW MAKE UNIVERSE BE OUT
+
* '''<code>p-contact</code>''' - current contact info in an <code>[[h-card]]</code>
HOW THING THROUGH
+
* '''<code>p-education</code>''' - an education <code>[[h-event]]</code> event, years, embedded <code>[[h-card]]</code> of the school, location. {{main|h-card}}
HOW MAKE THING THROUGH
+
* '''<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-card}}
HOW THING BE THROUGH
+
* '''<code>p-skill</code>''' - a skill or ability, optionally including level and/or duration of experience
HOW MAKE THING BE THROUGH
+
* '''<code>p-affiliation</code>''' - an affiliation with an <code>[[h-card]]</code> organization
HOW ANYTHING THROUGH
+
 
HOW MAKE ANYTHING THROUGH
+
All properties are optional.
HOW ANYTHING BE THROUGH
+
 
HOW MAKE ANYTHING BE THROUGH
+
== Status ==
HOW EVERYTHING THROUGH
+
 
HOW MAKE EVERYTHING THROUGH
+
'''h-resume''' is a microformats.org draft specification. Public discussion on h-resume takes place on [[h-resume-feedback]], the #microformats [[irc]] channel on irc.freenode.net, and [http://microformats.org/discuss/mail/microformats-new/ microformats-new mailing list].
HOW EVERYTHING BE THROUGH
+
 
HOW MAKE EVERYTHING BE THROUGH
+
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.
HOW UNIVERSE THROUGH
+
 
HOW MAKE UNIVERSE THROUGH
+
== Property Details ==
HOW UNIVERSE BE THROUGH
+
 
HOW MAKE UNIVERSE BE THROUGH
+
(stub, add any property explanations here)
HOW THING OUT
+
 
HOW MAKE THING OUT
+
'''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-competency vocabulary with p-summary, p-rating, and dt-duration properties.
HOW THING BE OUT
+
 
HOW MAKE THING BE OUT
+
== Examples in the Wild ==
HOW ANYTHING OUT
+
* … add any h-resume examples you find in the wild
HOW MAKE ANYTHING OUT
+
 
HOW ANYTHING BE OUT
+
 
HOW MAKE ANYTHING BE OUT
+
{{h-spec-section-validating}}
HOW EVERYTHING OUT
+
 
HOW MAKE EVERYTHING OUT
+
 
HOW EVERYTHING BE OUT
+
== Backward Compatibility ==
HOW MAKE EVERYTHING BE OUT
+
=== Publisher Compatibility ===
HOW UNIVERSE OUT
+
(stub)
HOW MAKE UNIVERSE OUT
+
=== Parser Compatibility ===
HOW UNIVERSE BE OUT
+
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.
HOW MAKE UNIVERSE BE OUT
+
 
 +
compat root class name: <code id="hresume">hresume</code><br/>
 +
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]]

Revision as of 19:49, 25 August 2013

<entry-title>h-resume</entry-title> Tantek Çelik (Editor)


h-resume is a simple, open format for publishing resumes and CVs on on the web. h-resume is one of several open microformat draft standards suitable for embedding data in HTML/HTML5.

h-resume is the microformats2 update to hResume.

Per CC0, to the extent possible under law, the editors have waived all copyright and related or neighboring rights to this work. In addition, as of 2021-05-06, the editors have made this specification available under the Open Web Foundation Agreement Version 1.0.

Example

Here is a simple resume example:

<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>
  
  <p class="p-summary">Joe is a top-notch llama farmer with a degree in <span class="p-skill">Llama husbandry</span> and a thirst to produce the finest wool known to man</p>
</div>

Get started

The class h-resume is a root class name that indicates the presence of an h-resume.

See microformats2 parsing specification to learn more about property classnames.

Properties

h-resume properties, inside an element with class h-resume:

  • p-summary - overview of qualifications and objectives
  • p-contact - current contact info in an h-card
  • p-education - an education h-event event, years, embedded h-card of the school, location.
    Main article: h-card
  • p-experience - a job or other professional experience h-event event, years, embedded h-card of the organization, location, job-title.
    Main article: h-card
  • p-skill - a skill or ability, optionally including level and/or duration of experience
  • p-affiliation - an affiliation with an h-card 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, the #microformats #microformats on freenode channel on irc.freenode.net, and microformats-new mailing list.

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 proposed expansion into competency with explicit summary, rating and/or duration components. Based on existing real world adoption, we should consider an h-competency vocabulary with p-summary, p-rating, and dt-duration properties.

Examples in the Wild

  • … add any h-resume examples you find in the wild


Main article: microformats validators

Test and validate microformats2 markup in general with:


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 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: hresume
properties: (parsed as p- plain text unless otherwise specified)

  • summary
  • contact - including compat root vcard in the absence of h-card
  • education - including compat root vevent in the absence of h-event
  • experience - including compat root vevent in the absence of h-event
  • skill
  • affiliation - including compat root vcard in the absence of h-card

Background

h-resume is based on the existing hResume specification.

See Also