Migra al tema book

Author: sio2sio2

.github/workflows/docs.yaml

@@ -14,7 +14,7 @@ jobs:
       - name: Configurar Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
+          python-version: '3.x'
 
       - name: Instalación de dependencias.
         run: |

requirements.txt

@@ -1,4 +1,5 @@
-sphinx==5.3
-sphinx-design
-cloud_sptheme
+sphinx
+sphinx-book-theme
+sphinx-copybutton
+sphinx-togglebutton
 sphinx-multitoc-numbering

source/01.intro/02a.serial.rst

@@ -96,10 +96,10 @@ herramientas anterior, facilitamos un :download:`documento JSON
 <files/casilleros.json>` que enumera los profesores de un centro educativo con
 los casilleros que tienen asignados:
 
-.. dropdown:: JSON sobre casilleros
-
-   .. literalinclude:: files/casilleros.json
-      :language: json
+.. literalinclude:: files/casilleros.json
+   :language: json
+   :caption: JSON sobre casilleros
+   :class: toggle
 
 Las ideas que inspiran este documento son las siguientes\ [#]_:
 
@@ -332,12 +332,11 @@ Un ejemplo sencillo de este tipo de documentos es:
 o, si queremos uno más amplio, equivalente al :ref:`ejemplo introductorio
 para JSON <json-ejemplo-inicial>`:
 
-.. _yaml-ejemplo-inicial:
-
-.. dropdown:: YAML de casilleros
-
-   .. literalinclude:: files/casilleros.yaml
-      :language: yaml
+.. literalinclude:: files/casilleros.yaml
+   :language: yaml
+   :caption: YAML de casilleros
+   :name: yaml-ejemplo-inicial
+   :class: toggle
 
 Como en el caso de |JSON| nos resultará enormemente útil validadores:
 
@@ -919,15 +918,15 @@ Ejercicios resueltos
      en la que se mide. Por ejemplo, en alguna receta se necesitarán 200 gramos de
      tomate, pero en otra bastará con indicar dos piezas.
 
-   .. dropdown:: Solución propuesta JSON
-
-      .. literalinclude:: files/ejyaml1.recetas.json
-         :language: json
-
-   .. dropdown:: Solución propuesta YAML
+   .. literalinclude:: files/ejyaml1.recetas.json
+      :language: json
+      :class: toggle
+      :caption: Solución propuesta JSON
 
-      .. literalinclude:: files/ejyaml1.recetas.yaml
-         :language: yaml
+   .. literalinclude:: files/ejyaml1.recetas.yaml
+      :language: yaml
+      :class: toggle
+      :caption: Solución propuesta YAML
 
 #. Tomando como referencia el documento anterior, escriba otro que enumere la
    red de restaurantes de una cadena, de cada uno de los cuales se refiera:
@@ -938,15 +937,15 @@ Ejercicios resueltos
      ofrecen al público (tapa, media ración o ración). Por supuesto, varios
      restaurantes pueden ofrecer la misma receta.
 
-   .. dropdown:: Solución propuesta JSON
-
-      .. literalinclude:: files/ejyaml2.cadena.json
-         :language: json
-
-   .. dropdown:: Solución propuesta YAML
+   .. literalinclude:: files/ejyaml2.cadena.json
+      :language: json
+      :class: toggle
+      :caption: Solución propuesta JSON
 
-      .. literalinclude:: files/ejyaml2.cadena.yaml
-         :language: yaml
+   .. literalinclude:: files/ejyaml2.cadena.yaml
+      :language: yaml
+      :class: toggle
+      :caption: Solución propuesta YAML
 
 .. rubric:: Enlaces de interés
 

source/01.intro/02b.marcas.rst

@@ -272,10 +272,10 @@ Ejemplo introductorio
 Echemos un vistazo a :download:`este XML <files/casilleros.xml>` que permite
 gestionar los casilleros de los profesores de un centro de enseñanza:
 
-.. dropdown:: Casilleros de profesores
-
-   .. literalinclude:: files/casilleros.xml
-      :language: xml
+.. literalinclude:: files/casilleros.xml
+   :caption: Ejemplo de casilleros
+   :class: toggle
+   :language: xml
 
 .. caution:: El documento no es un texto marcado, sino una sucesión de datos, por
    lo que estamos utilizando este |XML| para *marcado descriptivo orientado al
@@ -767,18 +767,18 @@ Ejercicios resueltos
 #. Escribir la versión |XML| del :ref:`primer ejercicio YAML resuelto
    <yaml-resueltos>`.
 
-   .. dropdown:: Solución propuesta
-
-      .. literalinclude:: files/ejxml1.recetas.xml
-         :language: xml
+   .. literalinclude:: files/ejxml1.recetas.xml
+      :caption: Solución propuesta
+      :class: toggle
+      :language: xml
 
 #. Escribir la versión |XML| del :ref:`segundo ejercicio resuelto
    <yaml-resueltos>`.
 
-   .. dropdown:: Solución propuesta
-
-      .. literalinclude:: files/ejxml2.cadena.xml
-         :language: xml
+   .. literalinclude:: files/ejxml2.cadena.xml
+      :caption: Solución propuesta
+      :class: toggle
+      :language: xml
 
 .. rubric:: Notas al pie
 

source/02.validacion/01.dtdxml.rst

@@ -114,24 +114,25 @@ ello tomemos el :ref:`documento XML usado como ejemplo introductorio
 <xml-ejemplo>`, aunque con una ligera variación\ [#]_ (descárguelo de :download:`aquí
 <files/casilleros_v2.xml>`):
 
-.. dropdown:: XML de casilleros
-
-   .. literalinclude:: files/casilleros_v2.xml
-      :language: xml
+.. literalinclude:: files/casilleros_v2.xml
+   :caption: XML de casilleros
+   :class: toggle
+   :language: xml
 
 La definición de su gramática hecha en |DTD| es :download:`la siguiente
 <files/casilleros_v2.dtd>`:
 
-.. dropdown:: DTD de casilleros
+.. literalinclude:: files/casilleros_v2.dtd
+   :caption: DTD de casilleros
+   :class: toggle
 
-   .. literalinclude:: files/casilleros_v2.dtd
 
 Este |DTD|, a su vez, llama a otro que contiene exclusivamente :download:`las
 entidades que definen los departamentos <files/departamentos.ent>`\ [#]_:
 
-.. dropdown:: DTD de definición de entidades
-
-   .. literalinclude:: files/departamentos.ent
+.. literalinclude:: files/departamentos.ent
+   :caption: DTD de definición de entidades
+   :class: toggle
 
 .. _xml-valid:
 
@@ -513,17 +514,17 @@ entremezclan los elementos de los espacios de nombres, lo más fácil es escribi
 siempre el |XML| de la última forma que se propuso, o sea, cambiando el espacio
 de nombres predeterminado y definir :file:`casilleros.dtd` así:
 
-.. dropdown:: DTD de casilleros
-
-   .. literalinclude:: files/casilleros_ns.dtd
-      :emphasize-lines: 2, 22, 25-28
+.. literalinclude:: files/casilleros_ns.dtd
+   :caption: DTD de casilleros
+   :class: toggle
+   :emphasize-lines: 2, 22, 25-28
 
 y :file:`direccion.dtd` de este otro modo:
 
-.. dropdown:: DTD de direccion
-
-   .. literalinclude:: files/direccion_ns.dtd
-      :emphasize-lines: 2
+.. literalinclude:: files/direccion_ns.dtd
+   :caption: DTD de direccion
+   :class: toggle
+   :emphasize-lines: 2
 
 En cualquier caso, cuando hay espacios de nombres, lo más juicioso es evitar |DTD|.
 
@@ -535,17 +536,17 @@ Ejercicios resueltos
 #. Tomando el |XML| sobre recetas, :ref:`ya resuelto en la unidad anterior
    <xml-resueltos>`, escriba un |DTD| para validarlo.
 
-   .. dropdown:: DTD para el XML propuesto
-
-      .. literalinclude:: files/ejxml1.recetas.dtd
+   .. literalinclude:: files/ejxml1.recetas.dtd
+      :caption: DTD para el XML propuesto
+      :class: toggle
 
 #. Tomando el |XML| sobre una cadena de restaurantes :ref:`ya resuelto en el
    epígrafe anterior <xml-resueltos>`, escriba un |DTD| para validarlo. Procure
    reaprovechar el |DTD| del ejercicio anterior.
 
-   .. dropdown:: DTD para el XML propuesto
-
-      .. literalinclude:: files/ejxml2.cadena.dtd
+   .. literalinclude:: files/ejxml2.cadena.dtd
+      :caption: DTD para el XML propuesto
+      :class: toggle
 
 Conclusiones
 ************
@@ -598,10 +599,9 @@ y escriba para ellas la gramática |DTD|.
    :file:`casilleros.dtd` o incluso haberlas incluido como adición a la propia
    declaración del documento en el |XML|:
 
-   .. dropdown::  XML de casilleros con entidades empotradas
-
-      .. literalinclude:: files/casilleros_v1.xml
-         :language: xml
+   .. literalinclude:: files/casilleros_v1.xml
+      :caption: XML de casilleros con entidades empotradas
+      :language: xml
 
 .. [#] También soporta :ref:`Relax-NG Compact <rnc>` y :ref:`XML Schemas <xsd>`.
 

source/02.validacion/02.yaml.rst

@@ -39,17 +39,17 @@ Ejemplo
 -------
 Tomemos la versión |JSON| del :ref:`ejemplo introductorio <json-ejemplo-inicial>`:
 
-.. dropdown:: Casilleros
-
-   .. literalinclude:: /01.intro/files/casilleros.json
-      :language: json
+.. literalinclude:: /01.intro/files/casilleros.json
+   :class: toggle
+   :caption: Casilleros
+   :language: json
 
 Este |JSON| se ajusta al siguiente esquema:
 
-.. dropdown:: Gramática de Casilleros con JSON Schema
-
-   .. literalinclude:: files/casilleros.schema.json
-      :language: json
+.. literalinclude:: files/casilleros.schema.json
+   :caption: Gramática de Casilleros con JSON Schema
+   :class: toggle
+   :language: json
 
 Como puede verse, el documento es en sí un documento |JSON| y tiene un modo algo
 particular (y nada intuitivo) de expresar una ocurrencia de nodos, que se habría
@@ -890,42 +890,42 @@ definidos en otra parte del archivo. Con este fin existe la propiedad
 ``$defs``
    Contiene subesquemas con nombre a los que puede hacerse referencia:
 
-   .. dropdown:: Esquema con referencia interna
-
-      .. code-block:: json
-
-         {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "$id": "gente.schema.json",
-
-            "type": "array",
-            "title": "Ejemplo de referencia",
-            "description": "Un porrón de personas dentro de una secuencia",
-            "items": { "$ref": "#/$defs/persona" },
-            "uniqueItems": true,
+   .. code-block:: json
+      :caption: Esquema con referencia interna
+      :class: toggle
 
-            "$defs": {
-               "persona": {
-                  "type": "object",
-                  "properties": {
-                     "nombre": {
-                        "type": "string",
-                        "description": "Nombre completo de la persona"
-                     },
-                     "edad": {
-                        "type": "integer",
-                        "minimum": 0
-                     },
-                     "casado": {
-                        "type": "boolean",
-                        "default": false
-                     }
+      {
+         "$schema": "https://json-schema.org/draft/2020-12/schema",
+         "$id": "gente.schema.json",
+
+         "type": "array",
+         "title": "Ejemplo de referencia",
+         "description": "Un porrón de personas dentro de una secuencia",
+         "items": { "$ref": "#/$defs/persona" },
+         "uniqueItems": true,
+
+         "$defs": {
+            "persona": {
+               "type": "object",
+               "properties": {
+                  "nombre": {
+                     "type": "string",
+                     "description": "Nombre completo de la persona"
                   },
-                  "additionalProperties": false,
-                  "required": ["nombre"]
-               }
+                  "edad": {
+                     "type": "integer",
+                     "minimum": 0
+                  },
+                  "casado": {
+                     "type": "boolean",
+                     "default": false
+                  }
+               },
+               "additionalProperties": false,
+               "required": ["nombre"]
             }
          }
+      }
 
 .. _json-schema-condicional:
 
@@ -1085,18 +1085,18 @@ Ejercicios resueltos
 Tomando las versiones |JSON| (o |YAML|) de :ref:`los dos ejercicios ya resueltos
 <yaml-resueltos>`, podemos para el primero definir así su gramática:
 
-.. dropdown:: recetas.schema.json
-
-   .. literalinclude:: files/recetas.schema.json
-      :language: json
+.. literalinclude:: files/recetas.schema.json
+   :class: toggle
+   :caption: recetas.schema.json
+   :language: json
 
 El segundo podemos definirlo con otra gramática que :ref:`referencie la primera
 <json-schema-ref>`:
 
-.. dropdown:: restaurantes.schema.json
-
-   .. literalinclude:: files/restaurantes.schema.json
-      :language: json
+.. literalinclude:: files/restaurantes.schema.json
+   :class: toggle
+   :caption: restaurantes.schema.json
+   :language: json
 
 Ejercicios propuestos
 =====================

source/02.validacion/index.rst

@@ -23,10 +23,10 @@ saber que el documento de ejemplo que ha escrito se ajusta a la gramática
 Por ejemplo, la solución |XML| del :ref:`primer ejercicio resuelto
 <xml-resueltos>` era esta:
 
-.. dropdown:: Primer ejercicio resuelto
-
-   .. literalinclude:: /01.intro/files/ejxml1.recetas.xml
-      :language: xml
+.. literalinclude:: /01.intro/files/ejxml1.recetas.xml
+   :caption: Primer ejercicio resuelto
+   :class: toggle
+   :language: xml
 
 Esto implica mucho: que la etiqueta del nodo raíz es :code:`<recetas>` y que
 no tiene ninguna propiedad, pero sí varios nodos  :code:`<receta>`  dentro, etc.