• Opción de menú «Insertar» en el gestor de escenas

    Para agregar o insertar escenas en la página web, hay que utilizar la opción del menú Insertar.

    Agregar e insertar escenas
    Agregar e insertar escenas

    Se pueden agregar o insertar escenas nuevas de Descartes, de Descartes5, un Discurso o un Ítem, también se pueden agregar e insertar escenas del sistema, es decir, escenas que han sido previamente guardadas en un archivo. Y finalmente se pueden agregar o insertar escenas que previamente han sido copiadas al portapapeles (ver en la opción Editar: copiar y pegar escenas ).

    • Agregar pone la nueva escena después de todas las que hay en la página.
    • Insertar pone la escena antes de la que esté seleccionada.

    Para seleccionar una escena hay que hacer clic sobre el botón negro marcado con una S que aparece a la derecha de cada escena.

    Para insertar escenas en el modo de Mostrar HTML hay que colocar el cursor en el punto del código html donde se quiere hacer la inserción. Al hacer esto, se activarán también las opciones de Insertar párrafo e Insertar párrafo con escena en el menú Insertar.

    • Insertar escena sirve para insertar una escena dentro de en un párrafo o tabla ya existente. Si se escoge esta opción, el cursor tendrá que colocarse dentro del párrafo (o la tabla) en el cual se pretende insertar, o sea en algún sitio entre <p> y </p> (o en algún elemento de la tabla).
    • Insertar párrafo con escena insertará en el lugar donde está el cursor una nueva escena dentro de un nuevo párrafo con alineación centrada; por tanto, conviene colocar el cursor en el texto del código html pero fuera de un párrafo (entre un </p> y el siguiente <p>).

    Las escenas nuevas aparecen en forma gráfica como escenas vacías con red cartesiana, y son totalmente operativas. Por tanto pueden editarse como de costumbre, dando un doble clic o un clic derecho con el cursor colocado sobre la escena para abrir la ventana de edición o de configuración. Otra forma de abrir la ventana del editor de configuración es darle una clic al botón «E» que aparece en la pantalla en el lado superior derecho.

    • Insertar párrafo sirve para insertar un nuevo párrafo en el sitio donde se ubica el cursor. Esta operación simplemente agrega el código html de apertura y cierre de un párrafo (<p> y </p>), y se podría incluso hacer manualmente.
  • Opción de menú «Editar» en el gestor de escenas

    Esta opción permite realizar todo lo necesario para llevar a buen término la edición tanto del código html como de las escenas.

    Al abrir una página con varias escenas, si la opción Html está en ocultar, aparecerán una tras de otra –por ejemplo, en la figura siguiente podemos observar dos escenas– y si está activa la opción Html las observaremos con bloques de código.

    Página con dos escenas
    Página con dos escenas

    Las escenas que aparecen son editables, es decir, haciendo un doble clic sobre alguna de ellas se abre el editor de configuración de la escena, o bien pulsando el botón config ya sea sobre la escena (si tal botón aparece en ella) o sobre la ventana exterior (que aparece tras un clic derecho sobre cualquier sitio de la escena). Los cambios que se hagan a la configuración y que se hayan aplicado, pasarán a formar parte de la página y por tanto se guardarán cuando ésta se guarde en el disco. Además, si durante la edición se cambia el tamaño de una escena, la página se refresca automáticamente y la escena aparece con su nuevo tamaño.

    El resto del código html puede editarse manualmente en formato de texto. Por tanto, es posible escribir todo el contenido de la página que se está creando, incluso el texto, dentro del Gestor. Sin embargo, para hacer mejoras de estilo del texto, es recomendable usar cualquier editor de html.

    Cuando se crea una página nueva (Archivo->Nuevo) aparece una escena básica, embebida en la estructura elemental de una página web, con los códigos de apertura, a modo de paréntesis de apertura (etiquetas), <html>, <head> y <body>, y sus respectivos cierres en orden inverso: </body>, </head> y</html>. También aparece el título de la página (<title>TITULO</title>) y un solo párrafo vacío alineado a la izquierda (<p> y </p>).

    Archivo nuevo
    Archivo nuevo

    Sin necesidad de profundizar en el lenguaje html puede observarse que los códigos que utiliza este lenguaje son de texto (caracteres legibles), que las secciones que lo forman están etiquetadas y que éstas, tienen la forma <nombre> y </nombre>. No es necesario usar esto para trabajar con Descartes, sin embargo, puede ayudar a comprender lo que ocurre en algunas ocasiones.

    En esta opción de menú encontramos las posibilidades reflejadas a continuación:

    Opción "Editar"
    Opción «Editar»
    • Cortar, copiar y pegar escenas.  A la derecha de cada escena se encuentra un botón negro con una S, y al pulsarlo quedará seleccionada la escena y se dibujará a su alrededor un marco rojo. En el menú Editar se activarán las siguientes opciones:
      • Cortar escena, para eliminar una escena, pero guardándola en el portapapeles para poderla pegar en otro sitio (se denomina portapapeles a una zona de memoria donde se guarda la información que se corta o se copia, se guarda la escena).
      • Copiar escena, para guardar un duplicado de la escena seleccionada en el portapapeles.
      • Pegar escena, para insertar en el lugar donde esté el cursor la escena que haya en el portapapeles, que será la última cortada o copiada.
      • Eliminar escena, para borrar la escena seleccionada de la página.

    Esas mismas operaciones pueden realizarse con las combinaciones de teclas acostumbradas: Ctrl-X para cortarla, Ctrl-C para copiarla, Crtl-V para pegarla y Supr (o Del) para suprimirla. Y como ya se ha indicado, la escena más recientemente copiada o cortada permanece en el portapapeles y se puede insertar en la página mediante las opciones de Insertar escena e Insertar párrafo con escena del menú Editar y eligiendo la sub-opción del portapapeles.

    Sin embargo, para cortar, copiar, pegar o eliminar un trozo del código html, se trabaja directamente sobre el texto usando las combinaciones de teclas Ctrl-X, Ctrl-C, Crtl-V y Supr (o Del); no es posible hacerlo usando el menú.

    •  Deshacer y rehacer.
      • Si se pulsa la opción de deshacer en el menú Editar, se anulará el último cambio que se efectuó en la página. Se puede deshacer repetidamente hasta llegar a la situación inicial cuando se abrió o creó la página.
      • Si se pulsa rehacer, se revoca el último deshacer (o sea, vuelve a efectuar la acción deshecha). También se puede rehacer repetidamente hasta llegar a la última versión de la página, es decir la que se estaba mostrando cuando se comenzó a pulsar deshacer.
  • Opción de menú «Html» en el gestor de escenas

    En esta opción se muestran dos alternativas

    • Mostrar HTML que hace visible y editable, en modo texto, el código html de la página en la que está embebida la o las escenas de Descartes.
    • Ocultar HTML que oculta ese código html y muestra sólo las escenas.

    En la siguiente imagen observamos la situación cuan se ha seleccionado «Mostrar HTML».

    Mostrar el código HTML en el gestor
    Mostrar el código HTML en el gestor

     

  • Opción de menú «Servidores» en el gestor de escenas

    Mediante esta opción el gestor de escenas permite publicar y leer archivos html en servidores especializados. Se cuenta con tres posibilidades.

    Opción de menú: "Servidores"
    Opción de menú: «Servidores»

     

    • Descargar Escena de un Servidor responde con una serie de ventanas de diálogo en las que hay que escoger (de una lista) el servidor al que se va a acceder, el usuario, el proyecto y el archivo html. El gestor de escenas abre ese archivo, muestra la o las escenas que vienen incluídas y permite editarlas. Tal archivo puede volverse a publicar en el servidor bajo el mismo usuario o bajo otro, siempre y cuando se proporcione la contraseña, que deberá propocionársela al usuario el proveedor del servicio.
    • Publicar Escena en un servidor responde con una serie de ventanas de diálogo en las que hay que escoger (de una lista) el servidor al que se va a acceder, el usuario, proporcionar una contraseña, elegir un proyecto o definir uno nuevo y elegir un archivo html para sobreescribirlo o definir uno nuevo.
    • Abrir URL responde preguntando por una dirección URL en donde se supone encontrará un archivo html con escenas para editar. Actualmente, si la escena utiliza otros archivos auxiliares de imágenes, macros, ficheros, sonido o audio, estos no estarán disponibles en la edición de la escena.
  • Opción menú «Opciones» en el gestor de escenas

    El gestor de escenas genera un código propio que recoge toda la información relativa a los objetos que el editor o desarrollador de una escena ha incluido en la misma. Ese código necesita de un intérprete que aporte al navegador de páginas web la información necesaria para que muestre la escena, los objetos en ella incluidos y permita la interactividad. Consecuentemente hay que indicar al navegador dónde se ubica el intérprete del código y esto se realiza mediante esta opción de menú. Descartes dispone de dos intérpretes, uno en Java y otro en javascript (JS).

    Opción de menú "Opciones"
    Opción de menú: «Opciones»

    Esta opción de menú es un mero selector mediante el que se establece el estado que ha de aplicarse en el momento que se guarde el archivo html que se esté editando.  En cualquier momento, el usuario puede seleccionar una de las seis opciones posibles y ésta queda reflejada en la barra de estado del gestor, la cual está ubicada en la parte inferior de la ventana (ver figura siguiente).  La opción por defecto es «Librería portable->sólo para JS»; no obstante cuando se abre un archivo que contiene alguna escena se detecta la opción con la que fue grabada y queda activada. La opción que está
    seleccionada en cada momento se refleja en la zona de mensajes de la parte inferior del gestor de escenas.

    Opciones reflejadas en la barra de estado
    Opciones reflejadas en la barra de estado

    Se presentan tres posibilidades:

    • Librería en Internet que indica que para localizar el intérprete se accederá a un sitio web, que por defecto es: https://arquimedes.matem.unam.mx/Descartes5/lib/.
    • Librería portable que señala que el intérprete se ubique en una subcarpeta denominada lib al nivel del archivo html que se está editando (./lib) y es el propio editor el que crea esa carpeta y copia el intérprete o intérpretes en ella.
    • Librería de proyecto que marca que el intérprete se direccione y ubique en una carpeta lib un nivel por encima al correspondiente al archivo que se está editando (../lib).

    Y cada una de las opciones anteriores cuenta con dos subopciones:

    • para Java y JS que direcciona y/o ubica ambos intérpretes en el lugar indicado en la opción anterior y a su vez crea dos archivos html con el nombre que se indicó al editar o que se indique al guardar. Por ejemplo si el archivo que se está editando se denomina suma.html al guardar se actualizará este archivo para que sea interpretado con Java y suma_JS.html para la versión de javascript (añade al nombre el sufijo _JS).
    • sólo para JS que direcciona y/o ubica sólo el intérprete de javascript en un único archivo de igual nombre al editado, es decir, en el ejemplo puesto antes sería suma.html.

     

    La opción Librería portable tiene como objetivo crear un objeto desagregado, es decir que si se copia toda la carpeta que lo contiene se puede trasladar a cualquier otro lugar del ordenador u otro ordenador y seguirá funcionando igual (ese es el significado usualmente empleado para portable). Esta distribución se ha utilizado por ejemplo en el desarrollo de las misceláneas. Para la opción JS la línea incluida es:

    <script type=’text/javascript’ src=’lib/descartes-min.js’></script>

    La opción de librería de proyecto busca compartir un único archivo del intérprete para un conjunto de páginas ubicadas a diferente nivel. Así en la imagen siguiente podemos ver un proyecto que utiliza diferentes escenas, cada una de ellas ubicadas en una carpeta y una única carpeta lib compartida por ellas. Esta distribución se ha utilizado en el desarrollo de objetos, por ejemplo, en CanalsPizarra interactiva y suele ser una estructura de archivos muy útil. De ahí que se haya contemplado en el gestor de escenas esta opción.

    Ubicación del intérprete en la opción proyecto

    Ubicación del intérprete en la opción proyecto

    Para la opción DescartesJS la línea incluida en la página de cada escena es:

     <script type=’text/javascript’ src=’../lib/descartes-min.js’></script>

    La opción librería en internet direcciona a Descartes5.jar y a descartes-min.js al directorio de distribución del servidor arquimedes. Esta opción es la que se usado en las escenas incluidas en esta documentación con el objeto de que usen siempre la última versión y consecuentemente si en algún momento en una nueva versión se produjese un error, un funcionamiento inadecuado o un cambio de comportamiento, la documentación sirva de fuente de detección y localización del mismo. Para DescartesJS se incluye:

    <script type=’text/javascript’ src=’https://arquimedes.matem.unam.mx/Descartes5/lib/descartes-min.js’></script>