Remove highlights mention from docs

Author: JayPanoz

README.md

@@ -12,7 +12,6 @@ Readium CSS provides styles for reflowable text:
 - reading modes (day, night, and sepia);
 - themes;
 - user settings;
-- media overlays and user highlights;
 - a set of baselines and recommendations for accessibility, overrides, and internationalization.
 
 **Readium CSS is currently in alpha** (version `1.0.0-beta.1`).

css/ReadMe.md

@@ -7,8 +7,7 @@ Readium CSS is a set of reference stylesheets for EPUB Reading Systems. It provi
 - default styles;
 - reading modes (night, sepia, etc.);
 - themes;
-- user settings;
-- media overlays and user highlights.
+- user settings.
 
 **Note:** Readium CSS stylesheets were not designed and should not be used for fixed-layout EPUB, nor other file formats like FB2, PRC, Mobi, TEI, etc.
 

css/src/modules/ReadiumCSS-os_a11y.css

@@ -29,8 +29,6 @@
   }
 
   /* For links, hyperlink keyword is automatically set */
-
-  /* Should we also set user highlights? */
 }
 
 @media screen and (-ms-high-contrast: white-on-black) {

docs/CSS02-quickstart.md

@@ -9,8 +9,7 @@ Readium CSS is a set of reference stylesheets for EPUB Reading Systems. It provi
 - default styles;
 - reading modes (night, sepia, etc.);
 - themes;
-- user settings;
-- media overlays and user highlights.
+- user settings.
 
 **Note:** Readium CSS stylesheets were not designed and should not be used for fixed-layout EPUB, nor other file formats like FB2, PRC, Mobi, TEI, etc.
 

docs/CSS08-defaults.md

@@ -7,7 +7,6 @@ Defaults is currently made of 5 stylesheets:
 - 1 base stylesheet for all ebooks;
 - 1 default reading mode stylesheet for all ebooks (day mode);
 - 1 default stylesheet for unstyled ebooks;
-- 1 stylesheet for user highlights and media overlays;
 - 1 stylesheet to deal with the OS’ a11y modes.
 
 **Note:** The default stylesheet should not be appended if there are author styles in the EPUB file.
@@ -362,41 +361,7 @@ An optional primary accentuation `color` you could use for headings or any other
 
 An optional secondary accentuation `color` you could use for any element of your choice.
 
-## User highlights and media overlays
-
-### Highlights
-
-You can use classic [insert famous highlighters’ brand] colors in all their neon glory:
-
-- yellow;
-- green;
-- orange;
-- pink.
-
-There’s no blue since it is too close to the default `::selection`.
-
-Ideally, you should offer users the possibility to switch colors when highlighting as they might use a color pattern to manage different types of highlights/notes.
-
-There’s a class syntax you can use to differentiate highlights: `.readiumCSS-{color}-highlight` e.g. `.readiumCSS-yellow-highlight` or `.readiumCSS-pink-highlight`.
-
-Values are declared in `rgba` so that those colors don’t have to be redefined in night modes.
-
-At first sight, contrast is OK for those colors in default and night mode, but it will obviously depend on the `background-color` and `color` values you’re using for themes.
-
-### Media Overlays
-
-We’re using the same one as Readium 1 for interop reasons.
-
-```
-.readiumCSS-mo-active-default {
-  background-color: yellow !important;
-  color: black !important;
-}
-```
-
-It has been prefixed with `readiumCSS-` but you can get rid of it if needed.
-
-### OS’ a11y modes
+## OS’ a11y modes
 
 This stylesheet is intended to deal with a11y settings users can set at the OS level, whenever possible: 
 

docs/ReadiumCSS_docs.epub

@@ -28,9 +28,7 @@
 
       <li>themes;</li>
 
-      <li>user settings;</li>
-
-      <li>media overlays and user highlights.</li>
+      <li>user settings.</li>
     </ul>
 
 	<p><strong>Note:</strong> Readium CSS stylesheets were not designed and should not be used for fixed-layout EPUB, nor other file formats like FB2, PRC, Mobi, TEI, etc.</p>

docs/ReadiumCSS_docs/OEBPS/Text/Section-002.xhtml

@@ -24,8 +24,6 @@
 
       <li>1 default stylesheet for unstyled ebooks;</li>
 
-      <li>1 stylesheet for user highlights and media overlays;</li>
-
       <li>1 stylesheet to deal with the OS’ a11y modes.</li>
     </ul>
 
@@ -374,65 +372,22 @@
       </section>
     </section>
 
-    <section id="user-highlights-and-media-overlays" class="level2">
-      <h2 id="sigil_toc_id_134">User highlights and media overlays</h2>
-
-      <section id="highlights" class="level3">
-        <h3 class="sigil_not_in_toc">Highlights</h3>
-
-        <p>You can use classic [insert famous highlighters’ brand] colors in all their neon glory:</p>
-
-        <ul>
-          <li>yellow;</li>
-
-          <li>green;</li>
-
-          <li>orange;</li>
+    <section id="os-a11y-modes" class="level2">
+      <h2 id="sigil_toc_id_134">OS’ a11y modes</h2>
+        
+      <p>This stylesheet is intended to deal with a11y settings users can set at the OS level, whenever possible:</p>
 
-          <li>pink.</li>
-        </ul>
-
-        <p>There’s no blue since it is too close to the default <code>::selection</code>.</p>
-
-        <p>Ideally, you should offer users the possibility to switch colors when highlighting as they might use a color pattern to manage different types of highlights/notes.</p>
-
-        <p>There’s a class syntax you can use to differentiate highlights: <code>.readiumCSS-{color}-highlight</code> e.g. <code>.readiumCSS-yellow-highlight</code> or <code>.readiumCSS-pink-highlight</code>.</p>
-
-        <p>Values are declared in <code>rgba</code> so that those colors don’t have to be redefined in night modes.</p>
-
-        <p>At first sight, contrast is OK for those colors in default and night mode, but it will obviously depend on the <code>background-color</code> and <code>color</code> values you’re using for themes.</p>
-      </section>
-
-      <section id="media-overlays" class="level3">
-        <h3 class="sigil_not_in_toc">Media Overlays</h3>
-
-        <p>We’re using the same one as Readium 1 for interop reasons.</p>
-
-        <pre><code>.readiumCSS-mo-active-default { 
-  background-color: yellow !important; 
-  color: black !important; 
-}</code></pre>
-
-        <p>It has been prefixed with <code>readiumCSS-</code> but you can get rid of it if needed.</p>
-      </section>
-
-      <section id="os-a11y-modes" class="level3">
-        <h3 class="sigil_not_in_toc">OS’ a11y modes</h3>
-
-        <p>This stylesheet is intended to deal with a11y settings users can set at the OS level, whenever possible:</p>
-
-        <ul>
-          <li>high-contrast mode;</li>
+      <ul>
+        <li>high-contrast mode;</li>
 
-          <li>inverted colors;</li>
+        <li>inverted colors;</li>
 
-          <li>monochrome;</li>
+        <li>monochrome;</li>
 
-          <li>reduced motion.</li>
-        </ul>
+        <li>reduced motion.</li>
+      </ul>
 
-        <p>For <code>monochrome</code>, we’ll have to adjust reading modes (night, sepia, etc.) in their specific stylesheet; we’ll see if we can at least manage some more global settings in there.</p>
-      </section>
+      <p>For <code>monochrome</code>, we’ll have to adjust reading modes (night, sepia, etc.) in their specific stylesheet; we’ll see if we can at least manage some more global settings in there.</p>
     </section>
   </section>
 </body>

docs/ReadiumCSS_docs/OEBPS/Text/Section-008.xhtml

@@ -169,7 +169,7 @@
           <a href="../Text/Section-008.xhtml#sigil_toc_id_58">Default</a>
         </li>
         <li>
-          <a href="../Text/Section-008.xhtml#sigil_toc_id_134">User highlights and media overlays</a>
+          <a href="../Text/Section-008.xhtml#sigil_toc_id_134">OS’ a11y modes</a>
         </li>
       </ol>
       </li>

docs/ReadiumCSS_docs/OEBPS/Text/nav.xhtml

@@ -8,7 +8,7 @@
     <dc:language>en</dc:language>
     <dc:identifier id="epub-id-1">urn:uuid:91cab77e-946f-4814-9e61-8494a5d5cb0f</dc:identifier>
     <meta name="cover" content="cover_jpg"/>
-    <meta property="dcterms:modified">2020-04-30T19:10:46Z</meta>
+    <meta property="dcterms:modified">2020-06-03T19:52:07Z</meta>
     <meta content="0.9.5" name="Sigil version"/>
     <meta property="schema:accessibilityFeature">displayTransformability</meta>
     <meta property="schema:accessibilityFeature">readingOrder</meta>