hresume-profile: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Close bracket)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:hResume Profile}}
The following is an [http://gmpg.org/xmdp/ XMDP] profile for the [[hresume|hResume]] specification.
== URLs ==
This profile is hosted as a separate XMDP file on microformats.org:
* http://microformats.org/profile/hresume
* shortURL: http://ufs.cc/x/hresume
== Usage ==
Profiles are referenced in (X)HTML files in the <code>&lt;head&gt;</code> tag, e.g.:
<source lang=html4strict>
<head profile='http://microformats.org/profile/hresume'>
</source>
== Profile ==
<source lang=html4strict>
<dl class="profile">
<dl class="profile">
<dt id='class'>class</dt>
<dt id="rel">rel</dt>
<dd>
<dd><p>
<p>[http://www.w3.org/TR/html401/struct/global.html#adef-class HTML4 definition of the 'class' attribute.] This meta data profile defines some 'class' attribute values (class names) and their meanings as suggested by a [http://www.w3.org/TR/WD-htmllink-970328#profile draft of 'Hypertext Links in HTML'].</p>
  <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
<dl>
    HTML4 definition of the 'rel' attribute.</a> 
<dt id='hresume'>hresume</dt>
  Here is an additional value as defined in the
<dd>A container for the rest of the class names defined in this XMDP profile.</dd>
  <a rel="help start" href="http://microformats.org/wiki/rel-tag">
  rel-tag</a>
  specification.</p>
  <dl>
  <dt id="tag">tag</dt>
  <dd>Indicates that the referred resource serves as a "tag",
      or keyword/subject, for the referring page, or some portion of the referring page (such as an hResume).</dd>
  </dl>
</dd>
<dt>class</dt>
<dd><p>
  <a href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
  HTML4 definition of the 'class' attribute.</a>
  This meta data profile defines some 'class' attribute values (class names)  
  and their meanings as suggested by a  
  <a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
  draft of "Hypertext Links in HTML"</a>.
  All values are defined according to the semantics defined in the
  <a rel="help start" href="http://microformats.org/wiki/hresume">
  hResume specification</a>.
  </p>
  <dl>
  <dt id="hresume">hresume</dt>
    <dd>The root class name and container for a resume.
  </dd>
 
  <dt id="summary">summary</dt>
    <dd>This optional property serves as an overview of qualifications and objectives. Re-used from hReview which re-used it from hCalendar which re-uses it from iCalendar (section 4.8.1.12 of RFC 2445).
    </dd>


<dt id='summary'>summary</dt>
  <dt id="contact">contact</dt>
<dd>The class name summary is used to mark up an overview of qualifications and objectives. Optional, single instance allowed.</dd>
    <dd>This optional property provides information about the person who authored the resume. If the value is provided then the same element that
    has the class name of "contact" should use the class name of "vcard" and thus represent an embedded hCard.</dd>
<dt id='contact'>contact</dt>
<dd>Current contact info in an hCard; {{should}} use 'address' with hCard when possible. Required, single instance allowed.</dd>


<dt id='education'>education</dt>
  <dt id="education">education</dt>
<dd>The class name 'education' is applied to an hcalendar event. Optional, multiple hcalendar events allowed within the class.</dd>
    <dd>This optional property provides an instance of education. If the value is provided then the same element that
    has the class name of "experience" must also use the class name of "vevent" and thus represent an embedded hCalendar event.</dd>


<dt id='experience'>experience</dt>
  <dt id="experience">experience</dt>
<dd>The class name 'experience' is applied to an hCalendar event. Job titles/positions should use an hCard of the organization. Use of the [http://microformats.org/wiki/include-pattern include pattern] to indicate title(s) in the organization. Optional, multiple hcalendar events allowed within the class.</dd>
    <dd>This optional property provides an instance of work experience. If the value is provided then the same element that
    has the class name of "experience" must also use the class name of "vevent" and thus represent an embedded hCalendar event. It must also contain an embedded hCard to indicate the job title and company/organization details.</dd>


<dt id='skill'>skill</dt>
  <dt id="skill">skill</dt>
<dd>An hResume may be tagged using the rel-tag microformat and the 'skill' class name. Optional, multiple rel-tags allowed within the class.</dd>
    <dd>This optional property indicates one or more phrases or keywords that represent skills. This property should be used on a hyperlink which itself uses the rel-tag microformat to link to a page about the skill.</dd>


<dt id='affiliation'>affiliation</dt>
  <dt id="affiliation">affiliation</dt>
<dd>The class name affiliation is used along with an hcard of the organization. Optional, multiple hcard affiliations allowed within the class. Use of the [http://microformats.org/wiki/include-pattern include pattern] to indicate membership in the organization.</dd>
    <dd>This optional property indicates one or more organizations that the person is affiliated with. If the value is provided then the same element that
    has the class name of "affiliation" should use the class name of "vcard" and thus represent an embedded hCard for the organizational affiliation.</dd>


<dt id='publication'>publication</dt>
  <dt id="publication">publication</dt>
<dd>Just use 'cite'. When there is a citation microformat, then that can be used in combination with the cite element to further markup the components of the citation.</dd>
    <dd>This optional property indicates one or more publications made by the person. If the value is provided then the element that  
    has the class name of "affiliation" should be a <code>cite</code> element.
    </dd>


<dt id='include'>include</dt>
  <dt id="value">value</dt>
<dd>On a linking element (e.g. <code>&lt;a></code> or <code>&lt;object></code>), used to indicate that the linked resource should be logically "included", replacing the link, in accordance with the [http://microformats.org/wiki/include-pattern include pattern].</dd>
    <dd>This class name is used to distinguish the <em>actual</em> value
</dl>
    of a property from any other cruft that may be in
</dd>
    the containing element representing the property.
    See the
    <a href="http://microformats.org/wiki/value-class-pattern">
      value-class-pattern</a> for details.</dd>
 
  <dt id="value-title">value-title</dt>
    <dd>This class name is used to distinguish the <em>actual</em> value
    of a property, specifically in the 'title' attribute of the element,
    from the element contents and the element representing
    the containing property.
    See the
    <a href="http://microformats.org/wiki/value-class-pattern#Parsing_value_from_a_title_attribute">
      value-class-pattern value-title description</a> for details.</dd>
 
  <dt id='include'>include</dt>
  <dd>On a linking element (e.g. <code>&lt;a&gt;</code> or <code>&lt;object&gt;</code>), this property is
  used to indicate that the linked resource should be logically "included",  
  replacing the link, in accordance with the <a href="http://microformats.org/wiki/include-pattern">include pattern</a>.</dd>
  </dl>
</dd>
</dl>
</dl>
</source>
== Related Pages ==
{{hresume-related-pages}}

Latest revision as of 16:27, 18 July 2020


The following is an XMDP profile for the hResume specification.

URLs

This profile is hosted as a separate XMDP file on microformats.org:

Usage

Profiles are referenced in (X)HTML files in the <head> tag, e.g.:

<head profile='http://microformats.org/profile/hresume'>

Profile

<dl class="profile">
 <dt id="rel">rel</dt>
 <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
     HTML4 definition of the 'rel' attribute.</a>  
   Here is an additional value as defined in the
   <a rel="help start" href="http://microformats.org/wiki/rel-tag">
   rel-tag</a> 
   specification.</p>
  <dl>
   <dt id="tag">tag</dt>
   <dd>Indicates that the referred resource serves as a "tag", 
       or keyword/subject, for the referring page, or some portion of the referring page (such as an hResume).</dd>
  </dl>
 </dd>
 <dt>class</dt>
 <dd><p>
   <a href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
   HTML4 definition of the 'class' attribute.</a>
   This meta data profile defines some 'class' attribute values (class names) 
   and their meanings as suggested by a 
   <a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
   draft of "Hypertext Links in HTML"</a>.
   All values are defined according to the semantics defined in the 
   <a rel="help start" href="http://microformats.org/wiki/hresume">
   hResume specification</a>.
  </p>
  <dl>
   <dt id="hresume">hresume</dt>
    <dd>The root class name and container for a resume.
   </dd>

   <dt id="summary">summary</dt>
    <dd>This optional property serves as an overview of qualifications and objectives. Re-used from hReview which re-used it from hCalendar which re-uses it from iCalendar (section 4.8.1.12 of RFC 2445).
    </dd>

   <dt id="contact">contact</dt>
    <dd>This optional property provides information about the person who authored the resume. If the value is provided then the same element that 
    has the class name of "contact" should use the class name of "vcard" and thus represent an embedded hCard.</dd>

   <dt id="education">education</dt>
    <dd>This optional property provides an instance of education. If the value is provided then the same element that 
    has the class name of "experience" must also use the class name of "vevent" and thus represent an embedded hCalendar event.</dd>

   <dt id="experience">experience</dt>
    <dd>This optional property provides an instance of work experience. If the value is provided then the same element that 
    has the class name of "experience" must also use the class name of "vevent" and thus represent an embedded hCalendar event. It must also contain an embedded hCard to indicate the job title and company/organization details.</dd>

   <dt id="skill">skill</dt>
    <dd>This optional property indicates one or more phrases or keywords that represent skills. This property should be used on a hyperlink which itself uses the rel-tag microformat to link to a page about the skill.</dd>

   <dt id="affiliation">affiliation</dt>
    <dd>This optional property indicates one or more organizations that the person is affiliated with. If the value is provided then the same element that 
    has the class name of "affiliation" should use the class name of "vcard" and thus represent an embedded hCard for the organizational affiliation.</dd>

   <dt id="publication">publication</dt>
    <dd>This optional property indicates one or more publications made by the person. If the value is provided then the element that 
    has the class name of "affiliation" should be a <code>cite</code> element.
    </dd>

   <dt id="value">value</dt>
    <dd>This class name is used to distinguish the <em>actual</em> value
     of a property from any other cruft that may be in 
     the containing element representing the property.
     See the 
     <a href="http://microformats.org/wiki/value-class-pattern"> 
      value-class-pattern</a> for details.</dd>

   <dt id="value-title">value-title</dt>
    <dd>This class name is used to distinguish the <em>actual</em> value
     of a property, specifically in the 'title' attribute of the element,
     from the element contents and the element representing 
     the containing property.
     See the 
     <a href="http://microformats.org/wiki/value-class-pattern#Parsing_value_from_a_title_attribute"> 
      value-class-pattern value-title description</a> for details.</dd>

   <dt id='include'>include</dt>
   <dd>On a linking element (e.g. <code>&lt;a&gt;</code> or <code>&lt;object&gt;</code>), this property is 
   used to indicate that the linked resource should be logically "included", 
   replacing the link, in accordance with the <a href="http://microformats.org/wiki/include-pattern">include pattern</a>.</dd>
  </dl>
 </dd>
</dl>

Related Pages

Research

Previously

hResume is the classic microformats predecessor for h-resume. Work on hResume is documented at the following for historical purposes. Much of the general discussion and research likely still applies.

The hResume specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.