Web Conversion Process (XML)

Please note: this is hypothetical as the required input and output mechanisms have not yet been built.

Step 1: Convert Word document to XML

Load oXygen.

Create a new DocBook V5 “article”.

tutorial1

tutorial2

Make sure you are in “author” view as shown below.

tutorial3

Make sure you have set up preferences to allow broken word xml. Go to options->Preferences.

tutorial4

Then search “schema aware” in the search box and click on the corresponding highlighted result. On the Schema Aware page tick the “custom” radio button and uncheck “Reject action when the result is invalid”, pressing “OK” to confirm.

tutorial5

Now, in the article view click just after “text” as shown in the following image. This is important and the editor is very picky about where content can be pasted in.

tutorial6

Copy and paste the entire Word document at that position. After a short wait you should see a “Validation Problem” prompt. Select the first choice “inside the closest ‘sect1’ element, to the right of the current position” and press “OK”.

tutorial7

You should see something like this, click on “text” at the bottom to proceed to the next step. If the document does not format properly remove any page breaks in the word file and try again. You can do this in word by search and replacing ^m with nothing.

tutorial8

Once in text view, delete the address tag, email tag, the highlighted subtitle and sample paragraph.

tutorial9

Switch to text view and change the title to that of the document.

Step through the red marks on the right, you can do this by clicking them, removing any xml errors (these will mainly be mismatched tags). Do tables, images, internal links etc. [TODO]

Step x: Upload XML to MOS

[TODO]

Next steps:

Download web publication archive from MOS

Send web publication archive to SG web team

Optional:

Download EPUB/MOBI e-book files from MOS

Follow process to publish on SG Publications Directory website