La solución correcta para esto es usar referencias relativas, según esta respuesta stackoverflow.com/a/11916467/1633251 (vea el comentario con el enlace a un nuevo documento de github sobre cómo hacerlo). La respuesta corta es usar[Read more words!](docs/more_words.md)
David H
2
La mayoría de las soluciones proponen señalar el repositorio en sí. ¿Qué pasa si desea evitar los archivos binarios en el repositorio (incluso en una rama separada, como se propuso) y desea almacenarlo en un lugar externo? ¿Alguna buena práctica? ¿Un gist tal vez (IDK si gist puede ser binario o solo texto)? creando otro repositorio "myproject-assets" para el proyecto "myproject"? ¿Hay algún lugar de imagen popular externo similar al estándar de facto de YouTube para subir videos?
GitHub recomienda que utilice enlaces relativos con el ?raw=trueparámetro para garantizar que los repositorios se bifurquen correctamente.
El raw=trueparámetro está allí para garantizar que la imagen a la que se vincula se muestre tal cual. Eso significa que solo se vinculará la imagen, no toda la interfaz de GitHub para ese archivo respectivo. Vea este comentario para más detalles.
Bueno, agregué los documentos oficiales en los enlaces relativos, pero no puedo encontrar algún repositorio que los use, si tiene sugerencias, estaré encantado de ayudarlo, ya que todo el asunto es ayudar a más personas, no permanecer en el alcance (Mi error aquí).
Cuando dices /relative/path/to/img.jpg, ¿no es ese un camino absoluto debido a la barra diagonal?
jww
1
@kelvin, el raw=trueparámetro está ahí para representar la imagen a la que apunta la ruta de GitHub, no la interfaz de GitHub. Pruebe y vea la diferencia: github.com/altercation/solarized/blob/master/img/… vs github.com/altercation/solarized/blob/master/img/… . La primera URL le mostrará la interfaz de GitHub y la imagen, mientras que la segunda solo le mostrará la imagen. Los enlaces relativos siguen siendo útiles al clonar / bifurcar repositorios, por lo que sí, debe usar rutas relativas con ese parámetro, pero son dos conceptos diferentes.
Paul
70
Aunque ya hay una respuesta aceptada, me gustaría agregar otra forma de cargar imágenes para leerme en GitHub.
Debes crear un problema en tu repositorio
Arrastra y suelta en el área de comentarios tu imagen
Después de generar el enlace para la imagen, insértelo en el archivo Léame
Me interesa cuánto tiempo vivirán las imágenes cargadas de esta manera. ¿Github realiza la limpieza de algunas imágenes? Como, "si esta imagen no hace referencia a ningún problema de Github, puedo eliminarla con seguridad" ...
artin
1
@Artin probablemente solo cuando el problema se elimine por completo. Temas cerrados se quedan para siempre, ya que desempeñan un papel muy importante en la documentación y depuración
andrhamm
55
Descubrí que la ruta a la imagen en mi repositorio no era suficiente, tenía que vincular a la imagen en el raw.github.comsubdominio.
Formato de URL https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Ejemplo de descuento ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
Votando a favor de esto debido al comentario de @sorens sobre la respuesta aceptada. Es malo especificar un baño absoluto ya que no funcionará bien en repositorios bifurcados. (O si cambia el nombre de su repositorio, o si github cambia el nombre de dominio, etc., etc.)
Linus Unnebäck
77
@ LinusUnnebäck: Hay una buena razón para usar rutas absolutas en mi humilde opinión: si el readme.md también se usa en otros lugares, por ejemplo, como una página principal de Doxygen. Los enlaces relativos no funcionarán entonces.
Ela782
1
@ Ela782 aunque, en una nota adicional, eso no debería ser un problema para el software que está extrayendo archivos README específicamente de GitHub ; dicho software debe saber resolver adecuadamente las URL relativas. npm hace , por ejemplo.
Mark Amery el
¿Cómo vincular a la imagen en el raw.github.comsubdominio? ¿Dónde cargar el archivo de imagen?
Saif
@Saif raw.github.com es solo un reflejo de lo que está comprometido con su repositorio de github. Simplemente envíe la imagen a su repositorio y siga el formato de URL especificado.
-1 por la razón dada por @ shaobin0604; los documentos oficiales recomiendan usar enlaces relativos al vincular a un archivo en su propio repositorio, de modo que el enlace apunte al lugar correcto cuando se bifurca.
Mark Amery el
17
La sintaxis de reducción para mostrar imágenes es:
![image](https://{url})
PERO: ¿Cómo proporcionar el url?
Probablemente no desee saturar su repositorio con capturas de pantalla, no tienen nada que ver con el código
es posible que no desee lidiar con la molestia de hacer que su imagen esté disponible en la web ... (cárguela en un servidor ...).
Entonces ... puedes usar este increíble truco para hacer que github aloje tu archivo de imagen. TDLR:
crear un problema en la lista de problemas de su repositorio
arrastre y suelte su captura de pantalla sobre este problema
copie el código de descuento que github acaba de crear para que pueda mostrar su imagen
Crea un problema relacionado con la adición de imágenes
Agregue la imagen arrastrando y soltando o seleccionando un archivo
Luego copie la fuente de la imagen
Ahora agregue ![Screenshot](http://url/to/img.png)a su archivo README.md
¡Hecho!
Alternativamente, puede usar algún sitio de alojamiento de imágenes como imgury obtener su url y agregarlo en su archivo README.md o también puede usar algún alojamiento de archivo estático.
Primero, cree un directorio (carpeta) en la raíz de su repositorio local que contendrá el screenshotsque desea agregar. Llamemos al nombre de este directorio screenshots. Coloque las imágenes (JPEG, PNG, GIF, `etc.) que desea agregar a este directorio.
En segundo lugar, debe agregar un enlace a cada imagen en su archivo README. Entonces, si tengo imágenes nombradas 1_ArtistsActivity.pngy 2_AlbumsActivity.pngen mi directorio de capturas de pantalla, agregaré sus enlaces de esta manera:
Si desea cada captura de pantalla en una línea separada, escriba sus enlaces en líneas separadas. Sin embargo, es mejor si escribe todos los enlaces en una línea, separados solo por espacio. Puede que en realidad no se vea muy bien, pero al hacerlo, GitHub los organiza automáticamente para usted.
Debe completar las sustituciones reales anteriores (por ejemplo, MY_IMAGE = image.jpg) para que esto funcione.
Pero, espera ... fracaso: ¡no hay una foto renderizada real! ¡Y el enlace es exactamente como lo proporciona Google Storage!
Github camo- Imágenes anónimas
Github aloja tus imágenes de forma anónima , ¡sí! Sin embargo, esto presenta un problema para los activos de almacenamiento de Google. Debe obtener la URL generada de su Google Cloud Console.
Estoy seguro de que hay una manera más fluida, sin embargo, simplemente visite el punto final de su URL y copie la URL larga. Detalles:
FYI: parece que algo está cambiando en el lado de Google o Github. He tenido algunas imágenes en README que fallaron a través de este método, y algunas estaban funcionando a partir de la tarde del 28 de marzo de 2020. ¡YMMV aquí!
Jason R Stevens CFA
0
Para mí, la mejor manera es ...
Cree un nuevo problema con ese repositorio en github y luego cargue el archivo en formato gif. Para convertir archivos de video a formato gif, puede usar este sitio web http://www.online-convert.com/
Envíe el problema recién creado.
Copie la dirección del archivo cargado
Finalmente en su archivo README poner! [Demo] (DIRECCIÓN COPIADA)
Con las imágenes ubicadas en el /screen-shotsdirectorio. El exterior <div>permite posicionar las imágenes. El relleno se logra usando <img width="desired-padding" height="0">.
[Read more words!](docs/more_words.md)
Respuestas:
Si usa Markdown (README.md):
Siempre que tenga la imagen en su repositorio, puede usar una URL relativa:
Si necesita incrustar una imagen alojada en otro lugar, puede usar una URL completa
GitHub recomienda que utilice enlaces relativos con el
?raw=true
parámetro para garantizar que los repositorios se bifurquen correctamente.El
raw=true
parámetro está allí para garantizar que la imagen a la que se vincula se muestre tal cual. Eso significa que solo se vinculará la imagen, no toda la interfaz de GitHub para ese archivo respectivo. Vea este comentario para más detalles.Vea un ejemplo: https://raw.github.com/altercation/solarized/master/README.md
Si utiliza IVS entonces usted tendrá que establecer el atributo esterilice a
true
así:?raw=true&sanitize=true
. (Gracias @EliSherer)Además, la documentación sobre enlaces relativos en archivos README: https://help.github.com/articles/relative-links-in-readmes
Y, por supuesto, los documentos de rebajas: http://daringfireball.net/projects/markdown/syntax
Además, si crea una nueva rama
screenshots
para almacenar las imágenes, puede evitar que estén en elmaster
árbol de trabajoLuego puede incrustarlos usando:
fuente
/relative/path/to/img.jpg
, ¿no es ese un camino absoluto debido a la barra diagonal?raw=true
parámetro está ahí para representar la imagen a la que apunta la ruta de GitHub, no la interfaz de GitHub. Pruebe y vea la diferencia: github.com/altercation/solarized/blob/master/img/… vs github.com/altercation/solarized/blob/master/img/… . La primera URL le mostrará la interfaz de GitHub y la imagen, mientras que la segunda solo le mostrará la imagen. Los enlaces relativos siguen siendo útiles al clonar / bifurcar repositorios, por lo que sí, debe usar rutas relativas con ese parámetro, pero son dos conceptos diferentes.Aunque ya hay una respuesta aceptada, me gustaría agregar otra forma de cargar imágenes para leerme en GitHub.
Más detalles puedes encontrar aquí
fuente
Descubrí que la ruta a la imagen en mi repositorio no era suficiente, tenía que vincular a la imagen en el
raw.github.com
subdominio.Formato de URL
https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Ejemplo de descuento
![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
fuente
raw.github.com
subdominio? ¿Dónde cargar el archivo de imagen?fuente
Una línea a continuación debe ser lo que buscas
si su archivo está en el repositorio
si su archivo está en otra url externa
fuente
La sintaxis de reducción para mostrar imágenes es:
PERO: ¿Cómo proporcionar el
url
?Entonces ... puedes usar este increíble truco para hacer que github aloje tu archivo de imagen. TDLR:
http://solutionoptimist.com/2013/12/28/awesome-github-tricks/
fuente
Mucho más simple que agregar URL Simplemente cargue una imagen en el mismo repositorio, como:
![Screenshot](screenshot.png)
fuente
agregue esto a README
fuente
Reducción:
![Screenshot](http://url/to/img.png)
Luego copie la fuente de la imagen
Ahora agregue
![Screenshot](http://url/to/img.png)
a su archivo README.md¡Hecho!
Alternativamente, puede usar algún sitio de alojamiento de imágenes como
imgur
y obtener su url y agregarlo en su archivo README.md o también puede usar algún alojamiento de archivo estático.Problema de muestra
fuente
Método 1-> Modo de reducción
Método 2-> forma HTML
o
Nota -> Si no quieres darle estilo a tu imagen, es decir, cambiar el tamaño, elimina la parte de estilo
fuente
Primero, cree un directorio (carpeta) en la raíz de su repositorio local que contendrá el
screenshots
que desea agregar. Llamemos al nombre de este directorioscreenshots
. Coloque las imágenes (JPEG, PNG, GIF, `etc.) que desea agregar a este directorio.Captura de pantalla de Android Studio Workspace
En segundo lugar, debe agregar un enlace a cada imagen en su archivo README. Entonces, si tengo imágenes nombradas
1_ArtistsActivity.png
y2_AlbumsActivity.png
en mi directorio de capturas de pantalla, agregaré sus enlaces de esta manera:Si desea cada captura de pantalla en una línea separada, escriba sus enlaces en líneas separadas. Sin embargo, es mejor si escribe todos los enlaces en una línea, separados solo por espacio. Puede que en realidad no se vea muy bien, pero al hacerlo, GitHub los organiza automáticamente para usted.
Finalmente, confirma tus cambios y empújalo.
fuente
Busqué en Google algunas preguntas similares y no vi ninguna respuesta con mi problema y es una solución bastante simple / fácil.
Google Cloud Storage: un enfoque ligeramente diferente de las imágenes en README
Aquí va: al igual que el OP, quería una imagen en mi README de Github y, conociendo la sintaxis de Markdown para hacerlo, la escribí:
Debe completar las sustituciones reales anteriores (por ejemplo, MY_IMAGE = image.jpg) para que esto funcione.
Github
camo
- Imágenes anónimasGithub aloja tus imágenes de forma anónima , ¡sí! Sin embargo, esto presenta un problema para los activos de almacenamiento de Google. Debe obtener la URL generada de su Google Cloud Console.
Estoy seguro de que hay una manera más fluida, sin embargo, simplemente visite el punto final de su URL y copie la URL larga. Detalles:
Instrucciones
https
nogs
) en una nueva pestaña / ventana del navegadorEsperemos que esto ayude a acelerar y aclarar este problema para cualquier otra persona.
fuente
Para mí, la mejor manera es ...
Espero que esto ayude.
fuente
Agregue la imagen en el repositorio desde la opción de cargar el archivo y luego en el archivo README
fuente
Con las imágenes ubicadas en el
/screen-shots
directorio. El exterior<div>
permite posicionar las imágenes. El relleno se logra usando<img width="desired-padding" height="0">
.fuente