======Creación de Links Web======

==== Introducción ====
Existen 3 tipos de links Web: 

  *Externos: Los links que llevan a paginas externas.
  *Internos: Los links que llevan a otras paginas dentro de la Wiki
  *Interwikis y rápidos: Los links que llevan a otras wikis, por ejemplo a wikipedia, o a paginas muy usadas en internet. 

==== Links Externos ====

Los links externos son reconocidos de manera automática.\\

Por ejemplo, si queremos poner un links a google, simplemente deberemos escribir cualquiera de los siguientes dos códigos:

<file>
https://www.google.com/
</file>

<file>
www.google.com/
</file>

Los cuales respectivamente generaran estos resultados:

https://www.google.com/

www.google.com/

----
----
También es posible que se muestre un texto con el link en vez de mostrarse directamente la dirección web utilizando el siguiente código:

<file>
[["dirección web"|"texto que se mostrara"]]
</file>

Por ejemplo en el caso de google podríamos usar lo siguiente:

<file>
[[http://www.google.com|Este es un link que nos lleva a la pagina de google.]]
</file>

El cual generara el siguiente resultado:

[[http://www.google.com|Este es un link que nos lleva a la pagina de google.]] 

----
----
Las direcciones de correo electrónico también se pueden hacer linkeables mediante el siguiente código:

<file>
<"dirección de mail">
</file>

Por ejemplo:
<file>
<universidad.publica.org@gmail.com>
</file>

Generara:

<universidad.publica.org@gmail.com>

\\
De igual manera que con las direcciones web también se puede elegir mostrar un texto en vez de la dirección de mail. El código a utilizar sera:

<file>
[["dirección de mail"|"texto que se mostrara"]]
</file>

Así, tenemos que por ejemplo el código:

<file>
[[universidad.publica.org@gmail.com|Envíanos un email!!!]]
</file>

Creara en la pagina el siguiente link:

[[universidad.publica.org@gmail.com|Envíanos un email!!!]]

==== Links Internos ====

Se pueden crear links internos a paginas de esta wiki sin necesidad de escribir la dirección web completa. 

Esto se logra simplemente escribiendo el nombre de la pagina entre dos corchetes al inicio y dos corchetes al final.

Así, el código a utilizar sera:

<file>
[["nombre de la pagina"]]
</file>

Por ejemplo, si queremos poner de manera interna el link ''<nowiki>https://universidad-publica.org/doku.php?id=reglas-base:reglas-de-publicacion:reglas-de-publicacion</nowiki>'', simplemente deberemos tomar el nombre de la pagina (es decir la parte del vinculo que se encuentra a la derecha del igual) y usar el código:

<file>
[[reglas-base:reglas-de-publicacion:reglas-de-publicacion]]
</file>

Esto nos generara la siguiente salida a las "Reglas de Publicación" como se muestra a continuación:

[[reglas-base:reglas-de-publicacion:reglas-de-publicacion]]
\\
\\

Nota 1: Los nombres de las paginas siempre deben ser escritos en minúscula, aunque si por error los escribe en mayúscula la wiki automáticamente los convertirá a minúsculas. Los caracteres especiales directamente no se pueden usar.

Nota 2: Observe que los dos puntos se utilizan para ir recorriendo el árbol de jerarquía de los "espacios de nombres". 
Puede consultar mas sobre los "espacios de nombres" y sobre los "nombres de las paginas" en los siguientes links: [[doku>namespaces|Dokuwiki namespaces]] y [[doku>pagename|Dokuwiki pagenames]].
\\ 
----
----
También es posible personalizar la leyenda de los links mediante el código:

<file>
[["nombre de la pagina"|"leyenda que se mostrara en la pagina"]]
</file>

Siguiendo nuestro ejemplo, el código: 

<file>
[[reglas-base:reglas-de-publicacion:reglas-de-publicacion|Este es un link customizado a las reglas de publicación]]
</file>

Nos dará como salida:

[[reglas-base:reglas-de-publicacion:reglas-de-publicacion|Este es un link customizado a las reglas de publicación]]
\\
\\

Nota: Los links a paginas existentes se muestran con un estilo diferente al de las paginas que no existen. A modo de ejemplo: [[solicitudes-base:solicitudes:solicitudes|pagina existente]] - [[pagina que no existe]].
----
----

También es posible hacer links a secciones especificas de una pagina. Solo se debe agregar un numeral y el nombre de la sección atrás del nombre de la pagina:

<file>
[["nombre de la pagina"#"nombre de la sección interna"|"leyenda que se mostrara en la pagina"]]
</file>

Así, si por ejemplo queremos ir a la sección "Varias Lineas para un Ítem" de la pagina "Listas" que tiene el vinculo externo ''<nowiki>https://universidad-publica.org/doku.php?id=tutoriales-base:tutoriales:listas</nowiki>'' deberemos usar el código:

<file>
[[tutoriales-base:tutoriales:listas#Varias Lineas para un Ítem| Link a la sección que explica como tener una lista en la que un ítem tiene varias lineas]]
</file>

Que nos arrojara la siguiente salida:

[[tutoriales-base:tutoriales:listas#Varias Lineas para un Ítem| Link a la sección que explica como tener una lista en la que un ítem tiene varias lineas]]
\\
\\

Nota: Cuando el nombre de una sección dentro de una pagina cambia, el link deja de funcionar. Por lo que recomendamos que use con cuidado este herramienta.
\\
\\

Nota General: DokuWiki no utiliza la regla [[wp>CamelCase]] para automáticamente generar links.

Nota para administradores (usuarios ignorarla): La regla CamelCase puede ser activada en el archivo de configuraciones. Ver: [[doku>config]]. Test: Si DokuWiki es un link, es porque la regla CamelCase esta activada.

==== Links Interwiki y Links rápidos====

Es posible poner links rápidos a otras wikis y a ciertas paginas muy utilizadas sin necesidad de utilizar links externos.

El código a utilizar es:

<file>
[["clave de la wiki o pagina popular">"identificador de la pagina web en especifico"]]
</file>

Así por ejemplo:

<file>
[[wpes>Economía]]
</file>

Generara el siguiente link que nos llevara a la pagina "Economía" de la wikipedia en español :\\

[[wpes>Economía]]

Para ver la documentación completa de esta funcionalidad visite [[doku>Interwiki]]. Pero aquí tiene una lista de los atajos que probablemente sean mas utilizados:

^Sintaxis                                            ^Ejemplo                                                  ^Salida                       ^Descripción  ^
| <file>[[doku>"Nombre de la pagina"]]</file>        |''%%[[doku>manual]]%%''                                  |[[doku>manual]]              | Este atajo genera un link a una pagina en DokuWiki. En el ejemplo, un link al manual del usuario de Dokuwiki  |
| <file>[[go>"palabra clave"]]</file>                |''%%[[go>futbol]]%%''                                    |[[go>futbol]]                | Este atajo genera un link a la pagina mas popular en google sobre la palabra clave. En el ejemplo, nos llevara a la pagina de futbol mas popular en google |
| <file>[[google>"palabra clave"]]</file>            |''%%[[google>futbol]]%%''                                |[[google>futbol]]            | Este atajo nos lleva a google search y busca la palabra clave devolviendonos todos los resultados. En el ejemplo, nos buscara futbol en google  |
| <file>[[this>"pagina de nuestra wiki"]]</file>     |''%%[[this>tutoriales-base:tutoriales:tutoriales]]%%''   |[[this>tutoriales-base:tutoriales:tutoriales]]    | Este atajo nos lleva a una pagina de nuestra wiki. En el ejemplo, nos lleva a la sección de tutoriales. El nombre de la pagina puede obtenerse de la dirección web copiando lo que esta a continuación de ''%%https://universidad-publica.org/doku.php?id=%%'' |
| <file>[[wp>"Nombre de la pagina"]]</file>          |''%%[[wp>Philosophy]]%%''                                |[[wp>Philosophy]]            | Este atajo genera un link a una pagina en la Wikipedia en ingles. En el ejemplo, un link a la pagina Philosophy de Wikipedia  |
| <file>[[wpes>"Nombre de la pagina"]]</file>        |''%%[[wpes>Filosofia]]%%''                               |[[wpes>Filosofia]]           | Este atajo genera un link a una pagina en la Wikipedia en español. En el ejemplo, un link a la pagina filosofia de Wikipedia  |

~~NOTOC~~