[Bug] docs: remaining issues with markdown manual using mkdocs

[neteler]

Describe the bug

After the important work in #3849 to enable a markdown based manual using mkdocs this report collects yet open issues.

Issue collection

• [ ] intro page: missing GUI introduction page
  • addressed in #4746
• [ ] wxGUI pages: dist.x86_64-pc-linux-gnu/docs/mkdocs/site/wxGUI.md and related are missing from mkdocs:
  • WARNING - Doc file 'g.gui.rdigit.md' contains a link 'wxGUI.md', but the target is not found among documentation files.
  • WARNING - Doc file 'g.gui.rdigit.md' contains a link 'wxGUI.components.md', but the target is not found among documentation files., etc.
• [ ] icons: the GUI icons/ directory is yet missing: dist.x86_64-pc-linux-gnu/docs/mkdocs/site/icons/ (see wxGUI.md etc. which needs it)
• [ ] barscales PNG files : WARNING - Doc file 'd.barscale.md' contains a link 'barscales/classic.png', but the target is not found among documentation files.
• [ ] colortables PNG files : WARNING - Doc file 'd.vect.md' contains a link 'colortables/population_dens.png', but the target is not found among documentation files. etc.
• [ ] northarrows PNG files : WARNING - Doc file 'd.northarrow.md' contains a link 'northarrows/9.png', but the target is not found among documentation files.
• [ ] keywords: missing dash instead of white space (maybe to be fixed in lib/gis/parser_rest_md.c" line 507?):
  • example dist.x86_64-pc-linux-gnu/docs/mkdocs/site/keywords.html#map management should be dist.x86_64-pc-linux-gnu/docs/mkdocs/site/keywords.html#map-management
• [ ] topic filenames contain white spaces in MD filenames:
  • 'topic_time management.md': file name should better be 'topic_time_management.md' (underscore rather than white space)
  • maybe somewhere around https://github.com/OSGeo/grass/blob/bea8435a9e84b0e9789cac03aaa5bb9d619194c9/man/build_topics.py#L81
• [ ] keywords anchors: warnings in build-mkdocs step (cd man; make build-mkdocs):
  • Doc file 'topic_time management.md' contains a link 'keywords.md#time management', but the doc 'keywords.md' does not contain an anchor '#time management'. -> it should be 'keywords.md#time-management'`

[neteler]

keywords: missing dash instead of white space (maybe to be fixed in lib/gis/parser_rest_md.c" line 507?):

This seems to help:

--- a/lib/gis/parser_rest_md.c
+++ b/lib/gis/parser_rest_md.c
@@ -537,7 +537,7 @@ void print_escaped_for_md_keywords(FILE *f, const char *str)
         else {
             /* keyword index */
             char *str_link;
-            str_link = G_str_replace(str_s, " ", "%20");
+            str_link = G_str_replace(str_s, " ", "-");
             G_str_to_lower(str_link);
             fprintf(f, "[%s](keywords.md#%s)", str_s, str_link);
             G_free(str_link);

Does it make sense, @landam?