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

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

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

Imágenes y carpetas

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

Revisé el repositorio de mi wiki y 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 entendido mal algo?

Para usar rutas relativas, haga lo siguiente:

[[foo.jpg]]

Para obtener más información, consulte la página de la wiki de demostración sobre imágenes .

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

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

• En su máquina local, use la herramienta de línea de comandos de Git que desee guardar en el 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, cree un directorio de imágenes, lo llamaré "imágenes" y pondré las imágenes que desee en el directorio.

• Y luego empuja tu directorio git wiki a github

• No podrá ver físicamente las imágenes en 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 envolviéndola más así:

  [![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 las enumera. Sin embargo, tenga en cuenta que incluso cuando se inserta el nuevo directorio, la pestaña "páginas" no muestra el directorio.

Ninguna de las respuestas parece funcionar al agregar una imagen 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 blobcon rawle da la URL de la imagen sin procesar:

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

Ahora, incrustarías la imagen usando la reducción 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 sin procesar 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

El camino relativo funciona para mí así:

página de inicio de la wiki:

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

subpágina de la wiki:

![text](images/someimage.png)

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

Si desea cargar rápidamente una imagen con arrastrar / soltar, puede realizar lo siguiente (aunque sea hackish):

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

Después de crear el problema una vez, puede usarlo tantas veces como desee 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.

He aquí una forma práctica de hacerlo:

• Ir a cualquier problema en github
• En la sección de comentarios puede adjuntar archivos, simplemente arrastre / suelte, seleccione o pegue su 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!

Lo averigué.

La URL tiene el siguiente formato

https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension

pathtoimage es opcional

El formato de URL de James no me funcionó, tal vez se haya cambiado. He usado:

https://github.com/username/project/wiki/pathtoimage/image.extension

Donde pathtoimagees opcional.

Finalmente, llevé las imágenes al repositorio usando el método descrito por nerdwin y consiguió que se mostraran en la wiki usando ![test](test.jpg)

La siguiente rebaja hará referencia a una imagen en su repositorio de GitHub desde su correspondiente wiki 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
  • Activos
    • 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 rebaja

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

Advertencias

1. El caso importa
2. Si estás en la página de inicio especial de la wiki, no necesitas 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)

Usa la ruta relativa

el Wiki se encuentra en [repositoryname]/wiki

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

Así que usa la ruta relativa: ../raw/master/[file path in repository]

Pongo imágenes y archivos PDF en mis wikis. Clono la wiki y agrego un directorio imagesy un files, luego uso la siguiente rebaja para incrustar enlaces de imágenes y agregar enlaces a archivos:

Imágenes:

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

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

Archivos:

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

Tenga en cuenta que no hay barra inclinada para que la filesruta de la wiki se resuelva correctamente como un enlace en este formato.

Documenté esto con más detalle en una esencia de GitHub

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

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

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

[[/images/imageName.png]]

Esta imagen solo se mostró al cambiar el nombre:

wikiPage.md --> wikiPage.wiki

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

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

PERO:

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

Muchas de las respuestas no funcionaron para mí, esto es lo que finalmente funcionó:

![](../raw/master/Images/ImportantImage.png)

Usando el modo de editor "Markdown" y una subpágina como:

https://github.com/project/repo/wiki/MyPage

-Juan