fix: correct heading underline characters for TYPO3 convention

When ImageZoom.rst and ImageAlignment.rst were extracted from Images.rst
into their own pages, heading underline characters were not promoted to
match the new document hierarchy. Sections that were h3/h4 in the parent
document need to become h2/h3 as standalone pages.

TYPO3 heading convention:
- h1: = above and below (page title)
- h2: = below only (sections)
- h3: - below only (subsections)
- h4: ~ below only (sub-subsections)

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>

Author: CybotTM

Documentation/Reference/ReStructuredText/Graphics/ImageAlignment.rst

@@ -30,7 +30,7 @@ preference.
 .. _image-float-css-classes:
 
 Float with CSS classes
-----------------------
+======================
 
 Add ``float-left`` or ``float-right`` to the ``:class:`` option. You can combine
 these with other classes such as ``with-shadow`` or ``with-border``:
@@ -48,7 +48,7 @@ these with other classes such as ``with-shadow`` or ``with-border``:
 .. _image-float-align-option:
 
 Align option
-------------
+============
 
 The ``:align:`` option on ``..  figure::`` directives supports ``left``, ``right``,
 and ``center``. Values ``left`` and ``right`` produce the same floating behavior
@@ -69,7 +69,7 @@ Using ``:align: center`` centers the figure without any text wrapping.
 .. _image-float-clearing:
 
 Clearing floats
----------------
+===============
 
 After a floated image, you may want subsequent content to appear below the
 image rather than wrapping around it. Use the ``clear-both`` class to clear
@@ -95,7 +95,7 @@ property to the next element, forcing it below any floated content.
 .. _image-float-responsive:
 
 Responsive behavior
--------------------
+===================
 
 Floated images automatically switch to full-width block display on small
 screens (below 576px). This ensures readable text on mobile devices
@@ -104,7 +104,7 @@ without horizontal scrolling.
 .. _image-float-example-8:
 
 Example 8: Figure floated left
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------
 
 ..  figure:: /_Images/a4.jpg
     :alt: Example figure floated left
@@ -137,7 +137,7 @@ Typesetting requires one or more fonts.
 .. _image-float-example-9:
 
 Example 9: Figure aligned right
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------------
 
 ..  figure:: /_Images/a4.jpg
     :alt: Example figure aligned right
@@ -170,7 +170,7 @@ Typesetting requires one or more fonts.
 .. _image-float-example-10:
 
 Example 10: Image floated left with shadow
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------------------
 
 ..  image:: /_Images/a4.jpg
     :alt: Example image floated left
@@ -199,7 +199,7 @@ Typesetting requires one or more fonts.
 .. _image-float-best-practices:
 
 Best practices for floating
-----------------------------
+============================
 
 *   Always use ``..  rst-class:: clear-both`` after floated content to prevent
     layout issues with subsequent sections

Documentation/Reference/ReStructuredText/Graphics/ImageZoom.rst

@@ -18,7 +18,7 @@ the documentation page.
 .. _image-zoom-modes:
 
 Available zoom modes
---------------------
+====================
 
 The zoom functionality is controlled by the `:zoom:` option on figure
 and image directives. The following zoom modes are available:
@@ -59,7 +59,7 @@ and image directives. The following zoom modes are available:
 .. _image-zoom-options:
 
 Directive options
------------------
+=================
 
 The following options are available for the figure and image directives:
 
@@ -83,12 +83,12 @@ The following options are available for the figure and image directives:
 .. _image-zoom-examples:
 
 Usage examples
---------------
+==============
 
 .. _image-zoom-example-3:
 
 Example 3: Lightbox zoom
-~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------
 
 ..  figure:: /_Images/a4.jpg
     :alt: Example screenshot
@@ -109,7 +109,7 @@ Example 3: Lightbox zoom
 .. _image-zoom-example-4:
 
 Example 4: Gallery mode with grouped images
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------------------------
 
 ..  code-block:: rst
 
@@ -130,7 +130,7 @@ Example 4: Gallery mode with grouped images
 .. _image-zoom-example-5:
 
 Example 5: Inline scroll-wheel zoom
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------------
 
 ..  code-block:: rst
 
@@ -143,7 +143,7 @@ Example 5: Inline scroll-wheel zoom
 .. _image-zoom-example-6:
 
 Example 6: Magnifier lens
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------
 
 ..  code-block:: rst
 
@@ -156,7 +156,7 @@ Example 6: Magnifier lens
 .. _image-zoom-example-7:
 
 Example 7: Hidden zoom indicator
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+---------------------------------
 
 ..  code-block:: rst
 
@@ -170,14 +170,14 @@ Example 7: Hidden zoom indicator
 .. _image-zoom-accessibility:
 
 Accessibility considerations
------------------------------
+=============================
 
 All zoom modes are designed with accessibility in mind:
 
 .. _image-zoom-keyboard:
 
 Keyboard navigation
-~~~~~~~~~~~~~~~~~~~
+-------------------
 
 *   **Lightbox and Gallery modes**: Full keyboard support
 
@@ -204,7 +204,7 @@ Keyboard navigation
 .. _image-zoom-screen-reader:
 
 Screen reader support
-~~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
 All zoom modes maintain proper ARIA attributes and provide descriptive
 labels for assistive technologies. Always use the `:alt:` option to
@@ -213,15 +213,15 @@ provide descriptive alternative text for images.
 .. _image-zoom-reduced-motion:
 
 Reduced motion support
-~~~~~~~~~~~~~~~~~~~~~~~
+----------------------
 
 The zoom functionality respects the `prefers-reduced-motion` media query.
 When reduced motion is preferred, transitions and animations are disabled.
 
 .. _image-zoom-best-practices:
 
 Best practices
---------------
+==============
 
 *   Always include descriptive `:alt:` text for accessibility
 *   Use `lightbox` as the default for most images