Skip to content

Commit

Permalink
Merge pull request oasis-tcs#895 from keberlein/review-t-edits
Browse files Browse the repository at this point in the history 
Review T edits
  • Loading branch information
@keberlein
keberlein authored Feb 14, 2023
2 parents 200da82 + f48daef commit 6471c04
Show file tree
Hide file tree
Showing 2 changed files with 74 additions and 50 deletions.
116 changes: 69 additions & 47 deletions specification/langRef/base/imagemap.dita
View file
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,14 @@
</section>
<example id="example" otherprops="examples">
<title>Example</title>
<p>The following code sample shows an image map for a detail of
Rembrandt's "The Night Watch":</p>
<codeblock><b>&lt;imagemap id="the-night-watch"></b>
<p rev="review-t">This section contains examples of how the
<xmlelement>imagemap</xmlelement> element can be used:</p>
<fig>
<title>Example: Image map that uses the circle, rectangle, and
polygon shapes</title>
<p>The following code sample shows an image map for a detail of
Rembrandt's "The Night Watch":</p>
<codeblock><b>&lt;imagemap id="the-night-watch"></b>
&lt;image href="Detail_from_The_Night_Watch.jpg" id="night_watch">
&lt;alt>Detail from Rembrandt's The Night Watch&lt;/alt>
&lt;/image>
Expand Down Expand Up @@ -75,50 +80,67 @@
Willem van Ruytenburch&lt;/xref>
&lt;/area><b>
&lt;/imagemap></b></codeblock>
<p>The following image shows the areas that are defined by the image
map. Each of the three supported shapes are used.</p>
<image placement="break" href="../../images/night-watch-areas.jpg"
scale="70">
<alt>A screen capture of the image map as rendered in Oxygen
Editor, showing the three defined areas</alt>
</image>
<p>The following table lists the defined areas, the shape used,
alternate text, and link targets:</p>
<simpletable frame="topbot" relcolwidth="1* 2* 5* 5*" keycol="1">
<sthead>
<stentry>Area</stentry>
<stentry>Shape</stentry>
<stentry>Alternate text</stentry>
<stentry>Link target</stentry>
</sthead>
<strow>
<stentry>1</stentry>
<stentry>Polygon</stentry>
<stentry>Frans Banninck Cocq</stentry>
<stentry><xref
href="https://en.wikipedia.org/wiki/Frans_Banninck_Cocq"
format="html" scope="external">Wikipedia entry for Frans
Banninck Cocq</xref></stentry>
</strow>
<strow>
<stentry>2</stentry>
<stentry>Circle</stentry>
<stentry>A member of the schutterij (the night
watch)</stentry>
<stentry><xref href="https://en.wikipedia.org/wiki/Schutterij"
format="html" scope="external">Wikipedia entry for
Schutterij</xref></stentry>
</strow>
<strow>
<stentry>3</stentry>
<stentry>Rectangle</stentry>
<stentry>Willem van Ruytenburch</stentry>
<stentry><xref
href="https://en.wikipedia.org/wiki/Willem_van_Ruytenburch"
format="html" scope="external">Wikipedia entry for Willem van
Ruytenburch</xref></stentry>
</strow>
</simpletable>
<p>The following image shows the areas that are defined by the
image map. Each of the three supported shapes are used.</p>
<image placement="break" href="../../images/night-watch-areas.jpg"
scale="70">
<alt>A screen capture of the image map as rendered in Oxygen
Editor, showing the three defined areas</alt>
</image>
<p>The following table lists the defined areas, the shape used,
alternate text, and link targets:</p>
<simpletable frame="topbot" relcolwidth="1* 2* 5* 5*" keycol="1">
<sthead>
<stentry>Area</stentry>
<stentry>Shape</stentry>
<stentry>Alternate text</stentry>
<stentry>Link target</stentry>
</sthead>
<strow>
<stentry>1</stentry>
<stentry>Polygon</stentry>
<stentry>Frans Banninck Cocq</stentry>
<stentry><xref
href="https://en.wikipedia.org/wiki/Frans_Banninck_Cocq"
format="html" scope="external">Wikipedia entry for Frans
Banninck Cocq</xref></stentry>
</strow>
<strow>
<stentry>2</stentry>
<stentry>Circle</stentry>
<stentry>A member of the schutterij (the night watch)</stentry>
<stentry><xref href="https://en.wikipedia.org/wiki/Schutterij"
format="html" scope="external">Wikipedia entry for
Schutterij</xref></stentry>
</strow>
<strow>
<stentry>3</stentry>
<stentry>Rectangle</stentry>
<stentry>Willem van Ruytenburch</stentry>
<stentry><xref
href="https://en.wikipedia.org/wiki/Willem_van_Ruytenburch"
format="html" scope="external">Wikipedia entry for Willem
van Ruytenburch</xref></stentry>
</strow>
</simpletable>
</fig>
<fig rev="review-t">
<title>Example: Image map with the default shape</title>
<p>The following code sample shows an image map that specifies that
the entire image is the linkable region. Because the default
shape is specified, the <xmlelement>coords</xmlelement> element
is empty.</p>
<codeblock><b>&lt;imagemap id="portrait"></b>
&lt;image keyref="bronte-sisters">
&lt;alt>Portrait of the Bronte sisters&lt;/alt>
&lt;/image>
&lt;area>
&lt;shape>default&lt;/shape>
&lt;coords/>
&lt;xref keyref="wiki-bronte-sisters"/>
&lt;/area><b>
&lt;/imagemap></b></codeblock>
</fig>
</example>
</refbody>
</reference>
8 changes: 5 additions & 3 deletions specification/langRef/base/sort-as.dita
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference xml:lang="en-us" id="sort-as" >
<title><xmlelement>sort-as</xmlelement></title>
<shortdesc>For elements that are sorted, the <xmlelement>sort-as</xmlelement> element provides
text that is combined with the base sort phrase to construct the effective sort
phrase.</shortdesc>
<shortdesc rev="review-t">The <xmlelement>sort-as</xmlelement> element
can be used to specify an effective sort phrase when the base sort
phrase is not appropriate for sorting, for example, Japanese
characters. This element prepends text to the base sort phrase in order
to construct an effective sort phrase.</shortdesc>
<prolog>
<metadata>
<keywords>
Expand Down

0 comments on commit 6471c04

Please sign in to comment.