images github wiki gollum-wiki

images - ¿Incrustar imágenes dentro de un repositorio GitHub wiki(gollum)?



github wiki images (14)

Los wikis de Github están respaldados por un repositorio git separado y luego por el repositorio principal del proyecto.

Esta publicación del equipo de Github hace que parezca que deberías poder vincular las imágenes almacenadas en el repositorio de wiki dentro del marcado de wiki.

Imágenes y carpetas

Ahora puede hacer referencia a las imágenes alojadas dentro del repositorio de Git.

Revisé el repositorio de mi wiki e inserté una carpeta de recursos y una imagen en él. Mi pregunta es, ¿cómo hago para usar esta imagen ?

¿Es esto posible o he malentendido algo?

Usa la ruta relativa

el Wiki está ubicado en [repositoryname]/wiki

Los archivos en el repositorio se encuentran en [repositoryname]/raw/master/[file path in repository]

Entonces solo use la ruta relativa: ../raw/master/[file path in repository]

Aquí hay una forma práctica de hacerlo:

  • Ir a cualquier problema en github
  • En la sección de comentarios puedes adjuntar archivos, simplemente arrastra / suelta, selecciona o pega tu imagen
  • Copie el código / enlace que se muestra en el área de texto
  • Pégalo en la wiki
  • Lucro !

¡Ni siquiera tiene que crear o modificar ningún problema en comparación con la solución @tiby!

El camino relativo funciona para mí así:

página de inicio de la wiki:

![text](wiki/images/someimage.png)

página secundaria de la wiki:

![text](images/someimage.png)

Tenga en cuenta que al hacer una vista previa de la imagen no se mostrará, tuve que guardarlo.

El comentario de @ Drew Noakes a la pregunta original lo hizo por mí:

La sintaxis de la imagen que quería que se muestre:

[[/images/imageName.png]]

Esta imagen solo se muestra al cambiar el nombre:

wikiPage.md --> wikiPage.wiki

La siguiente estructura de carpetas se usó en el repositorio wiki:

repository.wiki |--wikiPage.wiki |--images |--imageName.png

PERO:

La sintaxis en .wiki difiere de los archivos .md.

El siguiente descuento hará referencia a una imagen en su repositorio de GitHub desde su wiki correspondiente de GitHub.

![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)

El ejemplo anterior asume que tiene la siguiente estructura de archivos en su repositorio

  • Camino
    • ToAssets
      • En
        • Repo.png

Para un ejemplo del mundo real, si quisiera hacer referencia a esta imagen en github desde la wiki correspondiente, usaría esta marca

![Azure App Settings](../blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)

Advertencias

  1. El caso importa
  2. Si está en la página de inicio especial de la wiki, no necesita subir un nivel con el ../ En mi ejemplo anterior, el enlace correcto sería

Para la página de inicio:

![Azure App Settings](blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)

Finalmente obtuve las imágenes en el repositorio usando el método descrito por nerdwin y las conseguí mostrar en la wiki usando ![test](test.jpg)

Ninguna de las respuestas parece funcionar al agregar una imagen en readme.md . Aunque tengo una solución:

Si la URL de la imagen es:

https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png

Reemplazar blob con raw le da la URL de la imagen sin formato:

https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png

Ahora, debe incrustar la imagen usando el descuento normal:

![Image Alt](https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png)

ACTUALIZACIÓN: a partir de ahora, GitHub también sirve imágenes en bruto de un subdominio diferente raw.github.com . Entonces, también puedes usar:

https://raw.github.com/Username/Repository-Name/master/Directory-Inside-Repository/image.png

EJEMPLO: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png

Para incrustar una miniatura de imagen externa, use lo siguiente ![Image](<external link to the image>)

Para los espectadores que deseen ver imágenes en una wiki de github, he encontrado que el siguiente método funciona:

  • Vaya a la pestaña "Acceso a Git" dentro de la página wiki de su repositorio y recupere la ruta SSH que debería ser algo así como: [email protected]: USER / REPO.wiki.git donde USUARIO es su nombre de cuenta y REPO es el nombre del repositorio

  • En su máquina local, utilice la herramienta de línea de comandos de Git que desee codificar en su directorio local de su elección y obtenga el repositorio a través de

    git clone [email protected]: USER / REPO.wiki.git

  • Ahora dentro de este repositorio crea un directorio de imágenes, lo llamaré "imágenes" y pondré las imágenes que quieras en el directorio

  • Y luego empuja tu directorio wiki git a github

  • No podrá ver físicamente las imágenes en, por ejemplo, la pestaña "Páginas", pero si simplemente hace referencia a las imágenes en un enlace local, debería poder verlas. Ejemplo con Markdown a continuación:

    ![Alt attribute text Here](images/YOURIMAGE.ext)

  • También puede incrustar la imagen como un enlace en sí mismo envolviéndola de la siguiente manera:

    [![Alt attribute text Here](images/YOURIMAGE.ext)](http://Yoursite.com)

También puede agregar subdirectorios dentro de su copia local para ayudar a organizar la wiki ya que la pestaña "páginas" simplemente los enumera. Tenga en cuenta, sin embargo, que incluso cuando se empuja el nuevo directorio, la pestaña "páginas" no muestra el directorio.

Puse imágenes y PDF en mis wikis. Copio el wiki y agrego un directorio de images y de files , luego utilizo el siguiente recorte para incrustar enlaces de imágenes y agregar enlaces de archivos:

Imágenes:

[[/images/path/to/image.ext|ALT TEXT]]

La barra diagonal no es necesaria si todas las páginas wiki están en el nivel raíz, pero yo uso subdirectorios y una ruta absoluta se resuelve correctamente y mantiene las cosas simples.

Archivos:

[link text](files/path/to/file.ext "ALT TEXT")

Tenga en cuenta que no hay una barra diagonal para que la ruta de los files wiki se resuelva correctamente como un enlace en este formato.

Documenté esto en una esencia de GitHub

Si desea subir una imagen rápidamente con la función de arrastrar / soltar, puede realizar lo siguiente (aunque sea hackoso):

Crea un problema ficticio; arrastre y suelte su imagen allí; copie / pegue el código de imagen de rebaja cargado en su wiki;

Después de crear el problema una vez, puede usarlo varias veces para hacerlo.

Espero que esto ayude a cualquiera que busque una solución rápida, sin necesidad de que la imagen resida en el repositorio.