Ací es mostren les diferències entre la revisió seleccionada i la versió actual de la pàgina.
Ambdós costats versió prèvia Revisió prèvia Següent revisió | Revisió prèvia | ||
es:sobrewiki:manual [2019/07/04 11:53] drodriguez |
es:sobrewiki:manual [2019/07/09 09:46] (actual) drodriguez [Añadir la posibilidad de comentar] |
||
---|---|---|---|
Línia 1: | Línia 1: | ||
====== Manual de la Wiki-OFSTI ====== | ====== Manual de la Wiki-OFSTI ====== | ||
### | ### | ||
- | Con este **manual** sabrás lo necesario para poder colaborar, y por lo tanto, **crear y editar contenido** de la wiki. Éste es un manual que **explica los aspectos más básicos** a tener en cuenta, pero no es su objetivo explicar todas las posibilidades que permite la wiki, ya que eso se puede encontrar en el [[https://www.dokuwiki.org/es:manual|manual oficial de Dokuwiki]]. | + | Este **manual** explica los pasos necesarios para poder colaborar en la wiki y, por lo tanto, **crear y editar contenidos**, realizar **comentarios** en las distintas entradas o **suscribirse** a páginas concretas para recibir actualizaciones. En el manual se **explican los aspectos más básicos** a tener en cuenta a la hora de interactuar con la wiki, y su contenido se puede ampliar consultando el [[https://www.dokuwiki.org/es:manual|manual oficial de Dokuwiki]]. |
### | ### | ||
- | Si antes de editar cualquier página quieres experimentar, usa nuestra [[playground:playground|página de pruebas]]. | + | \\ |
===== Cómo registrarse ===== | ===== Cómo registrarse ===== | ||
### | ### | ||
- | Si deseas colaborar en la wiki, suscribirte a páginas o publicar comentarios, es necesario registrase. Para ello simplemente accede a la página de **registro** e introduce un nombre de usuario y tu email. Seguidamente te llegará un correo con el password para poder iniciar sesión en la pantalla de **login**. | + | Si deseas colaborar en la wiki, suscribirte a páginas o publicar comentarios, es necesario estar registrdo. Para ello simplemente accede a la página de **registro** e introduce un nombre de usuario y tu correo electrónico. En cuestión de minutos te llegará un correo con la contraseña para poder iniciar sesión en la pantalla de **login**. |
### | ### | ||
- | Una vez has iniciado sesión, si deseas puedes modificar tu contraseña accediendo en la pantalla de actualización del perfil, arriba a la derecha: | + | Habiendo iniciado sesión, puedes modificar tu contraseña accediendo en la pantalla de actualización del perfil, en la opción correspondiente del menú superior derecho: |
{{ :sobrewiki:manual1.png |}} | {{ :sobrewiki:manual1.png |}} | ||
+ | \\ | ||
===== Editar una página ===== | ===== Editar una página ===== | ||
### | ### | ||
- | Si estás registrado puedes editar cualquiera de las páginas de la sección de "Contenidos", las cuales son: [[es:contenidos:interoperabilidad|interoperabilidad]], [[es:contenidos:sintactica|sintáctica]], [[es:contenidos:semantica|semántica]] y [[es:contenidos:estandares|estándares]]. De ésta manera puedes ayudar a mejorar éstas páginas ampliándola con tus conocimientos o simplemente corregir algún error que hayas detectado. | + | Si estás registrado puedes editar cualquiera de las páginas que esté dentro de la sección de "Contenidos". Para acceder al modo de edición, entra dentro de la propia página y haz clic sobre el botón "Editar ésta página" ubicado a la derecha de la misma. |
- | ### | + | |
- | Para editar cualquiera de éstas páginas, entra dentro de la propia página y clica sobre el botón "Editar ésta página" ubicado a la derecha de la página. | + | |
{{ :sobrewiki:manual2.png |}} | {{ :sobrewiki:manual2.png |}} | ||
- | ===== Ventana de edición ===== | + | __**Ventana de edición**__ |
### | ### | ||
- | La ventana de edición es el espacio donde puedes escribir y editar el contenido que desees. Ésta te proporciona una barra de herramientas que te permite darle formato al texto, insertar imágenes o incluir hipervínculos, entre otras opciones habituales en cualquier programa de edición de texto. | + | La ventana de edición es el espacio donde puedes escribir y editar el contenido que desees. Esta te proporciona una barra de herramientas que te permite darle formato al texto, insertar imágenes o incluir hipervínculos, entre otras opciones habituales en cualquier programa de edición de texto. |
### | ### | ||
{{ :sobrewiki:manual3.png |}} | {{ :sobrewiki:manual3.png |}} | ||
Línia 28: | Línia 26: | ||
El formato al texto se puede aplicar simplemente seleccionando el texto y clicando sobre el botón correspondiente, o introducir los caracteres especiales de Dokuwiki antes y después del texto. Por ejemplo, incluir doble asterisco antes y después de una palabra o texto, le da el formato de **negrita**. | El formato al texto se puede aplicar simplemente seleccionando el texto y clicando sobre el botón correspondiente, o introducir los caracteres especiales de Dokuwiki antes y después del texto. Por ejemplo, incluir doble asterisco antes y después de una palabra o texto, le da el formato de **negrita**. | ||
### | ### | ||
- | Si quieres más información sobre la sintaxis y edición del texto con las herramientas de Dokuwiki, consulta el apartado de [[https://www.dokuwiki.org/wiki:syntax|sintaxis]] del manual oficial de Dokuwiki. | + | Si quieres más información sobre la sintaxis y edición del texto con las herramientas de Dokuwiki, consulta el apartado de [[https://www.dokuwiki.org/wiki:syntax|sintaxis]] del manual oficial. |
+ | __**Uso de HTML y PHP**__ | ||
+ | ### | ||
Dokuwiki también te permite usar código HTML y código PHP para darle formato al texto o incluir otros tipos de elementos como capas, frames, formularios, etc. | Dokuwiki también te permite usar código HTML y código PHP para darle formato al texto o incluir otros tipos de elementos como capas, frames, formularios, etc. | ||
### | ### | ||
- | Para usar HTML simplemente hay que incluir el contenido entre las etiquetas **<HTML>** y **</HTML>**, o para incluir contenido en PHP éste se ha de incluir entre las etiquetas **<PHP>** y **</PHP>**. | + | Para usar HTML o PHP simplemente hay que incluir el contenido entre las etiquetas **<HTML>** y **</HTML>**, y **<PHP>** y **</PHP>** respectivamente. |
### | ### | ||
Por ejemplo, el siguiente código HTML crea la tabla que se muestra a continuación: | Por ejemplo, el siguiente código HTML crea la tabla que se muestra a continuación: | ||
{{ :sobrewiki:manual4.png |}} | {{ :sobrewiki:manual4.png |}} | ||
- | {{ :es:sobrewiki:manual8.png |}} | + | <html> |
+ | <table style="width:100%"> | ||
+ | <tr> | ||
+ | <th>Nombre</th> | ||
+ | <th colspan="2">Teléfono</th> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Lucía García</td> | ||
+ | <td>55577854</td> | ||
+ | <td>55577855</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </html> | ||
### | ### | ||
Para más información sobre la inclusión de contenido en HTML o PHP, se puede consultar el [[https://www.dokuwiki.org/wiki:syntax#embedding_html_and_php|apartado correspondiente]] en el manual oficial de Dokuwiki. | Para más información sobre la inclusión de contenido en HTML o PHP, se puede consultar el [[https://www.dokuwiki.org/wiki:syntax#embedding_html_and_php|apartado correspondiente]] en el manual oficial de Dokuwiki. | ||
### | ### | ||
- | + | \\ | |
- | ===== Creación de nuevas páginas ===== | + | ===== Creación de páginas nuevas ===== |
### | ### | ||
- | Si deseas crear nuevas páginas, ya sea para publicar un artículo o crear nuevas secciones en nuevas páginas, primero has de tener en cuenta desde dónde se accede a ésta o éstas páginas que deseas crear, ya que primero se han de crear los enlaces (hipervínculos). | + | Para crear una nueva página primero es necesario identificar desde dónde se accederá a ésta, ya que como paso previo a su creación, se tiene que crear su referencia (hipervínculo). Para indicar la referencia se tiene que acceder a la página que la contendrá, e introducir el nombre de la página nueva y el texto a mostrar, separados por el símbolo | e incluídos entre los símbolos que usa Dokuwiki para los enlaces: <html>[[ y ]]. Por ejemplo; [[mi_nueva_pagina|Mi nueva página]]</html>. |
- | ###### | + | |
- | Para crear un enlace, se introduce el nombre de la página y el texto separados por el símbolo | e incluídos entre los símbolos que usa Dokuwiki para los enlaces; estos son **<html>**[[ y ]]. Por ejemplo; [[mi_nueva_pagina|Mi nueva página]]**</html>**. | + | |
###### | ###### | ||
- | Una vez guardada la página donde se ha creado el enlace, éste se marcará de color rojo indicando de que el enlace creado todavía contiene una página inexistente. Para crear la página simplemente se clica sobre el enlace creado, y posteriormente sobre el botón de "Crear esta página" que se muestra a la derecha de la pantalla. | + | Una vez guardada la página donde se ha creado la referencia, este se marcará de <html><font color="red">color rojo</font></html>, indicando que la página relacionada todavía no existe. Para crear la página simplemente se tiene que hacer clic sobre el enlace creado, y posteriormente sobre el botón "Crear esta página" que se muestra a la derecha de la pantalla. |
### | ### | ||
{{ :sobrewiki:manual5.png |}} | {{ :sobrewiki:manual5.png |}} | ||
Si deseas más información sobre la creación de enlaces, puedes acceder al apartado de [[https://www.dokuwiki.org/wiki:syntax#links|Links]] de la documentación oficial de Dokuwiki. | Si deseas más información sobre la creación de enlaces, puedes acceder al apartado de [[https://www.dokuwiki.org/wiki:syntax#links|Links]] de la documentación oficial de Dokuwiki. | ||
+ | \\ | ||
+ | \\ | ||
+ | ===== Publicación en Castellano y Catalán ===== | ||
+ | En la Wiki-OFSTI se permite publicar en dos idiomas; en castellano y en catalán. Cuando estás en cualquier página, puedes cambiar entre un idioma u otro simplemente clicando sobre el icono correspondiente en forma de bandera, en la parte superior de la página. | ||
+ | {{ :es:sobrewiki:manual9.png |}} | ||
+ | El contenido de las páginas no se traduce automáticamente, sino que es necesario redactar la traducción. Por lo tanto, si creas una página nueva y deseas que ésta se muestre en los dos idiomas, es necesario que tras redactarla y publicarla en un idioma, cliques sobre el icono de la bandera del otro idioma. Posteriormente clica sobre el icono de creación de nueva página para empezar a crear el contenido en éste otro idioma. | ||
+ | \\ | ||
+ | \\ | ||
+ | ===== Creación de hipervínculos ===== | ||
+ | ### | ||
+ | Dokuwiki permite crear enlaces para hacer referencias a otras páginas de manera muy simple. Éstos pueden ser enlaces internos o externos, es decir, enlaces que llevan a otras páginas dentro de la propia wiki, o enlaces que llevan a otras páginas externas fuera de la wiki. | ||
+ | ### | ||
+ | __**Creación de enlaces internos**__ | ||
+ | |||
+ | Para crear enlaces a otras páginas de la wiki, simplemente se pone entre dobles corchetes el namespace en el que se ubica la pàgina que queremos referenciar, y posteriormente el texto que se mostrará de enlace, separado por la barra vertical |. El siguiente ejemplo muestra el enlace a la página sintáctica de la wiki: | ||
+ | |||
+ | <html>[[es:contenidos:sintactica|página sintáctica]]</html> --> [[es:contenidos:sintactica|página sintáctica]] | ||
+ | |||
+ | __**Creación de enlaces externos**__ | ||
+ | |||
+ | Para crear enlaces a otras páginas externas, se pone entre dobles corchetes la **URL** en el que se ubica la pàgina que queremos referenciar, y posteriormente el texto que se mostrará de enlace, separado por la barra vertical |. El siguiente ejemplo muestra el enlace a la página www.google.com: | ||
+ | <html>[[https://www.google.com/|Google]]</html> --> [[https://www.google.com/|Google]] | ||
+ | \\ | ||
+ | \\ | ||
+ | ===== Realización de pruebas ===== | ||
+ | Antes de editar cualquier página de la wiki se pueden realizar todo tipo de pruebas con la [[playground:playground|página de pruebas]]. | ||
+ | \\ | ||
+ | \\ | ||
===== Suscribirse a páginas ===== | ===== Suscribirse a páginas ===== | ||
### | ### | ||
- | La suscripción a páginas te permite recibir un email cada vez que alguien ha realizado alguna modificación en la página suscrita. Para suscribirte a una página, simplemente tienes que clicar sobre el botón "Suscribirse a cambios de la página" situado a la derecha de la pantalla. | + | La suscripción a páginas te permite recibir un email cada vez que alguien modifique la página a la cual te hayas suscrito. Para suscribirte a una página, simplemente tienes que hacer clic sobre el botón "Suscribirse a cambios de la página" situado a la derecha de la pantalla. |
### | ### | ||
{{ :sobrewiki:manual6.png |}} | {{ :sobrewiki:manual6.png |}} | ||
- | Puedes suscribirte a tantas páginas como desees, y cancelar suscripciones siempre que quieras des del "Administrador de suscripciones". | + | Puedes suscribirte a tantas páginas como desees, y cancelar suscripciones siempre que quieras entrando en la página suscrita y clicando sobre el mismo botón con forma de sobre (mostrado en la imagen anterior) para gestionar la suscripción de la página. |
{{ :sobrewiki:manual7.png |}} | {{ :sobrewiki:manual7.png |}} | ||
+ | \\ | ||
+ | \\ | ||
+ | ===== Añadir la posibilidad de comentar ===== | ||
+ | Dokuwiki también ofrece la posibilidad de añadir un foro de discusión en las páginas creadas. De este modo, cualquier otro usuario registrado puede dejar un comentario o responder a otros usuarios en la página. | ||
+ | |||
+ | Para añadir el foro de discusión, añade el siguiente código al final de la página: | ||
+ | |||
+ | <HTML>~~DISCUSSION|Deja aquí tus comentarios</HTML> | ||
+ | Si deseas más información sobre esta característica, consulta el manual [[https://www.dokuwiki.org/plugin:discussion|aquí]]. | ||
+ | \\ | ||
---- | ---- | ||
~~DISCUSSION|Deja aquí tus comentarios o consultas sobre el funcionamiento de la wiki ~~ | ~~DISCUSSION|Deja aquí tus comentarios o consultas sobre el funcionamiento de la wiki ~~ |