Hipervínculos con destinos explicitos
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Los hipervínculos explícitos tienen 2 partes; la etiqueta y el nombre del "objetivo" del enlace.
* Delimita la etiqueta del enlace rodeandolo de comillas simples inversas "`" y finalizalo con un subrayado "(\`etiqueta\`\_)".
* Si no hay espacios en blanco ni signos de puntuación puedes finalizarlo con un subrayado y olvidar las comillas.
* (FIXME) Label of link regex representation (approx.): [^\s]_|`.+`_
* El objetivo estará cumplido empezando por 2 '.', espacio en blanco, y un '_', la etiqueta del enlace, un ':' y un espacio en blanco (.. _label:).
* Los objetivos son neutrales al espacio en blanco y no distinguen entre mayúsculas y minúsculas.
* (FIXME) Target of link regex representation (approx.): \.\.\w+_.+:\w+
* Una vez que el objetivo es definido, lo está para todo el documento y puede ser ubicado en cualquier lugar del documento.
* Los objetivos deben ser separados por líneas en blanco de cualquier cosa que no sea un objetivo. Los objetivos pueden ser listados uno detrás de otro.
* Redefinir el objetivo dará un error
* Si un objetivo no tiene una dirección dada coge la del siguiente objetivo, permitinedo cambios (para abreviados y versiones largas, por ejemplo).
Ejemplos::
This sentence has simple link_ in it.
.. _link: http://www.google.com./
This sentence has a `long link`_ in it.
This one has a link that has an address that's the `same as the long link`_ .
.. _same as the long link:
.. _long link: http://makeashorterlink.com./
Remember, `link targets`_ are case-insensitive and whitespace-neutral.
.. _LINK TARGETS: http://pythonowns.blogspot.com/
El resultado es:
This sentence has simple link_ in it.
.. _link: http://www.google.com./
This sentence has a `long link`_ in it.
This one has a link that has an address that's the `same as the long link`_ .
.. _same as the long link:
.. _long link: http://makeashorterlink.com./
Remember, `link targets`_ are case-insensitive and whitespace-neutral.
.. _LINK TARGETS: http://pythonowns.blogspot.com/
Hipervínculos con destinos implicitos
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Los hipervínculos implícitos no necesitan que sus objetivos se nombren como los hipervínculos explícitos.
* Los hipervínculos implícitos pueden definirse de 2 maneras, en línea y no en línea
* La etiqueta de un hipervínculo 'no en línea' está marcada como la etiqueta de un hipervínculo explícito excepto que '__' es usado en vez de '-'.
* Non-inline hyperlink regex representation (approx.): [^\s]__|\`.+\`__
* El objetivo para un hipervínculo implícito no en línea se caracteriza por '..', espacio en blanco, '__:', y un espacio en blanco (.. __: ); el subrayado son 2 guiones bajos y un espacio en blanco (__ ).
* Non-inline target regex representation (approx.): __\s+.+|\.\.\s+__:\s+.+
* No es necesario tener definido el objetivo antes que el siguiente vínculo anónimo, se resuelven en orden
* La etiqueta de un hipervínculo 'en línea' tienen la forma \`etiqueta \\`\_\_ .
* Inline hyperlink regex representation (approx.): \`.+\s+<.+>\`\_\_
* Se cuiadadoso con los hipervínculo en línea porque pueden volverse muy largos.
* Cuando tengas errores sobre que tienes más vínculos que objetivos, trata de solucionarlo buscando `__` y comprueba que esto significa que debe ser implícito y que si es en línea que el vínculo está escrito.
Por ejemplo
::
Here is an `implicit link`__ .
.. __: http://www.python.org./
Shorthand target is used__ below.
__ http://www.kbb.com/
This link has an `inlined `__ link.
You do not need to have the link__ target before__ the next anonymous link.
__ http://www.w3.org./
__ http://www.archive.org/
produce como resultado
Here is an `implicit link`__ .
.. __: http://www.python.org./
Shorthand target is used__ below.
__ http://www.kbb.com/
This link has an `inlined `__ link.
You do not need to have the link__ target before__ the next anonymous link.
__ http://www.w3.org./
__ http://www.archive.org/
