[GRASS-git] [OSGeo/grass] 36f302: CMake: Build the MkDocs documentation site (#7719)

[Anna Petrasova]

  Branch: refs/heads/main
  Home:   https://github.com/OSGeo/grass
  Commit: 36f3025aebf81700826b98cc65be1006a9db441e
      https://github.com/OSGeo/grass/commit/36f3025aebf81700826b98cc65be1006a9db441e
  Author: Anna Petrasova <kratochanna at gmail.com>
  Date:   2026-07-16 (Thu, 16 Jul 2026)

  Changed paths:
    M .github/workflows/cmake.yml
    M CMakeLists.txt
    M cmake/modules/generate_docs.cmake
    M display/CMakeLists.txt
    M doc/CMakeLists.txt
    A doc/development/CMakeLists.txt
    M gui/icons/CMakeLists.txt
    M man/CMakeLists.txt
    M man/build_manpages.py

  Log Message:
  -----------
  CMake: Build the MkDocs documentation site (#7719)

Make the markdown documentation tree complete enough to build the
MkDocs site, and add build-mkdocs and serve-mkdocs targets matching
the Autotools ones (both run mkdocs from PATH and are not part of the
default build).

Copy the site files from man/mkdocs (mkdocs.yml, index and keywords
pages, theme overrides, CSS, logo) into the markdown tree. Add an
MD_ONLY mode to generate_docs for the web-only guides from doc/ and
doc/development/, which have no HTML source and no man page. Exclude
those pages from man page generation with a new --exclude option in
build_manpages.py, derived from the doc/ directories like WEB_ONLY_MD
in man/Makefile. Copy the assets linked from the pages (GUI icons,
color tables, barscale and north arrow thumbnails, grass_logo.txt)
into the markdown tree alongside their existing html copies.

AI assistance (Claude Fable)



To unsubscribe from these emails, change your notification settings at https://github.com/OSGeo/grass/settings/notifications