Writing and publishing WordPress Blog posts in MS Word

I suppose the first question I have to ask, before getting to the ‘How,’ is the ‘Why’ question: Why write blog posts in Word in the first place?

Why Blog with Word in the first place?

Well, I can’t really recommend Word as a tool (e.g., in my book), if I’m not willing to use it. I am also practising what I preach, and this blog post you are reading now was written in Word 2013 (the first few blog posts on my site were done with the native WordPress tool).

And I must also admit that the native WordPress tool for creating posts is quite nice. And the WordPress team has really gone to a lot of effort to see to it that you can create typographically professional blog posts.

But there are some distinct advantages to using Word, especially if you write the kind of blog posts that I do. I know that there are probably good responses to each of these, but the fact is that they do act as motivators to me, and I believe will also for many (but not all) other users.

Firstly, I can format my text quickly in Word with Styles. Yes, WordPress also has styles, but it’s quicker and easier to create and use new styles in Word.

Secondly, I have much more keyboard shortcuts in Word, and all told, Word generally gets the job done quicker than WordPress (compare adding a hyperlink in the two, as an example). I don’t have time for doing things slowly.

Third, I can work on the blog post while offline in Word, which is not so easy to do with WordPress.

Fourth, and this is a biggie, adding pictures is a pain in WordPress. Each time the picture needs to be added to the gallery, and then inserted into the post. Yes, WordPress has structured it so that you can do this in one smooth operation, but it just takes far too long. With Word, it’s just a case of simply inserting the pictures where I want them. When I publish the post, all the pictures are uploaded to the gallery in one go.

Fifth, I can use automatic numbering features (such as automatically numbering my figures, using cross-references, etc.). If I rearrange things in my post, Word sorts out the numbering for me. That’s no small advantage!

Sixth, I can do more advanced kinds of spelling and grammar checking, etc.

Seventh, and this is another biggie, tables are a cinch in Word, and a pain in most other programs. Having “cut my teeth” on Word, I sort of took doing advanced tables for granted. Word really is great with tables, all my gripes about minor things aside. It wasn’t until I started looking into the printing of that book, and developing websites with basic tools like Google Sites and even FrontPage, that I began to appreciate how far ahead Word is with tables. Want a table like the one in this post? Word should be your tool of choice.

I suppose I could come up with even more, but I think this pretty much covers my main motives.

How to set up the WordPress Blog account in Word

The first thing to do is to set up the WordPress account to which you are blogging.

Microsoft gives some very short and cryptic advice here:

http://office.microsoft.com/en-us/word-help/help-with-blogging-in-word-HA010164021.aspx

WordPress’s basic guide is here:

http://codex.wordpress.org/Weblog_Client

The basic idea is that you have to tell Word where to find the xmlrpc.php on your site, but both of the above assume that your blog is on the front page of your site—admittedly, many sites are set up like that.

Apart from locating the file, you also have to prepare your site to receive the blog posts. If you have WordPress 3.5 or later, this is enabled by default, but for earlier versions, you need to enable the Remote Publishing setting in the Writing section of the site settings. So step 1 should be: Upgrade to the latest version of WordPress.

Step 2, then, is find the xmlrpc.php file. However, my blog was a bit atypical, in that I wanted a static front page, and my blog page is not the main page. This caused some problems, but that helps explain to you, dear reader, how to get yours set up. Also, if you use some file browsers, the file path given makes (to me) no sense. For example, Figure 1 shows the CPanel file browser. If I had to infer the file path from that, it would be /home/trueinsi/public_html/xmlrpc.php. But when I connect with my trusty Total Commander‘s FTP client, I see that it is actually public_html/insight/xmlrpc.php (Figure 2). This equates to http://trueinsight.za.com/insight/xmlrpc.php. The /insight/ part of the location is, of course, the subdomain.

Figure 1    CPanel file browser

Figure 2    FTP via Total Commander

Now I’m getting somewhere. After having found the location of the xmlrpc.php file, the first thing you want to do in Word is to actually open a blank blog post. This is the easiest way to access the blogging tools in Word. Yes, you can add the tools from the ribbon to a new ribbon of your choice in Word, or to the QAT, but since you want to write a blog post anyway, this is just a lot less effort. Note that this setup needs to be done only for the first post. Word then remembers all your settings, and they are available each time you start your next post.

So, click on New, Blog post (Figure 3). Word opens a new blog post, with a trimmed down set of ribbons (too trimmed down, if you ask me)—Figure 4.

Figure 3    Creating a new blog post in Word

Figure 4    Blog Post ribbons

To set up your accounts (I eventually want to maintain at least two regular blogs) click on Manage Accounts (Figure 5), which will open the Blog Accounts dialog (Figure 6).

Figure 5    Manage Accounts

Figure 6    Blog Accounts dialog

From there, click on New, and in the New Blog Account dialog, select WordPress as your Blog type (Figure 7).

Figure 7    New Blog Account dialog

This, in turn, opens the New WordPress Account dialog (Figure 8), where you have to enter the location of your xmlrpc.php file (as discussed above) and your user name and password.

Figure 8    New WordPress Account dialog

You can also set the Picture options (Figure 9).

Figure 9    Picture options

Figure 10 shows the dialog with all the settings completed.

Figure 10    Completed account settings

When you have added the details and clicked on OK, Word will warn you about the security of the post (Figure 11).

Figure 11    Sending information

So now you’re all set, and from now on, it should be as simple as just selecting your account and writing your blog entry.

Setting up individual blog posts

When the Blog template is opened, it displays a title with the account you want to use (Figure 12). If you have multiple accounts, you can select the right account from the dropdown that will appear when you click on the account line (Figure 13).

Figure 12    Blog title and account

Figure 13    Selecting a different blog account

It is also a useful idea to add categories to your posts. For example, I have set up my menu to include several categories, so that they serve as handy shortcuts to people wanting to read posts related to that category. So, for example, Figure 14 shows my category for Excel blog posts.

Figure 14    Example of a blog-post category in a site menu

Adding categories is easy—just select Insert Category from the Blog Post ribbon tab (Figure 15). The list of categories will be displayed underneath the account information (see Figure 13 above).

Figure 15    Adding categories

For the rest, simply write the blog post, as per normal. The dearth of tools caused by Word hiding normal editing ribbon tabs is a bit annoying, but is easily overcome by adding the tools you want either to the Blog Post ribbon or the QAT.

Publishing the blog post

Once the post is ready, you can publish it straight from Word (Figure 16). I generally recommend first publishing it as a draft, which is exactly the same as saving a blog post as a draft from the WordPress editor. The advantage to this approach is that it allows me to go to WordPress and satisfy my paranoid self that everything looks right before going public with the post (for example, with this post, I forgot to update my fields, so my figure numbering and cross-referencing was out—I could then go back to Word and correct it). If you’re braver, you can go straight to publishing from Word. It stands to reason that while you can write the post offline, you need to be online to publish the post.

Figure 16    Publishing a blog post

Editing existing blog posts

What I find really nice is the fact that you can also open existing posts in Word and edit them. Simply click on Open Existing (Figure 17), choose the post you want to edit from the Open Existing Post dialog (Figure 18), and you’re good to go.

Figure 17    Opening existing blog posts

Figure 18    Open Existing Post dialog

Conclusion

In short, while there are many Blog writing tools out there, I find that for the kind of work I tend to want to include in my Blog posts—captioned figures, tables, fast editing, etc., Word is a good tool of choice, albeit not the only one. After some simple setup, blogging with Word is clean and simple, the way it should be.

Share

Separate table (or figure) numbering for appendices

A question recently came up in the Word-PC e-mail list which is quite typical of something a student doing a thesis or dissertation might come across. I will also modify this post to that context. I was quick to give an answer, and only later thought through all the implications, so that my initial answer would have been less than satisfactory. Here is, what I believe, a more robust solution.

The requirement is as follows:

  1. A dissertation is using chapter-based numbering instead of sequential numbering for its tables (i.e., in Chapter 3, the tables would be 3-1, 3-2, etc.). Note of course, that the student can set the delimiter (here a hyphen) in the process of activating chapter based numbering (the dialog is shown below)—many students use a period.
  2. The dissertation also has appendices, which must be numbered with uppercase letters (Appendix A, Appendix B, etc.).
  3. Those appendices contain tables (or figures, or any other label created with the Insert Caption tool).
  4. Those tables need to be numbered in the chapter-based style, but now reflecting the Appendix number. Thus A-1, A-2, etc. for Appendix A, and so on.

Parts of these are very easy to do. It’s the combination that is a headache.

Requirement 1 is simple. Just use the Insert Caption tool to add the numbers, and set the table-based numbering. See p. 162–163 of Doing your dissertation with Microsoft Word if you have the book (if you don’t some screen caps below will help).

Requirement 2 is equally simple. I have created, in the two templates (Thesis 2010.dotx and Thesis up 2009.dotx) which can be downloaded from the examples page, a style called “Appendix Title” that uses normal upper case alphabetic numbering. This is what the style looks like, showing its definition:

Some pointers. When modifying the style, be sure to go to the paragraph dialog and set its outline level to Level 1. This will ensure that it should be included in your Table of Contents (mine is based on Heading 1, which gives the same end result). Using this style for your appendix headings gives them the desired numbering scheme, thus satisfying requirement 2.

Requirements 3 and 4 are dealt with together, as these are the more tricky ones.

Here are the problems:

When Word adds caption labels, and those caption labels use chapter-based numbering, Word actually adds two fields: One is a STYLEREF field which is set to automatically pull in the heading level 1. The second is a SEQ field, which is set to restart after each occurrence of heading level 1.

Furthermore, whenever you add a table anywhere in the dissertation, Word runs through all instances of the table, and resets all of them. If you thus make changes to the switches of these caption labels in the appendix, they can get nixed by adding any table anywhere else in the dissertation.

To get started, use the Insert Caption tool to insert the caption label for the first table in the first appendix. We will modify the fields it adds afterwards (or, if you are confident writing out fields by hand, you can just skip ahead).

Click on Insert Caption (Captions group, References ribbon). From the Caption dialog, choose Numbering… to open the Caption Numbering dialog, and include the chapter number, also choosing the delimiter (separator). No need to change the Chapter start with style setting here, since all that is allow are the nine built-in heading levels. We will modify this manually later:

Once the chapter-based numbering has been set, the Caption dialog should look more or less like this:

Clicking on OK let’s Word add the caption label, using two fields.

Let’s first look at those fields Word adds. This is what they look like before and after being selected and set to Show field codes (Shift + F9):

So. The field codes (the bits between the braces) and text Word adds, is:

Table { STYLEREF 1 \s }–{SEQ Table \* ARABIC \s 1}

We can’t just change the STYLEREF field from 1 (Word shorthand for the built-in style “Heading 1”) to “Appendix Title,” as Word will nix this each time it updates the caption labels when a table is added somewhere. We also cannot change the restart switch for the SEQ field to anything other than 1-9 (i.e., Word’s nine built-in heading styles).

So we need a slightly different approach.

The first thing is to keep Word from automatically changing these table captions. The second is to get it to restart with each new appendix. Both of these are accomplished by setting the first appendix table caption to:

Table { STYLEREF “Appendix Title” \s }–{SEQ AppendixTable \* ARABIC \r 1}

The change to the STYLEREF field will pull in the required appendix number (from my custom style–if you are using a different style, then you would have to include whatever that style name would be). But note that it is the change to the SEQ identifier (from Table to AppendixTable) that essentially creates a new sequence, and prevents Word from reverting the STYLEREF field from STYLEREF “Appendix Title” back to STYLEREF 1. The SEQ field switch \r 1 which has replaced the \s 1 switch tells Word to restart at 1 here. Note that the 1s in the two switches have vastly different meanings. The \s 1 means restart numbering if there is an instance of “Heading 1” style between me and the preceding similar caption. The 1 refers to Heading 1. The \r 1 means restart right here, using the number 1. Here the 1 refers to 1.

But still more needs to be done. For each subsequent table in each appendix, the caption must be:

Table { STYLEREF “Appendix Title” \s }–{SEQ AppendixTable \* ARABIC \n}

Here the \n switch just tells Word to continue the numbering sequence from the previous similar caption label.

So the first table caption of each appendix will be:

Table { STYLEREF “Appendix Title” \s }–{SEQ AppendixTable \* ARABIC \r 1}

And the table caption of all other tables in each appendix will be:

Table { STYLEREF “Appendix Title” \s }–{SEQ AppendixTable \* ARABIC \n}

Probably the best way to achieve this is to simply copy and paste the caption paragraph for each new table. Yes, it’s a little manual work, but it’s not that bad. If you’re work averse, you could always record a macro writing out the fields (remember to use Ctrl + F9 to add the field braces) and then run that macro each time. Remember to also set the paragraph style to Caption, thus ensuring consistent formatting for your chapter and appendix tables.

Unfortunately, the job is not quite done.

Because we changed the SEQ field from SEQ Table to SEQ AppendixTable, the tables in the appendices will not appear in the list of tables. So we need to fix that.

To get that done, insert (or re-insert) the list of tables.

From the Table of Figures dialog, select the Options button:

In the Table of Figures Options dialog, specify that the table of figures should be built from the Caption Style:

Once you click on OK, notice that back in the Table of Figures dialog, Word will have set the Caption label to (none). This won’t do, because that means that the table will include, tables, figures, and any other caption labels. Compare the Table of Figures dialog below to the one shown above:

Just reset this to Table, and click on OK:

The end result is a list of tables that includes both your chapter and appendix tables:

The great thing about this approach is that it is stable and it works. It will withstand the updating caused by adding new tables or deleting existing tables, updating all fields in the document, closing and re-opening the document, etc.

It does require a small amount of manual work, but I think it is well worth the effort.

Update (2014-03-11):
If you want to do this with multiple captions (e.g., Tables and Figures in your appendices), then a little more work is needed. Read about it here.

Share

Change revision author names

Announcing a new addition to the True Insight Word uTIlities

Change revision authors

It seems that people often encounter problems with the revision author name when using track changes to review a document.

The problem may stem from various circumstances:

  • They forget to set the user name before making their revisions
  • They work on a single document from multiple computers where the registered user name is not the same on the various computers
  • They have made their revisions, but wish to anonymise them before sending them to another person

Regardless of these various situations, the desired end result is the same–to change the author names of revisions once they have been made.

To fully understand the solution, we just need to understand something about reviewing in Word. Essentially, reviewing a document can entail two things: Commenting on the text (done through comments), and suggesting actual changes (either insertions or deletions) through revisions. Interestingly, if you look at the navigation buttons on the Review ribbon, then you will notice that there are buttons that take you from one comment to the next (or previous), and buttons that take you to the next (or previous) revision.

However, while the buttons for the comments do exactly that–take you only to comments, bypassing revisions; the buttons for revisions take you to both revisions and comments. Granted, you can choose to ignore comments (and some other options–even insertions and deletions) from the Show Markup options:

 

In short, while comments are part of the reviewing process, they are viewed differently in the Word object model.

When faced with this problem, the first thought, of course, is to do this manually. However, you will notice that this is not possible, for both comments and revisions.

The next thought is to do it via VBA (if that is an option–if not, see below).

For comments, this is entirely possible. The Comment Object has an Author property, which is read/write. Thus, code like this will change the author name of comments:

For i = 1 To .Comments.Count
  .Comments(i).Author = str_authorname
  .Comments(i).Initial = str_Initial
Next i

But for some odd reason which only the people at Microsoft will know (or sometimes I wonder if even they will know the reason for decisions like this), the Revision Object also has an Author property, but it is read only. Thus, a snippet of code like this, which Word’s VBA IntelliSense will happily allow one to write, will result in an error:

For i = 1 To .Revisions.Count
  .Revisions(i).Author = str_authorname
Next i

This is a problem, since often, being able to change the comment author but not the revision author will not be a satisfactory solution.

What to do?

Well, there are other ways to approach the problem. firstly, if the aim of the exercise relates to my third bullet above (but not the first two), then the document comments and revisions can be anonymised using the Document Inspector:

Note that you want to use the Remove Document Properties and Personal Information button, not the Remove Comments, Revisions, Versions, and Annotations button–you want the revisions and comments to remain, but not be attributed to any author. This approach can be seen in Office help articles like this one: http://office.microsoft.com/en-us/word-help/change-the-author-name-for-review-comments-HA010036415.aspx

 Ok. what about the first two problems I mentioned above? This sort of change can also be made manually, as described by Andrew Savikas and Andy Bruno in Andrew Savikas’ book Word Hacks: Tips & Tools for Taming Your Text. The basic technique is described here: http://oreilly.com/catalog/wordhks/chapter/hack41.pdf, but even this process can seem daunting to less advanced users.

After all that, it does seem as if this new tool in the uTIlities set is a bit moot, but at the end of the day, it has firstly been requested by some users, and secondly, presents what I believe Microsoft should have allowed for these functions. It is simple and effective, and requires you the user, not to have to use VBA or a relatively complex hack to get the job done.

The use of the tool is simple. Once the document is open, select the tool from the uTIlities ribbon, decide how to manage the document (make a backup and do the changes in the original, or do the changes in a renamed copy of the original):

And then choose the author names to replace (any number of names can be replaced with a single new name), add the new author name, and decide whether to change the comments too (and if so, what Initials to use):

If all goes well, clicking OK will do the job. Simple enough.

To date, I know of no other tool that automates this process, and yes, I did get it right to make the change using VBA (naturally!), but of course, I had to take the long way around to get past that read only property. I’ll leave you to speculate about the details!  🙂

So, if you want to give it a spin, go visit the Word uTIlities page and download it today!

Share