test: add integration tests for float class modernization

Add integration test covering all float/align scenarios:
- :align: left/right/center on figures (via Twig alignMap)
- :class: float-left/float-right on figures and images (rewritten)
- :align: left/right on standalone images
- Mixed legacy + extra classes (float-left with-shadow)
- Simultaneous :align: + :class: overlap (doubled class, harmless)

Verify deprecation warnings are emitted with correct file/line context
for both FigureDirective (4 warnings) and ImageDirective (2 warnings).

Update render test documentation to use :align: (recommended path)
and remove legacy deprecation examples (covered by integration test).

Author: CybotTM

Documentation-rendertest/ImagesAndFigures/FloatAndAlignment.rst

@@ -13,12 +13,14 @@ Float and alignment
    :local:
 
 
+.. _images-float-image-left:
+
 Image float left
 ================
 
 .. |example-teaser-left| image:: ../images/q150_cccccc.png
    :alt: Left floating image
-   :class: float-left with-shadow
+   :class: float-start with-shadow
 
 |example-teaser-left|
 Typesetting is the composition of text by means of arranging physical
@@ -32,12 +34,14 @@ visual display.
 Floating cleared. Below the image.
 
 
+.. _images-float-image-right:
+
 Image float right
 =================
 
 .. |example-teaser-right| image:: ../images/q150_cccccc.png
    :alt: Right floating image
-   :class: float-right with-shadow
+   :class: float-end with-shadow
 
 |example-teaser-right|
 Typesetting is the composition of text by means of arranging physical
@@ -51,12 +55,15 @@ visual display.
 Floating cleared. Below the image.
 
 
+.. _images-float-figure-left:
+
 Figure float left
 =================
 
 .. figure:: ../images/q150_cccccc.png
    :alt: Left floating figure
-   :class: float-left with-shadow
+   :align: left
+   :class: with-shadow
 
    A figure floated to the left
 
@@ -72,12 +79,15 @@ could be a manuscript, a previously composed version, or a plain text.
 Floating cleared. Below the figure.
 
 
+.. _images-float-figure-right:
+
 Figure float right
 ==================
 
 .. figure:: ../images/q150_cccccc.png
    :alt: Right floating figure
-   :class: float-right with-shadow
+   :align: right
+   :class: with-shadow
 
    A figure floated to the right
 
@@ -93,6 +103,8 @@ could be a manuscript, a previously composed version, or a plain text.
 Floating cleared. Below the figure.
 
 
+.. _images-float-align-left:
+
 Figure align left
 =================
 
@@ -114,6 +126,8 @@ could be a manuscript, a previously composed version, or a plain text.
 Floating cleared. Below the figure.
 
 
+.. _images-float-align-right:
+
 Figure align right
 ==================
 

Documentation-rendertest/ImagesAndFigures/Zoom.rst

@@ -13,6 +13,8 @@ Zoom
    :local:
 
 
+.. _images-zoom-lightbox:
+
 Zoom: Lightbox
 ==============
 
@@ -29,20 +31,24 @@ the bottom-right corner of the image.
      - Shadow
      - Border + Shadow
    * - .. figure:: ../images/q150_f8f8f8.png
+          :alt: Figure with lightbox zoom
           :zoom: lightbox
 
           Figure
      - .. figure:: ../images/q150_eeeeee.png
+          :alt: Figure with lightbox zoom and border
           :zoom: lightbox
           :class: with-border
 
           Figure + border
      - .. figure:: ../images/q150_dddddd.png
+          :alt: Figure with lightbox zoom and shadow
           :zoom: lightbox
           :class: with-shadow
 
           Figure + shadow
      - .. figure:: ../images/q150_cccccc.png
+          :alt: Figure with lightbox zoom, border and shadow
           :zoom: lightbox
           :class: with-border with-shadow
 
@@ -64,6 +70,8 @@ the bottom-right corner of the image.
           :class: with-border with-shadow
 
 
+.. _images-zoom-gallery:
+
 Zoom: Gallery
 =============
 
@@ -78,18 +86,21 @@ Gallery Group A (screenshots):
    :widths: 33 33 33
 
    * - .. figure:: ../images/q150_f8f8f8.png
+          :alt: Screenshot 1 in gallery group
           :zoom: gallery
           :gallery: screenshots
           :class: with-border with-shadow
 
           Screenshot 1
      - .. figure:: ../images/q150_eeeeee.png
+          :alt: Screenshot 2 in gallery group
           :zoom: gallery
           :gallery: screenshots
           :class: with-border with-shadow
 
           Screenshot 2
      - .. figure:: ../images/q150_dddddd.png
+          :alt: Screenshot 3 in gallery group
           :zoom: gallery
           :gallery: screenshots
           :class: with-border with-shadow
@@ -113,6 +124,8 @@ Gallery Group B (photos):
           :class: with-border with-shadow
 
 
+.. _images-zoom-lens:
+
 Zoom: Lens
 ==========
 
@@ -130,20 +143,24 @@ keyboard (Enter to toggle, arrows to move) for accessibility.
      - Shadow
      - Border + Shadow
    * - .. figure:: ../images/q150_f8f8f8.png
+          :alt: Figure with lens zoom
           :zoom: lens
 
           Figure
      - .. figure:: ../images/q150_eeeeee.png
+          :alt: Figure with lens zoom and border
           :zoom: lens
           :class: with-border
 
           Figure + border
      - .. figure:: ../images/q150_dddddd.png
+          :alt: Figure with lens zoom and shadow
           :zoom: lens
           :class: with-shadow
 
           Figure + shadow
      - .. figure:: ../images/q150_cccccc.png
+          :alt: Figure with lens zoom, border and shadow
           :zoom: lens
           :class: with-border with-shadow
 
@@ -165,6 +182,8 @@ keyboard (Enter to toggle, arrows to move) for accessibility.
           :class: with-border with-shadow
 
 
+.. _images-zoom-inline:
+
 Zoom: Inline
 ============
 
@@ -181,20 +200,24 @@ icon indicates scroll zoom is available. Keyboard: +/- to zoom, arrows to pan.
      - Shadow
      - Border + Shadow
    * - .. figure:: ../images/q150_f8f8f8.png
+          :alt: Figure with inline zoom
           :zoom: inline
 
           Figure
      - .. figure:: ../images/q150_eeeeee.png
+          :alt: Figure with inline zoom and border
           :zoom: inline
           :class: with-border
 
           Figure + border
      - .. figure:: ../images/q150_dddddd.png
+          :alt: Figure with inline zoom and shadow
           :zoom: inline
           :class: with-shadow
 
           Figure + shadow
      - .. figure:: ../images/q150_cccccc.png
+          :alt: Figure with inline zoom, border and shadow
           :zoom: inline
           :class: with-border with-shadow
 
@@ -216,7 +239,9 @@ icon indicates scroll zoom is available. Keyboard: +/- to zoom, arrows to pan.
           :class: with-border with-shadow
 
 
-Zoom Indicator Options
+.. _images-zoom-indicator-options:
+
+Zoom indicator options
 ======================
 
 The zoom indicator can be hidden using ``:zoom-indicator: false``:
@@ -227,11 +252,13 @@ The zoom indicator can be hidden using ``:zoom-indicator: false``:
    * - With indicator (default)
      - Without indicator
    * - .. figure:: ../images/q150_f8f8f8.png
+          :alt: Figure with zoom indicator visible
           :zoom: lightbox
           :class: with-border with-shadow
 
           Indicator visible
      - .. figure:: ../images/q150_eeeeee.png
+          :alt: Figure with zoom indicator hidden
           :zoom: lightbox
           :zoom-indicator: false
           :class: with-border with-shadow