Added more improvements and upgraded the dependencies

.gitignore

@@ -9,9 +9,12 @@ __pycache__/
 
 # Distribution / packaging
 .Python
+.env
+.sass-cache
 env/
 bin/
 build/
+bnk/
 develop-eggs/
 dist/
 eggs/
@@ -24,6 +27,8 @@ parts/
 sdist/
 var/
 venv/
+py3.*/
+*.bnk
 *.egg-info/
 .installed.cfg
 *.egg
@@ -62,3 +67,6 @@ docs/_build/
 # Sublime Text
 *.sublime-project
 *.sublime-workspace
+
+# Visual Studio Code
+*.code-workspace

.readthedocs.yml → .readthedocs.yaml

@@ -1,20 +1,32 @@
-# .readthedocs.yml
+# .readthedocs.yaml
 # Read the Docs configuration file
 # 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"
+    # You can also specify other tool versions:
+    # nodejs: "20"
+    # rust: "1.70"
+    # golang: "1.20"
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: source/conf.py
 
 # Optionally build your docs in additional formats such as PDF and ePub
+# formats: all
+#    - pdf
+#    - epub
 formats:
   - htmlzip
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.7
   install:
     - requirements: requirements.txt

Makefile

@@ -5,8 +5,8 @@
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 PAPER         =
-BUILDDIR      = build
 SOURCEDIR     = source
+BUILDDIR      = build
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4

requirements.txt

@@ -1,30 +1,75 @@
-# https://pypi.org/project/sphinx-immaterial/
-Jinja2==3.1.2
-Pygments==2.13.0
-alabaster==0.7.12
-appdirs==1.4.4
-babel==2.10.3
-certifi==2022.6.15
-charset-normalizer==2.1.1
-docutils==0.19
-idna==3.3
+# https://pypi.org/project/Sphinx/
+alabaster==1.0.0
+babel==2.17.0
+charset-normalizer==3.4.1
+certifi==2025.1.31
+docutils==0.21.2
+idna==3.10
 imagesize==1.4.1
-importlib-metadata==4.12.0
-markupsafe==2.1.1
-packaging==21.3
-pydantic==1.10.1
-pyparsing==3.0.9
-pytz==2022.2.1
-requests==2.28.1
+Jinja2==3.1.5
+MarkupSafe==3.0.2
+packaging==24.2
+Pygments==2.19.1
+requests==2.32.3
+roman-numerals-py==3.1.0
 snowballstemmer==2.2.0
-sphinx==5.1.1
-sphinx-immaterial==0.9.0
-sphinxcontrib-applehelp==1.0.2
-sphinxcontrib-devhelp==1.0.2
-sphinxcontrib-htmlhelp==2.0.0
+Sphinx==8.2.1
+sphinxcontrib-applehelp==2.0.0
+sphinxcontrib-devhelp==2.0.0
+sphinxcontrib-htmlhelp==2.1.0
 sphinxcontrib-jsmath==1.0.1
-sphinxcontrib-qthelp==1.0.3
-sphinxcontrib-serializinghtml==1.1.5
-typing-extensions==4.3.0
-urllib3==1.26.12
-zipp==3.8.1
+sphinxcontrib-qthelp==2.0.0
+sphinxcontrib-serializinghtml==2.0.0
+urllib3==2.3.0
+
+# https://pypi.org/project/sphinx-immaterial/
+annotated-types==0.7.0
+appdirs==1.4.4
+pydantic==2.10.6
+pydantic-core==2.27.2
+pydantic-extra-types==2.10.2
+sphinx-immaterial==0.13.0
+typing-extensions==4.12.2
+
+# sphinx-immaterial[keys] https://pypi.org/project/sphinx-immaterial/
+markdown==3.7
+pymdown-extensions==10.14.3
+pyyaml==6.0.2
+
+# https://pypi.org/project/ipython/
+# asttokens==3.0.0
+# decorator==5.2.1
+# executing==2.2.0
+# ipython==8.32.0
+# jedi==0.19.2
+# matplotlib-inline==0.1.7
+# parso==0.8.4
+# pexpect==4.9.0
+# prompt_toolkit==3.0.50
+# ptyprocess==0.7.0
+# pure-eval==0.2.3
+# stack_data==0.6.3
+# traitlets==5.14.3
+# wcwidth==0.2.13
+
+# https://pypi.org/project/sphinxcontrib-email/
+lxml==5.3.1
+sphinxcontrib-email==0.3.6
+
+# https://pypi.org/project/yasfb/
+cssselect==1.2.0
+pyquery==2.0.1
+yasfb==0.8.0
+
+# https://pypi.org/project/sphinx-disqus/
+# sphinx-disqus==1.3.0
+# sphinx-disqus==1.2.0
+
+# https://github.com/bonartm/sphinxcontrib-quizdown
+# sphinxcontrib-quizdown @ git+https://github.com/bonartm/sphinxcontrib-quizdown.git@d9f24a7a2305ad5b196e06597b1779c9414d1d85
+
+# https://pypi.org/project/sphinx_contributors/
+sphinx_contributors==0.2.7
+
+# https://pypi.org/project/sphinx-tabs/
+sphinx-tabs==3.4.7

source/_templates/base.html

@@ -0,0 +1,63 @@
+{% extends '!base.html' %}
+
+    <!-- Meta tags -->
+    {%- block site_meta %}
+      <meta charset="utf-8" />
+      <meta name="viewport" content="width=device-width,initial-scale=1" />
+      <meta name="keywords" content="Python, Python 2.7, Python 3, Aprende Python, Funciones, Clases, Libreria estandar, Python nivel básico, nivel, básico, introductorio, básico, Aprende, contenido, Creative Commons, Venezuela, entrenamiento, practicas, curso, tutorial, Programación, software, código fuente, ejemplos, Sphinx, documentation, builder">
+
+      <!-- Primary Meta Tags -->
+      <meta name="title" content="Aprende Python desde el nivel más básico">
+      <meta name="robots" content="index, follow">
+      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+      <meta name="language" content="Spanish">
+
+      <!-- Page description -->
+      <meta name="description" content="Materiales del entrenamiento de programación en Python - Nivel básico, con ejemplos prácticos">
+
+      <!-- Page author -->
+      <meta name="author" content="Leonardo J. Caballero G.">
+
+      <!-- Canonical -->
+      <link rel="canonical" href="https://entrenamiento-python-basico.readthedocs.io/es/latest/" />
+
+      <!-- Favicon -->
+      <link rel="apple-touch-icon" sizes="57x57" href="_static/favicon/apple-icon-57x57.png">
+      <link rel="apple-touch-icon" sizes="60x60" href="_static/favicon/apple-icon-60x60.png">
+      <link rel="apple-touch-icon" sizes="72x72" href="_static/favicon/apple-icon-72x72.png">
+      <link rel="apple-touch-icon" sizes="76x76" href="_static/favicon/apple-icon-76x76.png">
+      <link rel="apple-touch-icon" sizes="114x114" href="_static/favicon/apple-icon-114x114.png">
+      <link rel="apple-touch-icon" sizes="120x120" href="_static/favicon/apple-icon-120x120.png">
+      <link rel="apple-touch-icon" sizes="144x144" href="_static/favicon/apple-icon-144x144.png">
+      <link rel="apple-touch-icon" sizes="152x152" href="_static/favicon/apple-icon-152x152.png">
+      <link rel="apple-touch-icon" sizes="180x180" href="_static/favicon/apple-icon-180x180.png">
+      <link rel="icon" type="image/png" sizes="192x192"  href="_static/favicon/android-icon-192x192.png">
+      <link rel="icon" type="image/png" sizes="32x32" href="_static/favicon/favicon-32x32.png">
+      <link rel="icon" type="image/png" sizes="96x96" href="_static/favicon/favicon-96x96.png">
+      <link rel="icon" type="image/png" sizes="16x16" href="{{ favicon_url }}" />
+      <link rel="manifest" href="browserconfig.xml">
+      <link rel="manifest" href="manifest.json">
+      <meta name="msapplication-TileColor" content="#ffffff">
+      <meta name="msapplication-TileImage" content="_static/favicon/ms-icon-144x144.png">
+      <meta name="theme-color" content="#ffffff">
+
+      <!-- Open Graph / Facebook -->
+      <meta property="og:type" content="website">
+      <meta property="og:url" content="https://entrenamiento-python-basico.readthedocs.io/es/latest/">
+      <meta property="og:title" content="Aprende Python desde el nivel más básico">
+      <meta property="og:description" content="Materiales del entrenamiento de programación en Python - Nivel básico, con ejemplos prácticos">
+      <meta property="og:image" content="https://entrenamiento-python-basico.readthedocs.io/es/latest/_static/images/plone_source_code.jpg">
+      <meta property="og:image:type" content="image/jpeg">
+      <meta property="og:image:alt" content="Programación con Python en Plone CMS">
+      <meta property="og:locale" content="es_ES" />
+
+      <!-- Twitter -->
+      <meta property="twitter:card" content="summary_large_image">
+      <meta property="twitter:site" content="@macagua">
+      <meta property="twitter:creator" content="@macagua">
+      <meta property="twitter:url" content="https://entrenamiento-python-basico.readthedocs.io/es/latest/">
+      <meta property="twitter:title" content="Aprende Python desde el nivel más básico">
+      <meta property="twitter:description" content="Materiales del entrenamiento de programación en Python - Nivel básico, con ejemplos prácticos">
+      <meta property="twitter:image" content="https://entrenamiento-python-basico.readthedocs.io/es/latest/_static/images/plone_source_code.jpg">
+
+    {% endblock %}

source/_templates/browserconfig.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig><msapplication><tile><square70x70logo src="_static/favicon/ms-icon-70x70.png"/><square150x150logo src="_static/favicon/ms-icon-150x150.png"/><square310x310logo src="_static/favicon/ms-icon-310x310.png"/><TileColor>#ffffff</TileColor></tile></msapplication></browserconfig>

source/_templates/manifest.json

@@ -0,0 +1,47 @@
+{
+    "$schema": "https://json.schemastore.org/web-manifest-combined.json",
+    "name": "Aprende Python 3 desde 0",
+    "short_name": "Aprende Python 3",
+    "start_url": "https://entrenamiento-python-basico.readthedocs.io/es/latest/",
+    "display": "standalone",
+    "theme_color": "#dfdfdf",
+    "background_color": "#dfdfdf",
+    "icons": [
+     {
+      "src": "/_static/favicon/android-icon-36x36.png",
+      "sizes": "36x36",
+      "type": "image/png",
+      "density": "0.75"
+     },
+     {
+      "src": "/_static/favicon/android-icon-48x48.png",
+      "sizes": "48x48",
+      "type": "image/png",
+      "density": "1.0"
+     },
+     {
+      "src": "/_static/favicon/android-icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "density": "1.5"
+     },
+     {
+      "src": "/_static/favicon/android-icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "density": "2.0"
+     },
+     {
+      "src": "/_static/favicon/android-icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "density": "3.0"
+     },
+     {
+      "src": "/_static/favicon/android-icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "density": "4.0"
+     }
+    ]
+}