bibword Wiki & Documentation Rss Feed

Updated Wiki: BibWord Format Contributors

Yves — Fri, 13 Nov 2009 17:22:46 GMT

Formatting a set of contributors

Introduction
Variables
Examples

Introduction

Cited works often have multiple authors, editors, and other types of contributors. To format a set of contributors, BibWord use 13 variables. All the variables are grouped inside a single list element which in turn belongs to the namelists section of the BibWord data element. To make this a bit more clear, consider the following definition of a list:

  <xsl:variable name="data">
    <namelists>
      <list name="citation" id="1">
        <!-- The 13 variables influencing the look of a list of contributors. -->
      </list>
    </namelists>
  </xsl:variable>

As you can see in the example, the list element contains two attributes: name and id.

The id attribute is a mandatory numerical value and is used by format strings to know which list to use when formatting a set of contributors. For example, a format string looking like {%Author:5%} indicates that the authors should be formatted according to the rules provided in the list with an id equal to 5.

The name attribute is optional and purely intended for developers. It can help them identify what the list is used for. In the above example, it indicates that this list is probably used to format contributors in a citation.

Variables

Formatting a single name

BibWord provides three variables/elements to format names in a set of contributors:

first_person: format information for the name of the first contributor in the set
other_persons: format information for all contributors in the set except the first one
corporate: format information in case the contributor is a corporation

Each of these three elements take a format strings as value. For example:

  <first_person>{%Last:u%}{, %First%}</first_person>
  <other_persons>{%First% }{%Last%}</other_persons>
  <corporate>{%Corporate:u%}</corporate>

Combining names

When there is more than one contributor in a set, the contributors have to be grouped in some way. BibWord provides three variables to do this grouping:

separator_between_if_two: the separator to display if there are only two contributors
separator_between_if_more_than_two: the separator to display if there are more than two contributors
separator_before_last: the separator to display before the last contributor if there are more than two contributors

For each of these elements, any possible string value can be used. For example:

  <separator_between_if_two> and </separator_between_if_two>
  <separator_between_if_more_than_two>; </separator_between_if_more_than_two>
  <separator_before_last>; and </separator_before_last>

Limiting the number of authors shown

Sometimes a set of contributors consists of more persons than the style allows to display. In such case, only a limited number of contributors is shown followed by a string like 'et al.' to indicate that there are more contributors. BibWord can do this by means of 3 elements:

max_number_of_persons_to_display: indicates the maximum number of contributors that can be displayed
number_of_persons_to_display_if_more_than_max: indicates the number of contributors to display if the set of contributors contains more contributors than the maximum number that can be displayed
overflow: contains the string to display after the last contributor if there are too many contributers

The first two elements require a numerical value while for the last one any string value can be used. For example:

  <max_number_of_persons_to_display>5</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>1</number_of_persons_to_display_if_more_than_max>
  <overflow>, et al.</overflow>

Prefix and suffix

Sometimes a set of contributors are no ordinary authors, they can be editors, translators, ... in which case you might want to add a prefix or suffix string like 'ed.' or 'eds.'.

single_prefix: the text to display in front of the contributors if there is only one
single_suffix: the text to display behind the contributors if there is only one
multi_prefix: the text to display in front of the contributors if there is more than one
multi_suffix: the text to display behind the contributors if there is more than one

  <single_prefix>Editor: </single_prefix>
  <single_suffix> (ed.)</single_suffix>
  <multi_prefix>Editors: </multi_prefix>
  <multi_suffix> (eds.)</multi_suffix>

Examples

Consider the following contributor set:

Mick Jagger
Brian Jones
Keith Richards
Bill Wyman
Charlie Watts

With the following output:

JAGGER M. and B. Jones
JAGGER M., B. Jones, K. Richards, and B. Wyman
JAGGER M., et al.

Ït is clear that the first contributor should be displayed in capitals with his last name first and his first name abbreviated:

  <first_person>{%Last:u%}{ %First:asdp%}</first_person>

The other contributors are formatted with an abbreviated first name followed by their last name:

  <other_persons>{%First:asdp% }{%Last%}</other_persons>

There is no information on how to format corporate contributors, but it seems logical that they follow the same rule as for the first contributor:

  <corporate>{%Corporate:u%}</corporate>

Now that the different names in the contributor set are formatted correctly, it is time to combine them. From the first example, one can see that if only two contributors are available, " and " is used to combine them. If there are more than two contributors, as in the second example, a comma is used for concatenating. Also, from the second example, one can see that ", and " is used to combine the last contributor with the others. So we get:

  <separator_between_if_two> and </separator_between_if_two>
  <separator_between_if_more_than_two>, </separator_between_if_more_than_two>
  <separator_before_last>, and </separator_before_last>

The last example shows what happens in case there are too many contributors to display them all. Only the first is displayed, followed by 'et al.' in italics. In combination with the second example, we see that 4 contributors can be displayed at most at one time. Hence, we get:

  <max_number_of_persons_to_display>4</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>1</number_of_persons_to_display_if_more_than_max>
  <overflow>, &lt;i&gt;et al.&lt;/i&gt;</overflow>

Note that the overflow contains "" which translates to the html tag "" which is used to indicate that "et al." should be displayed in italics.

Combining all these items results in:

  <xsl:variable name="data">
    <namelists>
      <list name="authors" id="2">
        <first_person>{%Last:u%}{ %First:asdp%}</first_person>
        <other_persons>{%First:asdp% }{%Last%}</other_persons>
        <corporate>{%Corporate:u%}</corporate>
        <separator_between_if_two> and </separator_between_if_two>
        <separator_between_if_more_than_two>, </separator_between_if_more_than_two>
        <separator_before_last>, and </separator_before_last>
        <max_number_of_persons_to_display>4</max_number_of_persons_to_display>
        <number_of_persons_to_display_if_more_than_max>1</number_of_persons_to_display_if_more_than_max>
        <overflow>, &lt;i&gt;et al.&lt;/i&gt;</overflow>
      </list>
    </namelists>
  </xsl:variable>

Updated Wiki: Documentation

Yves — Fri, 13 Nov 2009 17:22:10 GMT

The Styles

Styles

The Tools

BibWord : the template on top of which the styles are created
BibWord Extender : the external application used to add extra functionality like year suffices to the Word bibliography tools
BibType : an application to extend the available fields and types

Creating and Editing Styles

Updated Wiki: BibWord Format Strings

Yves — Thu, 12 Nov 2009 23:01:59 GMT

Introduction

Format strings are the core of BibWord. They are responsible for the way

a (footnote)citation looks
a bibliography entry looks
a bibliography is sorted
decisions are made for year suffices
the name of a single contributor looks

Hence, understanding how format strings work, is understanding 90% of BibWord.

Variables/Parameters

Variables or parameters are defined in between percentage (%) marks. A basic example of a variable is

     %First%

which represents the first name of a person. For a full list of all possible parameters, please check the guide coming with BibWord.

Extra options can be assigned to a parameter by adding a colon (:) after the parameter's name followed by one or more symbols. An example is:

     %First:u%

which indicates that the first name should be displayed in upper case characters. For a full list of all options of each parameter, please check the guide coming with BibWord.

Parameters can also be combined so that if the first part has no value, the value of a second or latter part can be displayed instead. This type of parameter or'ing is done using the vertical bar (|) symbol. An example is:

     %First:l|Last:u%

which indicates that if the first name is available, it should be displayed in lower case characters. If it is not available, then the last name of a person should be displayed in upper case characters if available.

Instead of parameters, literal strings can also be used. This is done by placing the string between double quotes. An example is:

     %Last:u|"Anon"%

which displays the last name of a person in upper case characters if available. If the last name is not available, "Anon", without the quotes, will be displayed. Using literal strings it is possible to guarantee that always something will be shown.

Pages, a special parameter

The Pages parameter does not follow the regular syntax. Instead, it consists of 3 sets of options separated by a colon (:) after the parameter's name. The first set indicates the prefix to show if Pages contains a single page number. The second indicates the prefix to show if Pages contains a range of pages. The third one contains the remaining options. An example is:

     %Pages:p. :pp. :a2%

Conditional Brackets

Braces ({ and }) are used by BibWord as conditional brackets. Conditional brackets ensure that data only gets displayed if each parameter within the conditional brackets has a value. That way, leading or trailing literal strings will not be displayed if not required. A basic example is:

  {Vol. %Volume%}

which displays "Vol. x" if the variable Volume has an actual value, or displays nothing otherwise. Note that if you do an or'ing of a parameter with a literal string, there will always be output shown. For example:

  {%Edition|"1st"% edition}

will display the content of the Edition parameter if available followed by " edition" or, if the parameter is not available, just "1st edition". So in this example, the conditional brackets are not required.

Conditional brackets can also be nested. This can be interesting if the way you wish to display a parameter depends on the availability of other parameters. Take the following example:

  { %Volume%{(%Issue%)} }{ no. %Issue% }

Depending on the availability of the two parameters Volume and Issue there are 4 different outcomes:

Volume is available, Issue is available: Volume(Issue)
Volume is available, Issue is not available: Volume
Volume is not available, Issue is available: no. Issue
Volume is not available, Issue is not available: -

Note that unless the r option is added to a parameter, a parameter can only be used once. That explains why you do not get "Volume(Issue) no. Issue" for the first outcome.

Warning: Conditional brackets should always be used in a balanced way. When your style does not output anything, you should verify if your brackets are balanced.

Examples

Example bibliography format string

Consider the following journal articles:

Doe, John. 2009. Creating bibliography styles using BibWord. Modern Bibliography Tools. 25(3):513-22.
Bibliographies throughout the ages. 2007. Modern Bibliography Tools. 3:15-18.
Doe, Jane. 2005. Bibliographies for dummies. Modern Bibliography Tools. 51-57.

Now we are going to create a format string step by step.

The first element in the format string is the author followed by a period:

  {%Author:1%.}

In case there is no author, like in the second example, the title is used instead:

  {%Author:1|Title%.}

Next the year is displayed:

  {%Author:1|Title%.}{ %Year%.}

After the year, the title is displayed:

  {%Author:1|Title%.}{ %Year%.}{ %Title%.}

But what if there is no author? Then the title is already displayed in front of the year. This is not an issue for BibWord as by default, different variables can only be displayed once. So if the title is already displayed at the beginning, it won't be displayed anymore.

Next we add the name of the journal:

  {%Author:1|Title%.}{ %Year%.}{ %Title%.}{ %JournalName%.}

As you can see from the examples, the name of the journal is displayed in italics. The result of the formatting is actually html code, so to obtain italics, the html italics element can be used:

  {%Author:1|Title%.}{ %Year%.}{ %Title%.}{ &lt;i&gt;%JournalName%&lt;/i&gt;.}

Note that you should use < for < and > for >.

So far, the format string was pretty straightforward. Now comes a slightly more difficult part. The difficulty lies in the fact that the formatting changes depending on the elements that are available. The easiest solution is to consider each of the possible cases and generate a format string for them. So here we have:

  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}
  { &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}
  { %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}
  { %Issue%}
  { %Pages:::a2%}

Two points to explain here. The first is the volume being displayed in bold. Just like the element can be used for italics, the element can be used for bold.

The 'a2' as options for the Pages parameter indicates that page ranges should be abbreviated and that the second part of the range should have a length of at least 2.

As BibWord does not allow the reuse of the same element by default, you can put the different format strings after each other starting with those with the most parameters to cover all the cases:

  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}{ &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}{ &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}{ %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}{ %Issue%}{ %Pages:::a2%}

So now that everything is covered, both parts can be put after each other, and a final period can be added:

  {%Author:1|Title%.}{ %Year%.}{ %Title%.}{ &lt;i&gt;%JournalName%&lt;/i&gt;.}{ &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}{ &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}{ %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}{ %Issue%}{ %Pages:::a2%}.

Example contributor format strings

First : Henry
Middle: Alfred
Last  : Kissinger

KISSINGER               : {%Last:u%}
Kissinger               : {%Last%}
Kissinger, Henry        : {%Last%}{, %First%}
Kissinger, Henry Alfred : {%Last%}{, %First|Middle%}{ %Middle%}
Kissinger, H. A.        : {%Last%}{, %First:adsp|Middle:adsp%}{ %Middle:adsp%}
Kissinger, H.A.         : {%Last%}{, %First:adp|Middle:adp%}{%Middle:adp%}
Kissinger, H.           : {%Last%}{, %First:adp%}
Kissinger, H A          : {%Last%}{, %First:ads|Middle:ads%}{ %Middle:ads%}
Kissinger, HA           : {%Last%}{, %First:a|Middle:a%}{%Middle:a%}
Kissinger, H            : {%Last%}{, %First:as%}
Kissinger Henry         : {%Last%}{ %First%}
Kissinger Henry Alfred  : {%Last%}{ %First%}{ %Middle%}
Kissinger H. A.         : {%Last%}{ %First:adsp%}{ %Middle:adsp%}
Kissinger H.A.          : {%Last%}{ %First:adp|Middle:adp%}{%Middle:adp%}
Kissinger H.            : {%Last%}{ %First:adp%}
Kissinger H A           : {%Last%}{ %First:ads%}{ %Middle:ads%}
Kissinger HA            : {%Last%}{ %First:a|Middle:a%}{%Middle:a%}
Kissinger H             : {%Last%}{ %First:as%}
Henry Kissinger         : {%First% }{%Last%}
Henry Alfred Kissinger  : {%First% }{%Middle% }{%Last%}
H. A. Kissinger         : {%First:adsp% }{%Middle:adsp% }{%Last%}
H.A. Kissinger          : {%First:adp%}{%Middle:adp%}{ %Last%}
H. Kissinger            : {%First:adp%}{ %Last%}
H A Kissinger           : {%First:ads% }{%Middle:ads% }{%Last%}
HA Kissinger            : {%First:a%}{%Middle:a%}{ %Last%}
H Kissinger             : {%First:as%}{ %Last%}

Example sorting format strings

Order of appearance                   : nothing, this is the default setting for BibWord
Author + Title                        : {%Author:10%} {%Title:a%}
Author + Year + Title                 : {%Author:10|Title:a%} {%Year%} {%Title:a%}
First Author + Year + Other Authors   : {%Author:11r%} {%Year%} {%Author:12%}
First Author + # of Authors + Year    : {%Author:11r%} {%Author:c%} {%Year%}
Date (ascending - oldest first)       : {%Year|"0000"%}{%Month:n|"01"%}{%Day:n|"01"%}
Date (descending - most recent first) : {%Year:i|"9999"%}{%Month:in|"12"%}{%Day:in|"31"%}

with the following options for formatting the author:

<list id="10" name="all_contributors">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person>{%Last|First|Middle%}{ %First%}{ %Middle%}</first_person>
  <other_persons>{%Last|First|Middle%}{ %First%}{ %Middle%}</other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

<list id="11" name="first_contributor">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person>{%Last|First|Middle%}{ %First%}{ %Middle%}</first_person>
  <other_persons></other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

<list id="12" name="second_and_later_contributor">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person></first_person>
  <other_persons>{%Last|First|Middle%}{ %First%}{ %Middle%}</other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

Updated Wiki: BibWord Format Strings

Yves — Thu, 12 Nov 2009 23:00:37 GMT

Format Strings

Introduction
Variables/Parameters
Conditional Brackets
Examples

Introduction

Format strings are the core of BibWord. They are responsible for the way

a (footnote)citation looks
a bibliography entry looks
a bibliography is sorted
decisions are made for year suffices
the name of a single contributor looks

Hence, understanding how format strings work, is understanding 90% of BibWord.

Variables/Parameters

Variables or parameters are defined in between percentage (%) marks. A basic example of a variable is

     %First%

     %First:u%

     %First:l|Last:u%

     %Last:u|"Anon"%

Pages, a special parameter

     %Pages:p. :pp. :a2%

Conditional Brackets

  {Vol. %Volume%}

  {%Edition|"1st"% edition}

  { %Volume%{(%Issue%)} }{ no. %Issue% }

Depending on the availability of the two parameters Volume and Issue there are 4 different outcomes:

Volume is available, Issue is available: Volume(Issue)
Volume is available, Issue is not available: Volume
Volume is not available, Issue is available: no. Issue
Volume is not available, Issue is not available: -

Examples

Example bibliography format string

Consider the following journal articles:

Doe, John. 2009. Creating bibliography styles using BibWord. Modern Bibliography Tools. 25(3):513-22.
Bibliographies throughout the ages. 2007. Modern Bibliography Tools. 3:15-18.
Doe, Jane. 2005. Bibliographies for dummies. Modern Bibliography Tools. 51-57.

Now we are going to create a format string step by step.

The first element in the format string is the author followed by a period:

  {%Author%.}

In case there is no author, like in the second example, the title is used instead:

  {%Author|Title%.}

Next the year is displayed:

  {%Author|Title%.}{ %Year%.}

After the year, the title is displayed:

  {%Author|Title%.}{ %Year%.}{ %Title%.}

  {%Author|Title%.}{ %Year%.}{ %Title%.}{ %JournalName%.}

  {%Author|Title%.}{ %Year%.}{ %Title%.}{ &lt;i&gt;%JournalName%&lt;/i&gt;.}

  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}
  { &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}
  { %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}
  { %Issue%}
  { %Pages:::a2%}

  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}{ &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}{ &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}{ %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}{ %Issue%}{ %Pages:::a2%}

So now that everything is covered, both parts can be put after each other, and a final period can be added:

  {%Author|Title%.}{ %Year%.}{ %Title%.}{ &lt;i&gt;%JournalName%&lt;/i&gt;.}{ &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%):%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;(%Issue%)}{ &lt;b&gt;%Volume%&lt;/b&gt;:%Pages:::a2%}{ %Issue%:%Pages:::a2%}
  { &lt;b&gt;%Volume%&lt;/b&gt;}{ %Issue%}{ %Pages:::a2%}.

Example contributor format strings

First : Henry
Middle: Alfred
Last  : Kissinger

KISSINGER               : {%Last:u%}
Kissinger               : {%Last%}
Kissinger, Henry        : {%Last%}{, %First%}
Kissinger, Henry Alfred : {%Last%}{, %First|Middle%}{ %Middle%}
Kissinger, H. A.        : {%Last%}{, %First:adsp|Middle:adsp%}{ %Middle:adsp%}
Kissinger, H.A.         : {%Last%}{, %First:adp|Middle:adp%}{%Middle:adp%}
Kissinger, H.           : {%Last%}{, %First:adp%}
Kissinger, H A          : {%Last%}{, %First:ads|Middle:ads%}{ %Middle:ads%}
Kissinger, HA           : {%Last%}{, %First:a|Middle:a%}{%Middle:a%}
Kissinger, H            : {%Last%}{, %First:as%}
Kissinger Henry         : {%Last%}{ %First%}
Kissinger Henry Alfred  : {%Last%}{ %First%}{ %Middle%}
Kissinger H. A.         : {%Last%}{ %First:adsp%}{ %Middle:adsp%}
Kissinger H.A.          : {%Last%}{ %First:adp|Middle:adp%}{%Middle:adp%}
Kissinger H.            : {%Last%}{ %First:adp%}
Kissinger H A           : {%Last%}{ %First:ads%}{ %Middle:ads%}
Kissinger HA            : {%Last%}{ %First:a|Middle:a%}{%Middle:a%}
Kissinger H             : {%Last%}{ %First:as%}
Henry Kissinger         : {%First% }{%Last%}
Henry Alfred Kissinger  : {%First% }{%Middle% }{%Last%}
H. A. Kissinger         : {%First:adsp% }{%Middle:adsp% }{%Last%}
H.A. Kissinger          : {%First:adp%}{%Middle:adp%}{ %Last%}
H. Kissinger            : {%First:adp%}{ %Last%}
H A Kissinger           : {%First:ads% }{%Middle:ads% }{%Last%}
HA Kissinger            : {%First:a%}{%Middle:a%}{ %Last%}
H Kissinger             : {%First:as%}{ %Last%}

Example sorting format strings

Order of appearance                   : nothing, this is the default setting for BibWord
Author + Title                        : {%Author:10%} {%Title:a%}
Author + Year + Title                 : {%Author:10|Title:a%} {%Year%} {%Title:a%}
First Author + Year + Other Authors   : {%Author:11r%} {%Year%} {%Author:12%}
First Author + # of Authors + Year    : {%Author:11r%} {%Author:c%} {%Year%}
Date (ascending - oldest first)       : {%Year|"0000"%}{%Month:n|"01"%}{%Day:n|"01"%}
Date (descending - most recent first) : {%Year:i|"9999"%}{%Month:in|"12"%}{%Day:in|"31"%}

with the following options for formatting the author:

<list id="10" name="all_contributors">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person>{%Last|First|Middle%}{ %First%}{ %Middle%}</first_person>
  <other_persons>{%Last|First|Middle%}{ %First%}{ %Middle%}</other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

<list id="11" name="first_contributor">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person>{%Last|First|Middle%}{ %First%}{ %Middle%}</first_person>
  <other_persons></other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

<list id="12" name="second_and_later_contributor">
  <single_prefix></single_prefix>
  <multi_prefix></multi_prefix>
  <corporate>{%Corporate%}</corporate>
  <first_person></first_person>
  <other_persons>{%Last|First|Middle%}{ %First%}{ %Middle%}</other_persons>
  <separator_between_if_two> </separator_between_if_two>
  <separator_between_if_more_than_two> </separator_between_if_more_than_two>
  <separator_before_last></separator_before_last>
  <max_number_of_persons_to_display>500</max_number_of_persons_to_display>
  <number_of_persons_to_display_if_more_than_max>500</number_of_persons_to_display_if_more_than_max>
  <overflow></overflow>
  <single_suffix></single_suffix>
  <multi_suffix></multi_suffix>
</list>

Updated Wiki: Documentation

Yves — Thu, 12 Nov 2009 22:59:46 GMT

The Styles

Styles

The Tools

BibWord : the template on top of which the styles are created
BibWord Extender : the external application used to add extra functionality like year suffices to the Word bibliography tools
BibType : an application to extend the available fields and types

Creating and Editing Styles

Format Strings

Updated Wiki: History

Yves — Sat, 24 Oct 2009 22:40:19 GMT

Project History

BibWord

BibWord v.2.7 (25/10/2009)

added the 'n' option to always display Month and MonthAccessed with 2 digits
added the 'i' option to invert Month and MonthAccessed (13 - Month) (useful for sorting purposes)
added the 'i' option to invert Day and DayAccessed (32 - Month) (useful for sorting purposes)
added the 's' option to SourceType
fixed a bug in the options of Year and YearAccessed formatting where the options were ignored in combination with the 'r' flag

BibWord v.2.6 (27/09/2009)

added the 'i' option to invert Year and YearAccessed (9999 - Year) (useful for sorting purposes)
added the 'a' option to abbreviate Corporate contributors
grouped and cleaned up all sorting functionality

BibWord v.2.5 (10/05/2009)

added the 'm' option to title formatting to allow for the selection of the master title
added the 's' option to title formatting to allow for the selection of the sub title
added the 'f' option to title formatting to capitalize the first word
extended the 'a' option so now other articles then 'a', 'an', and 'the' can be moved to the end (i18n)
fixed bug in name abbreviation where abbreviated parts without spaces did get further abbreviated (A.B. became A.)
fixed a display bug where an URL between < and > was not shown

BibWord v.2.4 (26/04/2009)

added default 'MsoBibliography' style to footnote citations (Word 2008 only)
added a 'c' option to contributors so they can be counted (e.g. %Author:c%)
fixed a year suffix issue where sources where not sorted but still required year suffices

BibWord v.2.3 (26/02/2009)

added functionality to make in-text citations links which point to their accompanying bibliography entry through the citationaslink element in the general section
added a version variable at the end of the stylesheet (for easier BibWord updates)
removed an obsolete debugging routine

BibWord v.2.2 (17/02/2009)

added support for b:FootnoteCitation (Word 2008)
added support for b:Description (Word 2008)
added support for b:updateURL (Word 2008)

BibWord v.2.1 (11/02/2009)

changed both the file encoding and output encoding to utf-8 (Word 2008 support)
changed html output encoding to utf-8 (Word 2008 support)

BibWord v.2.0 (04/02/2009)

renamed all key variables to skey to prevent double definition of key when the stylesheet is used in combination with Internet Explorer
fixed a recursion bug in the get-person-parameter routine

BibWord v.1.9 (08/12/2008)

added the possibility to format placeholders using the 'Placeholder' type for sources
fixed two bugs in the abbreviate-name routine (reported by ilbajec)

BibWord v.1.8 (29/11/2008)

simplified ordinal formatting
introduced roman numerals for CitationVolume, Edition, Month, MonthAccessed, and Volume
added the possibility to specify a minimum length for abbreviated pages (e.g. 'a2': 135-137 becomes 135-37 rather than 135-7)
fixed a bug in the recursion where sometimes a field was marked as used while it was not

BibWord v.1.7 (23/11/2008)

fixed a bug influencing all BibWord extensions

BibWord v.1.6 (22/11/2008)

added the option to display only the first page of a range of pages
added the option to display the ordinal suffix in superscript
fixed a bug in the formatting of ordinals where sometimes the wrong suffix was shown
fixed a bug in the abbreviation of pages where sometimes nothing was shown

BibWord v.1.5 (11/11/2008)

fixed a namelist formatting bug where the wrong separator was displayed before the last contributor and the overflow
fixed a bug in the formatting of ordinals
added 4 new variables for in-text citations: CitationPages, CitationPrefix, CitationSuffix, CitationVolume
added support for abbreviating and extending page ranges (e.g. 137-139 => 137-9)
added support for year suffices (requires the BibWord Extender tool)

BibWord v.1.4

fixed a recursion error where variables got marked as being used while they were not
added 'r' parameter to all variables allowing variables being used multiple times within the same format
added day formatting options
added the possibility to use string laterals instead of variables (e.g.: %Author:2|"Anonymous"%)
changed name abbreviation to support the display and/or removal of dashes and spaces between name parts
added a possibility to display an error message when there is no formatting information for a source string

BibWord v.1.3

fixed the way the 'x' at the start and the end of a bibliography are hidden in case tables are used

BibWord v.1.2

added month formatting

BibWord v.1.1

added the BibOrder extension

BibWord v.1.0

initial release

BibWord Extender

BibWord Extender v.2.0 (16/03/2009)

runs on Mono
allows for selection of a different style directory than the default one
allows for creating backups of your file (just so you can always be on the safe side)
handles non-BibWord styles better

BibWord Extender v.1.2 (11/02/2009)

fixed encoding issue (this should hopefully also fix the \u2013 issues some people reported)

BibWord Extender v.1.1 (06/12/2008)

made stylesheet encoding independent
compiled targetting x86 so registry access on a 64 bit machine does not fail

BibWord Extender v.1.0 (16/11/2008)

initial release

BibOrder (deprecated)

BibOrder v.1.0 (5/9/2008)

initial release

BibType

BibType v.1.0 (4/8/2008)

initial release

Updated Wiki: BibWord

Yves — Sat, 24 Oct 2009 22:38:21 GMT

BibWord

Latest version (v.2.7)

Introduction

Starting with Microsoft Word 2007, customers with knowledge of XML and XSLT can create their own stylesheets to format citation and bibliography fields within their Word documents. Although still in its infancy, the technology looks very promising for everyone interested in writing scientific articles. Unfortunately, the technology is poorly documented and for most customers the stylesheets which come with Word are overly complex to be used as a guideline for developing new stylesheets.

BibWord is an XSLT template which attempts to simplify the process of creating new bibliography styles. With the help of the BibWord Extender tool, the functionality of the bibliography styles can even be extended.

Advantages

Some of the advantages of the BibWord approach are:

the elimination of the need to understand and write XSLT;
the introduction of a simple conditional language to format reference data depending on its availability;
the grouping of all formatting information allowing users to update or change existing BibWord styles in seconds;
the possibility to use numerical in-text citations based on the order of the bibliography entries through the BibWord Extender tool;
the possibility to use year suffices if the same author published multiple works in the same year through the BibWord Extender tool.

Information

More information on the formatting capabilities of BibWord can be found:

in the 'BibWord Guide' which comes with each release;
in the style template which comes with an example for formatting books;
in a number of publically available styles implemented so far;
in this tutorial.

License

BibWord is currently licensed under the MIT license. If you have problems with this license and still want to use BibWord, please contact the project coordinators to discuss alternative licensing policies.

History

See project history.

Updated Wiki: Home

Yves — Sun, 27 Sep 2009 19:07:32 GMT

Introduction

BibWord makes it easier to create and manipulate Microsoft Word citation and bibliography styles. BibWord also resolves several limitations of the basic implementation by Microsoft.
For end-users, BibWord offers a collection of easy to use styles.

For End-Users (updated May 10, 2009)

Styles
A collection of styles created using the BibWord template. Styles include:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Chemical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Council of Science Editors (CSE)
Harvard AGPS - Anglia - Exeter - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver
...

BibWord Extender
A tool for creating numeric in-text citations based on the ordering of the bibliographic entries. With some styles, it can also be used to generate year suffices.

For Developers (updated September 27, 2009)

Tools

BibWord - A template for the creation of Word 2007/2008 bibliography styles. Styles created using the template can be easily maintained or adjusted by others.
BibWord Extender - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles.
BibType - A command-line tool for the creation and adaptation of the content of the GUI for editing sources within Word 2007 (bibform.xml).

FAQ

List of FAQ questions for people creating their own stylesheets from scratch or adjusting the predefined Word 2007 bibliography styles.

Older stuff

A number of older stylesheets and templates. They are no longer supported.

IEEE style v.2.5 - an older pre-BibWord version of the IEEE style. Use the BibWord replacements instead.
Template using a two column layout for bibliographies.
Template with extension capabilities such as sorting.
BibOrder - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles. (deprecated, use BibWord Extender instead)
A number of requested styles based on the original Word 2007 styles.

Updated Wiki: History

Yves — Sun, 27 Sep 2009 17:21:40 GMT

Project History

BibWord

BibWord v.2.6 (27/09/2009)

added the 'i' option to invert Year and YearAccessed (9999 - Year) (useful for sorting purposes)
added the 'a' option to abbreviate Corporate contributors
grouped and cleaned up all sorting functionality

BibWord v.2.5 (10/05/2009)

added the 'm' option to title formatting to allow for the selection of the master title
added the 's' option to title formatting to allow for the selection of the sub title
added the 'f' option to title formatting to capitalize the first word
extended the 'a' option so now other articles then 'a', 'an', and 'the' can be moved to the end (i18n)
fixed bug in name abbreviation where abbreviated parts without spaces did get further abbreviated (A.B. became A.)
fixed a display bug where an URL between < and > was not shown

BibWord v.2.4 (26/04/2009)

added default 'MsoBibliography' style to footnote citations (Word 2008 only)
added a 'c' option to contributors so they can be counted (e.g. %Author:c%)
fixed a year suffix issue where sources where not sorted but still required year suffices

BibWord v.2.3 (26/02/2009)

added functionality to make in-text citations links which point to their accompanying bibliography entry through the citationaslink element in the general section
added a version variable at the end of the stylesheet (for easier BibWord updates)
removed an obsolete debugging routine

BibWord v.2.2 (17/02/2009)

added support for b:FootnoteCitation (Word 2008)
added support for b:Description (Word 2008)
added support for b:updateURL (Word 2008)

BibWord v.2.1 (11/02/2009)

changed both the file encoding and output encoding to utf-8 (Word 2008 support)
changed html output encoding to utf-8 (Word 2008 support)

BibWord v.2.0 (04/02/2009)

renamed all key variables to skey to prevent double definition of key when the stylesheet is used in combination with Internet Explorer
fixed a recursion bug in the get-person-parameter routine

BibWord v.1.9 (08/12/2008)

added the possibility to format placeholders using the 'Placeholder' type for sources
fixed two bugs in the abbreviate-name routine (reported by ilbajec)

BibWord v.1.8 (29/11/2008)

simplified ordinal formatting
introduced roman numerals for CitationVolume, Edition, Month, MonthAccessed, and Volume
added the possibility to specify a minimum length for abbreviated pages (e.g. 'a2': 135-137 becomes 135-37 rather than 135-7)
fixed a bug in the recursion where sometimes a field was marked as used while it was not

BibWord v.1.7 (23/11/2008)

fixed a bug influencing all BibWord extensions

BibWord v.1.6 (22/11/2008)

added the option to display only the first page of a range of pages
added the option to display the ordinal suffix in superscript
fixed a bug in the formatting of ordinals where sometimes the wrong suffix was shown
fixed a bug in the abbreviation of pages where sometimes nothing was shown

BibWord v.1.5 (11/11/2008)

fixed a namelist formatting bug where the wrong separator was displayed before the last contributor and the overflow
fixed a bug in the formatting of ordinals
added 4 new variables for in-text citations: CitationPages, CitationPrefix, CitationSuffix, CitationVolume
added support for abbreviating and extending page ranges (e.g. 137-139 => 137-9)
added support for year suffices (requires the BibWord Extender tool)

BibWord v.1.4

fixed a recursion error where variables got marked as being used while they were not
added 'r' parameter to all variables allowing variables being used multiple times within the same format
added day formatting options
added the possibility to use string laterals instead of variables (e.g.: %Author:2|"Anonymous"%)
changed name abbreviation to support the display and/or removal of dashes and spaces between name parts
added a possibility to display an error message when there is no formatting information for a source string

BibWord v.1.3

fixed the way the 'x' at the start and the end of a bibliography are hidden in case tables are used

BibWord v.1.2

added month formatting

BibWord v.1.1

added the BibOrder extension

BibWord v.1.0

initial release

BibWord Extender

BibWord Extender v.2.0 (16/03/2009)

runs on Mono
allows for selection of a different style directory than the default one
allows for creating backups of your file (just so you can always be on the safe side)
handles non-BibWord styles better

BibWord Extender v.1.2 (11/02/2009)

fixed encoding issue (this should hopefully also fix the \u2013 issues some people reported)

BibWord Extender v.1.1 (06/12/2008)

made stylesheet encoding independent
compiled targetting x86 so registry access on a 64 bit machine does not fail

BibWord Extender v.1.0 (16/11/2008)

initial release

BibOrder (deprecated)

BibOrder v.1.0 (5/9/2008)

initial release

BibType

BibType v.1.0 (4/8/2008)

initial release

Updated Wiki: BibWord

Yves — Sun, 27 Sep 2009 17:20:08 GMT

BibWord

Latest version (v.2.6)

Introduction

Advantages

Some of the advantages of the BibWord approach are:

the elimination of the need to understand and write XSLT;
the introduction of a simple conditional language to format reference data depending on its availability;
the grouping of all formatting information allowing users to update or change existing BibWord styles in seconds;
the possibility to use numerical in-text citations based on the order of the bibliography entries through the BibWord Extender tool;
the possibility to use year suffices if the same author published multiple works in the same year through the BibWord Extender tool.

Information

More information on the formatting capabilities of BibWord can be found:

in the 'BibWord Guide' which comes with each release;
in the style template which comes with an example for formatting books;
in a number of publically available styles implemented so far;
in this tutorial.

License

History

See project history.

Updated Wiki: BibWord

Yves — Sun, 27 Sep 2009 17:19:57 GMT

BibWord

Latest version (v.2.5)

Introduction

Advantages

Some of the advantages of the BibWord approach are:

the elimination of the need to understand and write XSLT;
the introduction of a simple conditional language to format reference data depending on its availability;
the grouping of all formatting information allowing users to update or change existing BibWord styles in seconds;
the possibility to use numerical in-text citations based on the order of the bibliography entries through the BibWord Extender tool;
the possibility to use year suffices if the same author published multiple works in the same year through the BibWord Extender tool.

Information

More information on the formatting capabilities of BibWord can be found:

in the 'BibWord Guide' which comes with each release;
in the style template which comes with an example for formatting books;
in a number of publically available styles implemented so far;
in this tutorial.

License

History

See project history.

Updated Wiki: Styles

Yves — Thu, 24 Sep 2009 13:32:26 GMT

Styles

Latest version of all styles

Introduction

The main goal of this project is to collect and maintain a number of bibliography styles which can be used by Microsoft Word 2007 and later. Most styles are either created using BibWord or derived from the styles which come with Microsoft Word.

Each family of styles comes with its own release page. Whenever bugs are fixed or new types are added, the same release gets updated.

Everybody who wants to submit a style can do so by contacting one of the project coordinators. The only requirement for putting a style on the project page, is that you release your style under the MIT license. That basically allows people to do whatever they want with your style as long as they give you credit for it.

Supported styles

The following list contains an overview of the current set of styles:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Medical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Chicago Footnotes (beta - not in zip)
Council of Science Editors (CSE)
Harvard - AGPS
Harvard - Anglia
Harvard - Exeter
Harvard - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver

Download

You can download a zip file containing all styles from here.

Installation on Windows (Word 2007)

To use the bibliography styles, they have to be copied into the Microsoft Word bibliography style directory. This directory can vary depending on where Word is installed:

    <winword.exe directory>\Bibliography\Style

On most 32-bits machines with Microsoft Word 2007 this will be:

    %programfiles%\Microsoft Office\Office12\Bibliography\Style

Once the styles are copied to the directory, they will show up every time Microsoft Word is opened.

Remark: the types.xml included with the stylesheets should be used in combination with BibType to create some extra fields for the different types.

Installation on Mac OS X (Word 2008)

To use the bibliography styles, right-click on Microsoft Word 2008 and select show package contents. Put the files in:

    Contents/Resources/Style/

On most Macs with Microsoft Word 2008 this will be:

    /Applications/Microsoft Office 2008/Microsoft Word.app/Contents/Resources/Style/

FAQ

A number of frequently asked questions regarding the style linked from this page can be found here.

Updated Wiki: Styles

Yves — Fri, 07 Aug 2009 22:44:47 GMT

Styles

Latest version of all styles

Introduction

Supported styles

The following list contains an overview of the current set of styles:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Medical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Chicago Footnotes (beta - not in zip)
Council of Science Editors (CSE)
Harvard - AGPS
Harvard - Anglia
Harvard - Exeter
Harvard - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver

Download

You can download a zip file containing all styles from here.

Installation on Windows (Word 2007)

To use the bibliography styles, they have to be copied into the Microsoft Word bibliography style directory. This directory can vary depending on where Word is installed:

    <winword.exe directory>\Bibliography\Style

On most 32-bits machines with Microsoft Word 2007 this will be:

    %program files%\Microsoft Office\Office12\Bibliography\Style

Installation on Mac OS X (Word 2008)

To use the bibliography styles, right-click on Microsoft Word 2008 and select show package contents. Put the files in:

    Contents/Resources/Style/

On most Macs with Microsoft Word 2008 this will be:

    /Applications/Microsoft Office 2008/Microsoft Word.app/Contents/Resources/Style/

FAQ

A number of frequently asked questions regarding the style linked from this page can be found here.

Updated Wiki: Styles_FAQ

Yves — Tue, 07 Jul 2009 19:09:51 GMT

Frequently Asked Questions for BibWord Styles

This pages contains answers regarding questions about the styles published through this project. For questions regarding the citations and bibliography tool in general, check the developer FAQ.

Why is a new style not showing up in Word when I add it to the Style directory?
In Word 2008, new styles are only added for citations. How can I use the new styles for bibliographies?
Why does it take Word so long to show the dropdown list with style names the first time?
Why do I get 'BO' instead of a number when using certain styles?
Why do certain styles have a * at the end of their name?
Can I request to get a certain style?
Can I (not) link my in-text citations to their bibliography entries?
Can I change the surrounding brackets for in-text citations?
How do I get my in-text citations in superscript?
How do I convert all my in-text citations to static text in one go?
Is there an easy way to get rid of sources which are not cited in the text?
How do I set the indentation of my bibliography?
Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).
Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?

Q: Why is a new style not showing up in Word when I add it to the Style directory?
A: The list of available reference styles gets loaded only once. So when you add a new style to the style directory, you need to restart Word.

Q: In Word 2008, new styles are only added for citations. How can I use the new styles for bibliographies?
A: Add the bibliography using one of the four predefined styles. Then go to the citation toolbox and select the style you want. This will update all the citations and bibliographies in your text to the new style.

Q: Why does it take Word so long to show the dropdown list with style names the first time?
A: Word has to retrieve the style names of every XSL in the style directory the first time. Hence, the more styles you put in the directory, the more time Word needs to fill the drop down list.

Q: Why do I get 'BO' instead of a number when using certain styles?
A: 'BO' is often printed when the BibOrder number is not available. Use the BibWord Extender tool on the document to add the missing numbers.

Q: Why do certain styles have a * at the end of their name?
A: Although the usage of a * is not mandatory, it often indicates that part of the functionality of the style can only be used in combination with the BibWord Extender tool.

Q: Can I request to get a certain style?
A: No. Using BibWord, you really should try to create the style yourself. Keep in mind that even if you find someone prepared to create the style for you that you will have to provide him/her with detailed information about the formatting guidelines for your style. Messages containing "I need style x." will most likely be ignored.

Q: Can I (not) link my in-text citations to their bibliography entries?
A: Yes. Set the value of citation_as_link to 'yes' if you want in-text citations to link to their specific bibliography entry, or to any other value if you do not.

Q: Can I change the surrounding brackets for in-text citations?
A: Yes. You can change the surrounding brackets by changing the values of openbracket and closebracket

Q: How do I get my in-text citations in superscript?
A: In-text citations inherit the style of their surroundings. Only limited formatting (bold, underline, italic) can be applied to them through the reference style. For any further formatting, such as superscript, a character style has to be applied to all CITATION fields.

The following macro creates a character style called In-Text Citation if it does not yet exist. When the style is newly created, it sets the font to superscript. Then the style is applied to all CITATION fields in the document. By changing/updating the style In-Text Citation you can then update the formatting of all citations

Sub ApplyCitationStyle()
    Dim stylename As String
    Dim exists As Boolean
    Dim s As Style
    Dim fld As Field
                
    stylename = "In-Text Citation"
        
    ' Check if the style already exists.
    exists = False
        
    For Each s In ActiveDocument.Styles
        If s.NameLocal = stylename Then
           exists = True
           Exit For
        End If
    Next
    
    ' If the style did not exist yet, create it.
    If exists = False Then
        Set s = ActiveDocument.Styles.Add(stylename, wdStyleTypeCharacter)
        s.BaseStyle = ActiveDocument.Styles(wdStyleDefaultParagraphFont).BaseStyle
        s.Font.Superscript = True
    End If
    
    ' Now that the style really exists, select it.
    Set s = ActiveDocument.Styles(stylename)
     
    ' Apply the style to all in-text citations.
    For Each fld In ActiveDocument.Fields
        If fld.Type = wdFieldCitation Then
            fld.Select
            Selection.Style = s
        End If
    Next

End Sub

Q: How do I convert all my in-text citations to static text in one go?
A: You can use the following macro to convert all in-text citations:

Sub CitationsToStaticText()
    Dim fld As Field
            
    ' Go over all stories, including main, footnotes, ...
    For Each sr In ActiveDocument.StoryRanges
        ' Find all citation fields and convert them to static text.
        For Each fld In sr.Fields
            If fld.Type = wdFieldCitation Then
                fld.Select
                WordBasic.BibliographyCitationToText
            End If
        Next
    Next

End Sub

Q: Is there an easy way to get rid of sources which are not cited in the text?
A: You can use the following macro to remove all uncited sources from a document:

Sub RemoveUnusedCitations()
    ' Get the number of sources.
    idx = ActiveDocument.Bibliography.Sources.Count
    
    ' Remmove unused sources starting from the last one.
    Do While (idx > 0)
        If ActiveDocument.Bibliography.Sources(idx).Cited = False Then
            ActiveDocument.Bibliography.Sources(idx).Delete
        End If
        idx = idx - 1
    Loop
End Sub

Q: How do I set the indentation of my bibliography?
A: Add a bibliography to your document. Open the 'Styles' pane (CTRL+ALT+SHIFT+S) and look for a style called 'Bibliography' (or a localized translation of the word 'Bibliography'). Change the indentation settings there. That way, whenever your bibliography gets updated, the indentation will remain correct.

Q: Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).
A: Yes. You can add a second source to a citation by using the '\m' switch and the tag of the source you want to add. In Word 2007, if you want to add a source with tag 'Bee99' to an existing citation, right click the citation and select 'Edit Field...'. It will show you something like 'CITATION Gup97 \l 2060'. To add the extra source, change it to 'CITATION Gup97 \l 2060 \m Bee99'. For more information, also see the Microsoft Office online help topic on the CITATION field code.

Alternatively, you can put your cursor inside any in-text citation, then go to 'References' tab in the ribbon and click 'Insert Citation'.

To change the separator between two grouped in-text citations, BibWord uses the separator element.

Q: Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?
A: No. You probably made a mistake when entering the different author names. You should enter them one by one in the dialog that comes up when clicking the "Edit..." button next to the author field. That way you will not make a mistake.

If you really want to enter them as a string, then be aware that the correct format is "Last1, First1 Middle1; Last2, First2 Middle2; ...". So the names are separated by a ";" while name parts are separated by a ",".

Note that there is a bug in Word where sometimes the name conversion goes wrong. For more info, see here.

Updated Wiki: Styles_FAQ

Yves — Fri, 29 May 2009 17:08:09 GMT

Frequently Asked Questions for BibWord Styles

This pages contains answers regarding questions about the styles published through this project. For questions regarding the citations and bibliography tool in general, check the developer FAQ.

Why is a new style not showing up in Word when I add it to the Style directory?
In Word 2008, new styles are only added for citations. How can I use the new styles for bibliographies?
Why does it take Word so long to show the dropdown list with style names the first time?
Why do I get 'BO' instead of a number when using certain styles?
Why do certain styles have a * at the end of their name?
Can I request to get a certain style?
Can I (not) link my in-text citations to their bibliography entries?
Can I change the surrounding brackets for in-text citations?
How do I get my in-text citations in superscript?
How do I convert all my in-text citations to static text in one go?
Is there an easy way to get rid of sources which are not cited in the text?
How do I set the indentation of my bibliography?
Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).
Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?

Sub ApplyCitationStyle()
    Dim stylename As String
    Dim exists As Boolean
    Dim s As Style
    Dim fld As Field
                
    stylename = "In-Text Citation"
        
    ' Check if the style already exists.
    exists = False
        
    For Each s In ActiveDocument.Styles
        If s.NameLocal = stylename Then
           exists = True
           Exit For
        End If
    Next
    
    ' If the style did not exist yet, create it.
    If exists = False Then
        Set s = ActiveDocument.Styles.Add(stylename, wdStyleTypeCharacter)
        s.BaseStyle = ActiveDocument.Styles(wdStyleDefaultParagraphFont).BaseStyle
        s.Font.Superscript = True
    End If
    
    ' Now that the style really exists, select it.
    Set s = ActiveDocument.Styles(stylename)
     
    ' Apply the style to all in-text citations.
    For Each fld In ActiveDocument.Fields
        If fld.Type = wdFieldCitation Then
            fld.Select
            Selection.Style = s
        End If
    Next

End Sub

Q: How do I convert all my in-text citations to static text in one go?
A: You can use the following macro to convert all in-text citations:

Sub CitationsToStaticText()
    Dim fld As Field
            
    ' Go over all stories, including main, footnotes, ...
    For Each sr In ActiveDocument.StoryRanges
        ' Find all citation fields and convert them to static text.
        For Each fld In sr.Fields
            If fld.Type = wdFieldCitation Then
                fld.Select
                WordBasic.BibliographyCitationToText
            End If
        Next
    Next

End Sub

Q: Is there an easy way to get rid of sources which are not cited in the text?
A: You can use the following macro to remove all uncited sources from a document:

Sub RemoveUnusedCitations()
    ' Get the number of sources.
    idx = ActiveDocument.Bibliography.Sources.Count
    
    ' Remmove unused sources starting from the last one.
    Do While (idx > 0)
        If ActiveDocument.Bibliography.Sources(idx).Cited = False Then
            ActiveDocument.Bibliography.Sources(idx).Delete
        End If
        idx = idx - 1
    Loop
End Sub

Q: How do I set the indentation of my bibliography?
A: Add a bibliography to your document. Open the 'Styles' pane (CTRL+ALT+SHIFT+S) and look for a style called 'Bibliography' (or a localized translation of the word 'Bibliography'). Change the indentation settings there. That way, whenever your bibliography gets updated, the indentation will remain correct.

Q: Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).
A: Yes. You can add a second source to a citation by using the '\m' switch and the tag of the source you want to add. In Word 2007, if you want to add a source with tag 'Bee99' to an existing citation, right click the citation and select 'Edit Field...'. It will show you something like 'CITATION Gup97 \l 2060'. To add the extra source, change it to 'CITATION Gup97 \l 2060 \m Bee99'. For more information, also see the Microsoft Office online help topic on the CITATION field code.

Alternatively, you can put your cursor inside any in-text citation, then go to 'References' tab in the ribbon and click 'Insert Citation'.

To change the separator between two grouped in-text citations, BibWord uses the separator element.

Q: Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?
A: No. You probably made a mistake when entering the different author names. You should enter them one by one in the dialog that comes up when clicking the "Edit..." button next to the author field. That way you will not make a mistake.

If you really want to enter them as a string, then be aware that the correct format is "Last1, First1 Middle1; Last2, First2 Middle2; ...". So the names are separated by a ";" while name parts are separated by a ",".

Note that there is a bug in Word where sometimes the name conversion goes wrong. For more info, see here.

Updated Wiki: Styles_FAQ

Yves — Fri, 29 May 2009 17:07:44 GMT

Frequently Asked Questions for BibWord Styles

This pages contains answers regarding questions about the styles published through this project. For questions regarding the citations and bibliography tool in general, check the developer FAQ.

Why is a new style not showing up in Word when I add it to the Style directory?
In Word 2008, new styles are only added for citations. How can I use the new styles for bibliographies?
Why does it take Word so long to show the dropdown list with style names the first time?
Why do I get 'BO' instead of a number when using certain styles?
Why do certain styles have a * at the end of their name?
Can I request to get a certain style?
Can I (not) link my in-text citations to their bibliography entries?
Can I change the surrounding brackets for in-text citations?
How do I get my in-text citations in superscript?
How do I convert all my in-text citations to static text in one go?
Is there an easy way to get rid of sources which are not cited in the text?
How do I set the indentation of my bibliography?
Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).
Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?

Sub ApplyCitationStyle()
    Dim stylename As String
    Dim exists As Boolean
    Dim s As Style
    Dim fld As Field
                
    stylename = "In-Text Citation"
        
    ' Check if the style already exists.
    exists = False
        
    For Each s In ActiveDocument.Styles
        If s.NameLocal = stylename Then
           exists = True
           Exit For
        End If
    Next
    
    ' If the style did not exist yet, create it.
    If exists = False Then
        Set s = ActiveDocument.Styles.Add(stylename, wdStyleTypeCharacter)
        s.BaseStyle = ActiveDocument.Styles(wdStyleDefaultParagraphFont).BaseStyle
        s.Font.Superscript = True
    End If
    
    ' Now that the style really exists, select it.
    Set s = ActiveDocument.Styles(stylename)
     
    ' Apply the style to all in-text citations.
    For Each fld In ActiveDocument.Fields
        If fld.Type = wdFieldCitation Then
            fld.Select
            Selection.Style = s
        End If
    Next

End Sub

Q: How do I convert all my in-text citations to static text in one go?
A: You can use the following macro to convert all in-text citations:

Sub CitationsToStaticText()
    Dim fld As Field
            
    ' Go over all stories, including main, footnotes, ...
    For Each sr In ActiveDocument.StoryRanges
        ' Find all citation fields and convert them to static text.
        For Each fld In sr.Fields
            If fld.Type = wdFieldCitation Then
                fld.Select
                WordBasic.BibliographyCitationToText
            End If
        Next
    Next

End Sub

Q: Is there an easy way to get rid of sources which are not cited in the text?
A: You can use the following macro to remove all uncited sources from a document:

Sub RemoveUnusedCitations()
    ' Get the number of sources.
    idx = ActiveDocument.Bibliography.Sources.Count
    
    ' Remmove unused sources starting from the last one.
    Do While (idx > 0)
        If ActiveDocument.Bibliography.Sources(idx).Cited = False Then
            ActiveDocument.Bibliography.Sources(idx).Delete
        End If
        idx = idx - 1
    Loop
End Sub

Q: How do I set the indentation of my bibliography?
A: Add a bibliography to your document. Open the 'Styles' pane (CTRL+ALT+SHIFT+S) and look for a style called 'Bibliography' (or a localized translation of the word 'Bibliography'). Change the indentation settings there. That way, whenever your bibliography gets updated, the indentation will remain correct.

Q: Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).

A: Yes. You can add a second source to a citation by using the '\m' switch and the tag of the source you want to add. In Word 2007, if you want to add a source with tag 'Bee99' to an existing citation, right click the citation and select 'Edit Field...'. It will show you something like 'CITATION Gup97 \l 2060'. To add the extra source, change it to 'CITATION Gup97 \l 2060 \m Bee99'. For more information, also see the Microsoft Office online help topic on the CITATION field code.

Alternatively, you can put your cursor inside any in-text citation, then go to 'References' tab in the ribbon and click 'Insert Citation'.

To change the separator between two grouped in-text citations, BibWord uses the separator element.

Q: Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?

A: No. You probably made a mistake when entering the different author names. You should enter them one by one in the dialog that comes up when clicking the "Edit..." button next to the author field. That way you will not make a mistake.

If you really want to enter them as a string, then be aware that the correct format is "Last1, First1 Middle1; Last2, First2 Middle2; ...". So the names are separated by a ";" while name parts are separated by a ",".

Note that there is a bug in Word where sometimes the name conversion goes wrong. For more info, see here.

Updated Wiki: Home

Yves — Sun, 10 May 2009 13:43:12 GMT

Introduction

For End-Users (updated May 10, 2009)

Styles
A collection of styles created using the BibWord template. Styles include:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Chemical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Council of Science Editors (CSE)
Harvard AGPS - Anglia - Exeter - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver
...

BibWord Extender
A tool for creating numeric in-text citations based on the ordering of the bibliographic entries. With some styles, it can also be used to generate year suffices.

For Developers (updated May 10, 2009)

Tools

BibWord - A template for the creation of Word 2007/2008 bibliography styles. Styles created using the template can be easily maintained or adjusted by others.
BibWord Extender - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles.
BibType - A command-line tool for the creation and adaptation of the content of the GUI for editing sources within Word 2007 (bibform.xml).

FAQ

List of FAQ questions for people creating their own stylesheets from scratch or adjusting the predefined Word 2007 bibliography styles.

Older stuff

A number of older stylesheets and templates. They are no longer supported.

IEEE style v.2.5 - an older pre-BibWord version of the IEEE style. Use the BibWord replacements instead.
Template using a two column layout for bibliographies.
Template with extension capabilities such as sorting.
BibOrder - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles. (deprecated, use BibWord Extender instead)
A number of requested styles based on the original Word 2007 styles.

Updated Wiki: Home

Yves — Sun, 10 May 2009 13:37:31 GMT

Introduction

For End-Users (updated Apr. 26, 2009)

Styles
A collection of styles created using the BibWord template. Styles include:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Chemical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Council of Science Editors (CSE)
Harvard AGPS - Anglia - Exeter - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver
...

BibWord Extender
A tool for creating numeric in-text citations based on the ordering of the bibliographic entries. With some styles, it can also be used to generate year suffices.

For Developers (updated Apr. 26, 2009)

Tools

BibWord - A template for the creation of Word 2007/2008 bibliography styles. Styles created using the template can be easily maintained or adjusted by others.
BibWord Extender - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles.
BibType - A command-line tool for the creation and adaptation of the content of the GUI for editing sources within Word 2007 (bibform.xml).

FAQ

List of FAQ questions for people creating their own stylesheets from scratch or adjusting the predefined Word 2007 bibliography styles.

Older stuff

A number of older stylesheets and templates. They are no longer supported.

IEEE style v.2.5 - an older pre-BibWord version of the IEEE style. Use the BibWord replacements instead.
Template using a two column layout for bibliographies.
Template with extension capabilities such as sorting.
BibOrder - An extension of BibWord for creating both numeric in-text citations based on the ordering of the bibliographic entries and year suffices. This can only be used with BibWord styles. (deprecated, use BibWord Extender instead)
A number of requested styles based on the original Word 2007 styles.

Updated Wiki: Styles

Yves — Sun, 10 May 2009 13:35:30 GMT

Styles

Latest version of all styles

Introduction

Supported styles

The following list contains an overview of the current set of styles:

Associação Brasileira de Normas Técnicas (ABNT)
Association for Computing Machinery (ACM)
American Medical Society (ACS)
American Medical Association (AMA)
American Sociological Association (ASA)
Chicago Footnotes (beta - not in zip)
Council of Science Editors (CSE)
Harvard - AGPS
Harvard - Anglia
Harvard - Exeter
Harvard - Leeds
Humana Press
IEEE
Lecture Notes in Computer Science (LNCS)
Modern Humanities Research Association (MHRA)
Nature
Vancouver

Download

You can download a zip file containing all styles from here.

Installation on Windows (Word 2007)

To use the bibliography styles, they have to be copied into the Microsoft Word bibliography style directory. This directory can vary depending on where Word is installed:

    <winword.exe directory>\Bibliography\Style

On most machines with Microsoft Word 2007 this will be:

    %program files%\Microsoft Office\Office12\Bibliography\Style

Installation on Mac OS X (Word 2008)

To use the bibliography styles, right-click on Microsoft Word 2008 and select show package contents. Put the files in:

    Contents/Resources/Style/

On most Macs with Microsoft Word 2008 this will be:

    /Applications/Microsoft Office 2008/Microsoft Word.app/Contents/Resources/Style/

FAQ

A number of frequently asked questions regarding the style linked from this page can be found here.

Updated Wiki: History

Yves — Sun, 10 May 2009 09:53:46 GMT

Project History

BibWord

BibWord v.2.5 (10/05/2009)

added the 'm' option to title formatting to allow for the selection of the master title
added the 's' option to title formatting to allow for the selection of the sub title
added the 'f' option to title formatting to capitalize the first word
extended the 'a' option so now other articles then 'a', 'an', and 'the' can be moved to the end (i18n)
fixed bug in name abbreviation where abbreviated parts without spaces did get further abbreviated (A.B. became A.)
fixed a display bug where an URL between < and > was not shown

BibWord v.2.4 (26/04/2009)

added default 'MsoBibliography' style to footnote citations (Word 2008 only)
added a 'c' option to contributors so they can be counted (e.g. %Author:c%)
fixed a year suffix issue where sources where not sorted but still required year suffices

BibWord v.2.3 (26/02/2009)

added functionality to make in-text citations links which point to their accompanying bibliography entry through the citationaslink element in the general section
added a version variable at the end of the stylesheet (for easier BibWord updates)
removed an obsolete debugging routine

BibWord v.2.2 (17/02/2009)

added support for b:FootnoteCitation (Word 2008)
added support for b:Description (Word 2008)
added support for b:updateURL (Word 2008)

BibWord v.2.1 (11/02/2009)

changed both the file encoding and output encoding to utf-8 (Word 2008 support)
changed html output encoding to utf-8 (Word 2008 support)

BibWord v.2.0 (04/02/2009)

renamed all key variables to skey to prevent double definition of key when the stylesheet is used in combination with Internet Explorer
fixed a recursion bug in the get-person-parameter routine

BibWord v.1.9 (08/12/2008)

added the possibility to format placeholders using the 'Placeholder' type for sources
fixed two bugs in the abbreviate-name routine (reported by ilbajec)

BibWord v.1.8 (29/11/2008)

simplified ordinal formatting
introduced roman numerals for CitationVolume, Edition, Month, MonthAccessed, and Volume
added the possibility to specify a minimum length for abbreviated pages (e.g. 'a2': 135-137 becomes 135-37 rather than 135-7)
fixed a bug in the recursion where sometimes a field was marked as used while it was not

BibWord v.1.7 (23/11/2008)

fixed a bug influencing all BibWord extensions

BibWord v.1.6 (22/11/2008)

added the option to display only the first page of a range of pages
added the option to display the ordinal suffix in superscript
fixed a bug in the formatting of ordinals where sometimes the wrong suffix was shown
fixed a bug in the abbreviation of pages where sometimes nothing was shown

BibWord v.1.5 (11/11/2008)

fixed a namelist formatting bug where the wrong separator was displayed before the last contributor and the overflow
fixed a bug in the formatting of ordinals
added 4 new variables for in-text citations: CitationPages, CitationPrefix, CitationSuffix, CitationVolume
added support for abbreviating and extending page ranges (e.g. 137-139 => 137-9)
added support for year suffices (requires the BibWord Extender tool)

BibWord v.1.4

fixed a recursion error where variables got marked as being used while they were not
added 'r' parameter to all variables allowing variables being used multiple times within the same format
added day formatting options
added the possibility to use string laterals instead of variables (e.g.: %Author:2|"Anonymous"%)
changed name abbreviation to support the display and/or removal of dashes and spaces between name parts
added a possibility to display an error message when there is no formatting information for a source string

BibWord v.1.3

fixed the way the 'x' at the start and the end of a bibliography are hidden in case tables are used

BibWord v.1.2

added month formatting

BibWord v.1.1

added the BibOrder extension

BibWord v.1.0

initial release

BibWord Extender

BibWord Extender v.2.0 (16/03/2009)

runs on Mono
allows for selection of a different style directory than the default one
allows for creating backups of your file (just so you can always be on the safe side)
handles non-BibWord styles better

BibWord Extender v.1.2 (11/02/2009)

fixed encoding issue (this should hopefully also fix the \u2013 issues some people reported)

BibWord Extender v.1.1 (06/12/2008)

made stylesheet encoding independent
compiled targetting x86 so registry access on a 64 bit machine does not fail

BibWord Extender v.1.0 (16/11/2008)

initial release

BibOrder (deprecated)

BibOrder v.1.0 (5/9/2008)

initial release

BibType

BibType v.1.0 (4/8/2008)

initial release

bibword Wiki & Documentation Rss Feed

Updated Wiki: BibWord Format Contributors

Formatting a set of contributors

Table of Contents

Introduction

Variables

Formatting a single name

Combining names

Limiting the number of authors shown

Prefix and suffix

Examples

Updated Wiki: Documentation

The Styles

The Tools

Creating and Editing Styles

Updated Wiki: BibWord Format Strings

Format Strings

Table of Contents

Introduction

Variables/Parameters

Pages, a special parameter

Conditional Brackets

Examples

Example bibliography format string

Example contributor format strings

Example sorting format strings

Updated Wiki: BibWord Format Strings

Format Strings

Table of Contents

Introduction

Variables/Parameters

Pages, a special parameter

Conditional Brackets

Examples

Example bibliography format string

Example contributor format strings

Example sorting format strings

Updated Wiki: Documentation

The Styles

The Tools

Creating and Editing Styles

Updated Wiki: History

Project History

BibWord

BibWord Extender

BibOrder (deprecated)

BibType

Updated Wiki: BibWord

BibWord

Introduction

Advantages

Information

License

History

Updated Wiki: Home

Introduction

For End-Users (updated May 10, 2009)

For Developers (updated September 27, 2009)

Older stuff

Updated Wiki: History

Project History

BibWord

BibWord Extender

BibOrder (deprecated)

BibType

Updated Wiki: BibWord

BibWord

Introduction

Advantages

Information

License

History

Updated Wiki: BibWord

BibWord

Introduction

Advantages

Information

License

History

Updated Wiki: Styles