Merge pull request #170 from edrlab/contents

Reorganisation and sanitisation of the about pages

.vscode/settings.json

@@ -1,3 +1,3 @@
 {
-    "commentTranslate.targetLanguage": "fr"
+    "commentTranslate.targetLanguage": "es"
 }

content/en/th3/400_ressources/300_accessibility.md

@@ -0,0 +1,23 @@
+---
+title: Accessibility
+role: chapter
+draft: false
+weight: '300'
+---
+
+# Accessibility {#a11y}
+
+Thorium Reader is for everyone, including people who are blind or have
+other types of visual, cognitive or motor disabilities. The application
+is compatible with accessible technologies like screen readers,
+including JAWS, NVDA, Narrator and VoiceOver. It includes a read-aloud
+feature with visual highlighting. Thorium Reader can be used with the
+mouse or the keyboard, and keyboard shortcuts are configurable. The
+display can be customized to meet the needs of users, including colors,
+text size, spacing, font and layout.
+
+
+## Accessibility information {#a11y_info}
+
+Currently Thorium displays in the Book information panel, the accessibility information provided by the publisher. Thorium displays this information as it was defined. In case of doubt or
+complaint, please contact the distributor or the publisher of the file.

content/en/th3/400_ressources/311_screenReaders.md

@@ -0,0 +1,73 @@
+---
+title: Reading with a screen reader
+role: chapter
+draft: false
+weight: '301'
+---
+
+## Reading with a screen reader
+
+When launching Thorium, if a screen reader is detected, the relative
+functions are activated.
+
+Note that screen readers use a separate buffer to access the HTML
+content which results in the visual scroll / page offset to be out of
+sync. In other words, Thorium is generally not aware of the user\'s
+current reading location inside the screen reader buffer, unless the
+screen reader user triggers standard web API events (such as mouse click
+anywhere in the text, or keyboard tab into focusable HTML elements).
+
+ warning
+Attention !
+
+Accessibility features addressed to assistive technologies are strongly
+affected by the quality of the book files.
+
+
+# Keystrokes common to NVDA and JAWS
+
+(contribution from Prashant Verma, DAISY Consortium)
+
+For reading text, navigating in tables, navigating in the browser
+window, the insertion key can be replaced by the modifier key of the screen
+reader (e.g. the Caps Lock key).
+
+## Quick keys for navigation
+
+The screen reader must be in navigation or virtual cursor mode.
+
+|Action|Command|
+|---|---|
+|Next title| <kbd>H</kbd>|
+|Next table| <kbd>T</kbd>|
+|Next chart| <kbd>G</kbd>|
+|Next list|<kbd>L</kbd>|
+|Next form field|<kbd>F</kbd>|
+|List of elements| <kbd>INSERT</kbd> + <kbd>F7</kbd> (works regardless of cursor mode)|
+
+*Use the above keys with the <kbd>Shift</kbd> key to move to the previous
+item.*
+
+## Text
+
+|Action|Command|
+|---|---|
+|Previous character| <kbd>←</kbd>|
+|Next character| <kbd>→</kbd>|
+|Previous word|<kbd>Ctrl</kbd> + <kbd>←</kbd>|
+|Say Next word|<kbd>Ctrl</kbd> + <kbd>→</kbd>|
+|Previous line|<kbd>↑</kbd>|
+|Next line|<kbd>↓</kbd>|
+|Previous sentence|<kbd>Alt</kbd> + <kbd>↑</kbd> (Jaws only)|
+|Next sentence|<kbd>Alt</kbd> + <kbd>↓</kbd> (Jaws only)|
+|Read all| <kbd>INSERT</kbd> + <kbd>↓</kbd>|
+|Announce Font|<kbd>INSERT</kbd> + <kbd>F</kbd>|
+
+## Tables
+
+|Action|Command|
+|---|---|
+|Cell to the right| <kbd>Alt</kbd> + <kbd>Ctrl</kbd> + <kbd>→</kbd>|
+|Cell to the left|<kbd>Alt</kbd> + <kbd>Ctrl</kbd> + <kbd>←</kbd>|
+|Cell below|<kbd>Alt</kbd> + <kbd>Ctrl</kbd> + <kbd>↓</kbd>|
+|Cell above|<kbd>Alt</kbd> + <kbd>Ctrl</kbd> + <kbd>↑</kbd>|

content/en/th3/900_about_Thorium/903_thorium-accessibility-policy.md

@@ -7,59 +7,37 @@ weight: 903
 toc: false
 ---
 
-22 November 2022
+EDRLab is a non profit developpement laboratory and places accessibility as a core requirement of it's actions. That include the developpement of Thorium Reader. 
 
-Please read carefully the following terms and conditions and the documents incorporated by reference therein (collectively, the “Terms of Use”) before you begin using the Thorium Reader application (the “Application”).
+However, the core aspect of innovation and experimentation of our work may affect accessibility at some points. 
+Funding limitations may also affect our action and will to provide the best reading experience for all readers. 
+These are the main reasons why we cannot, at this moment, afford a full accessibility testing cycle at each release. 
 
-By using the Application, you agree to be bound by these Terms of Use and our Privacy Policy, which are incorporated herein by reference. If you do not agree to these Terms of Use or the Privacy Policy, you should not access or use our Application.
+Any identified blockers are publicly informed and searchable via a dedicated Label [Accessibility on our Issue tracker](https://github.com/edrlab/thorium-reader/issues?q=is%3Aissue+is%3Aopen+label%3Aaccessibility) that are treated as priority by the development team. 
 
-## Access to the Application
-We reserve the right to withdraw or modify the Application and any service we provide on it. We will not be liable if, for any reason, all or part of the Application is inaccessible at any time or during any period.
+## understanding all and each users’ needs
 
-## Continuous Agreement
-We may change the Terms of Use from time to time. We will notify you by posting the revised Terms of Use on this page and the date on which the last changes were made will be noted at the top of the page. You should review these Terms of Use regularly as you will be bound by any revisions. To the fullest extent permitted by Applicable laws, rules, regulations and requirements (collectively, “Applicable laws”), you understand and agree that your continued access or use of the Application following the posting of changes to the Terms of Use constitutes your acceptance of such changes.
+We capture feedback about customers’ experiences from an accessibility perspective thru different channels: 
+    * Developpement [Issue tracker dedicated Label Accessibility](https://github.com/edrlab/thorium-reader/issues?q=is%3Aissue+is%3Aopen+label%3Aaccessibility)
+    * Email [contact form](https://www.edrlab.org/contact/) 
+    * Indivdual feedback collected by our [members organisations dedicated to serving people with disabilities](https://members.edrlab.org/categories/serving-persons-with-print-disabilities/) 
 
-## Ownership and Use of the Application
-EDRLab is the owner of the Application, including all copyrights, trademarks, trade names, logos, patents, trade secrets and other intellectual property rights relating thereto. EDRLab may license third parties for the use or operation of the Application.
+## Thorium Reader accessibility features are informed
 
-In any case, the user does not have and will acquire no rights in the Application, other than the right to use it under the Terms of Use. Nothing in the Application or the Content may be interpreted as conferring on you any right, title, interest or other license in the software integrated into the Application or the Content or that can be downloaded into the Application, including, in particular, any intellectual property rights in the software making up the Application and its components, except the right to use it according to the Terms of Use. In addition, you may not rent, sell, modify, decompile, disassemble, reverse engineer or transfer the Application in whole or in part. You may not use any device, software or routine to interfere with or attempt to interfere with the proper functioning of the Application in whole or in part.
+When an accessibility feature is introduced, we make that information public thru
+* the version change log
+* a short mention on the website landing page
+* listed for reference in this website [ressources section, accessibility page](../../400_ressources/300_accessibility)
+* all accessibility related explanations are available in the documentation, not in a separate chapter or place.
 
-You may use the Application only for lawful purposes and in accordance with these Terms of Use. Without limiting the scope of the foregoing, you agree not to use the Application in any way that violates any local or international law or regulation, to impersonate or attempt to impersonate the identity of another person or to adopt any other conduct that restricts or hinders the use or enjoyment of the Application by anyone.
+## Support for assistive technology
 
-In the event that you have authorized a minor to use the Application and its Content, you acknowledge that you are responsible for: i) their behavior online; ii) to control their access and use of the Application and its Content; and iii) the consequences of any misuse of the Application and its Content on its part. You acknowledge the Application may import Content that is inappropriate for a minor. We recommend that you exercise reasonable supervision over the use of the Application and its Content by minors in your care.
+A specific attention is given to non visual access thru screen readers. 
 
-## Intellectual Property of the Content
-Contents imported in the Application can be protected by copyright or other intellectual property rights. You are responsible for ensuring that your use of the Contents, as well as of all the elements that compose them, does not violate any intellectual property right or any other right.
+As much as possible we intend to maintain a similar access path between visual and non visual access. Whenever necessary, we use dedicated technologies like ARIA-Role.
 
-## Confidentiality
-By using the Application, you accept the terms of the privacy policy relative to the Application. This policy is incorporated into these terms of use by reference and explains EDRLab’s privacy practices.
+New functionalities are tested with screen readers.
 
-Links to Other Sites or Resources
-You may integrate in the Application links to third-party services or resources not operated by EDRLab, including Library data feeds. EDRLab has no control over such third-party sites or resources and is not responsible for their availability, security, Content or resources. The inclusion of such links does not imply an endorsement or a recommendation by EDRLab of the third-party service or resource in question. EDRLab is not responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with your use of or reliance on any Content, information, products, goods or services available on or through any third party service.
+## Accessibility testing
 
-## Limitation of Warranty
-TO THE FULLEST EXTENT PERMITTED BY LAW, THE APPLICATION AND CONTENT ARE PROVIDED “AS IS”, “AS AVAILABLE” AND WITHOUT CONDITIONS, REPRESENTATIONS, WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, ARISING BY STATUTE OR OTHERWISE, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, UNINTERRUPTED OPERATION, FREEDOM FROM ERROR, ACCESSIBILITY, ACCURACY, TIMELINESS, RELIABILITY, PUNCTUALITY, LEGALITY, PRIVACY, COMPLETENESS, SECURITY, QUALITY, TITLE, NON-INFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE, AND NO WARRANTY ARISING FROM COURSE OF DEALING OR USAGE OF TRADE. YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION OF YOUR COMPUTER EQUIPMENT OR MOBILE DEVICE AND SOFTWARE THAT MAY BE REQUIRED AS A RESULT OF VIRUSES, ERRORS OR OTHER PROBLEMS OF ANY KIND THAT YOU MAY EXPERIENCE AS A RESULT OF YOUR USE OF THE APPLICATION.
-
-Without limiting the foregoing, EDRLab makes no representation as to the availability of the Books, the libraries’ compliance with lending conditions and the libraries’ compliance with the licensing conditions of the Books from the publishers, and cannot incur any liability in this regard.
-
-## Limitation of Liability
-TO THE FULLEST EXTENT PERMITTED BY LAW, BRAND, ITS PARENT, SUBSIDIARY AND AFFILIATE COMPANIES AND EACH OF THEIR RESPECTIVE OFFICERS, DIRECTORS, EMPLOYEES, AGENTS, REPRESENTATIVES, LICENSORS, LICENSEES AND ASSIGNS (COLLECTIVELY, THE “EDRLAB PARTIES”) SHALL NOT BE LIABLE FOR ANY DAMAGES OR INJURY, INCLUDING, WITHOUT LIMITATION, CONSEQUENTIAL DAMAGES, SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR OTHERWISE ARISING OUT OF THE USE OF, OR INABILITY TO USE, THE APPLICATION OR THE CONTENT, WHETHER IN CONTRACT OR TORT OR UNDER ANY OTHER THEORY OF LAW ARISING OUT OF OR IN CONNECTION WITH THE USE OR OPERATION OF THE CONTENT, THE APPLICATION OR THE INFORMATION ACCESSED FROM OR RELATED TO THE APPLICATION. THE PARTIES ASSUME NO LIABILITY, EVEN IF THEY OR ONE OF THEIR AUTHORIZED REPRESENTATIVES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SUCH DAMAGES MAY INCLUDE, WITHOUT LIMITATION, DAMAGES OR INJURY RESULTING FROM ANY ERROR, OMISSION, INTERRUPTION, DEFECT, FAILURE OF PERFORMANCE, DELAY IN OPERATION OR TRANSMISSION, LINE FAILURE, OR FROM ANY COMPUTER VIRUS, WORM, TROJAN HORSE OR OTHER HARMFUL COMPONENT.
-
-Some applicable laws may not allow the exclusion of certain warranties or the limitation or exclusion of liability for incidental or consequential damages. Therefore, some of the above limitations or exclusions may not apply to you. In all cases of exclusion, direct and indirect damage is limited to the price paid to obtain the right to use the Application.
-
-You acknowledge that the EDRLab Parties have no obligation to monitor any Content accessible through the Application. However, you acknowledge that the EDRLab Parties have the right to monitor the use of the Application, at its sole discretion, and to disclose any information necessary to comply with any law, regulation or government request, in order to be able to operate the Application adequately or in order to protect itself or its users under the “Privacy Policy”.
-
-## Compensation
-You hereby agree to indemnify and hold harmless the EDRLab Parties from and against any and all claims, actions or proceedings of any nature whatsoever and all damages, judgments, losses, liabilities, costs and expenses, including reasonable attorneys’ fees and expenses (including those incurred to enforce this provision), arising out of your use of the Application, the Content, any actual or alleged breach by you of these Terms of Use, or any violation by you of any applicable law or the rights of any other person or entity.
-
-## Severability
-If any provision of these Terms of Use shall be deemed unlawful, void, or for any reason unenforceable, then that provision shall be deemed severable from these Terms of Use and shall not affect the validity and enforceability of any remaining provisions. The Terms of Use shall be construed to the greatest extent possible so as to give the closest possible effect to the invalid provision, within the bounds of legality.
-
-## Absence of Waiver
-The fact that EDRLab does not require the execution of any part of these terms of use does not constitute a waiver of its rights hereunder for past or future actions on the part of anyone.
-
-## Applicable Laws and Jurisdiction
-These Terms of Use and any dispute arising out of or relating to these Terms of Use shall be governed by the laws in force in France, without reference to its conflict of law rules. Any action, suit or proceeding arising out of these Terms of Use (whether for breach of contract, wrongful conduct or otherwise) shall be brought exclusively in France, as the case may be, located in Paris, and you agree to submit to the jurisdiction of such courts for any action, suit or proceeding arising out of these Terms of Use.
-
-## Contact Us
-All questions, comments or requests regarding these terms of use should be sent to EDRLab at: [[email protected]](mailto:[email protected]).
+    * Community testing thru [epubtest.org](https://epubtest.org/)

content/en/th3/900_about_Thorium/910_credits.md

@@ -1,25 +1,11 @@
 ---
-title: "Credits"
+title: "Credits for Thorium Reader"
 description: ""
 draft: false
 weight: 902
 toc: false
 ---
 
-This documentation site is designed and maintained by EDRLab 
-as part of the development of the Thorium-Reader application.
-
-The main contributors of this documentation are : 
-* Gautier Chomel
-* Georges Kerscher
-* Noelia Ruiz Martínez
-* Prashant Verma
-
-This site is made with the static site generator 
-[Hugo](https://gohugo.io/) and the
-[Hugo Book Theme](https://github.com/alex-shpak/hugo-book/).
-
- <h2>Who has developed this app</h2>
 
  <p>Thorium Reader is currently developed by:</p>
 
@@ -41,7 +27,7 @@ This site is made with the static site generator
  <li>Manuel Lagrand, intern, node.js developer.</li>
  </ul>
 
- <p>The project is supervised by Laurent Le Meur, EDRLab CTO.</p>
+
 
  <h2>Who is financing this app</h2>
 

content/en/th3/900_about_Thorium/913_licence.md

@@ -1,18 +1,39 @@
 ---
-title: "Licence"
+title: "Licence for Thorium Reader"
 description: ""
 draft: false
 weight: 913
 toc: false
 ---
 
-## Licensing
+The Thorium-reader application is open-source, released under a BSD 3 license. It is based on the open-source Readium Desktop toolkit Licensed to the [Readium Foundation](https://readium.org/) under one or more contributor license agreements.
 
-Copyright 2019 European Digital Reading Lab. All rights reserved. Licensed to the Readium Foundation under one or more contributor license agreements.
+BSD 3-Clause License
 
-The Thorium-reader application is open-source, released under a BSD 3 license. It is based on the open-source Readium Desktop toolkit.
+Copyright (c) 2017, EDRLab
+All rights reserved.
 
-The content of this web site is free and may be reused under the terms of the BSD License. 
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
 
- This static site is generated by Hugo and the Hugo Book theme. 
-[Source code is public](https://github.com/edrlab/thorium-reader-doc).
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

content/en/th3/950_about_this_website/912_accessibility_declaration.md

@@ -1,5 +1,5 @@
 ---
-title: "Accessibility : conforms to WCAG 2.1 AA"
+title: "Accessibility of this website"
 description: ""
 draft: false
 weight: 912
@@ -9,9 +9,11 @@ toc: false
 This site was tested with NVDA on Firefox on Windows 10. 
 No accessibility blockers were found.
 
+Last testing: December 2024
+
 If you encounter any difficulties you can inform us via the 
 contact form or by opening an issue on our 
-[support tracker](https://github.com/edrlab/thorium-reader-doc/issues/new).
+[support tracker](https://github.com/edrlab/thorium-reader-doc/issues/new) or thru our [contact form](https://www.edrlab.org/contact/).
 
 The page is in English but you can write in your language by telling us so we can 
 in your language so that we can mobilize the right people.