diff --git a/docs/docsite/Makefile.sphinx b/docs/docsite/Makefile.sphinx index 3b4280e554..9e87abb226 100644 --- a/docs/docsite/Makefile.sphinx +++ b/docs/docsite/Makefile.sphinx @@ -2,11 +2,12 @@ # # You can set these variables from the command line. +LLM_DEFINES ?= EXTRA_TAGS ?= DOCS_VARIANTS ?= SPHINXCONFDIR = rst LANGOPTS ?= -SPHINXOPTS ?= -j $(CPUS) -n -w rst_warnings -c "$(SPHINXCONFDIR)" $(DOCS_VARIANTS) $(EXTRA_TAGS) $(LANGOPTS) +SPHINXOPTS ?= -j $(CPUS) -n -w rst_warnings -c "$(SPHINXCONFDIR)" $(DOCS_VARIANTS) $(EXTRA_TAGS) $(LANGOPTS) $(LLM_DEFINES) SPHINXBUILD = sphinx-build SPHINXPROJ = sdfsdf SOURCEDIR = rst diff --git a/docs/docsite/rst/conf.py b/docs/docsite/rst/conf.py index ff66abc3b7..244475863e 100644 --- a/docs/docsite/rst/conf.py +++ b/docs/docsite/rst/conf.py @@ -71,6 +71,7 @@ 'notfound.extension', 'sphinx_antsibull_ext', # provides CSS for the plugin/module docs generated by antsibull 'sphinx_copybutton', + 'sphinx_llms_txt', # generates LLM friendly content with the llms.txt standard ] # Later on, add 'sphinx.ext.viewcode' to the list if you want to have diff --git a/tests/requirements.in b/tests/requirements.in index 354269ef8f..c8b33eb6fc 100644 --- a/tests/requirements.in +++ b/tests/requirements.in @@ -10,6 +10,7 @@ sphinx-intl # translation utility used by docs/docsite/Makefile sphinx-notfound-page # extension used for the custom 404 page (cowsay) sphinx-ansible-theme # extension used for the custom docs theme sphinx-reredirects # extension to create redirects for moved pages +sphinx-llms-txt # generates LLM friendly plain text sphinx-rtd-theme rstcheck antsibull-docutils >= 1.3.0 # rst-yamllint checker diff --git a/tests/requirements.txt b/tests/requirements.txt index e3d1a783b0..9d0407edeb 100644 --- a/tests/requirements.txt +++ b/tests/requirements.txt @@ -174,6 +174,8 @@ sphinx-copybutton==0.5.2 # via -r tests/requirements.in sphinx-intl==2.3.2 # via -r tests/requirements.in +sphinx-llms-txt==0.5.2 + # via -r tests/requirements.in sphinx-notfound-page==1.1.0 # via -r tests/requirements.in sphinx-reredirects==0.1.6