Skip to content

Commit

Permalink
updated snapshots
Browse files Browse the repository at this point in the history
  • Loading branch information
@mattgarrish
mattgarrish committed Oct 17, 2024
1 parent e96cb6a commit bdd5bc4
Show file tree
Hide file tree
Showing 8 changed files with 126 additions and 134 deletions.
97 changes: 48 additions & 49 deletions published/1.0/WD-ebraille=20241017/index.html
View file

Large diffs are not rendered by default.

97 changes: 48 additions & 49 deletions published/1.0/index.html
View file

Large diffs are not rendered by default.

31 changes: 15 additions & 16 deletions published/best-practices/styling/FPNOTE-ebraille-style-20241017/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,6 @@



<link rel="stylesheet" href="../../common/css/common.css">

<style type="text/css">

Expand Down Expand Up @@ -271,7 +270,7 @@
],
"localBiblio": {
"ebraille": {
"href": "https://daisy.github.io/ebraille/",
"href": "https://daisy.org/s/ebraille/",
"title": "eBraille 1.0",
"publisher": "DAISY Consortium",
"authors": [
Expand All @@ -281,7 +280,7 @@
"id": "ebraille"
},
"tagging": {
"href": "https://daisy.github.io/ebraille/best-practices/tagging/",
"href": "https://daisy.org/s/ebraille/best-practices/tagging/",
"title": "eBraille Tagging Best Practices",
"authors": [
"Willow Free"
Expand Down Expand Up @@ -386,7 +385,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
</div>

<section id="abstract" class="introductory"><h2>Abstract</h2>
<p>This document defines CSS styling conventions for the <a href="/">eBraille</a> format.</p>
<p>This document defines CSS styling conventions for the <a href="https://daisy.org/s/ebraille/">eBraille</a> format.</p>
</section>
<section id="sotd" class="introductory"><h2>Status of This Document</h2>

Expand Down Expand Up @@ -421,9 +420,9 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>


<p>The eBraille format incorporates CSS to provide its styling and layout
capabilities. <a href="https://daisy.github.io/ebraille/#html-css">Cascading Style Sheets (CSS)</a> defines
capabilities. <a href="https://daisy.org/s/ebraille/#html-css">Cascading Style Sheets (CSS)</a> defines
the requirements and restrictions regarding the use of CSS within eBraille. Basically,
with a few exceptions, <a href="https://daisy.github.io/ebraille/#dfn-ebraille-creator">eBraille creators</a>
with a few exceptions, <a href="https://daisy.org/s/ebraille/#dfn-ebraille-creator">eBraille creators</a>
have the whole spectrum of CSS features at their disposal. Yet, limitations exist in the
braille that reading devices can output. In order to ensure a successful and consistent
rendering on many devices, some guidelines are called for. This is what this document aims
Expand All @@ -440,7 +439,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>

<div class="note" role="note" id="issue-container-generatedID"><div role="heading" class="note-title marker" id="h-note" aria-level="3"><span>Note</span></div><div class="">
<p>The examples in this section assume
that <a href="https://daisy.github.io/ebraille/#dfn-reading-system">eBraille reading systems</a> do not
that <a href="https://daisy.org/s/ebraille/#dfn-reading-system">eBraille reading systems</a> do not
use the same default style sheets that web browsers do. To try these examples in a
browser, make sure the following style sheet is applied and the same monospaced font
and font size is used for all text:</p>
Expand All @@ -460,7 +459,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
<section id="media-queries"><div class="header-wrapper"><h3 id="x2-1-media-queries"><bdi class="secno">2.1 </bdi>Media queries</h3><a class="self-link" href="#media-queries" aria-label="Permalink for Section 2.1"></a></div>


<p>Through <a href="https://daisy.github.io/ebraille/#media-queries">media queries</a>, styles may be
<p>Through <a href="https://daisy.org/s/ebraille/#media-queries">media queries</a>, styles may be
applied conditionally depending on the type and characteristics of the
device. For instance:</p>

Expand Down Expand Up @@ -567,7 +566,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
<a class="self-link" href="#example-two-left-aligned-paragraphs-with-a-blank-in-between">Example<bdi> 3</bdi></a><span class="example-title">: Two left-aligned paragraphs with a blank in between</span>
</div>
<p>
Two <a href="https://daisy.github.io/ebraille/best-practices/tagging/#example-a-left-aligned-paragraph-that-is-flush-with-the-left-margin">“left-aligned” paragraphs</a> [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>] are separated from each other using
Two <a href="https://daisy.org/s/ebraille/best-practices/tagging/#example-a-left-aligned-paragraph-that-is-flush-with-the-left-margin">“left-aligned” paragraphs</a> [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>] are separated from each other using
a blank line.
</p>
<pre><code class="html hljs" aria-busy="false"><span class="hljs-tag">&lt;<span class="hljs-name">p</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"left-aligned"</span>&gt;</span>⠠⠥⠏⠕⠝ ⠓⠑⠁⠗⠊⠝⠛ ⠞⠓⠊⠎ ⠓⠑ ⠁⠏⠏⠑⠁⠗⠑⠙
Expand Down Expand Up @@ -1128,7 +1127,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>

<p>Sometimes it is necessary to break long words across rows, to save space, or
simply because a word is too long to fit within one row. The section
on <a href="https://daisy.github.io/ebraille/best-practices/tagging/#Text%20splitting">Text Splitting</a> in [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>]
on <a href="https://daisy.org/s/ebraille/best-practices/tagging/#Text%20splitting">Text Splitting</a> in [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>]
explains how this can be achieved using the Unicode character U+00AD (SOFT
HYPHEN) and the
[<cite><a class="bibref" data-link-type="biblio" href="#bib-html" title="HTML Standard">html</a></cite>] <a href="https://html.spec.whatwg.org/multipage/#the-wbr-element"><code>wbr</code></a> element.</p>
Expand Down Expand Up @@ -1169,7 +1168,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
</div>
<p>BANA stipulates that centered headings should be balanced and divided at a logical
location when longer than one line (rule 4.4.3). The
“<a href="https://daisy.github.io/ebraille/best-practices/tagging/#example-multiline-heading-that-does-not-consist-of-multiple-parts">Multiline heading that does not consist of multiple parts</a>” example in [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>]
“<a href="https://daisy.org/s/ebraille/best-practices/tagging/#example-multiline-heading-that-does-not-consist-of-multiple-parts">Multiline heading that does not consist of multiple parts</a>” example in [<cite><a class="bibref" data-link-type="biblio" href="#bib-tagging" title="eBraille Tagging Best Practices">tagging</a></cite>]
explains how to use <code>br</code> elements to manually divide the heading into
lines. However the balancing can also be achieved automatically using <a href="https://www.w3.org/TR/css-text-4/#text-wrap-style"><code>text-wrap: balance</code></a> [<cite><a class="bibref" data-link-type="biblio" href="#bib-css-text" title="CSS Text Module Level 4">css-text-4</a></cite>],
as this example shows.</p>
Expand Down Expand Up @@ -1548,7 +1547,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
properties may be used to draw lines with a certain thickness and
pattern. For screen/print CSS, this is the most common method. However, for
braille, ultimately it is
the <a href="https://daisy.github.io/ebraille/#dfn-reading-system">eBraille reading system</a>
the <a href="https://daisy.org/s/ebraille/#dfn-reading-system">eBraille reading system</a>
that approximates the lines with a series of raised braille dots. More
control over the exact braille dot patterns used to make up the lines can be
achieved through
Expand Down Expand Up @@ -1580,7 +1579,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
<p>Applied to the example, the pattern is a string of eight ‘⠐’ (U+2810)
characters, resulting in the URL
<a href="https://daisy.org/ebraille/border-image?pattern=⠐⠐⠐⠐⠐⠐⠐⠐"><code>https://daisy.org/ebraille/border-image?pattern=⠐⠐⠐⠐⠐⠐⠐⠐</code></a>.</p>
<p>As <a href="https://daisy.github.io/ebraille/#resource-location">eBraille does not support remote
<p>As <a href="https://daisy.org/s/ebraille/#res-location">eBraille does not support remote
resources</a>, the image can not be referenced directly from the style sheet
through this URL. An additional step is required: the image must be
downloaded and placed in or below the root directory of the
Expand Down Expand Up @@ -2070,7 +2069,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
‘overflow-x’, ‘overflow-y’, and ‘overflow’ properties</a></li>
<li><a href="https://www.w3.org/TR/2016/WD-CSS22-20160412/visuren.html#z-index">Specifying the stack level: the
‘z-index’ property</a></li>
<li><a href="https://www.w3.org/TR/css-backgrounds-3/##background-color">Base Color: the
<li><a href="https://www.w3.org/TR/css-backgrounds-3/#background-color">Base Color: the
‘background-color’ property</a></li>
<li><a href="https://www.w3.org/TR/css-box-3/#margin-physical">Page-relative (Physical) Margin
Properties: the ‘margin-top’, ‘margin-right’, ‘margin-bottom’, and
Expand Down Expand Up @@ -2546,7 +2545,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
<section id="references" class="appendix"><div class="header-wrapper"><h2 id="b-references"><bdi class="secno">B. </bdi>References</h2><a class="self-link" href="#references" aria-label="Permalink for Appendix B."></a></div><section id="normative-references"><div class="header-wrapper"><h3 id="b-1-normative-references"><bdi class="secno">B.1 </bdi>Normative references</h3><a class="self-link" href="#normative-references" aria-label="Permalink for Appendix B.1"></a></div>

<dl class="bibliography"><dt id="bib-ebraille">[ebraille]</dt><dd>
<a href="https://daisy.github.io/ebraille/"><cite>eBraille 1.0</cite></a>. Willow Free; et al.. DAISY Consortium. URL: <a href="https://daisy.github.io/ebraille/">https://daisy.github.io/ebraille/</a>
<a href="https://daisy.org/s/ebraille/"><cite>eBraille 1.0</cite></a>. Willow Free; et al.. DAISY Consortium. URL: <a href="https://daisy.org/s/ebraille/">https://daisy.org/s/ebraille/</a>
</dd></dl>
</section><section id="informative-references"><div class="header-wrapper"><h3 id="b-2-informative-references"><bdi class="secno">B.2 </bdi>Informative references</h3><a class="self-link" href="#informative-references" aria-label="Permalink for Appendix B.2"></a></div>

Expand Down Expand Up @@ -2583,7 +2582,7 @@ <h1 id="title" class="title">eBraille Styling Best Practices</h1>
</dd><dt id="bib-selectors">[selectors]</dt><dd>
<a href="https://www.w3.org/TR/selectors-4/"><cite>Selectors Level 4</cite></a>. Elika Etemad; Tab Atkins Jr.. W3C. 11 November 2022. W3C Working Draft. URL: <a href="https://www.w3.org/TR/selectors-4/">https://www.w3.org/TR/selectors-4/</a>
</dd><dt id="bib-tagging">[tagging]</dt><dd>
<a href="https://daisy.github.io/ebraille/best-practices/tagging/"><cite>eBraille Tagging Best Practices</cite></a>. Willow Free. DAISY Editor's Draft. URL: <a href="https://daisy.github.io/ebraille/best-practices/tagging/">https://daisy.github.io/ebraille/best-practices/tagging/</a>
<a href="https://daisy.org/s/ebraille/best-practices/tagging/"><cite>eBraille Tagging Best Practices</cite></a>. Willow Free. DAISY Editor's Draft. URL: <a href="https://daisy.org/s/ebraille/best-practices/tagging/">https://daisy.org/s/ebraille/best-practices/tagging/</a>
</dd></dl>
</section></section><p role="navigation" id="back-to-top">
<a href="#title"><abbr title="Back to Top">↑</abbr></a>
Expand Down
Loading

0 comments on commit bdd5bc4

Please sign in to comment.