Añade el concepto de perfiles a VScode

Author: José Miguel Sánchez Alés

docs/02.validacion/02.yaml.html

@@ -427,12 +427,13 @@ <h3><span class="section-number">2.2.2.1. </span>Esquema del nodo raíz<a class=
 sea cual sea el tipo del nodo. Ahora bien, ¿cuáles son específicas?</p>
 <span id="json-schema-integer"></span><dl id="json-schema-number">
 <dt><a class="reference external" href="https://json-schema.org/understanding-json-schema/reference/numeric.html">numeric</a> (que comprende <a class="reference internal" href="../01.intro/02a.serial.html#json-numero"><span class="std std-ref">integer</span></a> y <a class="reference internal" href="../01.intro/02a.serial.html#json-numero"><span class="std std-ref">number</span></a>)</dt><dd><p>Tiene asociadas propiedades que no requieren demasiada explicación:</p>
-<span id="json-schema-minimum"></span><dl class="simple" id="json-schema-exclusiveminimum">
-<dt><code class="docutils literal notranslate"><span class="pre">minimum</span></code>/<code class="docutils literal notranslate"><span class="pre">exclusiveMinimum</span></code></dt><dd><p>define el valor mínimo (incluido y sin incluir respectivamente).</p>
+<span id="json-schema-minimum"></span><dl class="simple" id="json-schema-maximum">
+<dt><code class="docutils literal notranslate"><span class="pre">minimum</span></code>/<code class="docutils literal notranslate"><span class="pre">maximum</span></code></dt><dd><p>define el valor mínimo y el máximo respectivamente.</p>
 </dd>
 </dl>
-<span id="json-schema-maximum"></span><dl class="simple" id="json-schema-exclusivemaximum">
-<dt><code class="docutils literal notranslate"><span class="pre">maximum</span></code>/<code class="docutils literal notranslate"><span class="pre">exclusiveMaximum</span></code></dt><dd><p>define el valor máximo (incluido y sin incluir respectivamente).</p>
+<span id="json-schema-exclusiveminimum"></span><dl class="simple" id="json-schema-exclusivemaximum">
+<dt><code class="docutils literal notranslate"><span class="pre">exclusiveMinimum</span></code>/<code class="docutils literal notranslate"><span class="pre">exclusiveMaximum</span></code></dt><dd><p>Si es <code class="docutils literal notranslate"><span class="pre">true</span></code>, excluye el valor mínimo y máximo respectivamente como
+valores validos. En su ausencia, lo son.</p>
 </dd>
 </dl>
 <dl class="simple" id="json-schema-multipleof">

docs/06.html/08.form.html

@@ -1264,7 +1264,7 @@ <h2><span class="section-number">6.7.6. </span>Ejercicios propuestos<a class="he
 <p>El formulario debería enviarse por el método POST</p>
 </li>
 </ol>
-<p class="oculta"><a class="reference download internal" download="" href="../_downloads/4eb317c21e3c49a8ce2f76817d84b06d/formulario.html"><code class="xref download docutils literal notranslate"><span class="pre">Solución</span> <span class="pre">propuesta</span></code></a>.</p>
+<p class="sol-oculta"><a class="reference download internal" download="" href="../_downloads/4eb317c21e3c49a8ce2f76817d84b06d/formulario.html"><code class="xref download docutils literal notranslate"><span class="pre">Solución</span> <span class="pre">propuesta</span></code></a>.</p>
 <p class="rubric">Notas al pie</p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="id7" role="note">

docs/98.apendices/99.tools/vscode.html

@@ -91,31 +91,79 @@ <h2>Generalidades<a class="headerlink" href="#generalidades" title="Enlace perma
 seleccionando <code class="docutils literal notranslate"><span class="pre">File&gt;Preferences&gt;Settings</span></code>) y escribiendo la palabra
 <em>display</em> para reducir los términos de búsqueda:</p>
 <img alt="../../_images/00-vscode-lang.png" src="../../_images/00-vscode-lang.png" />
+<div class="admonition note">
+<p class="admonition-title">Nota</p>
+<p>El idioma es, en realidad, una <a class="reference internal" href="#vs-extension"><span class="std std-ref">extensión</span></a> que
+se habilita al realizar esta operación.</p>
+</div>
 </dd>
-<dt><strong>Áreas de trabajo</strong></dt><dd><p>La mejor forma de trabajar con el programa es abriendo una <em>carpeta</em> en vez de
-archivos individuales, ya que podemos asimilar esta carpetas con proyectos
-(áreas de trabajo) y definir la configuración para cada área de trabajo
-independientemente:</p>
+</dl>
+<dl id="vs-workspace">
+<dt><strong>Áreas de trabajo</strong></dt><dd><p>El programa permite abrir archivos individuales, pero por lo general es mejor
+abrir una <em>carpeta</em>, ya que podemos asimilar ésta a un proyecto (área de
+trabajo) y definir una configuración particular independiente para ella:</p>
 <img alt="../../_images/01-vscode-abrir.png" src="../../_images/01-vscode-abrir.png" />
 </dd>
-<dt><strong>Configuración</strong></dt><dd><p>La configuración puede definirse de forma global o por área de trabajo y
-puede accederse a ella pulsando <kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">,</kbd>:</p>
+<dt><strong>Configuración</strong></dt><dd><p>La configuración puede definirse de forma <em>global</em> (y ya matizaremos esto de
+global) o por área de trabajo y puede accederse a ella pulsando <kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">,</kbd>:</p>
 <img alt="../../_images/02-vscode-conf.png" src="../../_images/02-vscode-conf.png" />
 <p>Se almacena en formato <abbr title="JavaScript Object Notation">JSON</abbr> y, cuando se define para el área de trabajo, se
 almacena dentro de la propia carpeta en <code class="file docutils literal notranslate"><span class="pre">.vscode/settings.json</span></code> con que
 es equivalente realizar la configuración a través de la interfaz que
 proporciona <kbd class="kbd docutils literal notranslate">Ctrl</kbd>+<kbd class="kbd docutils literal notranslate">,</kbd>, que editando directamente el archivo.</p>
 </dd>
+</dl>
+<dl id="vs-extension">
 <dt><strong>Extensiones</strong></dt><dd><p>Las extensiones permiten aumentar las funcionalidades del editor y pueden
-activarse tanto de forma global como por espacio de trabajo. Dependiendo de
-su naturaleza, nos convendrá para algunas lo primero y para otras lo
-segundo.</p>
+activarse tanto de forma <em>global</em> como por espacio de trabajo.</p>
 <p>Una indispensable para quien se haya criado editando archivos en <a class="reference external" href="https://www.vim.org/">vim</a> es <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=vscodevim.vim">VSCodeVim</a>, que
 permite editar archivos como se hace en el veterano editor.</p>
 <p>Para gestionar las extensiones, basta con pinchar sobre el icono lateral
 izquierdo  señalado:</p>
 <img alt="../../_images/03-vscode-ext.png" src="../../_images/03-vscode-ext.png" />
 </dd>
+<dt><strong>Perfiles</strong></dt><dd><p>Tanto al hablar de configuración como de extensiones hemos distinguido entre
+<em>global</em> y particular al área de trabajo. Sin embargo, el concepto de global
+no es absoluto, sino que en el programa podemos definir distintos perfiles
+a cada uno de los cuales podemos asociar una configuración y unas extensiones
+distintas, que hasta ahora hemos definido como globales. ¿Cuál es la utilidad
+de esto? Analicémoslo.</p>
+<p>Manejando únicamente el concepto de área de trabajo, podemos habilitar unas
+extensiones y realizar una configuración determinada para dentro de un
+directorio, por ejemplo, trabajar en <em>Python</em>. Estas extensiones y
+configuración sólo estarán disponibles si usamos ese directorio como área de
+trabajo, por lo que una de dos:</p>
+<ul class="simple">
+<li><p>Metemos todos nuestros archivos de <em>Python</em> dentro de esa área de trabajo,
+lo cual sólo es viable si nuestros desarrollos son de archivo único.</p></li>
+<li><p>Asignamos áreas de trabajo distintas a área de trabajo distintas, pero en
+ese caso tendremos que copiar la configuración  y habilitar manualmente las
+mismas extensiones una y otra ves.</p></li>
+</ul>
+<p>Lo habitual, sin embargo, es que los desarrollos necesiten un subárbol
+independiente de directorios; y, desde luego, no queremos ver más que ese
+subárbol. Esto hace inviable la primera alternativa y muy molesta la segunda.</p>
+<p>Para soslayar este problema existen los <em>perfiles</em>. Por defecto, existe un
+perfil llamado <em>Predeterminado</em>/<em>Default</em> al que se asocia la configuración
+que hasta ahora hemos llamado <em>global</em> y en el que se habilitan las
+extensiones instaladas que no hemos circunscrito a un área de trabajo
+particular. Se lo identifica porque debe aparecer en la esquina inferior
+izquierda una ruedecilla, que es el icono asociado a este perfil:</p>
+<img alt="../../_images/predeterminado.png" src="../../_images/predeterminado.png" />
+<p>Pulsando sobre el icono podemos cambiar de perfil o crear uno nuevo:</p>
+<img alt="../../_images/predeterminado2.png" src="../../_images/predeterminado2.png" />
+<p>Para crear uno podemos partir de cero, pero es mejor generarlo a partir del
+«Predeterminado» si en el predeterminado hemos hecho configuraciones que nos
+gustaría que aplicaran (p.e. el tamaño de letra en el editor) y hemos
+instalado extensiones que también son aplicables a cualquier lenguaje (p.e.
+el idioma). Para ello, podemos simplemente exportar el perfil a un archivo o
+«Mostrar los contenidos del perfil» para señalar aquello que realmente
+queremos guardar an el archivo. De una u otra manera, podremos usar el
+archivo resultante para crear un nuevo perfil (importar) al que le
+asociaremos un nombre (<em>Python</em>, <em>Java</em>, etc) y un icono característico que
+nos permita distinguirlo de los demás.</p>
+<img alt="../../_images/perfiles_areas.png" src="../../_images/perfiles_areas.png" />
+</dd>
 <dt><strong>Áreas especiales</strong></dt><dd><p>Podemos abrir algunas áreas especiales que nos permiten consultar o realizar
 ciertas actividades interesantes:</p>
 <ul class="simple">
@@ -423,7 +471,7 @@ <h2>Generalidades<a class="headerlink" href="#generalidades" title="Enlace perma
 <section id="javascript">
 <span id="vscode-javascript"></span><h2>Javascript<a class="headerlink" href="#javascript" title="Enlace permanente a este encabezado">¶</a></h2>
 <p>Al igual que <a class="reference internal" href="#vscode-javascript"><span class="std std-ref">ocurre con JSON</span></a>, el programa tiene
-soporte nativo para la escritura de <span class="xref std std-ref">Javascript</span>
+soporte nativo para la escritura de <a class="reference internal" href="../../08.js/index.html#js"><span class="std std-ref">Javascript</span></a>
 (autocompletado, <a class="reference external" href="https://es.wikipedia.org/wiki/Snippet">snippets</a>), pese a lo cual podemos hacer algunos añadidos
 para mejorarla:</p>
 <ul class="simple">

docs/99.ejercicios/64.html-form.html

@@ -125,7 +125,7 @@ <h3>Navegación</h3>
 <p>El formulario debería enviarse por el método POST</p>
 </li>
 </ol>
-<p class="oculta"><a class="reference download internal" download="" href="../_downloads/4eb317c21e3c49a8ce2f76817d84b06d/formulario.html"><code class="xref download docutils literal notranslate"><span class="pre">Solución</span> <span class="pre">propuesta</span></code></a>.</p>
+<p class="sol-oculta"><a class="reference download internal" download="" href="../_downloads/4eb317c21e3c49a8ce2f76817d84b06d/formulario.html"><code class="xref download docutils literal notranslate"><span class="pre">Solución</span> <span class="pre">propuesta</span></code></a>.</p>
 </section>
 
 

docs/_images/perfiles_areas.png

@@ -239,16 +239,17 @@ sea cual sea el tipo del nodo. Ahora bien, ¿cuáles son específicas?
    Tiene asociadas propiedades que no requieren demasiada explicación:
 
    .. _json-schema-minimum:
-   .. _json-schema-exclusiveminimum:
+   .. _json-schema-maximum:
 
-   ``minimum``/``exclusiveMinimum``
-      define el valor mínimo (incluido y sin incluir respectivamente).
+   ``minimum``/``maximum``
+      define el valor mínimo y el máximo respectivamente.
 
-   .. _json-schema-maximum:
+   .. _json-schema-exclusiveminimum:
    .. _json-schema-exclusivemaximum:
 
-   ``maximum``/``exclusiveMaximum``
-      define el valor máximo (incluido y sin incluir respectivamente).
+   ``exclusiveMinimum``/``exclusiveMaximum``
+      Si es ``true``, excluye el valor mínimo y máximo respectivamente como
+      valores validos. En su ausencia, lo son.
 
    .. _json-schema-multipleof:
 

docs/_images/predeterminado.png

@@ -18,17 +18,22 @@ Generalidades
 
    .. image:: files/00-vscode-lang.png
 
+   .. note:: El idioma es, en realidad, una :ref:`extensión <vs-extension>` que
+      se habilita al realizar esta operación.
+
+.. _vs-workspace:
+
 **Áreas de trabajo**
-   La mejor forma de trabajar con el programa es abriendo una *carpeta* en vez de
-   archivos individuales, ya que podemos asimilar esta carpetas con proyectos
-   (áreas de trabajo) y definir la configuración para cada área de trabajo
-   independientemente:
+   El programa permite abrir archivos individuales, pero por lo general es mejor
+   abrir una *carpeta*, ya que podemos asimilar ésta a un proyecto (área de
+   trabajo) y definir una configuración particular independiente para ella:
 
    .. image:: files/01-vscode-abrir.png
 
 **Configuración**
-   La configuración puede definirse de forma global o por área de trabajo y
-   puede accederse a ella pulsando :kbd:`Ctrl`\ +\ :kbd:`,`:
+   La configuración puede definirse de forma *global* (y ya matizaremos esto de
+   global) o por área de trabajo y puede accederse a ella pulsando :kbd:`Ctrl`\
+   +\ :kbd:`,`:
 
    .. image:: files/02-vscode-conf.png
 
@@ -37,11 +42,11 @@ Generalidades
    es equivalente realizar la configuración a través de la interfaz que
    proporciona :kbd:`Ctrl`\ +\ :kbd:`,`, que editando directamente el archivo.
 
+.. _vs-extension:
+
 **Extensiones**
    Las extensiones permiten aumentar las funcionalidades del editor y pueden
-   activarse tanto de forma global como por espacio de trabajo. Dependiendo de
-   su naturaleza, nos convendrá para algunas lo primero y para otras lo
-   segundo.
+   activarse tanto de forma *global* como por espacio de trabajo.
 
    Una indispensable para quien se haya criado editando archivos en `vim
    <https://www.vim.org/>`_ es `VSCodeVim
@@ -53,6 +58,56 @@ Generalidades
 
    .. image:: files/03-vscode-ext.png
 
+**Perfiles**
+   Tanto al hablar de configuración como de extensiones hemos distinguido entre
+   *global* y particular al área de trabajo. Sin embargo, el concepto de global
+   no es absoluto, sino que en el programa podemos definir distintos perfiles
+   a cada uno de los cuales podemos asociar una configuración y unas extensiones
+   distintas, que hasta ahora hemos definido como globales. ¿Cuál es la utilidad
+   de esto? Analicémoslo.
+
+   Manejando únicamente el concepto de área de trabajo, podemos habilitar unas
+   extensiones y realizar una configuración determinada para dentro de un
+   directorio, por ejemplo, trabajar en *Python*. Estas extensiones y
+   configuración sólo estarán disponibles si usamos ese directorio como área de
+   trabajo, por lo que una de dos:
+
+   * Metemos todos nuestros archivos de *Python* dentro de esa área de trabajo,
+     lo cual sólo es viable si nuestros desarrollos son de archivo único.
+   * Asignamos áreas de trabajo distintas a área de trabajo distintas, pero en
+     ese caso tendremos que copiar la configuración  y habilitar manualmente las
+     mismas extensiones una y otra ves.
+
+   Lo habitual, sin embargo, es que los desarrollos necesiten un subárbol
+   independiente de directorios; y, desde luego, no queremos ver más que ese
+   subárbol. Esto hace inviable la primera alternativa y muy molesta la segunda.
+
+   Para soslayar este problema existen los *perfiles*. Por defecto, existe un
+   perfil llamado *Predeterminado*/*Default* al que se asocia la configuración
+   que hasta ahora hemos llamado *global* y en el que se habilitan las
+   extensiones instaladas que no hemos circunscrito a un área de trabajo
+   particular. Se lo identifica porque debe aparecer en la esquina inferior
+   izquierda una ruedecilla, que es el icono asociado a este perfil:
+
+   .. image:: files/predeterminado.png
+
+   Pulsando sobre el icono podemos cambiar de perfil o crear uno nuevo:
+
+   .. image:: files/predeterminado2.png
+
+   Para crear uno podemos partir de cero, pero es mejor generarlo a partir del
+   "Predeterminado" si en el predeterminado hemos hecho configuraciones que nos
+   gustaría que aplicaran (p.e. el tamaño de letra en el editor) y hemos
+   instalado extensiones que también son aplicables a cualquier lenguaje (p.e.
+   el idioma). Para ello, podemos simplemente exportar el perfil a un archivo o
+   "Mostrar los contenidos del perfil" para señalar aquello que realmente
+   queremos guardar an el archivo. De una u otra manera, podremos usar el
+   archivo resultante para crear un nuevo perfil (importar) al que le
+   asociaremos un nombre (*Python*, *Java*, etc) y un icono característico que
+   nos permita distinguirlo de los demás.
+
+   .. image:: files/perfiles_areas.png
+
 **Áreas especiales**
    Podemos abrir algunas áreas especiales que nos permiten consultar o realizar
    ciertas actividades interesantes:
@@ -386,7 +441,7 @@ específica para ella.
 Javascript
 ==========
 Al igual que :ref:`ocurre con JSON <vscode-javascript>`, el programa tiene
-soporte nativo para la escritura de :ref:`Javascript <javascript>`
+soporte nativo para la escritura de :ref:`Javascript <js>`
 (autocompletado, `snippets <https://es.wikipedia.org/wiki/Snippet>`_), pese a lo cual podemos hacer algunos añadidos
 para mejorarla:
 

docs/_images/predeterminado2.png

@@ -47,6 +47,6 @@
 
    El formulario debería enviarse por el método POST
 
-.. rst-class:: oculta
+.. rst-class:: sol-oculta
 
    :download:`Solución propuesta </99.ejercicios/soluciones/formulario.html>`.

docs/_sources/02.validacion/02.yaml.rst.txt

@@ -239,16 +239,17 @@ sea cual sea el tipo del nodo. Ahora bien, ¿cuáles son específicas?
    Tiene asociadas propiedades que no requieren demasiada explicación:
 
    .. _json-schema-minimum:
-   .. _json-schema-exclusiveminimum:
+   .. _json-schema-maximum:
 
-   ``minimum``/``exclusiveMinimum``
-      define el valor mínimo (incluido y sin incluir respectivamente).
+   ``minimum``/``maximum``
+      define el valor mínimo y el máximo respectivamente.
 
-   .. _json-schema-maximum:
+   .. _json-schema-exclusiveminimum:
    .. _json-schema-exclusivemaximum:
 
-   ``maximum``/``exclusiveMaximum``
-      define el valor máximo (incluido y sin incluir respectivamente).
+   ``exclusiveMinimum``/``exclusiveMaximum``
+      Si es ``true``, excluye el valor mínimo y máximo respectivamente como
+      valores validos. En su ausencia, lo son.
 
    .. _json-schema-multipleof: