Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GDAL "Rasterize (overwrite *)" algs help pages: not properly opened clicking the processing's Help button in Desktop #9479

Open
agiudiceandrea opened this issue Dec 15, 2024 · 1 comment

Comments

@agiudiceandrea
Copy link
Contributor

agiudiceandrea commented Dec 15, 2024

Description

Clicking the Help button of the "Rasterize (overwrite with attribute)" (gdal:rasterize_over) and the "Rasterize (overwrite with fixed value)" (gdal:rasterize_over_fixed_value) processing algorithm's dialog window in QGIS Desktop, the pages at https://docs.qgis.org/3.34/en/docs/user_manual/processing_algs/gdal/vectorconversion.html#gdalrasterize_over and https://docs.qgis.org/3.34/en/docs/user_manual/processing_algs/gdal/vectorconversion.html#gdalrasterize_over_fixed_value will be opened. Anyway the pages are not displayed at the correct internal section corresponding to the algorithm.
The issue doesn't occur for "Rasterize (vector to raster)" and "Convert format" GDAL algorithms in the same "Vector conversion" group.

The issue occurs using both Google Chrome 131.0.6778.140 and Mozilla Firefox 133.0.3 on Windows 10.

Page URL:

@DelazJ
Copy link
Collaborator

DelazJ commented Dec 15, 2024

Hi @agiudiceandrea
Thanks for catching up.
From a quick glance, this is due to the "_" character in the algs id (gdal:rasterize_over), hence in their anchor (gdalrasterize_over). When there is an underscore in an anchor, Sphinx, presumabily, generates a URL where this is replaced with "-". So the generated link in the docs are https://docs.qgis.org/3.34/en/docs/user_manual/processing_algs/gdal/vectorconversion.html#gdalrasterize-over and https://docs.qgis.org/3.34/en/docs/user_manual/processing_algs/gdal/vectorconversion.html#gdalrasterize-over-fixed-value while QGIS would always look for a URL with underscore.
To have the correct link displayed, and because I'm not sure we can redirect in docs, a proper fix would be IMHO to alias these algs to an id without underscore (rasterizeover and rasterizeoverfixedvalue) in QGIS itself. I don't have QGIS around but browsing the docs, we usually don't use such characters in algs id, only letters. So they'd be aligned with the others and we could set this (only [a-z] characters) up as a rule for algs id.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants