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

doc: Enable Markdown doc compilation #5048

Draft
wants to merge 17 commits into
base: main
Choose a base branch
from

Conversation

wenzeslaus
Copy link
Member

The initial commit simply uncoments the Markdown compilation lines from #3849. This requires the actual Markdown files to be present, so this breaks the CI. This will stay like this for now. The PR is mean to be tested together with the Markdown files generated by script in #4620 (switch to this branch after generating the files).

Subsequent commits will add fixes of the compilation (missing tools, files, etc.).

The initial commit simply uncoments the Markdown compilation lines from OSGeo#3849. This requires the actual Markdown files to be present, so this breaks the CI. This will stay like this for now. The PR is mean to be tested together with the Markdown files generated by script in OSGeo#4620 (switch to this branch after generating the files).

Subsequent commits will add fixes of the compilation (missing tools, files, etc.).
…eral and assumes that HTML will be eventually removed (the thumbnails are generated twice now, once for HTML and once of Markdown).
@github-actions github-actions bot added raster Related to raster data processing Python Related code is in Python module labels Feb 5, 2025
@github-actions github-actions bot added the GUI wxGUI related label Feb 5, 2025
@@ -83,6 +84,11 @@
font-style: italic;
}
</style>
"""

header_graphical_index_tmpl = f"""\
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[ruff] reported by reviewdog 🐶

Suggested change
header_graphical_index_tmpl = f"""\
header_graphical_index_tmpl = f"""\

short_family, module_family, imgs, year=year, skip_no_image=False
)
else:
raise ValueError(f"Unknown format: {output_format}")
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[ruff] reported by reviewdog 🐶

Suggested change
raise ValueError(f"Unknown format: {output_format}")
msg = f"Unknown format: {output_format}"
raise ValueError(msg)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
display docs GUI wxGUI related module Python Related code is in Python raster Related to raster data processing
Projects
Status: In Progress
Development

Successfully merging this pull request may close these issues.

3 participants