Skip to content

Adding section describing marking of capital letters attribute. #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kalaspuffar wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Adding section describing marking of capital letters attribute. #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ccb821f
Adding section describing marking of capital letters attribute.
kalaspuffar Oct 2, 2020
b2d996f
Changes after code review.
kalaspuffar Oct 5, 2020
3746c47
Update schema.
kalaspuffar Oct 5, 2020
5d5ef85
No whitespace changes
kalaspuffar Oct 5, 2020
a855571
Moved duplicated variables to textModificationAtts
kalaspuffar Oct 6, 2020
2fa93be
More true?
kalaspuffar Oct 6, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions src/obfl-specification.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2759,6 +2759,20 @@ <h4 id="L21851">Example</h4>
</tbody>
</table>

<h3 id="L2762">mark-capital-letters</h3>

<p>The value of the <code>mark-capital-letters</code> attribute can either be 'true' or 'false'.
The value 'true' indicates that the braille translator should add capital markings to the
text contents. The value 'false' indicates the braille translator should
<strong>NOT</strong> add capital markings text contents.</p>
Copy link
Copy Markdown

@PaulRambags PaulRambags Oct 5, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the default?

Copy link
Copy Markdown

@bertfrees bertfrees Oct 5, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The default is that there is no value, meaning the document does not override the overall policy. In other words, whether or not capitals are indicated is determined by the user's
preference and/or the braille system in use. For example, for German it defaults to "false". For Dutch to "true".

Copy link
Copy Markdown

@bertfrees bertfrees Oct 5, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(This is what the paragraph above that you didn't understand tries to explain.)


<p>The overall policy for marking capital letters should be determined by the
implementing application or language policy, for example per job or in a system setting.</p>

<p>This attribute will override that policy, using the <code>mark-capital-letters</code>
attribute on an element tells the braille translator that this element and child elements
should have another policy for marking capital letters.</p>

<h3 id="pagenumbercounter">page-number-counter</h3>

<p>Specifies a name for a page number counter to use.</p>
Expand Down
45 changes: 19 additions & 26 deletions src/validation/obfl.rng
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,19 @@
<attribute name="row-spacing"/>
</optional>
</define>
<!-- hyphenate, true to hyphenate, false otherwise -->
<define name="textAtts">

<define name="textModificationAtts">
<optional>
<attribute name="xml:lang">
<data type="NMTOKEN"/>
<attribute name="hyphenate">
<choice>
<value>true</value>
<value>false</value>
<value></value>
</choice>
</attribute>
</optional>
<optional>
<attribute name="hyphenate">
<attribute name="mark-capital-letters">
<choice>
<value>true</value>
<value>false</value>
Expand All @@ -51,6 +55,15 @@
</attribute>
</optional>
</define>

<define name="textAtts">
<optional>
<attribute name="xml:lang">
<data type="NMTOKEN"/>
</attribute>
</optional>
<ref name="textModificationAtts" />
</define>
<define name="name-id">
<attribute name="name">
<data type="ID"/>
Expand Down Expand Up @@ -540,27 +553,7 @@
<attribute name="xml:lang">
<data type="NMTOKEN"/>
</attribute>
<optional>
<attribute name="hyphenate">
<choice>
<value>true</value>
<value>false</value>
<value></value>
</choice>
</attribute>
</optional>
<optional>
<attribute name="translate">
<choice>
<value></value>
<value>pre-translated</value>
<value>grade0</value>
<value>grade1</value>
<value>grade2</value>
<value>grade3</value>
</choice>
</attribute>
</optional>
<ref name="textModificationAtts" />
</define>
<!---->
<define name="meta">
Expand Down