Microsoft Word 2010

PingBack from http://microsoft-sharepoint.simplynetdev.com/bibliography-citations-102-%e2%80%93-building-custom-styles/

It is great to finally see a follow-up post on this subject.

I have a remark though. You are using elements such as "b:Author/b:Author/b:NameList/b:Person/b:Last" without giving any clue as to where you got them. I had to retrieve the 'official' format from the open xml specification, but I doubt many people will look that hard for it. So a listing of the elements would be nice.

Some questions that remain:

1)What is the definition of the "SameAuthor", "MinAuthor", and "RepeatedAuthor" elements? Word calculates them internally, but without knowing what they represent, it is hard to use them.

2)Do the above elements (question 1) take into account that the 'author' is not always the Author? For example: Interview -> b:Interviewer, Art -> b:Artist, Book -> b:Author.

3)Can a characterstyle be directly applied to in-text citations from within the xslt? I mean, bibliographies get the MsoBibliography paragraph style applied to them. Can in-text citations get a similar MsoCitation character style applied to them? If so, what is its name? Right now it seems an in-text citation inherits its 'surrounding' style making it 'hard' to create superscript in-text citations for example.

4)Is there a(n undocumented) flag to indicate if an in-text citation should be of a different form? Basically, how can you differentiate between:

a)Darwin (1859) wrote that ...

b)... known as turtles (Darwin, 1859).

Any answers would be great, even if it is just an 'It can't be done.'

Yves

It would be very useful if Microsoft includes a tool for developing styles in word. So, I could configure a ABNT (Brazilian Academic Style), as I do need to make my doctor's thesis.

Microsoft coulda do a specific style for use in Brazil;

thanks,

Ok. That's pretty good. So, lets say, here in Brazil, according to the norm NBR 6023 of ABNT (Brazilian Association of Technical Norms), if it's not possible to determine when exactly the source was published (for instance), we should write the date between dashes; and if the place of publishing is unknown, we should write [S.l.], which means "sine loco". The same thing if the editor is unknown: we should write [S.n.], which means "sine nomine". How could the xsl script be made in this case?

And there's another issue: this same norm dictates that there are two ways of citations: one that introduces indirect citation (the author's thoughts in our own words), and another one that is the normal citation, which is:(Author, Year), used when the citation is placed after the citated fragment. To the first type of citation, one should put the name of the authors off the parentesis. So, it would be like this: Author (Year). But there's one more problem: in this type of citation, we should also mention the page on which we can find the source of that specific fragment. So, in the end, it would be: Author (Year, page number). How could it be solved?

Thanks

Romulo:

You can extend the example to do exactly what you require. You can conditionally check if a user has specified any value by using the counting method above. When the count is zero, you know that the field has not been specified and you can add any special information you may need such as [S.n.]

For example, you would add

<xsl:variable name="cPublisher">

<xsl:value-of select="count(b:Publisher)" />

</xsl:variable>

to count the publisher. You would then use the same method above to check whether cPublisher is zero and if so add [S.n.].

The second issue is a little bit more tricky. I hope this response will shed some light on Yves' question as well.

When you use a citation you'll notice that there an edit citation button. When you click the edit citation button, you get a dialog box that allows you to suppress certain fields and add pages to the citation.

You can once again conditionally display output depending on whether a tag exists or not. So you can display (Author, Year) when no fields are suppressed and then just (Year) when the author is suppressed. When you add pages or suppress an author through this dialog extra information is added to the source xml. Again, you'll have to use the same sort of conditional logic that we have in this example.

For details on how this works, you can crack open the built in XSLT's which by default install at C:\Program Files\Microsoft Office\Office12\Bibliography\Style\.

For example, I cracked open the Chicago style. I searched for noauthor and came up with the following code which conditionally displays the author depending if the noauthor flag is present. The noauthor flag is present when the author is supressed through the edit citation dialog.

- <xsl:variable name="author">

- <xsl:choose>

 <xsl:when test="msxsl:node-set($ListPopulatedWithMain)/b:Citation/b:NoAuthor" />

- <xsl:otherwise>

 <xsl:value-of select="$author0" />

 </xsl:otherwise>

 </xsl:choose>

 </xsl:variable>

You will be able to do something similar by having the citation display different outputs depending on whether the pages is specified and whether or not a field is suppressed.

I hope that answers your questions. Good luck building your style!

Rômulo and Nathan:

Using xslt's count() to check if data is available might not always work as it will also count empty elements (<b:Publisher></b:Publisher>). I think it might be better to use string-length() or text() to verify that if the element exists, it actually has content.

Nathan:

No, the conditions do not solve my fourth question. I'm aware of the NoAuthor (\n), NoYear (\y) and NoTitle (\t) flags. I know that in '(Darwin, 1859)' I could suppress the author to get to '(1859)' and then manually type 'Darwin ' in front of it. I'm just wondering if, through some unknown flag, it is possible to indicate that it should be 'Darwin (1859)' from the start so that the end user doesn't have to type 'Darwin' at all.

Yves:

You are right that you can use string-length or text to verify if the element exists. String-length is actually used in the built-in styles to check if elements exist; however, the count will also work as the tags are deleted when the string-length is zero.

Unfortunately, there is no such flag that does what you want.

Nathan,

My problem is:

Here in Brazil when we have more than 2 authors we write the first one and "et.al".

I how that office can see that I have different authors if I input them with ";" between.

So my point is:

Is there a counter that I can use?

How can I create a counter and input values for it?

Thanks

Julio Cesar Silva

Julio,

Each author is stored as a b:Person element inside a b:NameList element. You can use the count function to count the number of authors.

<xsl:variable name="cAuthors">

 <xsl:value-of select="count(b:Author/b:Author/b:NameList/b:Person)" />

</xsl:variable>

<xsl:choose>

 <xsl:when test="cAuthors = 1">

   <xsl:value-of select="b:Author/b:Author/b:NameList/b:Person/b:Last"/>

 </xsl:when>

 <xsl:when test="cAuthors = 2">

   <xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:Last"/>

   <xsl:text> and </xsl:text>

   <xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[2]/b:Last"/>

 </xsl:when>

 <xsl:when test="cAuthors &gt; 2">

   <xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:Last"/>

   <xsl:text> et al.</xsl:text>

 </xsl:when>

 <xsl:otherwise>

   <xsl:text>Anonymous work.</xsl:text>

 </xsl:otherwise>

</xsl:choose>

I prepare a simple sheet with this blog help, but it is not working. I had one sheet with book reference ok, but without et al. in case of multiples authors, so I tried to include this counter withou sucess :(

Could you help me?

<?xml version="1.0" ?>

<!-- List of the external resources that we are referencing -->

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:b="http://schemas.openxmlformats.org/officeDocument/2006/bibliography">

<!-- When the bibliography or citation is in your document, it's just HTML -->

<xsl:output method="html" encoding="us-ascii"/>

<!-- match the root element, and dispatch to its children -->

<xsl:template match="/">

<xsl:apply-templates select="*" />

</xsl:template>

<!--set an optional version number for this style-->

<xsl:template match="b:version">

<xsl:text>2006.5.07</xsl:text>

</xsl:template>

<!-- Defines the name of the style in the References dropdown -->

<xsl:template match="b:StyleName">

<xsl:text>COPPE</xsl:text>

</xsl:template>

<!-- Specifies which fields should appear in the Create Source dialog when in a collapsed state (The Show All Bibliography Fieldscheckbox is cleared) -->

<xsl:template match="b:GetImportantFields[b:SourceType = 'Book']">

<b:ImportantFields>

<b:ImportantField>

<xsl:text>b:Author/b:Author/b:NameList</xsl:text>

</b:ImportantField>

<b:ImportantField>

<xsl:text>b:Title</xsl:text>

</b:ImportantField>

<b:ImportantField>

<xsl:text>b:Year</xsl:text>

</b:ImportantField>

<b:ImportantField>

<xsl:text>b:Edition</xsl:text>

</b:ImportantField>

<b:ImportantField>

<xsl:text>b:City</xsl:text>

</b:ImportantField>

<b:ImportantField>

<xsl:text>b:Publisher</xsl:text>

</b:ImportantField>

</b:ImportantFields>

</xsl:template>

<!-- Defines the output format for a simple Book (in the Bibliography) with important fields defined -->

<xsl:template match="b:Source[b:SourceType = 'Book']">

<!--Count the number of Corporate Authors (can only be 0 or 1)-->

<xsl:variable name="cCorporateAuthors">

<xsl:value-of select="count(b:Author/b:Author/b:Corporate)" />

</xsl:variable>

<xsl:variable name="cAuthors">

<xsl:value-of select="count(b:Author/b:Author/b:NameList/b:Person)" />

</xsl:variable>

<!--Label the paragraph as an Office Bibliography paragraph -->

<p>

<xsl:choose>

<xsl:when test ="$cCorporateAuthors!=0">

<!-- when the corporate author exists display the corporate author-->

<xsl:value-of select="b:Author/b:Author/b:Corporate"/>

<xsl:text>, </xsl:text>

</xsl:when>

<xsl:otherwise>

<!-- when the corporate author does not exist, display the normal author-->

<xsl:choose>

<xsl:when test="cAuthors = 1">

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person/b:Last"/>

<xsl:text>, </xsl:text>

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person/b:First"/>

</xsl:when>

<xsl:when test="cAuthors = 2">

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:Last"/>

<xsl:text> , </xsl:text>

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:First"/>

<xsl:text>, </xsl:text>

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[2]/b:Last"/>

<xsl:text> , </xsl:text>

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[2]/b:First"/>

<xsl:text>, </xsl:text>

</xsl:when>

<xsl:when test="cAuthors &gt; 2">

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:Last"/>

<xsl:text>, </xsl:text

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person[1]/b:First"/>

<xsl:text>, </xsl:text>

<i>

<xsl:text> et al.</xsl:text>

</i>

</xsl:when>

<xsl:otherwise>

<xsl:text>Anonymous work.</xsl:text>

</xsl:otherwise>

</xsl:choose>

</xsl:choose>

<xsl:value-of select="b:Year"/>

<xsl:text>, </xsl:text>

<b>

<xsl:value-of select="b:Title"/>

<xsl:text>. </xsl:text>

</b>

<xsl:value-of select="b:Edition"/>

<xsl:text>, </xsl:text>

<xsl:value-of select="b:City"/>

<xsl:text>, </xsl:text>

<xsl:value-of select="b:Publisher"/>

<xsl:text>,</xsl:text>

</p>

</xsl:template>

<!-- Defines the output of the entire Bibliography -->

<xsl:template match="b:Bibliography">

<html xmlns="http://www.w3.org/TR/REC-html40">

<body>

<xsl:apply-templates select ="*">

</xsl:apply-templates>

</body>

</html>

</xsl:template>

<!-- Defines the output of the Citation -->

<xsl:template match="b:Citation/b:Source[b:SourceType = 'Book']">

<html xmlns="http://www.w3.org/TR/REC-html40">

<xsl:variable name="cCorporateAuthors">

<xsl:value-of select="count(b:Author/b:Author/b:Corporate)" />

</xsl:variable>

<body>    

<!-- Defines the output format as (Author, Year)-->

<xsl:text>(</xsl:text>

<xsl:choose>

<!-- when the corporate author exists display the corporate author-->

<xsl:when test ="$cCorporateAuthors!=0">

<xsl:value-of select="b:Author/b:Author/b:Corporate"/>

</xsl:when>

<!-- when the corporate author does not exist, display the normal author-->

<xsl:otherwise>

<xsl:value-of select="b:Author/b:Author/b:NameList/b:Person/b:Last"/>

</xsl:otherwise>

</xsl:choose>

<xsl:text>, </xsl:text>

<xsl:value-of select="b:Year"/>

<xsl:text>)</xsl:text>

</body>

</html>

</xsl:template>

<xsl:template match="text()" />

</xsl:stylesheet>

Thank you for help

Julio Cesar

Hi all,

Having better ideas...

I think that the short way to make this work for ABNT Brasil, is begin with a style, like chicago (just have et al.), and make the changes.

Simple changes... like order of fields and format.

Example: I need a biliography for Book like this:

Last Name Author[1], First Name Author[1], Title (Bold or Italic), Edition, City, Publisher, Year.

Could we work on this way?

Say you to me where fomat and order is? or set you it to us?

Thank you for help.

Julio Cesar Silva

Julio: try to contact me privately through the link under my name (yours was empty, so I can't reach you).

Also, if you are going to start editing one of the predefined styles, I suggest you use the ones coming with Word 2008 rather than Word 2007 as those contain comments about what some of the variables do and might be easier to manipulate.

Yves

Thanks for the informative answers Jonathan.

Regarding point 3.

While both <sup> and <span style="vertical-align:super;"> elements are formatted correctly as superscript in a bibliography, they are NOT in an in-text citation. (If you want an example style, I can provide one)

Testing has shown me that only simple formatting such as <i> or <span style="font-style:italic;"> is processed as expected for in-text citations.

Unlike bibliographies, it looks like it is not possible to use a predefined style definition for in-text citations either. They are just stripped away and the style used by the surrounding text is used instead.

Yves

Hi Jonathan,

thanks, this post was very helpfull and I started creating custom style used by my university.

However in my locale LCID=1063 (Lithuanian, LT) the value of b:Strings/b:PageShort and b:Strings/b:PagesCountinousShort should be "p." instead of "psl."

I made a workaround for it, but I would love to see it fixed. I was unable to find any usefull information how to file a bug.

BTW, this is official short version for pages. It is regulated by The State Commission of the Lithuanian Language: http://www.vlkk.lt/lit/nutarimai/rasyba/sutrumpinimai.html

From their website: "p. -- ponas, -ia, panelė; puslapis; punktas", where "puslapis" means page (same short version "p." is used for plural).

- Domas