Referenciación de páginas

Esta funcion ayuda hacer la referenciacion de otras paginas pertenecientes a la misma página estática, por medio de rutas relativas. La estructura de la función se muestra a continuación:

   {{ < referenciarDoc alt="<nombre>" url= "/../documento" > }}

Se aclara que los símbolos {{, <, >, }} no deben tener espacios entre sí, es decir, se debe escribir: {{< … >}}

Parametros

alt: Corresponde a una palabra o frase a la cual irá ligada el hipervinculo.

url: Corresponde a la ruta relativa que lleva al documento que se quiere referenciar.

Esta funcion generara un texto en negrilla que al darle click llevara al documento/página deseado. Para entender mejor como encontrar los documentos, hay que tener en cuenta la estructura que tiene hugo. Tomaremos de ejemplo este directorio:

|--documentacion
   |--pagos
      |--servicios.md
      |--clientes.md
      |--_index.md
   |--areas
      |--financiero.md
      |--soporte.md
      |--_index.md
   |--_index.html

Si nos encontramos ubicados en el archivo “_index.md” del directorio “pagos” y queremos citar el archivo “clientes.md” basta con poner “clientes.md”, dado a que nos encontramos en el mismo directorio:

   {{ < referenciarDoc alt="<nombre>" url="clientes.md" > }}

Pero si se desea citar el documento de “financiero.md” ubicado en el directorio “areas”, la ruta correcta sería “../areas/financiero.md”:

   {{ < referenciarDoc alt= <nombre> url= "../areas/financiero.md" > }}

Se debe poner “../” ó “/” antes de la ruta para que la función pueda hacer la busqueda en directorios de más alto nivel. Si se desea retroceder más de un nivel, se debe poner “../” el número de niveles a retornar.

Por otro lado, si nos encontramos ubicados en el archivo “_index.md” correspondiente al directorio “documentacion” y queremos citar el documento “_index.md” que se encuentra dentro del directorio de “areas”, se puede hacer de dos maneras “../areas/_index.md” o “/areas”.

   {{ < referenciarDoc alt= <nombre> url= "../areas/_index.md" or "/areas" > }}