update

epub-doc/en/build/epub/EPUB/pages/101_opening_thorium/index.xhtml

@@ -22,7 +22,8 @@ view</a> and will allow you to choose a book or to add
 one but also to access to 
         <a href="">catalogs</a> and organize your
 collection. To read a book just click on it or validate with
-[Enter]{.kbd} when selected.
+
+        <kbd>Enter</kbd> when selected.
       </li>
       <li>Select the book you want to read, use the 
         <code>contextual menu</code> (right

epub-doc/en/build/epub/EPUB/pages/110_libraries_actions/index.xhtml

@@ -58,7 +58,9 @@ be limited to the ones matching your query. To use this function,
 Activate the Search Box
 (
       <img src="../../resources/images/icons3/search-icon.svg" class="icon" alt="" role="presentation"/>) by clicking in it, moving focus or pressing
-the [Ctrl + F]{.kbd} key combination, enter the text you want to
+the 
+      <kbd>Ctrl</kbd> + 
+      <kbd>F</kbd> key combination, enter the text you want to
 search. 
       <code>Results</code> will display instantly. The search is performed
 thru the books informations including user added tags. The content

epub-doc/en/build/epub/EPUB/pages/211_reading_textuals/index.xhtml

@@ -15,9 +15,9 @@
     <p>For textual contents Thorium provides visual reading and audio playback.</p>
     <h3 id="read_text_adjust">Text adjustment settings</h3>
     <p>In the reading interface use the 
-      <code>Preferences</code> button (
-&lt;img src=&quot;../../resources/images/icons3/textarea-icon.svg){.icons}): the options
-are revealed.
+      <code>Preferences</code> button
+
+      <img src="../../resources/images/icons3/textarea-icon.svg"/>
     </p>
     <p>Reading settings can be saved or reset by using buttons 
       <span class="ui_button">Save</span> and 
@@ -33,7 +33,7 @@ Layout EPUBs will allow to open Image view for zooming on a page. PDFs
 can be enlarged using the Zoom sub-menu in the Preferences panel.</p>
     <h3 id="read_text_adjust_theme">Theme</h3>
     <p>The color of the background and foreground can be changed using one of
-the three available themes - Neutral, Sepia and Night.</p>
+the available themes.</p>
     <h3 id="read_text_adjust_font">Text</h3>
     <p>The font size can be increased or decreased using the slider. The font
 can also be changed. The available options are as follows Default, Old
@@ -59,11 +59,13 @@ you must know its exact name as it is set for the operating system.
           <em>Verdana</em> in the empty field that appears next to the
 drop-down list.
         </li>
-        <li>Confirm with [Enter]{.kbd}.</li>
+        <li>Confirm with 
+          <kbd>Enter</kbd>.
+        </li>
       </ol>
       <p>
         <img src="../../resources/images/local-fr/thorium-verdana.png" alt="Screenshot showing the Text settings Pannel with verdana set up as
-reading font" class="icons" />
+reading font" />
       </p>
       <h4 id="read_text_example_luciole">Example 2: Setting up Luciole as the reading font</h4>
       <ol>
@@ -83,11 +85,13 @@ font</a>
           <em>Luciole</em> in the empty field that appears next to the
 drop-down list.
         </li>
-        <li>Confirm with [Enter]{.kbd}.</li>
+        <li>Confirm with 
+          <kbd>Enter</kbd>.
+        </li>
       </ol>
       <p>
         <img src="../../resources/images/local-fr/thorium-luciole.png" alt="Screenshot showing the Text settings Pannel with Luciole set up as
-reading font" class="icons" />
+reading font" />
       </p>
     </div>
     <h3 id="read_text_display">Display</h3>
@@ -109,23 +113,33 @@ the digital book.
 more precise highlighting.
     </p>
     <div class="info">
-Thorium uses the voices from the computer\'s operating system, in
+Thorium uses the voices from the computer's operating system, in
 combination with the language information provided by the book. If you
 experience problems please check the related FAQ entry \[I can\'t select
-the adequate voice for read aloud function
-(TTS)\](../../400_ressources/430_faq.xhtml#TTSvoices).
+the adequate voice for read aloud function (TTS)\]([../../400_ressources/430_faq.xhtml#TTSvoices](https://thorium.edrlab.org/en/th3/400_ressources/430_faq/#TTSvoices)).
 </div>
     <h3 id="read_text_TTS">Text to Speech (TTS)</h3>
     <p>Text-to-speech is launched using the speaker button in the middle of the
-toolbar, or by using the keyboard shortcut [Ctrl]{.kbd} + [2]{.kbd}.</p>
+toolbar, or by using the keyboard shortcut 
+      <kbd>Ctrl</kbd> + 
+      <kbd>2</kbd>.
+    </p>
     <ul>
       <li>
         <p>Play and pause can be controlled with the keyboard shortcut
-[Ctrl]{.kbd} + [2]{.kbd}.</p>
+
+          <kbd>Ctrl</kbd> + 
+          <kbd>2</kbd>.
+        </p>
       </li>
       <li>
-        <p>The playback position can be moved with [Ctrl]{.kbd} + [1]{.kbd} and
-[Ctrl]{.kbd} + <kbd>3</kbd> for previous and next respectively.</p>
+        <p>The playback position can be moved with 
+          <kbd>Ctrl</kbd> + 
+          <kbd>1</kbd> and
+
+          <kbd>Ctrl</kbd> + 
+          <kbd>3</kbd> for previous and next respectively.
+        </p>
       </li>
       <li>
         <p>A speed control is available when read aloud is selected, with a
@@ -143,7 +157,7 @@ through options available in the
       </li>
     </ul>
     <div class="info">
-Thorium uses the voices from the computer\'s operating system, in
+Thorium uses the voices from the computer's operating system, in
 combination with the language information provided by the book. If you
 experience problems please check the related FAQ entry \[I can\'t select
 the adequate voice for read aloud function

epub-doc/en/build/epub/EPUB/pages/212_reading_visuals/index.xhtml

@@ -19,20 +19,30 @@ will appear around it) and activate zoom by clicking with the mouse or
 tapping it with the finger. Access to image zoom via keyboard is
 currently not possible.</p>
     <p>If the image is also a link or if the book your read is in a fixed
-layout format, you will need to hit the [Shift]{.kbd} key in order to
-enter the image zoom feature.</p>
+layout format, you will need to hit the 
+      <kbd>Shift</kbd> key in order to
+enter the image zoom feature.
+    </p>
     <p>To zoom in or out, tab to the 
       <code>+</code> or 
-      <code>-</code> buttons and hit [enter]{.kbd},
+      <code>-</code> buttons and hit 
+      <kbd>Enter</kbd>,
 use mouse wheel, scroll up and down or pinch and stretch trackpad or
 onscreen touch gestures.
     </p>
     <p>Once the image is zoomed you can move vertically and horizontally with
-[Left arrow]{.kbd}, [Right arrow]{.kbd}, [Left arrow]{.kbd} and [Right
-arrow]{.kbd}, by moving mouse while maintaining clic, with usual
-trackpad gestures or with finger moves on tactile screens.</p>
+
+      <kbd>Left arrow</kbd>, 
+      <kbd>Right arrow</kbd>, 
+      <kbd>Left arrow</kbd> and 
+      <kbd>Right arrow</kbd>,
+by moving mouse while maintaining clic, with usual
+trackpad gestures or with finger moves on tactile screens.
+    </p>
     <p>To close the image zoom view and to return to the reading view, press
-[ESC]{.kbd} key, or the X button.</p>
+
+      <kbd>ESC</kbd> key, or the X button.
+    </p>
     <p>Some restrictions due to ebook design may apply, for example when images
 are inserted as style (CSS), it is not possible to open the image view
 for zooming.</p>

epub-doc/en/build/epub/EPUB/pages/220_reading_actions/index.xhtml

@@ -12,7 +12,9 @@
   </head>
   <body>
     <h2 id="read_search">Search in a book</h2>
-    <p>You can use [Ctrl]{.kbd} + [F]{.kbd} keys to access the search field.
+    <p>You can use 
+      <kbd>Ctrl</kbd> + 
+      <kbd>F</kbd> keys to access the search field.
 Enter your search term. By clicking on the 
       <code>Search</code> button, you get
 

epub-doc/en/build/epub/EPUB/pages/240_annotations/index.xhtml

@@ -20,8 +20,12 @@ by opening an issue or sending us an email.</em>
     <p>The simplest way to add an annotation is to select a text and hit the
 Annotations button
 (&lt;img src=&quot;../../resources/images/icons3/annotation-icon.svg){.icon
-role=&quot;presentation&quot;}) or stroke the keyboard shortcut [Shift]{.kbd} +
-[Ctrl]{.kbd} + [Alt]{.kbd} + [A]{.kbd}. This opens the Annotation pop up
+role=&quot;presentation&quot;}) or stroke the keyboard shortcut 
+      <kbd>Shift</kbd> +
+
+      <kbd>Ctrl</kbd> + 
+      <kbd>Alt</kbd> + 
+      <kbd>A</kbd>. This opens the Annotation pop up
 and place the cursor into the input box where you can write your
 annotation (optional). You can change highlight color and type (Solid
 background, Underline, Strikethrough or Outline) then validate the

epub-doc/en/build/epub/EPUB/pages/300_accessibility/index.xhtml

@@ -66,8 +66,11 @@ size</a>.
       </li>
       <li>
         <p>It is possible to increase the size of an image with
-[Shift+clic]{.kbd} on the image. Repeat several times to enlarge the
-image to the desired size.</p>
+
+          <kbd>Shift</kbd> + 
+          <code>Clic</code> on the image. Repeat several times to enlarge the
+image to the desired size.
+        </p>
       </li>
       <li>
         <p>The display can be selected as paginated or scrolling.</p>