Eric White's Blog

Bob McClellan and I will be hosting a live web-cast on Sept 7 at 8:00 AM PST.  We’ll be demoing some new functionality in DocumentBuilder 2.0, discussing the future of PowerTools for Open XML and DocumentBuilder, and taking questions and comments about it.  We’d love to hear your feedback, as well as ideas for enhancements. And if we run out of stuff to talk about with DocumentBuilder, any Open XML topic or question is fair game.

So if, like me, you can’t think of anything more fun than getting online with some other geeks, and discussing interrelated markup, document composability, and the intricacies of Open XML WordprocessingML, please join us!

You can find all the details in this blog post at OpenXMLDeveloper.org.

Whew!  I finished the fourth and final screen-cast.  In this screen-cast, I show how to use Word Automation Services to repaginate a document and update the table-of-contents.

You can download the code that I present in this video from OpenXMLDeveloper.org.

Here is the complete list of screen-casts in this series.

I’ve been posting some new content over at OpenXMLDeveloper.org, and somehow didn’t manage to post the info here.

I’ve posted the third (out of four) screen-casts around inserting / updating tables-of-contents.

Exploring Tables-of-Contents in Open XML WordprocessingML Documents (Part 3)

My goal is to get the fourth posted before the end of the week.

Update: Here is the complete list of screen-casts in this series.

The following screen-cast was in response to a specific query in the forums on OpenXMLDeveloper.org.  Even if you don’t care about speaker notes in an Open XML PresentationML document, you might be interested in watching this.  It shows my approach to researching Open XML markup.

Screen-cast: Remove Speaker Notes from an Open XML Presentation

The following screen-cast re-affirmed the truism: it takes more time to make a shorter screen-cast.  The following is 6:40 long.

New Screen-Cast: Short and Sweet Intro to DocumentBuilder 2.0

I’ve had a few questions lately about how the Microsoft Public License works.

The text of the Ms-PL: http://www.microsoft.com/opensource/licenses.mspx

You can find a page on Microsoft.com that explains the Ms-PL in straightforward terms: http://www.microsoft.com/resources/sharedsource/communitysourcelicensing.mspx

Here is a StackOverflow.com question/answer page regarding the Ms-PL: http://stackoverflow.com/questions/1424307/how-does-ms-pl-license-work

I’ve just published the second screen-cast in this series on updating the TOC of a WordprocessingML document.  In the first screen-cast, I explored the markup around TOCs.  In this second screen-cast, I discuss the markup a bit more, and then introduce some code that makes it easy to add a TOC to a document.  This code will become part of the PowerTools for Open XML project.

As part of the definition of each TOC, you specify a set of switches that Word uses as instructions on how to construct the TOC.  This screen-cast discusses the TOC switches, and shows how to find out more about them from the text of the Open XML standard.

You can find the code that I discuss in this video on OpenXMLDeveloper.org.

Now, back to editing the third screen-cast in this series.  Looks as though there are going to be four.

Here is the complete list of screen-casts in this series.

-Eric

One issue that has been sorely lacking in content is that of adding / updating TOCs in WordprocessingML documents.  I’m starting a series of screen-casts around this issue, and I’ve just posted the first in the series.  The first video walks through the markup for a table of contents.  It explains how the TOC can (but is not required to) be in a content control, and why you would want to put it in a content control.  It discusses how fields in WordprocessingML are used to represent a TOC.  The video dissects field markup, and explains how fields can be nested (and always are nested in the case of a TOC).

In the video, I reference three links.  Here are those links:

Open XML Package Editor Power Tool for Visual Studio 2010

Open XML Markup Simplifier Application

Deep dive into fields in WordprocessingML

The next video will be an introduction into some code that I’ve written for PowerTools for Open XML, which enables you to more easily insert a TOC into a document.

Update: Here is the complete list of screen-casts in this series.

Recently I wrote some code that implemented search-and-replace for Open XML WordprocessingML documents.  I wrote that code for an Open XML developer who needed to implement that functionality using XML DOM, although with a different language than C#.  Because XML DOM is standardized, translating the code to another language and another implementation of XML DOM is relatively straightforward.

I want to introduce search-and-replace functionality in a CMDLET in PowerTools for Open XML, but I have been moving PowerTools code away from XmlDocument, so I rewrote the search-and-replace code using LINQ to XML, using a functional transform.  It was an interesting and fun project.  The video below introduces the TextReplacer class, and compares it to the code that I presented that uses XmlDocument.  It is an interesting comparison of imperative code (using XmlDocument) and functional code (using LINQ to XML).

You can download the TextReplacer class from this blog post (in an attachment at the bottom).

DocumentBuilder 2.0 is a much-improved version of the DocumentBuilder class that is part of PowerTools for Open XML. Using DocumentBuilder, you can split Open XML WordprocessingML documents apart, and merge and combine them in a variety of ways. DocumentBuilder deals with the many issues associated with interrelated markup in Open XML WordprocessingML.

This third screen-cast in this 3 part series explains how DocumentBuilder is data-driven so that it is more robust.

You can find a complete list of DocumentBuilder 2.0 content as well as links to download it in the DocumentBuilder Wiki Page on OpenXMLDeveloper.org.

Before watching this screen-cast, be sure to watch the first in the series and the second in the series.

DocumentBuilder 2.0 is a much-improved version of the DocumentBuilder class that is part of PowerTools for Open XML.  Using DocumentBuilder, you can split Open XML WordprocessingML documents apart, and merge and combine them in a variety of ways.  DocumentBuilder deals with the many issues associated with interrelated markup in Open XML WordprocessingML.

You can find a complete list of DocumentBuilder 2.0 content as well as links to download it in the DocumentBuilder Wiki Page on OpenXMLDeveloper.org.

Before watching this screen-cast, be sure to watch the first in the series.

On June 20, 2011 (two days ago), I posted an update to DocumentBuilder. After more extensive testing, I found and fixed a few bugs in less common scenarios, including if comments in multiple sources contain images, multiple sources contain endnotes with images, and a few other situations. If you have downloaded DocumentBuilder 2.0, please re-download it.