docs: document image/figure float and alignment#510
Merged
linawolf merged 2 commits intoTYPO3-Documentation:mainfrom Mar 1, 2026
Merged
docs: document image/figure float and alignment#510linawolf merged 2 commits intoTYPO3-Documentation:mainfrom
linawolf merged 2 commits intoTYPO3-Documentation:mainfrom
Conversation
CybotTM
force-pushed
the
docs/image-float-alignment
branch
from
5752e02 to
d9f27c3
Compare
Add documentation for the new CSS float and alignment support for images and figures introduced in render-guides 0.37.0. Split the monolithic Images.rst into three focused pages: - Images.rst: basics, parameters, Examples 1-2 - ImageZoom.rst: zoom modes, options, accessibility, Examples 3-7 - ImageAlignment.rst: float/align, clearing, responsive, Examples 8-10 Depends on: TYPO3-Documentation/render-guides#1174
CybotTM
force-pushed
the
docs/image-float-alignment
branch
from
d9f27c3 to
8c4d0e2
Compare
linawolf
reviewed
Feb 28, 2026
linawolf
reviewed
Feb 28, 2026
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>
CybotTM
added a commit
to netresearch/typo3-docs-skill
that referenced
this pull request
Feb 28, 2026
…s.sh
Two issues fixed:
1. **Bug fix**: `((WARNINGS++))` and `((ERRORS++))` with `set -e` causes
the script to exit prematurely when the counter is 0, because bash
treats `((0))` as falsy (exit code 1). Replaced with
`WARNINGS=$((WARNINGS + 1))` which always succeeds.
2. **New check**: Added TYPO3 heading hierarchy validation that detects:
- First section heading not using `=` (h2) — catches the common issue
where sections extracted from a parent page retain their old heading
levels (e.g. `-` for h3 instead of `=` for h2)
- Non-standard underline characters (e.g. `^` instead of `=/-/~`)
- Skipped heading levels (e.g. h2 directly to h4 without h3)
The check follows TYPO3 heading convention:
- h1: `=` above and below (page title)
- h2: `=` below only (sections)
- h3: `-` below only (subsections)
- h4: `~` below only (sub-subsections)
This would have caught the heading issues reported in
TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument#510.
Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
3 tasks
linawolf
approved these changes
Mar 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Important
Depends on TYPO3-Documentation/render-guides#1174 — this PR documents features that require render-guides 0.37.0.
Summary
Images.rstinto three focused pages::class:and:align:to the optional parameters list with cross-referencesContext
The render-guides 0.37.0 release will add CSS float/alignment support for images and figures. This PR adds the corresponding user documentation.
Test plan
:ref:image-zoom,:ref:image-float-alignment) resolve correctly across the split files