Jekyll utiliza Markdown-formato de enlaces, pero ¿cómo puedo enlazar a contenido interno?

[[link]] 
InformationsquelleAutor JuanPablo | 2011-01-07

5 Comentarios

  1. 228

    Ahora puedes publicar enlaces internos mediante el uso de los siguientes:

    [Some Link]({% post_url 2010-07-21-name-of-post %})
    

    Esto también se hace referencia en el Jekyll Documentación.

    https://github.com/mojombo/jekyll/pull/369

    • Alguna idea de cómo internamente enlace a una página?
    • Parece que no es posible vincular a una página. Esta PR se cerró sin que se fusionan: github.com/jekyll/jekyll/pull/369
    • Es posible conseguir el título para mostrar fácilmente, por ejemplo, representar a [Title of post](/correct/permalink) con un solo comando? Sólo pude hacerlo con el filtrado que es demasiado detallado.
    • Si usted tiene subdirectorios: [Link Text]({% post_url /dirname/2010-07-21-post %})
    • Un pequeño error: Jekyll Documentación Es post-url no post_url
    • ¿Qué es «No es cierto ya«, refiriéndose a?
    • «No es cierto ya» estaba refiriéndose a la anterior respuesta. He borrado la respuesta para mayor claridad.
    • Sólo una pequeña nota: no incluya la extensión en 2010-07-21-nombre-de-post.
    • Esto funcionó muy bien para mí [pivot]({% post_url 2015-02-03-pivot.md %}) — el uso de post_url así como de la extensión de archivo.

  2. 26

    Para las páginas, se decidió no agregar un page_url etiqueta porque tendrías que saber la ruta de acceso de la página de todos modos. Tan sólo tienes que enlace de forma manual:

    [My page](/path/to/page.html)
    

    O usted puede hacer algo grande y feo, como si desea que a través de programación a conseguir el título de la página:

    {% for page in site.pages %}
      {% if page.url == '/path/to/page.html' %}
    [{{ page.title }}]({{ page.url }})
      {% endif %}
    {% endfor %}
    
  3. 26

    Ahora es posible enlazar a otras páginas además de los puestos mediante la link etiqueta. link obras de posts, páginas, documentos en una colección, y los archivos.

    {{ site.baseurl }}{% link _collection/name-of-document.md %}
    {{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %}
    {{ site.baseurl }}{% link news/index.html %}
    {{ site.baseurl }}{% link /assets/files/doc.pdf %}
    

    Recuerde incluir la extensión de archivo cuando se utiliza el link etiqueta.
    Para utilizarla para crear un vínculo:

    [Link to a document]({{ site.baseurl }}{% link _collection/name-of-document.md %})
    [Link to a post]({{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %})
    [Link to a page]({{ site.baseurl }}{% link news/index.html %})
    [Link to a file]({{ site.baseurl }}{% link /assets/files/doc.pdf %})
    

    Ver Jekyll Documentación.

  4. 7

    Hay varias formas de vinculación en Jekyll, algunos de los cuales son ahora obsoletos.

    Con las etiquetas link

    La forma recomendada de enlace a los archivos internos es

    [Link]({{ site.baseurl }}{% link path/to/file.md %})
    

    Tenga en cuenta que esto causaría un error si el archivo se mueve o se elimina.

    Con permalinks

    Para vincular a una página sin causar errores (enlaces rotos en su lugar):

    [Link]({{ '/path/to/page/' | relative_url }})
    

    Nota que aquí se necesita saber el enlace de la página y pasar a través de la relative_url filtro para asegurarse de que es el prefijo de la dirección url base del sitio.

    El enlace de una página depende de la permalink configuración en el archivo de configuración y la permalink clave en la materia frente del archivo.

    Con jekyll-relativa-enlaces

    Si quieres usar rutas relativas (y quieres los enlaces para trabajar en GitHub rebajas view), usted debe utilizar jekyll-relativa-enlaces. Esto le permite escribir enlaces como:

    [Link](./path/to/file.md)
    
    [Link to file in parent folder](../file.md)
    
  5. 3

    Si el el contenido interno está en la misma página, a continuación, es posible acceder a él mediante el auto_ids característica. Habilitar esta en _config.yml:

    kramdown:
        auto_ids: true
    

    Con esta opción habilitada a cada título se presenta un id ref basado en el texto de encabezado. Por ejemplo

    ### My Funky Heading
    

    se convertirá en

    <h3 id="my-funky-heading">My Funky Heading</h3>
    

    Puede crear vínculos a este dentro de un mismo documento por hacer algo como esto:

    The funky text is [described below](#my-funky-heading)
    

    Puede asignar un explícito de identificación si se prefiere:

    ### My Funky Heading
    {: #funky }
    

    y un enlace a ella

    The funky text is [described below](#funky)
    

Dejar respuesta

Please enter your comment!
Please enter your name here