6. Troubleshooting

6.1. Is it possible to use the standard styles names of MS-Word —"Normal", "Heading 1", "Heading 2", "Strong", "Emphasis", etc— in my .xfc style definition file?
6.2. When I attempt to modify the generated paragraph style in MS-Word or OpenOffice/Libre, the space after the paragraph is always set to 0pt.
6.3. I use a set of numbered paragraph styles (i.e. <paragraph-style numbering="XXX"/>) to create several lists. However all the list items are continuously numbered across the generated DOCX file as if it were a single, giant list. How to use a set of numbered paragraph styles to create several, distinct lists in the DOCX file?

6.1.

Is it possible to use the standard styles names of MS-Word —"Normal", "Heading 1", "Heading 2", "Strong", "Emphasis", etc— in my .xfc style definition file?

Yes, however it's recommended to avoid the name "Normal" for a paragraph-style as this has strange side-effects in MS-Word.

Note that using "Normal" as the name of a text-style works fine, except that MS-Word automatically renames this text style to "Normal1".

6.2.

When I attempt to modify the generated paragraph style in MS-Word or OpenOffice/Libre, the space after the paragraph is always set to 0pt.

More precisely, I've defined paragraph-style "Foo" as follows:

<paragraph-style name="Foo"
                 space-before="10pt" space-after="20pt" />

and the fo:block referencing paragraph-style "Foo" has no attribute space-after or margin-bottom directly set on it.

The generated word processor file looks as expected. However, when I used the style editor of MS-Word or OpenOffice/Libre Office to modify the "Foo" paragraph style, I've found that, while the space before the paragraph was indeed set to 10pt, the space after the paragraph was set to 0pt. Please fix this bug.

This is not a bug. This is a limitation which, due to the internal design of XFC, cannot be removed.

<paragraph-style name="Foo"
                 space-before="10pt" space-after="20pt" />
...
<fo:block xfc:user-style="Foo">...</fo:block>

is processed by XFC as if it was:

<paragraph-style name="Foo"
                 space-before="10pt" space-after="0pt" />
...
<fo:block xfc:user-style="Foo"
          space-after="20pt">...</fo:block>

6.3.

I use a set of numbered paragraph styles (i.e. <paragraph-style numbering="XXX"/>) to create several lists. However all the list items are continuously numbered across the generated DOCX file as if it were a single, giant list. How to use a set of numbered paragraph styles to create several, distinct lists in the DOCX file?

See Section 3.6, “The xfc:restart-numbering extension attribute”.