[daisy-pipeline.wiki] push by bertfrees - Remove BrailleCSSProperties page and refer to braille-css-spec instead on 2014-10-02 13:57 GMT

[daisy-p...@googlecode.com]

Revision: ff4b1cfeb58f
Branch: default
Author: Bert Frees <bert...@gmail.com>
Date: Thu Oct 2 13:56:28 2014 UTC
Log: Remove BrailleCSSProperties page and refer to braille-css-spec
instead
https://code.google.com/p/daisy-pipeline/source/detail?r=ff4b1cfeb58f&repo=wiki

Deleted:
/BrailleCSSProperties.wiki
Modified:
/ZedAIToPEFUsage.wiki

=======================================
--- /BrailleCSSProperties.wiki Wed Mar 12 16:14:50 2014 UTC
+++ /dev/null
@@ -1,82 +0,0 @@
-#summary Overview of all the Braille CSS properties
-
-= Braille CSS Properties =
-
-|| *Name* || *Values* || *Initial value* || *Applies to* || *Inherited* ||
*Comments* ||
-|| border`*` || `[` _`<braille-character>`_ | none `]{1,4}` || none ||
block | list-item || no || ||
-|| border-bottom`*` || _`<braille-character>`_ | none || none || block |
list-item || no || ||
-|| border-left`*` || _`<braille-character>`_ | none || none || block |
list-item || no || ||
-|| border-right`*` || _`<braille-character>`_ | none || none || block |
list-item || no || ||
-|| border-top`*` || _`<braille-character>`_ | none || none || block |
list-item || no || ||
-|| content`*` || _`<content-list>`_ | none || none || ::before and ::after
pseudo-elements || no || _`<content-list>`_ = `[` _`<string>`_ | content()
| attr(_`<name>`_) | target-text(_`<target>`_) |
target-string(_`<target>`_,_`<identifier>`_) |
target-counter(_`<target>`_,_`<identifier>`_) | leader(_`<pattern>`_) `]+` |
|
-|| [http://www.w3.org/TR/CSS21/generate.html#propdef-counter-reset
counter-reset] || none | `[` _`<identifier>`_ _`<integer>?`_ `]+` || none |
| `*` || no || The only supported value for _`<identifier>`_ is
_braille-page_ ||
-|| display`*` || block | inline | list-item | none | page-break || inline |
| `*` || no || ||
-|| left`*` || _`<natural-number>`_ | _inherit_ || 0 || block | list-item |
| yes || For resetting the left margin of a block to an absolute value. If
`margin-left` is non-nil, that value will be added. ||
-|| list-style-type`*` || _`<braille-character>`_ | decimal | lower-alpha |
lower-roman | none | upper-alpha | upper-roman | _inherit_ || none ||
list-item || yes || ||
-|| margin`*` || _`<integer>`_ `{1,4}` || 0 || block | list-item || no ||
Vertical margins (and padding) should be interpreted as the _minimal_
distance before or after a block. In other words, the `margin-bottom` of an
element will collapse with the `margin-top` of the next block. ||
-|| margin-bottom`*` || _`<natural-number>`_ || 0 || block | list-item ||
no || ||
-|| margin-left`*` || _`<integer>`_ || 0 || block | list-item || no || ||
-|| margin-right`*` || _`<integer>`_ || 0 || block | list-item || no || ||
-|| margin-top`*` || _`<natural-number>`_ || 0 || block | list-item || no |
| See remark above about vertical margins. ||
-|| [http://www.w3.org/TR/CSS2/page.html#propdef-orphans orphans] ||
_`<integer>`_ | _inherit_ || 0 || block | list-item || no || ||
-|| padding`*` || _`<integer>`_ `{1,4}` || 0 || block | list-item || no ||
See remark above about vertical margins. ||
-|| padding-bottom`*` || _`<natural-number>`_ || 0 || block | list-item ||
no || ||
-|| padding-left`*` || _`<natural-number>`_ || 0 || block | list-item || no
|| ||
-|| padding-right`*` || _`<natural-number>`_ || 0 || block | list-item ||
no || ||
-|| padding-top`*` || _`<natural-number>`_ || 0 || block | list-item || no |
| See remark above about vertical margins. ||
-|| [http://www.w3.org/TR/css3-page/#page page] || auto | _`<identifier>`_ |
| auto || block | list-item || yes || ||
-|| [http://www.w3.org/TR/CSS2/page.html#propdef-page-break-after
page-break-after] || always | auto | avoid | left | right | _inherit_ ||
auto || block | list-item || no || Not supported: left | right. ||
-|| [http://www.w3.org/TR/CSS2/page.html#propdef-page-break-before
page-break-before] || always | auto | avoid | left | right | _inherit_ ||
auto || block | list-item || no || Not supported: avoid | left. ||
-|| [http://www.w3.org/TR/CSS2/page.html#propdef-page-break-inside
page-break-inside] || auto | avoid | _inherit_ || auto || block | list-item
|| no || ||
-|| right`*` || _`<natural-number>`_ | _inherit_ || 0 || block | list-item |
| yes || For resetting the right margin of a block to an absolute value. If
`margin-right` is non-nil, that value will be added. ||
-|| [http://www.w3.org/TR/css3-gcpm/#string-set string-set] || none | `[`
_`<identifier>`_ _`<content-list>`_ `]` `[`, _`<identifier>`_
_`<content-list>`_ `]*` || none || `*` || no || _`<content-list>`_ = `[`
_`<string>`_ | content() | attr(_`<name>`_) `]+` ; Supported values for
_`<identifier>`_ are _print-page_, _running-header_ and _running-footer_ ||
-|| [http://www.w3.org/TR/CSS2/text.html#propdef-text-align text-align] ||
center | justify | left | right | _inherit_ || left || block | list-item ||
yes || Not supported: justify. ||
-|| text-indent`*` || _`<integer>`_ | _inherit_ || 0 || block | list-item |
| yes || ||
-|| typeform-indication`*` || none | _`<indicator-list>`_ || none || `*` ||
yes || _`<indicator-list>`_ = `[` _`<identifier>`_ `]+` ||
-|| [http://www.w3.org/TR/CSS2/page.html#propdef-widows widows] ||
_`<integer>`_ | _inherit_ || 0 || block | list-item || no || Not supported.
||
-
-(`*`) The properties marked with an asterisk are not plain CSS, but
Braille extensions.
-
-
-== @media print ==
-
-The following is a list of CSS properties that don't belong in the
category "Braille formatting". Rather, they describe the typeface of the
original print document, and they are used as _hints_ for the Braille
translation. Therefore, these properties are only valid for `@media print`,
whereas the above are only valid for `@media embossed`.
-
-|| *Name* || *Values* || *Initial value* || *Applies to* || *Inherited* ||
-|| [http://www.w3.org/TR/CSS21/colors.html#propdef-color color] ||
_`<color>`_ | _inherit_ || #000000 || `*` || yes ||
-|| [http://www.w3.org/TR/CSS21/fonts.html#font-styling font-style] ||
normal | italic | oblique | _inherit_ || normal || `*` || yes ||
-|| [http://www.w3.org/TR/CSS21/fonts.html#font-boldness font-weight] ||
normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 |
_inherit_ || normal || `*` || yes ||
-|| [http://www.w3.org/TR/CSS21/text.html#propdef-text-decoration
text-decoration] || none | underline | overline | line-through | blink |
_inherit_ || none || `*` || yes ||
-
-
-== @page ==
-
-TBD
-
-== CSS Selectors ==
-
-Below is a list of all the supported CSS selectors (for more information
see [http://www.w3.org/TR/CSS2/selector.html]):
-
-|| *Category* || *Pattern* || *Matches* ||
-|| Universal selector || `*` || any element ||
-|| Type selectors || `E` || any element E ||
-|| Descendant selectors || `E F` || any element F that is a
descendant of element E ||
-|| Child selectors || `E > F` || any element F that is a
child of element E ||
-|| Adjacent selectors || `E + F` || any element F immediately
preceded by a sibling element E ||
-|| Attribute selectors || `E[foo]` || any element E with a "foo"
attribute ||
-|| || `[foo]` || `*[foo]` ||
-|| || `E[foo="bar"]` || any element E whose "foo"
attribute value is "bar" ||
-|| || `E[foo~="bar"]` || any element E whose "foo"
attribute is a list of space-separated values, one of which is equal
to "bar" ||
-|| || `E[foo|="bar"]` || any element E whose "foo"
attribute has a hyphen-separated list of values beginning with "bar" ||
-|| Class selectors || `E.bar` || `E[class~="bar"]` ||
-|| || `.bar` || `*.bar` ||
-|| ID selectors || `E#bar` || any element E with ID equal
to "bar" ||
-|| || `#bar` || `*#bar` ||
-|| Pseudo-classes || `E:first-child` || any element E that is the
first child of its parent ||
-|| || `E:last-child` || any element E that is the
last child of its parent ||
-|| || `E:nth-child(n)` || any element E that is the
nth child of its parent ||
-|| || `E:only-child` || any element E that has no
siblings ||
-
-== Pseudo-elements ==
-
-The *::before* and *::after* pseudo-elements specify the location of
content before and after an element's document tree content. The 'content'
property, in conjunction with these pseudo-elements, specifies what is
inserted.
=======================================
--- /ZedAIToPEFUsage.wiki Mon Mar 17 11:36:44 2014 UTC
+++ /ZedAIToPEFUsage.wiki Thu Oct 2 13:56:28 2014 UTC
@@ -121,7 +121,7 @@

=== Styling with Braille CSS ===

-The formatting of documents into a paged braille layout is done entirely
based on CSS (Cascading Style Sheets). We use a flavor of CSS specially
designed for this use case. For people that already know CSS, it will feel
very natural. In fact, it is almost a subset of CSS3, but with some
restrictions and a few braille specific features. The most obvious
difference is that margins are expressed in units of cell width and line
height instead of pixels, ems and percentages. A complete overview of the
CSS properties and CSS selectors can be found on [BrailleCSSProperties this
page].
+The formatting of documents into a paged braille layout is done entirely
based on CSS (Cascading Style Sheets). We use a flavor of CSS specially
designed for this use case. For people that already know CSS, it will feel
very natural. In fact, it is almost a subset of CSS3, but with some
restrictions and a few braille specific features. The most obvious
difference is that margins are expressed in units of cell width and line
height instead of pixels, ems and percentages. A complete overview of
braille CSS can be found on [http://snaekobbi.github.io/braille-css-spec
this page].

The actual formatting of documents based on CSS is done with
[http://code.google.com/p/liblouisutdml/ liblouisutdml] under the hood. In
the future other implementations may be added. Note that, when the
_formatting_ begins, the braille _translation_ has already been performed.
Translation and formatting are completely separated steps, and their
implementations can be changed independently.