Tutorial de usuario para JMathWiki

Transcripción

1 Tutorial de usuario para JMathWiki Introducción El término WikiWiki es de origen hawaiano y significa: rápido. Comúnmente para abreviar esta palabra se utiliza Wiki que en términos tecnológicos es un software para la creación de contenido de forma colaborativa. Además Wiki fue el nombre que el programador Ward Cunningham, escogió para su invento, en 1994: un sistema de creación, intercambio y revisión de información en la web, de forma fácil y automática. Todos hemos navegado por la famosa enciclopedia que se dio a conocer en el 2001 denominada Wikipedia. Como sabemos, esta enciclopedia permite a los usuarios acceder y modificar sus contenidos. Un Wiki sirve para crear páginas web de forma rápida y eficaz, además ofrece gran libertad a los usuarios, incluso para aquellos usuarios que no tienen muchos conocimientos de informática ni programación, permite de forma muy sencilla incluir textos, hipertextos, documentos digitales, enlaces y demás. Para editar sólo es necesario pulsa sobre "editar" en la página que quieras editar y escribir. Si quieres utilizar algún formato puedes utilizar los botones situados encima del área de texto. La finalidad de un Wiki es permitir que varios usuarios puedan crear páginas web sobre un mismo tema, de esta forma cada usuario aporta un poco de su conocimiento para que la página web sea más completa, creando de esta forma una comunidad de usuarios que comparten contenidos acerca de un mismo tema o categoría. En síntesis, se le llama Wiki a las páginas Web con enlaces, imágenes y cualquier tipo de contenido que puede ser visitada y editada por cualquier persona. De esta forma se convierte en una herramienta Web que nos permite crear colectivamente documentos sin que se realice una aceptación del contenido antes de ser publicado en Internet. Un ejemplo claro: Wikipedia, un proyecto para desarrollar una enciclopedia libre en Internet. MediaWiki El software utilizado para montar JMathWiki es MediaWiki. MediaWiki es un software programado en lenguaje PHP que puede ser instalado en los servidores web Apache y puede usar como motor de base de datos MySQL. Fue desarrollado originalmente para Wikipedia aunque posteriormente fue hecho público (software libre). Actualmente es uno de los sistemas gestores de contenido más populares que se especializan en wikis. Entre las características más destacables podemos citar, por su utilidad en JMathWiki, el soporte de TeX para visualizar formulas matemáticas. 1

2 Qué podemos hacer en JMathWiki? Existen dos maneras de contribuir a JMathWiki: crear un problema nuevo o modificar uno ya existente. Para la gestión de este espacio, es importante conocer los permisos que tendrá cada tipo de usuario: Profesores Alumnos Leer un problema SI SI Editar un problema SI SI Renombrar un problema SI SI Crear un problema SI SI Borrar un problema SI NO Bloquear un problema SI NO Entrar en JMathWiki El acceso a JMathWiki será desde los espacios virtuales de la UJA de cada una de las asignaturas que participan en el proyecto en las que previamente el profesor encargado de su docencia ha creado un acceso a JMathWiki. Al pinchar en dicho enlace accederemos a la página de nuestra asignatura Ilustración 1. Página ejemplo asignatura 2

3 o a la página principal de la wiki, a la que siempre nos podremos dirigir pinchando en el botón Página Principal o en el logo de la wiki que aparecen a la izquierda de la pantalla. Ilustración 2. Página principal Tanto la página de nuestra asignatura como la página principal y algunas otras páginas como por ejemplo las páginas de los distintos bloques de tu asignatura o algunos problemas ejemplo ya resueltos, ya han sido editados por los profesores que trabajamos en este proyecto y protegidos salvo para administradores del espacio wiki, es decir, cada uno de los profesores que intervenimos en el proyecto de innovación. Lo primero que debes de hacer es registrarte como usuario (aunque no es necesario estar registrado para navegar por la wiki, es decir, sin registrarnos podemos ver los contenidos de la wiki, sin embargo no podremos editar ninguna página). Pulsa el botón Registrarse/Entrar situado en la zona superior derecha de la pantalla. 3

4 Ilustración 3.- Página de registro En esta ventana pinchamos en Crear una cuenta Ilustración 4.- Página creación de nueva cuenta 4

5 Rellenamos los datos solicitados: En nombre de usuario es imprescindible poner el nombre de usuario del correo electrónico del que disponemos como alumno de la Universidad de Jaén, es decir, el usuario que usamos para acceder a los espacios virtuales de la Universidad de Jaén. La contraseña, que posteriormente debemos de repetir, la elegimos cada uno de nosotros. Selecciona una contraseña que te sea fácil de recordad pues posteriormente tendrás que usarla para acceder al wiki cada vez que tengas que editar alguna página web. El profesor no podrá recordártela. En nombre real, aunque en general es opcional, en nuestro caso será obligatorio pues de otra forma el trabajo realizado por el alumno no podrá ser evaluado por tu profesor. Una vez rellenados los datos anteriores pinchamos en cree una nueva cuenta. A partir de este momento estamos registrados en JMathWiki. Una vez registrado como usuario de la wiki, podemos pulsar sobre el enlace a nuestra asignatura. Accedemos a una nueva página donde aparecen los distintos temas desarrollados en la asignatura correspondiente. También nos encontramos una tabla en la que se explican el código de colores que hemos seleccionado para que el alumno conozca la confianza que debe prestarle al problema al que ha accedido, según haya sido revisado o no por el profesor y esté completamente resuelto o no. Aunque sigamos estos códigos, no obstante, el profesor protegerá todo problema cuya solución haya sido completamente editada de forma correcta por algún alumno. Ilustración 5.- Página asignatura Matemática Discreta 5

6 Si queremos acceder al contenido de algún tema concreto de nuestra asignatura pulsamos sobre el enlace del tema correspondiente. Lo primero que observamos es que esta nueva página ha sido etiquetada de manera que en su título aparezca el indicativo de la asignatura, de la titulación a la que pertenece, mediante una abreviatura, y del tema en el que estamos, a saber: asignatura + abreviatura titulación + número del capítulo(t#) Así por ejemplo la página algebra inf t1 será la asignada al tema 1 de la asignatura Álgebra del Grado en Ingeniería Informática: Ilustración 6.- Página tema 1 de Matemática Discreta En la siguiente tabla encontramos los distintos calificativos usados para las asignaturas que intervienen en JMathWiki: Asignatura Álgebra (Grado en Ing. Informática) Álgebra (Grado en Estadística y Empresa) Ampliación de matemáticas (Grado en Ing. Industrial) Análisis y Métodos Numéricos (Grado en Ing. Informática) Matemática Discreta (Grado en Ing. Informática) Nombre usado en JmathWiki para tema 1 Algebra inf t1 Algebra est t1 Ampliacion ind t1 Analisis inf t1 Discreta inf t1 6

7 Matemáticas II (Grado en ADE y FICO) Matemáticas II (Grado en Ing. Industrial) Matemáticas II (Grado en Ing. Geomática y Topografía) Matematicas2 ade t1 Matematicas2 ind t1 Matematicas2 geo t1 El contenido que nos encontramos al entrar en un tema de nuestra asignatura es un listado de problemas relacionados con dicho tema, cada uno de los cuales aparecen con el nombre de Problema #, donde # es el número natural asignado al problema (esta forma de denotar los problemas nos permite la posibilidad de que el número de problemas sea tan grande como queramos). Justo después del enlace es posible hacer una breve descripción del problema para así facilitar la búsqueda al lector interesado. Con el fin de evitar interferencias entre las distintas asignaturas cada uno de los problemas estarán etiquetado mediante: Problema n (indicativo asignatura + abreviatura titulación + número tema) Por ejemplo, Problema 5 (algebra inf t1) será el nombre asignado al problema 5 del tema 1 de la asignatura Álgebra del Grado en Ingeniería Informática. Ilustración 7.- Página problema 5 del tema 1 de Matemática Discreta (problema no editado) Por último, en todas las páginas de los temas de cada asignatura nos encontramos con un enlace interno con la página de dicha asignatura, de 7

8 manera que con un solo clic de ratón podemos volver a la página de la asignatura y cambiarnos de tema. Si queremos hacer algún cambio en algún problema, pulsamos la pestaña editar. Al hacerlo, se entra en la vista de edición de la página. Es posible escribir el texto que desees en esta página y utilizar los diversos botones de edición que aparecen en la parte superior del área de edición. Una vez que hayamos terminado de escribir en el editor de texto, es recomendable que hagas clic en Mostrar previsualización para comprobar que todo está correcto. Si es así, haz clic en la opción Grabar la página y los cambios se incorporarán a la página de la asignatura. En el listado de problemas de un tema (ver ilustración 6) nos encontramos con algunos enlaces en rojo. Si pinchamos en alguno de ellos, observamos que se tratan de problemas que aun no se han editado, y por tanto, la página correspondiente a dicho problema aun no existe dentro de JMathWiki, por lo que se nos abre el editor de texto. Aquí podremos añadir el contenido que deseemos para dicho problema (ver ilustración 7). Por otra parte, si pinchamos en un enlace en azul, nos damos cuenta que esta página ya ha sido editada con anterioridad: Ilustración 8.- Página problema 2 del tema 1 de Matemática Discreta (problema editado) Si queremos modificarla, simplemente pincharemos en la pestaña editar situada en la parte superior de la pantalla. Aparecerá el mismo cuadro de texto que si quisiéramos crear una nueva página, con la diferencia de que en este caso, 8

9 no estará en blanco, sino que aparecerá el texto del problema previamente editado: Ilustración 9.- Página edición problema 2 del tema 1 de Matemática Discreta Una vez que hayas hecho las modificaciones, pincha sobre Mostrar previsualización y, si todo está correcto, haz clic en Grabar la página. Finalmente, en cada página en la que se resuelva un problema aparezceran dos enlaces internos uno a la página de problemas del tema al que pertenece éste: Otro problema del tema % y otro que nos llevará de vuelta a la página de la asignatura a la que pertenece este problema, por ejemplo: Volver a Matemática Discreta, de esta forma con un solo clic de ratón podemos cambiar de problema dentro del mismo tema o irnos a otro tema de nuestra asignatura. Edición de contenidos Cuando se edita una página, MediaWiki facilita una serie de herramientas muy interesantes: Ilustración 10.- Detalle botones de página de edición Siguiendo el orden de la botonera, es posible: 9

10 The TeX Box. Nos permite abrir un editor de TeX para facilitarnos la edición de símbolos matemáticos usando expresiones TeX. Consultar el apartado TeX en JMathWiki. Poner textos en negrita. Escribe el texto, selecciónalo con el ratón y, después, pulsa el segundo botón y el texto se etiquetará con '''. Poner textos en cursiva. Si quieres escribir en cursiva selecciona con el ratón el texto deseado y, después, pulsa el segundo botón y el texto se etiquetará con ''. Crear un enlace interno. Con este botón podemos crear nuevas páginas o artículos en la Wiki. Consulta el apartado Crear enlaces internos para ver cómo se hace. Crear un enlace externo. Con esta opción podrás hacer que un texto de la página permita acceder a otra página web de Internet. Consulta el apartado Crear enlaces externos para ver cómo se hace. Poner titulares. Si quieres que un texto sea un titular de la página o el inicio de una sección del contenido, selecciónalo y pulsa este botón. Añadir imágenes. Estos dos botones permiten incorporar archivos (imágenes) a la página de la Wiki. Consulta el apartado Añadir imágenes para ver cómo se hace. Añadir una fórmula matemática: Si se pulsa este botón aparecerá el código <math>escriba aquí una fórmula</math>. Elimina el texto Escriba aquí una fórmula e introduce el contenido correcto usando código TeX. Pasar por alto el formato Wiki. No recomendamos utilizar esta opción, que anula las características de formato propias de la Wiki. Añadir firma, fecha y hora. Se utiliza para introducir estos datos al final de la página. Introducir una línea horizontal: Esta opción permite crear líneas divisoras de contenidos. No se recomienda abusar para facilitar la lectura de la página TeX en JMathWiki Una de las características más importantes de MediaWiki, y en particular de JMathWiki, es que soporta la edición de fórmulas matemáticas usando la notación LaTeX. Aunque no es un parte de MediaWiki, sí que es una extensión que hemos incorporado, sin la cual nuestra wiki difícilmente podría sernos útil. Si queremos escribir una fórmula matemática en LaTeX en una página de nuestra wiki, accedemos a la página en la que queremos insertar la fórmula, la editamos y pulsando sobre el botón nos aparecen las etiquetas <math> que necesitamos para editar la fórmula. De hecho nos aparecerá <math>escribir la fórmula aquí</math> y sólo tendremos que escribir la fórmula donde nos indica. 10

11 Para facilitar el uso del LaTeX hemos incorporado una herramienta para editar fórmulas en LaTeX, se trata de The TeX Box, que se nos abrirá al pinchar sobre el botón. Como se puede observar esta nueva ventana que se nos abre tiene tres zonas, de arriba a abajo: 1. Primero nos encontramos con una línea Popup Window: The TEX Box en la que aparecerá una previsualización de la fórmula que queremos editar. 2. En segundo lugar, un área con título Enter a TEX expression que como su nombre indica es el área en la que debemos introducir la expresión en LaTeX. 3. Por último, tras los botones Preview, Clear, Insert y Close, otra parte donde aparecen los símbolos favoritos. Esta última área se puede redefinir con los símbolos matemáticos que más utilicemos en nuestras asignaturas. Ilustración 11.- The TeX Box Para insertar una fórmula usando este editor basta con editarla en LaTeX en el área correspondiente, pulsar sobre el botón Preview para previsualizarla y comprobar que es la fórmula que nosotros queremos editar: 11

12 Ilustración 12.- Detalle editando una fórmula Una vez comprobada que la fórmula está correcta pulsando sobre el botón Insert quedará insertada en la pantalla de edición del problema que estamos editando. Si necesitas escribir algún símbolo matemático que no aparece en el editor anterior siempre podrás encontrar el código en las siguientes direcciones: Ilustración 13.- Página de ayuda para formulas matemáticas en MediaWiki 12

13 Añadir imágenes Si queremos añadir una imagen a una página de JMathWiki, accedemos a la página en la que queremos incorporar la imagen, la edítamos y pulsa sobre el botón. En la pantalla aparecerá el siguiente código [[Archivo:Ejemplo.jpg]]. Ilustración 14.- Añadir una imagen en la pantalla de edición Sólo tienes que cambiar Ejemplo.jpg por el nombre del archivo de la imagen que quieres subir, por ejemplo LogoJMathWiki.jpg. Recuerda que debes poner la extensión correcta del archivo (.jpg,.png,.jpeg o.gif). Tras Grabar la página, si el archivo aun no está en la base de datos de JMathWiki nos aparecerá en rojo Archivo:LogoJMathWiki.jpg: 13

14 Ilustración 15.- Añadir una imagen no insertada en JMathWiki Sólo nos quedará subir dicho archivo a la Wiki, para ello pulsando sobre el enlace anterior accedemos a la página Subir archivo Ilustración 16.- Página subir archivo 14

15 Pulsamos en Examinar y buscamos el fichero en nuestro ordenador. Le damos un nombre al archivo y si queremos una descripción para localizarlo mejor. Por último, pulsamos en Subir un archivo Ilustración 17.- Imagen subida De esta forma volviendo a la página en la que hemos insertado la imagen, en dicha página ya podremos ver la imagen que acabamos de subir a la wiki: Ilustración 18.- Vista de la página después de insertar una imagen 15

16 Subir archivos a JMathWiki Para subir un archivo, ya sea imagen o de otro tipo, a la base de datos de nuestra wiki pulsamos el botón Subir archivo situado en el menú Herramientas en el lateral izquierdo de JMathWiki. Se nos abrirá la ventana de la ilustración 12. Pulsamos en Examinar y buscamos el fichero en nuestro ordenador. Le damos un nombre al archivo y si queremos una descripción para localizarlo mejor. Con el fin de que no haya conflicto con las imágenes subidas por otros usuarios de la wiki, utilizaremos como nombre de la imagen un sistema parecido al usado para nombrar los distintos problemas. Así, si la imagen es la primera que subimos para el problema 1 del tema 1 de la asignatura matemática discreta del Grado en Ingeniería Informática le asignaremos el nombre Problema 1(discreta inf t1)-1.jpg. De esta forma cada imagen que subamos a la wiki estará asignada a un problema concreto y todas las imágenes subidas para un mismo problema estarán enumeradas. Ahora sólo nos queda pulsar Subir un archivo y el archivo ya estará dentro de nuestra JMathWiki. Una vez que el archivo está asociado a la wiki puedes utilizarlo en cualquiera de sus páginas. Crear enlaces internos Los enlaces son muy importantes para facilitar la navegación por la Wiki. Como antes se ha mencionado, se recomienda crear un enlace interno en cada tema que nos vuelva a llevar a la página de la asignatura a la que pertenece dicho tema. Así mismo es recomendable que al final de cada problema aparezca un enlace interno tanto a la página del tema al que corresponde dicho problema, para que de esta forma sea fácil acceder a otro problema del mismo tema, así como a la página de la asignatura por si lo que deseamos es cambiar de tema dentro de la asignatura. Por otra parte, si hacemos referencia en un problema a otro que ya ha sido editado o que queremos editar, sería interesante crear un enlace interno que nos permita un rápido acceso entre ambos problemas. Por ejemplo, si estás editando un problema en el que se calculan los máximos y mínimos de cierta función, para lo cual es necesario calcular las derivadas sucesivas de dicha función, y en otro problema previamente hemos calculado estas derivadas podemos convertir la frase derivadas sucesivas en un enlace interno. Para enlazar ambos artículos debes seguir los siguientes pasos: Selecciona el texto (por ejemplo: derivadas sucesivas ). Pincha sobre el botón. En el editor aparecerá la frase entre doble corchete [[derivadas sucesivas]]. Al grabar la página, automáticamente este texto queda convertido en un enlace interno, que puede ser de dos colores: azul, si el problema ya existe; o rojo, si todavía no ha sido creado. 16

17 Si queremos que el nuevo problema tenga un nombre concreto (esto es conveniente para que no haya posibilidad de colisión con otro problemas de otras asignaturas como ya hemos comentado), escribiremos antes de la frase seleccionada como enlace y separada por el nombre de la página a la que queremos acceder, por ejemplo: [[problema 1(algebra t1) derivadas sucesivas]]. Crear enlaces externos Para crear un enlace a una url externa (aunque no será lo más común, puede que alguno lo necesitemos) hay dos opciones: Opción 1: Escribe la url completa en el texto del artículo (por ejemplo La propia Wiki detecta los enlaces que comiencen por Opción 2: La mejor opción, desde el punto de vista estilístico, es mostrar en la pantalla el nombre de la página y no su url. Para hacerlo de ese modo, debe seleccionar el texto que quieres enlazar (por ejemplo, web asignatura ) y pinchar sobre el botón. En la ventana que saldrá, introduce la URL del sitio ( y, cuando guardes los cambios, el enlace estará activo inmediatamente. Buscar información en una Wiki La búsqueda de artículos es útil, no solo para consultar la información de la Wiki, sino también para crear o modificar artículos existentes. En el buscador, situado en el menú lateral izquierdo, puedes introducir tanto una palabra como una cadena de palabras. Si lleva acentos, es muy recomendable que los introduzcas para que los resultados se ajusten lo más posible a lo que estás buscando. Una vez que pinches en buscar, obtendrás dos tipos de resultados: en primer lugar, aquellos cuyos títulos coincidan con las palabras que has escrito; a continuación, aquellos en los que la palabra aparezca en el cuerpo del artículo pero no en el título. Añadir tablas Si quieres introducir una tabla en uno de los artículos de la Wiki, debes conocer los códigos necesarios para crearlas. 17

18 Resumen del código Wiki para crear una tabla { Comienzo de la tabla + Leyenda de tabla. Opcional. Solo se pone una leyenda por tabla y se indica entre el inicio de la tabla y la primera fila. - Fila de tabla. Con este código se indica que ya están todos los datos de una fila y se va a comenzar una nueva.! Celda título de tabla. Opcional. Puedes añadir títulos consecutivos en la misma línea de la tabla separados por un doble signo de admiración (!!) o iniciar nuevas líneas, cada una de ellas con su propio símbolo de admiración (!). Celdas de datos de tabla. Obligatoria. Puedes añadir celdas de datos consecutivas en la misma línea separadas por una doble barra vertical ( ) o iniciar líneas nuevas cada una con su propia línea vertical ( ). } Final de la tabla. Las etiquetas anteriores deben comenzar en una nueva línea excepto la doble y el signo!! que te permiten añadir, si lo deseas, celdas consecutivas en una línea. Para más información sobre tablas en MediaWiki puedes leer: Página de estilo de JMathWiki Para que todos los problemas tengan un mismo estilo en los profesores que participan en el proyecto acordamos incorporar en este tutorial un apartado sobre el estilo de una página. Sobre el nombre que le damos a cada una de las páginas de problemas ya hablamos anteriormente (ver sección Entrar en JMathWiki ). En la ilustración de la próxima página podemos observar las siguientes cuestiones sobre estilo: Los enunciados de los problemas los editamos en negrita, es decir, entre las etiquetas '''Enunciado del problema'''. La palabra Solución: que nos indica que a partir de ésta hemos editado la solución del problema en cursiva, es decir, entre las etiquetas ''Solución:''. 18

19 Ilustración 19.- Detalle página de estilo de JMathWiki Posteriormente hemos insertado una imagen: [[Archivo:semaforocolor.jpg]] Siendo semaforocolor.jpg uno de los siguiente ficheros: rojo.jpg, amarillo.jpg o verde.jpg (ya incluidos en la wiki) según corresponda, ver tabla en la que se indica para que usamos cada color: Ilustración 20.- Detalle codificación revisión de ejercicios en JMathWiki Lo anterior permitirá al alumno que accede a la wiki conocer si el problema que quiere mirar está o no revisado por el profesor y si su resolución está o no completa. Posteriormente editamos la solución del problema sin usar ni negrita, ni cursiva. Una vez editado el problema entre dos líneas horizontales (que obtenemos pulsando con el ratón el botón ) facilitamos mediante dos 19

20 enlaces internos la navegación dentro de la asignatura a la que pertenece el problema insertando, por ejemplo: [ '''Otro problema'''] nos redirige a la página del tema 1 de la asignatura Álgebra del Grado en Ingeniería en Informática. O la línea: [ Volver a '''Álgebra'''] que nos enlaza con la página de la asignatura Álgebra del Grado en Ingeniería en Informática. Finalmente, es imprescindible que firmemos la página que hemos editado pulsando con el ratón el botón. Como podemos ver al firmar un documento aparece la hora y el día de la edición. Sin lo anterior no se podrá evaluar el trabajo que el alumno ha realizado. No obstante, si un problema no se firma, de todas forma queda constancia de quien lo ha editado en la ficha historial. Ilustración 21.- Detalle edición página estilo de JMathWiki 20

21 Otras acciones importantes en JMathWiki En este último apartado comentaremos algunas de las acciones que usualmente vamos a realizar como usuarios de JMathWiki. Cambiar contraseña: Para poder cambiar la contraseña primero tenemos que habernos registrado. Recordar que todos accedemos con el nombre de usuario de nuestro correo electrónico. Pinchamos sobre Páginas especiales situado en el menú herramientas en el lateral izquierdo de JMathWiki. En la página a la que accedemos buscamos el apartado Usuarios y permisos, pinchando sobre Cambiar la contraseña accedemos a una página en la que introducimos la contraseña antigua y dos veces la nueva. Finalmente pulsando el botón Cambiar contraseña tendremos una nueva contraseña para acceder a la wiki. Ilustración 22.- Detalle página Cambiar la contraseña Versión para imprimir: Si deseamos imprimir una página de JMathWiki, podemos usar la herramienta Versión para imprimir 21

22 Ilustración 24.- Detalle versión para imprimir que nos encontramos en el menú herramientas en el lateral izquierdo de nuestra pantalla. Pulsándolo nos genera una ventana del navegador que podemos imprimir sin tener que imprimir los marcos de la wiki. 22