Closed FlorianReimold closed 1 year ago
@FlorianReimold It might be helpful if you based your examples on pages (currently) rendered by the TYPO3 theme. This comes only as an afterthought (the last sentence) and might be misread that this is an issue unrelated to the TYPO3 theme (which would then be closed).
I agree that the screenshots displayed for "New" are unacceptable, but for the code snippet rendered on the TYPO3 docs page https://typo3-documentation.github.io/sphinx_typo3_theme/usage.html this looks ok.
btw. about the color scheme: There is syntax highlighting with dark background now for TypoScript templates in the backend in TYPO3 v12
It might make sense to join forces and combine efforts (also with the accessibility group) to choose a common color scheme for syntax hightlighting.
(Older) related issue: #88
Hello Florian
Newer Sphinx versions seem to bring along structural changes of html. The latest Sphinx version we are using for TYPO3 is 4.5.0.
I assume you are using the latest release of the theme v4.7.9. Note that the release is made from the 'develop' branch of the theme. My next milestone for the work on the theme is to merge the 'develop' branch into 'master' to solve this inconsistency.
To solve your problem look at https://github.com/TYPO3-Documentation/sphinx_typo3_theme/blob/develop/sphinx_typo3_theme/static/css/codeblock.css#L9 You probably can benefit from the last modifications I made in styling code blocks. ALL settings for this are contained in that single CSS file, and it is used in the theme "as it is", that is to say, it is not processed any further by SASS or something like that. Basically you only need to tweak the color definitions at the beginning of the file to change colors. You can even do this "on the fly" in the developer tools of the browser to find out what you like.
If you solve your problem, please report back.
To see a rendering test: https://typo3-documentation.github.io/sphinx_typo3_theme_rendering_test/Highlighting/Index.html
The light color scheme:
This html turns the "light" color scheme on:
Hello,
In the past, I built our eCAL Documentation with
Sphinx 3.5.4
andsphinx-typo3-theme 4.6.2
.Now I upgraded to
Sphinx 5.3.0
andsphinx-typo3-theme 4.7.9
. After this upgrade, I am not satisfied with the display of code blocks anymore:Old:![image](https://user-images.githubusercontent.com/11774314/205329671-552d52be-0501-4249-97a2-bd9c609c85a9.png)
New:![image](https://user-images.githubusercontent.com/11774314/205329706-9ad2a89a-084d-49e7-91b2-1b7812e471a3.png)
As you can see, a dark syntax highlighting is used on the dark background making the code barely readable. Do you have any recommendation on how I can fix that?
Kind Regards Florian
Edit: the sample page shows the same unreadable code: https://typo3-documentation.github.io/sphinx_typo3_theme/usage.html