From 1efe93f1596fc0e2fbd4bc2d1a7ad762ff8aef20 Mon Sep 17 00:00:00 2001 From: rchac Date: Tue, 19 Aug 2025 19:50:15 -0600 Subject: [PATCH] spanish docs --- docs-es/.readthedocs.yaml | 24 ++++++++++ docs-es/conf.py | 42 +++++++++++++++++ docs-es/index.rst | 99 +++++++++++++++++++++++++++++++++++++++ docs-es/requirements.txt | 3 ++ 4 files changed, 168 insertions(+) create mode 100644 docs-es/.readthedocs.yaml create mode 100644 docs-es/conf.py create mode 100644 docs-es/index.rst create mode 100644 docs-es/requirements.txt diff --git a/docs-es/.readthedocs.yaml b/docs-es/.readthedocs.yaml new file mode 100644 index 00000000..f0ed004a --- /dev/null +++ b/docs-es/.readthedocs.yaml @@ -0,0 +1,24 @@ +# Read the Docs configuration file for Spanish documentation +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +# Set the OS, Python version and other tools you might need +build: + os: ubuntu-22.04 + tools: + python: "3.11" + +# Build documentation in the "docs-es/" directory with Sphinx +sphinx: + configuration: docs-es/conf.py + # Fail on all warnings to avoid broken references + # fail_on_warning: true + +# Optional but recommended, declare the Python requirements required +# to build your documentation +# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html +python: + install: + - requirements: docs-es/requirements.txt \ No newline at end of file diff --git a/docs-es/conf.py b/docs-es/conf.py new file mode 100644 index 00000000..2a77e4fb --- /dev/null +++ b/docs-es/conf.py @@ -0,0 +1,42 @@ +# Configuration file for the Sphinx documentation builder. +# +# For the full list of built-in configuration values, see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Project information ----------------------------------------------------- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information + +project = "LibreQoS" +copyright = "2024, LibreQoE, LLC" +author = "Zach Biles" +release = "2.0" + +# -- General configuration --------------------------------------------------- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration + +extensions = ["myst_parser"] + +templates_path = ["_templates"] +exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] + +# Language configuration +language = "es" + +# -- Options for HTML output ------------------------------------------------- +# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output + +html_theme = "sphinx_rtd_theme" +html_static_path = ["_static"] + +# Localization settings +locale_dirs = ["locale/"] +gettext_compact = False + +# Theme options +html_theme_options = { + 'navigation_depth': 4, + 'collapse_navigation': False, + 'sticky_navigation': True, + 'includehidden': True, + 'titles_only': False +} \ No newline at end of file diff --git a/docs-es/index.rst b/docs-es/index.rst new file mode 100644 index 00000000..962347a3 --- /dev/null +++ b/docs-es/index.rst @@ -0,0 +1,99 @@ +.. LibreQoS documentation master file - Spanish version + +Bienvenido a la documentación de LibreQoS +========================================== + +.. toctree:: + :maxdepth: 1 + :caption: Primeros Pasos + + v2.0/design-es + v2.0/requirements-es + +.. toctree:: + :maxdepth: 1 + :caption: Implementando LibreQoS (v1.5 a v2.0): + + v2.0/prereq-es + v2.0/ubuntu-server-es + v2.0/bridge-es + v2.0/quickstart-es + v2.0/configuration-es + v2.0/components-es + v2.0/integrations-es + v2.0/lts-es + v2.0/Updates/update + v2.0/troubleshooting-es + v2.0/cake-es + v2.0/git-install-es + +.. toctree:: + :maxdepth: 1 + :caption: Inicio Rápido (v2.0): + + v2.0/Quickstart/quickstart-prereq + v2.0/Quickstart/quickstart-libreqos-2.0 + v2.0/Quickstart/configuration + v2.0/Quickstart/services-and-run + v2.0/Quickstart/share + +.. toctree:: + :maxdepth: 1 + :caption: Documentos Técnicos (v2.0): + + v2.0/TechnicalDocs/git-install + v2.0/TechnicalDocs/troubleshooting + v2.0/TechnicalDocs/integrations + v2.0/TechnicalDocs/extras + v2.0/TechnicalDocs/performance-tuning + +.. toctree:: + :maxdepth: 1 + :caption: Documentación Heredada (v1.4): + + Quickstart/quickstart-prereq + Quickstart/quickstart-libreqos-1.4 + Quickstart/configuration + Quickstart/services-and-run + Quickstart/share + Quickstart/networkdesignassumptions + +.. toctree:: + :maxdepth: 1 + :caption: Actualizaciones: + + Updates/update + +.. toctree:: + :maxdepth: 1 + :caption: Documentos Técnicos (v1.4): + + TechnicalDocs/complex-install + TechnicalDocs/troubleshooting + TechnicalDocs/integrations + TechnicalDocs/extras + +.. toctree:: + :maxdepth: 1 + :caption: Notas de Cambios: + + ChangeNotes/v1.5 + +.. toctree:: + :maxdepth: 1 + :caption: Versiones Anteriores: + + Legacy/v1.3.1 + +.. toctree:: + :maxdepth: 1 + :caption: Requisitos del Sistema: + + SystemRequirements/Compute + +Índices y tablas +================ + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` \ No newline at end of file diff --git a/docs-es/requirements.txt b/docs-es/requirements.txt new file mode 100644 index 00000000..17ed7e25 --- /dev/null +++ b/docs-es/requirements.txt @@ -0,0 +1,3 @@ +sphinx==6.2.1 +sphinx_rtd_theme +myst-parser \ No newline at end of file