From: Bob Stayton Date: Mon, 8 Nov 2004 07:51:39 +0000 (+0000) Subject: Including Steve'e suggestions. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4e1c67494018492dce89d93529502bdcdd5235b5;p=docbook-dsssl Including Steve'e suggestions. --- diff --git a/xsl/wordml/specifications.xml b/xsl/wordml/specifications.xml index d9a90ba29..c787b9197 100755 --- a/xsl/wordml/specifications.xml +++ b/xsl/wordml/specifications.xml @@ -4,7 +4,7 @@ DocBook-WordML Conversion Specifications BobStaytonSagehill Enterprises -SteveBallZveno +SteveBallZveno Draft Version 1.0, dated 5 November, 2004 @@ -53,21 +53,21 @@ dated 5 November, 2004 One problem facing this conversion project is the sheer number of DocBook elements, over 400 in DocBook 4.3. To support DocBook structural models, several of the elements will require more than one Word style. This could lead to a very long and unwieldy list of styles in the Word interface. That would make authoring less efficient and discourage users. So this project assumes that authors who need the full set of DocBook elements will use an XML authoring tool that better supports them. This project will enable authors to write basic DocBook documents using Word. Because Word is so widespread, this project will help a lot of new DocBook users get started with familiar tools. They can then graduate to more advanced tools as their needs develop. - -
- Project Non-Goals - The following goals do not for part of the scope of the project: - - - Support of versions of Word that do not feature reading/writing WordML (XML). That is, all versions prior to Word 11 (Office 2003). - - - Supporting user-defined style names. However, this system should not prevent, or make difficult, adding such support via a customisation layer. - - - Support of arbitrarily defined styles. This system may expect certain styles to be defined in a particular fashion (in particular, those defining the title of components and divisions). - - +
+
+Project Non-Goals +The following goals are not in the scope of this project: + + +Support of versions of Word that do not feature reading/writing WordML (XML). That is, all versions prior to Word 11 (Office 2003). + + +Supporting user-defined style names. However, this system should not prevent, or make difficult, adding such support via a customisation layer. + + +Support of arbitrarily defined styles. This system may expect certain styles to be defined in a particular fashion (in particular, those defining the title of components and divisions). + +
Mapping elements to styles @@ -87,7 +87,7 @@ dated 5 November, 2004 Some style names will indicate a parent-child relationship. For example, chapter-title indicates that the paragraph is a title whose DocBook parent is a chapter. -Some style names are simplified to make them easier to use in Word. For example, a paragraph in an orderedlist requires three elements in DocBook: orderedlist, listitem, and para. The paragraph style name in Word is shortened from orderedlist-listitem-para to just orderedlist. NB. in the case of lists (see below), the list level is appended so this example becomes orderedlist1 +Some style names are simplified to make them easier to use in Word. For example, a paragraph in an orderedlist requires three elements in DocBook: orderedlist, listitem, and para. The paragraph style name in Word is shortened from orderedlist-listitem-para to just orderedlist. In the case of lists (see below), the list level is appended so this example becomes orderedlist1 Style names with a number suffix indicate a nesting level, as described above. @@ -95,8 +95,8 @@ dated 5 November, 2004 Style names with continue indicate that the paragraph is part of the preceding element. For example, a para paragraph is used for a single paragraph para element. This would cause any preceding list to be closed. If a list item in the preceding list is to contain more than one paragraph, then the subsequent paragraphs in Word would get a para-continue style. - - Empty paragraph and character styles are ignored. + +Empty paragraph and character styles are ignored. The first paragraph style in the Word document is used to define the root element of the DocBook document. For example, if a Word document starts with book-title, then the DocBook document will have book as its root element. All the rest of the document content will be contained in that root element. @@ -226,7 +226,7 @@ colwidth="1.00*"/> itemizedlist/listitem/para -itemizedlist +itemizedlist1 itemizedlist1 itemizedlist2 itemizedlist3 @@ -235,7 +235,7 @@ itemizedlist4 orderedlist/listitem/para -orderedlist +orderedlist1 orderedlist1 orderedlist2 orderedlist3 @@ -244,16 +244,16 @@ orderedlist4 variablelist/varlistentry/term -variablelist-term -variablelist-term1 -variablelist-term2 -variablelist-term3 -variablelist-term4 +variablelist1-term +variablelist2-term +variablelist3-term +variablelist4-term +variablelist5-term A variablelist in Word should be a sequence of alternating paragraphs styled as variablelist-term and variablelist. variablelist/varlistentry/listitem/para -variablelist +variablelist1 variablelist1 variablelist2 variablelist3