Skip to content

Commit aa83e77

Browse files
author
Steve Canny
committed
docs: document CT_PPr analysis
1 parent ced8bc1 commit aa83e77

2 files changed

Lines changed: 199 additions & 0 deletions

File tree

doc/developer/analysis/ct_ppr.rst

Lines changed: 198 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,198 @@
1+
##########
2+
``CT_PPr``
3+
##########
4+
5+
.. highlight:: xml
6+
7+
.. csv-table::
8+
:header-rows: 0
9+
:stub-columns: 1
10+
:widths: 15, 50
11+
12+
Schema Name , CT_PPr
13+
Spec Name , Paragraph Properties
14+
Tag(s) , w:pPr
15+
Namespace , wordprocessingml (wml.xsd)
16+
Spec Section , 17.3.1.26
17+
18+
19+
Analysis
20+
========
21+
22+
23+
24+
attributes
25+
^^^^^^^^^^
26+
27+
None.
28+
29+
30+
child elements
31+
^^^^^^^^^^^^^^
32+
33+
========= === ================
34+
name # type
35+
========= === ================
36+
xyz ? CT_abc
37+
abc ? CT_TextListStyle
38+
p ? CT_TextParagraph
39+
========= === ================
40+
41+
42+
Spec text
43+
^^^^^^^^^
44+
45+
This element specifies a set of paragraph properties which shall be applied
46+
to the contents of the parent paragraph after all style/numbering/table
47+
properties have been applied to the text. These properties are defined as
48+
direct formatting, since they are directly applied to the paragraph and
49+
supersede any formatting from styles.
50+
51+
Consider a paragraph which should have a set of paragraph formatting
52+
properties. This set of properties is specified in the paragraph properties
53+
as follows::
54+
55+
<w:p>
56+
<w:pPr>
57+
<w:pBdr>
58+
<w:bottom w:val="single" w:sz="8" w:space="4" w:color="4F81BD"/>
59+
</w:pBdr>
60+
<w:spacing w:after="300"/>
61+
<w:contextualSpacing/>
62+
</w:pPr>
63+
</w:p>
64+
65+
The pPr element specifies the properties which are applied to the current
66+
paragraph - in this case, a bottom paragraph border using the bottom
67+
element (§17.3.1.7), spacing after the paragraph using the spacing element
68+
(§17.3.1.33), and that spacing should be ignored for paragraphs above/below
69+
of the same style using the contextualSpacing element (§17.3.1.9).
70+
71+
72+
Schema excerpt
73+
^^^^^^^^^^^^^^
74+
75+
::
76+
77+
<xsd:complexType name="CT_PPr">
78+
<xsd:complexContent>
79+
<xsd:extension base="CT_PPrBase">
80+
<xsd:sequence>
81+
<xsd:element name="rPr" type="CT_ParaRPr" minOccurs="0"/>
82+
<xsd:element name="sectPr" type="CT_SectPr" minOccurs="0"/>
83+
<xsd:element name="pPrChange" type="CT_PPrChange" minOccurs="0"/>
84+
</xsd:sequence>
85+
</xsd:extension>
86+
</xsd:complexContent>
87+
</xsd:complexType>
88+
89+
<xsd:complexType name="CT_PPrBase">
90+
<xsd:sequence>
91+
<xsd:element name="pStyle" type="CT_String" minOccurs="0"/>
92+
<xsd:element name="keepNext" type="CT_OnOff" minOccurs="0"/>
93+
<xsd:element name="keepLines" type="CT_OnOff" minOccurs="0"/>
94+
<xsd:element name="pageBreakBefore" type="CT_OnOff" minOccurs="0"/>
95+
<xsd:element name="framePr" type="CT_FramePr" minOccurs="0"/>
96+
<xsd:element name="widowControl" type="CT_OnOff" minOccurs="0"/>
97+
<xsd:element name="numPr" type="CT_NumPr" minOccurs="0"/>
98+
<xsd:element name="suppressLineNumbers" type="CT_OnOff" minOccurs="0"/>
99+
<xsd:element name="pBdr" type="CT_PBdr" minOccurs="0"/>
100+
<xsd:element name="shd" type="CT_Shd" minOccurs="0"/>
101+
<xsd:element name="tabs" type="CT_Tabs" minOccurs="0"/>
102+
<xsd:element name="suppressAutoHyphens" type="CT_OnOff" minOccurs="0"/>
103+
<xsd:element name="kinsoku" type="CT_OnOff" minOccurs="0"/>
104+
<xsd:element name="wordWrap" type="CT_OnOff" minOccurs="0"/>
105+
<xsd:element name="overflowPunct" type="CT_OnOff" minOccurs="0"/>
106+
<xsd:element name="topLinePunct" type="CT_OnOff" minOccurs="0"/>
107+
<xsd:element name="autoSpaceDE" type="CT_OnOff" minOccurs="0"/>
108+
<xsd:element name="autoSpaceDN" type="CT_OnOff" minOccurs="0"/>
109+
<xsd:element name="bidi" type="CT_OnOff" minOccurs="0"/>
110+
<xsd:element name="adjustRightInd" type="CT_OnOff" minOccurs="0"/>
111+
<xsd:element name="snapToGrid" type="CT_OnOff" minOccurs="0"/>
112+
<xsd:element name="spacing" type="CT_Spacing" minOccurs="0"/>
113+
<xsd:element name="ind" type="CT_Ind" minOccurs="0"/>
114+
<xsd:element name="contextualSpacing" type="CT_OnOff" minOccurs="0"/>
115+
<xsd:element name="mirrorIndents" type="CT_OnOff" minOccurs="0"/>
116+
<xsd:element name="suppressOverlap" type="CT_OnOff" minOccurs="0"/>
117+
<xsd:element name="jc" type="CT_Jc" minOccurs="0"/>
118+
<xsd:element name="textDirection" type="CT_TextDirection" minOccurs="0"/>
119+
<xsd:element name="textAlignment" type="CT_TextAlignment" minOccurs="0"/>
120+
<xsd:element name="textboxTightWrap" type="CT_TextboxTightWrap" minOccurs="0"/>
121+
<xsd:element name="outlineLvl" type="CT_DecimalNumber" minOccurs="0"/>
122+
<xsd:element name="divId" type="CT_DecimalNumber" minOccurs="0"/>
123+
<xsd:element name="cnfStyle" type="CT_Cnf" minOccurs="0" maxOccurs="1"/>
124+
</xsd:sequence>
125+
</xsd:complexType>
126+
127+
<xsd:complexType name="CT_FramePr">
128+
<xsd:attribute name="dropCap" type="ST_DropCap" use="optional"/>
129+
<xsd:attribute name="lines" type="ST_DecimalNumber" use="optional"/>
130+
<xsd:attribute name="w" type="s:ST_TwipsMeasure" use="optional"/>
131+
<xsd:attribute name="h" type="s:ST_TwipsMeasure" use="optional"/>
132+
<xsd:attribute name="vSpace" type="s:ST_TwipsMeasure" use="optional"/>
133+
<xsd:attribute name="hSpace" type="s:ST_TwipsMeasure" use="optional"/>
134+
<xsd:attribute name="wrap" type="ST_Wrap" use="optional"/>
135+
<xsd:attribute name="hAnchor" type="ST_HAnchor" use="optional"/>
136+
<xsd:attribute name="vAnchor" type="ST_VAnchor" use="optional"/>
137+
<xsd:attribute name="x" type="ST_SignedTwipsMeasure" use="optional"/>
138+
<xsd:attribute name="xAlign" type="s:ST_XAlign" use="optional"/>
139+
<xsd:attribute name="y" type="ST_SignedTwipsMeasure" use="optional"/>
140+
<xsd:attribute name="yAlign" type="s:ST_YAlign" use="optional"/>
141+
<xsd:attribute name="hRule" type="ST_HeightRule" use="optional"/>
142+
<xsd:attribute name="anchorLock" type="s:ST_OnOff" use="optional"/>
143+
</xsd:complexType>
144+
145+
<xsd:complexType name="CT_Ind">
146+
<xsd:attribute name="start" type="ST_SignedTwipsMeasure" use="optional"/>
147+
<xsd:attribute name="startChars" type="ST_DecimalNumber" use="optional"/>
148+
<xsd:attribute name="end" type="ST_SignedTwipsMeasure" use="optional"/>
149+
<xsd:attribute name="endChars" type="ST_DecimalNumber" use="optional"/>
150+
<xsd:attribute name="left" type="ST_SignedTwipsMeasure" use="optional"/>
151+
<xsd:attribute name="leftChars" type="ST_DecimalNumber" use="optional"/>
152+
<xsd:attribute name="right" type="ST_SignedTwipsMeasure" use="optional"/>
153+
<xsd:attribute name="rightChars" type="ST_DecimalNumber" use="optional"/>
154+
<xsd:attribute name="hanging" type="s:ST_TwipsMeasure" use="optional"/>
155+
<xsd:attribute name="hangingChars" type="ST_DecimalNumber" use="optional"/>
156+
<xsd:attribute name="firstLine" type="s:ST_TwipsMeasure" use="optional"/>
157+
<xsd:attribute name="firstLineChars" type="ST_DecimalNumber" use="optional"/>
158+
</xsd:complexType>
159+
160+
<xsd:complexType name="CT_Jc">
161+
<xsd:attribute name="val" type="ST_Jc" use="required"/>
162+
</xsd:complexType>
163+
164+
<xsd:complexType name="CT_OnOff">
165+
<xsd:attribute name="val" type="s:ST_OnOff"/>
166+
</xsd:complexType>
167+
168+
<xsd:complexType name="CT_Spacing">
169+
<xsd:attribute name="before" type="s:ST_TwipsMeasure" use="optional"/>
170+
<xsd:attribute name="beforeLines" type="ST_DecimalNumber" use="optional"/>
171+
<xsd:attribute name="beforeAutospacing" type="s:ST_OnOff" use="optional"/>
172+
<xsd:attribute name="after" type="s:ST_TwipsMeasure" use="optional"/>
173+
<xsd:attribute name="afterLines" type="ST_DecimalNumber" use="optional"/>
174+
<xsd:attribute name="afterAutospacing" type="s:ST_OnOff" use="optional"/>
175+
<xsd:attribute name="line" type="ST_SignedTwipsMeasure" use="optional"/>
176+
<xsd:attribute name="lineRule" type="ST_LineSpacingRule" use="optional"/>
177+
</xsd:complexType>
178+
179+
<xsd:complexType name="CT_String">
180+
<xsd:attribute name="val" type="s:ST_String" use="required"/>
181+
</xsd:complexType>
182+
183+
<xsd:complexType name="CT_Tabs">
184+
<xsd:sequence>
185+
<xsd:element name="tab" type="CT_TabStop" minOccurs="1" maxOccurs="unbounded"/>
186+
</xsd:sequence>
187+
</xsd:complexType>
188+
189+
<xsd:simpleType name="ST_OnOff">
190+
<xsd:union memberTypes="xsd:boolean ST_OnOff1"/>
191+
</xsd:simpleType>
192+
193+
<xsd:simpleType name="ST_OnOff1">
194+
<xsd:restriction base="xsd:string">
195+
<xsd:enumeration value="on"/>
196+
<xsd:enumeration value="off"/>
197+
</xsd:restriction>
198+
</xsd:simpleType>

doc/developer/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,3 +10,4 @@ Developer Documentation
1010
analysis/ct_document
1111
analysis/ct_body
1212
analysis/ct_p
13+
analysis/ct_ppr

0 commit comments

Comments
 (0)