Add meta tag description for most pages

Author: dalito

docs/conf.py

@@ -35,6 +35,7 @@
 html_static_path = ['_static']
 html_favicon = '_static/favicon_32.png'
 html_last_updated_fmt = '%Y-%m-%d'
+html_extra_path = ['_extra']  # files to copy to output root
 
 # -- Options for todo extension -----------------------------------
 # https://www.sphinx-doc.org/en/master/usage/extensions/todo.html#module-sphinx.ext.todo

docs/docs_maintenance/creating-docs-locally.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Build docs locally with Python/uv, install requirements, run sphinx-build, and preview vocabulary HTML. Learn more here."
+---
+
 # Building the docs locally
 
 You need on your computer:

docs/docs_maintenance/handling-ID-requests.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Maintainer steps to update vocabulary ID ranges: pull main, edit idranges.toml, commit, push, open PR, and clean up branches. Learn more here."
+---
+
 # Handling ID-requests
 
 ```{note} This guide is only relevant for maintainers with commit rights.

docs/docs_maintenance/making-releases.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Release checklist for the vocabulary: prepare branch, update docs and metadata, tag vYYYY-MM-DD, monitor publish workflow, verify URLs. Learn more here."
+---
+
 # Making Releases
 
 ```{note} This guide is only relevant for maintainers with commit rights.

docs/docs_usage/about.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Voc4Cat project context: community, curator governance, citations, licensing, and funding for the vocabulary and tools. Learn more here."
+---
+
 # About Voc4Cat
 
 ## Community

docs/docs_usage/guidelines.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Editorial rules for Voc4Cat vocabulary and terminology: labels, definitions, spelling, grammar, typography, and SKOS mappings. Learn more here."
+---
+
 # Guidelines for Voc4Cat
 
 The Voc4Cat guidelines have been developed as a blueprint for

docs/docs_usage/how-to-contribute.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Contribution guide for the Voc4Cat vocabulary: Learn how to request IDs, edit voc4cat.xlsx, and submit a PR with Excel updates."
+---
+
 # How to contribute to Voc4Cat?
 
 The contribution process is almost the same as in source code repositories.

docs/docs_usage/organizing-concepts.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Learn how Voc4Cat is organised, from top concepts to its use of different hierarchy types like IS-A, HAS-A or PART-OF."
+---
+
 # Hierarchies, Relations, and Collections
 
 ## The Three Fundamental Semantic Relations

docs/docs_usage/published-guidelines.md

@@ -1,3 +1,9 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Citation details for published Voc4Cat vocabulary guidelines on Zenodo and the canonical online version. Learn more here."
+---
+
 # Published Voc4Cat Guidelines
 
 ````{admonition} Suggested citation for the most current version [published on Zenodo](https://doi.org/10.5281/zenodo.15006962)

docs/index.md

@@ -1,5 +1,8 @@
 ---
 hide-toc: true
+myst:
+  html_meta:
+    "description lang=en": "Voc4Cat vocabulary for catalysis: docs, releases, RDF downloads, and why curated terms support FAIR data. Learn more here."
 ---
 
 # Welcome to Voc4Cat