@@ -1086,7 +1086,7 @@ xrefstyle="%c"/>.</para>
1086
1086
1087
1087
<informaltable frame =" all" >
1088
1088
<tgroup cols =" 3" rowsep =" 1" colsep =" 1" >
1089
- <colspec colname =" c1" colwidth =" 2 *" rowsep =" 1" />
1089
+ <colspec colname =" c1" colwidth =" 1 *" rowsep =" 1" />
1090
1090
<colspec colname =" c2" colwidth =" 1*" rowsep =" 1" />
1091
1091
<colspec colname =" c3" colwidth =" 2*" rowsep =" 1" />
1092
1092
@@ -1122,10 +1122,7 @@ xrefstyle="%c"/>.</para>
1122
1122
<row >
1123
1123
<entry ><code >%p</code ></entry >
1124
1124
<entry ><phrase outputformat =" print" ><xref linkend =" syntax-highlighting" xrefstyle =" %p" /></phrase ></entry >
1125
- <entry >Page number. Intended for print output (PDF). Displayed as <emphasis >"#"</emphasis > in HTML,
1126
- unless you differentiate between the output formats for print and online. See <xref
1127
- linkend =" using-pagenumber-in-crossreferences" xrefstyle =" %label" /> for a possible
1128
- solution.</entry >
1125
+ <entry >Page number in print output (PDF). Not displayed in HTML.</entry >
1129
1126
</row >
1130
1127
<row >
1131
1128
<entry ><code >%label (%c)</code ></entry >
@@ -1149,7 +1146,7 @@ xrefstyle="%c"/>.</para>
1149
1146
1150
1147
<informaltable frame =" all" >
1151
1148
<tgroup cols =" 3" colsep =" 1" rowsep =" 1" >
1152
- <colspec colname =" c1" colwidth =" 2 *" rowsep =" 1" />
1149
+ <colspec colname =" c1" colwidth =" 1 *" rowsep =" 1" />
1153
1150
<colspec colname =" c2" colwidth =" 1*" rowsep =" 1" />
1154
1151
<colspec colname =" c3" colwidth =" 2*" rowsep =" 1" />
1155
1152
@@ -1177,36 +1174,6 @@ xrefstyle="%c"/>.</para>
1177
1174
</tbody >
1178
1175
</tgroup >
1179
1176
</informaltable >
1180
-
1181
- <section xml : id =" using-pagenumber-in-crossreferences" >
1182
- <title >Using pagenumber in cross-references</title >
1183
- <para >The <code >%p</code > makes little sense in HTML output, since there are no page numbers.
1184
- If you use it anyway, it will be displayed as <emphasis >"#"</emphasis >, which can be
1185
- confusing for readers. A possible solution for this problem is the use of the
1186
- <code >outputformat</code > attribute, that was intoduced in <xref linkend =" profiling" /> and
1187
- <xref linkend =" table.effectivity-attributes" xrefstyle =" %label" /><phrase
1188
- outputformat =" print" > on page <xref linkend =" table.effectivity-attributes" xrefstyle =" %p"
1189
- /></phrase >.</para >
1190
-
1191
- <para ><emphasis >This</emphasis > cross reference to <xref linkend =" syntax-highlighting"
1192
- xrefstyle =" %label" />
1193
- <phrase outputformat =" print" > on <xref linkend =" syntax-highlighting" xrefstyle =" page %p"
1194
- /></phrase > will include the target`s page number only when the
1195
- <code >@profile.outputformat</code > parameter is <emphasis >"print"</emphasis >, but without
1196
- the annoying <emphasis >#</emphasis > in HTML.</para >
1197
-
1198
- <example >
1199
- <title >Use outputformat to deal with page numbers in cross references</title >
1200
- <programlisting >This cross reference to
1201
- < xref linkend=" syntax-highlighting" xrefstyle="%label/>
1202
- < phrase outputformat=" print">
1203
- on < xref linkend=" syntax-highlighting" xrefstyle=" page %p" />
1204
- < /phrase>
1205
- will reference the page number only when the
1206
- @profile.outputformat parameter is print, but
1207
- without the annoying # in HTML.</programlisting >
1208
- </example >
1209
- </section >
1210
1177
</section >
1211
1178
1212
1179
<section xml : id =" syntax-highlighting" >
0 commit comments