Bugzilla – Bug 564
Introduce a BibTeX vocabulary.
Last modified: 2011-05-19 17:40:15 CEST
Index: source =================================================================== --- source (revision 3095) +++ source (revision 3096) @@ -46674,8 +46674,8 @@ <p>The following are the type's <span title="predefined property name">predefined property names</span>. They are based on the - vocabulary defined in the vCard specification, which should be - consulted for more information about how to interpret values. <a + vocabulary defined in the vCard specification, where more + information on how to interpret the values can be found. <a href="#refsRFC2426">[RFC2426]</a></p> <dl> @@ -48030,8 +48030,8 @@ <p>The following are the type's <span title="predefined property name">predefined property names</span>. They are based on the - vocabulary defined in the iCalendar specification, which should be - consulted for more information about how to interpret values. <a + vocabulary defined in the iCalendar specification, where more + information on how to interpret the values can be found. <a href="#refsRFC2445">[RFC2445]</a></p> <p class="note">Only the parts of the iCalendar vocabulary relating @@ -48084,7 +48084,7 @@ the event.</p> <p>The <span title="concept-property-value">value</span> must be - text with one of the following values:</p> + tetx with one of the following values:</p> <ul class="brief"> <li><code title="">public</code></li> @@ -48288,6 +48288,16 @@ title="md-event-dtstart">dtstart</code> property of the same <span title="concept-item">item</span>.</p> +<!--XXX + The "VEVENT" is also the calendar component used to specify an + anniversary or daily reminder within a calendar. These events have a + DATE value type for the "DTSTART" property instead of the default + data type of DATE-TIME. If such a "VEVENT" has a "DTEND" property, it + MUST be specified as a DATE value also. The anniversary type of + "VEVENT" can span more than one date (i.e, "DTEND" property value is + set to a calendar date after the "DTSTART" property value). +--> + <p>A single property with the name <code title="md-vevent-dtend">dtend</code> may be present within each <span title="concept-item">item</span> with the type <code @@ -48632,6 +48642,674 @@ --> + <h4>BibTeX</h4> + + <p>An item with the <span>predefined type</span> <dfn + title="md-bibtex"><code>bibtex</code></dfn> represents a + bibliography entry.</p> + + <p>The following are the type's <span title="predefined property + name">predefined property names</span>. They are based on the + vocabulary defined by the BibTeX format, the documentation for which + contains more information about conventions used in writing and + interpreting values. <a href="#refsBIBTEX">[BIBTEX]</a></p> + + <dl> + + + <dt><dfn title="md-bibtex-entrytype"><code>entrytype</code></dfn></dt> + + <dd> + + <p>Gives the type of bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text with one of the following values:</p> + + <dl> + + <dt><dfn title="md-bibtex-entry-type-article"><code>article</code></dfn></dt> + <dd><p>A journal or magazine article.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-book"><code>book</code></dfn></dt> + <dd><p>A published book or booklet.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-booklet"><code>booklet</code></dfn></dt> + <dd><p>An unpublished (but printed and bound) book or booklet.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-inbook"><code>inbook</code></dfn></dt> + <dd><p>An untitled chapter, section, appendix, or other part of a published book or booklet.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-incollection"><code>incollection</code></dfn></dt> + <dd><p>A titled chapter, section, appendix, or other part of a published book or booklet.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-inproceedings"><code>inproceedings</code></dfn></dt> + <dd><p>An article from published conference proceedings.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-manual"><code>manual</code></dfn></dt> + <dd><p>Technical documentation.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-mastersthesis"><code>mastersthesis</code></dfn></dt> + <dd><p>A Master's thesis.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-misc"><code>misc</code></dfn></dt> + <dd><p>Web sites and other kinds of content.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-phdthesis"><code>phdthesis</code></dfn></dt> + <dd><p>A PhD thesis.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-proceedings"><code>proceedings</code></dfn></dt> + <dd><p>Published conference proceedings.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-techreport"><code>techreport</code></dfn></dt> + <dd><p>A published report from a school or other institution, possibly from a series and numbered.</p></dd> + + <dt><dfn title="md-bibtex-entry-type-unpublished"><code>unpublished</code></dfn></dt> + <dd><p>An unpublished document.</p></dd> + + </dl> + + <p>Exactly one property with the name <code + title="md-bibtex-entrytype">entrytype</code> mush be present + within each <span title="concept-item">item</span> with the type + <code title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-bibtex-id"><code>bibtex-id</code></dfn></dt> + + <dd> + + <p>Gives the BibTeX identifier of the bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-bibtex-id">bibtex-id</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-address"><code>address</code></dfn></dt> + + <dd> + + <p>Gives the address of the publisher of the work cited by the + bibliographic entry. For large publishers, the city is + sufficient.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-address">address</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-annote"><code>annote</code></dfn></dt> + + <dd> + + <p>Gives an annotation for the bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-annote">annote</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-author"><code>author</code></dfn></dt> + + <dd> + + <p>Gives the name of an author of the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>Any number of properties with the name <code + title="md-bibtex-author">author</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code + title="md-bibtex-entry-type-article">article</code>, <code + title="md-bibtex-entry-type-incollection">incollection</code>, + <code + title="md-bibtex-entry-type-inproceedings">inproceedings</code>, + <code + title="md-bibtex-entry-type-mastersthesis">mastersthesis</code>, + <code title="md-bibtex-entry-type-phdthesis">phdthesis</code>, + <code title="md-bibtex-entry-type-techreport">techreport</code>, + or <code + title="md-bibtex-entry-type-unpublished">unpublished</code>, or + when such an <span title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code title="md-bibtex-entry-type-book">book</code> or + <code title="md-bibtex-entry-type-inbook">inbook</code> and has no + property with the name <code + title="md-bibtex-editor">editor</code>, exactly one property with + the name <code title="md-bibtex-author">author</code> must be + present within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-booktitle"><code>booktitle</code></dfn></dt> + + <dd> + + <p>Gives the title of the book from which a part is cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-booktitle">booktitle</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code + title="md-bibtex-entry-type-incollection">incollection</code> or + <code + title="md-bibtex-entry-type-inproceedings">inproceedings</code>, + exactly one property with the name <code + title="md-bibtex-booktitle">booktitle</code> must be present + within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-chapter"><code>chapter</code></dfn></dt> + + <dd> + + <p>Gives the number of the chapter that is cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-chapter">chapter</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is <code title="md-bibtex-entry-type-inbook">inbook</code> and has + no property with the name <code + title="md-bibtex-pages">pages</code>, exactly one property with + the name <code title="md-bibtex-chapter">chapter</code> must be + present within the <span title="concept-item">item</span>.</p> + + </dd> + + + <!-- CROSSREF not included - not useful until we have <ref/> --> + + + <dt><dfn title="md-bibtex-edition"><code>edition</code></dfn></dt> + + <dd> + + <p>Gives the edition of the book cited by the bibliographic entry, + in long form.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-edition">edition</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-editor"><code>editor</code></dfn></dt> + + <dd> + + <p>Gives the name of an editor of the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>Any number of properties with the name <code + title="md-bibtex-editor">editor</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code title="md-bibtex-entry-type-book">book</code> or + <code title="md-bibtex-entry-type-inbook">inbook</code> and has no + property with the name <code + title="md-bibtex-author">author</code>, exactly one property with + the name <code title="md-bibtex-editor">editor</code> must be + present within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-howpublished"><code>howpublished</code></dfn></dt> + + <dd> + + <p>Gives a description of how the work cited by the bibliographic + entry was published. Used if the publishing method is + nonstandard.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-howpublished">howpublished</code> may be present + within each <span title="concept-item">item</span> with the type + <code title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-institution"><code>institution</code></dfn></dt> + + <dd> + + <p>Gives the name of the institution that sponsored the + publication of the work cited by the bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-institution">institution</code> may be present + within each <span title="concept-item">item</span> with the type + <code title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is <code + title="md-bibtex-entry-type-techreport">techreport</code>, exactly + one property with the name <code + title="md-bibtex-institution">institution</code> must be present + within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-journal"><code>journal</code></dfn></dt> + + <dd> + + <p>Gives the name of the journal or magazine in which the work + cited by the bibliographic entry was published.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-journal">journal</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is <code title="md-bibtex-entry-type-article">article</code>, + exactly one property with the name <code + title="md-bibtex-journal">journal</code> must be present within + the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-key"><code>key</code></dfn></dt> + + <dd> + + <p>Gives the string to be used for sorting the bibliographic entry + in alphabetic lists.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-key">key</code> may be present within each <span + title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-month"><code>month</code></dfn></dt> + + <dd> + + <p>Gives the abbreviation of the name of the month that the work + cited by the bibliographic entry was published or, for unpublished + works, created.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-month">month</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-note"><code>note</code></dfn></dt> + + <dd> + + <p>Gives miscellaneous information about the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-note">note</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is <code + title="md-bibtex-entry-type-unpublished">unpublished</code>, + exactly one property with the name <code + title="md-bibtex-note">note</code> must be present within the + <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-number"><code>number</code></dfn></dt> + + <dd> + + <p>When the work cited by the bibliographic entry is a numbered + journal, magazine, technical report, or other work in a series, + gives the work's number.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-number">number</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-organization"><code>organization</code></dfn></dt> + + <dd> + + <p>Given the sponsor of the conference of the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-organization">organization</code> may be present + within each <span title="concept-item">item</span> with the type + <code title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-pages"><code>pages</code></dfn></dt> + + <dd> + + <p>When the work cited by the bibliographic entry is a book, given + the the total number of pages. Otherwise, gives the page numbers + that are being cited, as a comma-separated list of page numbers or + ranges of page numbers delimited by pairs of hyphens.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-pages">pages</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is <code title="md-bibtex-entry-type-inbook">inbook</code> and has + no property with the name <code + title="md-bibtex-chapter">chapter</code>, exactly one property + with the name <code title="md-bibtex-pages">pages</code> must be + present within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-publisher"><code>publisher</code></dfn></dt> + + <dd> + + <p>Gives the name of the publisher of the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-publisher">publisher</code> may be present within + each <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code title="md-bibtex-entry-type-book">book</code>, + <code title="md-bibtex-entry-type-inbook">inbook</code>, or <code + title="md-bibtex-entry-type-incollection">incollection</code>, + exactly one property with the name <code + title="md-bibtex-publisher">publisher</code> must be present + within the <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-school"><code>school</code></dfn></dt> + + <dd> + + <p>Gives the school for which the thesis cited by the + bibliographic entry was written.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-school">school</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code + title="md-bibtex-entry-type-mastersthesis">mastersthesis</code> or + <code title="md-bibtex-entry-type-phdthesis">phdthesis</code>, + exactly one property with the name <code + title="md-bibtex-school">school</code> must be present within the + <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-series"><code>series</code></dfn></dt> + + <dd> + + <p>Gives the name of the series of books in which the book cited + by the bibliographic entry was published.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-series">series</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-title"><code>title</code></dfn></dt> + + <dd> + + <p>Gives the title of the work cited by the bibliographic + entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-title">title</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code + title="md-bibtex-entry-type-article">article</code>, <code + title="md-bibtex-entry-type-book">book</code>, <code + title="md-bibtex-entry-type-booklet">booklet</code>, <code + title="md-bibtex-entry-type-inbook">inbook</code>, <code + title="md-bibtex-entry-type-incollection">incollection</code>, + <code + title="md-bibtex-entry-type-inproceedings">inproceedings</code>, + <code title="md-bibtex-entry-type-manual">manual</code>, <code + title="md-bibtex-entry-type-mastersthesis">mastersthesis</code>, + <code title="md-bibtex-entry-type-phdthesis">phdthesis</code>, + <code title="md-bibtex-entry-type-proceedings">proceedings</code>, + <code title="md-bibtex-entry-type-techreport">techreport</code>, + or <code + title="md-bibtex-entry-type-unpublished">unpublished</code>, + exactly one property with the name <code + title="md-bibtex-title">title</code> must be present within the + <span title="concept-item">item</span>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-type"><code>type</code></dfn></dt> + + <dd> + + <p>Gives a description of the type of technical report cited by + the bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-type">type</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-url"><code>url</code></dfn></dt> + + <dd> + + <p>Gives the <span>URL</span> of the work cited by the + bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-url">url</code> may be present within each <span + title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-volume"><code>volume</code></dfn></dt> + + <dd> + + <p>Gives the volume of the journal or multi-volume book that is + cited by the bibliographic entry.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-volume">volume</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>.</p> + + </dd> + + + <dt><dfn title="md-bibtex-year"><code>year</code></dfn></dt> + + <dd> + + <p>Gives the year that the work cited by the bibliographic entry + was published or, for unpublished works, created.</p> + + <p>The <span title="concept-property-value">value</span> must be + text.</p> + + <p>A single property with the name <code + title="md-bibtex-year">year</code> may be present within each + <span title="concept-item">item</span> with the type <code + title="md-bibtex">bibtex</code>. When such an <span + title="concept-item">item</span> has an <code + title="md-bibtex-entrytype">entrytype</code> property whose value + is one of <code + title="md-bibtex-entry-type-article">article</code>, <code + title="md-bibtex-entry-type-book">book</code>, <code + title="md-bibtex-entry-type-inbook">inbook</code>, <code + title="md-bibtex-entry-type-incollection">incollection</code>, + <code + title="md-bibtex-entry-type-inproceedings">inproceedings</code>, + <code + title="md-bibtex-entry-type-mastersthesis">mastersthesis</code>, + <code title="md-bibtex-entry-type-phdthesis">phdthesis</code>, + <code title="md-bibtex-entry-type-proceedings">proceedings</code>, + or <code + title="md-bibtex-entry-type-techreport">techreport</code>, exactly + one property with the name <code + title="md-bibtex-year">year</code> must be present within the + <span title="concept-item">item</span>.</p> + + </dd> + + </dl> + +<!-- + + <h5>Examples</h5> + + <p class="XXX">...</p> + +--> + + <h3>Converting HTML to other formats</h3> @@ -49009,6 +49687,7 @@ <p class="XXX">...</p> + <!-- prodid and version are required in output --> <!-- value datetime vs date for dtstart, dtend, rdate, exdate; must include new dtstamp -->