Est-il possible de créer un lien relatif vers une image dans un fichier de démarque dans un résumé?

94

J'ai un résumé qui contient un fichier de démarque et une image.

Existe-t-il un moyen de faire un lien relatif vers cette image? Quelque chose comme ![My image](image.png)au lieu de![My image](https://gist.github.com/user/605560c2961cb3025038/raw/b75d2...6e8/img.png)

Voici un exemple

extraterrestre
la source

Réponses:

162

À partir de maintenant, les liens d'image relatifs fonctionnent pour moi, à la fois dans un référentiel et un wiki. J'utilise une syntaxe comme celle-ci:

![Kiku](images/Kiku.jpg)

Voici un exemple:

https://github.com/mark-anders/relative-image-url

Markand
la source
Merci! J'étais frustré d'essayer d'utiliser des images locales, mais cela a fonctionné!
Dim
Mon erreur était d'avoir un espace entre le ]et(
Peu fréquent
1
Au moins pour Github, je viens de découvrir que vous ne pouvez pas avoir d'espaces dans vos noms de fichiers ou que GitHub ne peut pas reconnaître les images locales (je ne suis pas sûr que l'ajout de guillemets résoudra ce problème)
Xiaoyong Zhu
5
Cela peut fonctionner sur les dépôts Github classiques, mais pas sur Gists ( gist.github.com ).
Beni Cherniavsky-Paskin
1
S'il y a des caractères spéciaux sur le chemin relatif de l'image que vous essayez de lier, assurez-vous qu'il est encodé en URL.
felixperreault
3

Selon http://blog.rodneyrehm.de/archives/35-Including-Data-From-Github.html , le problème lié à l'utilisation de https: //gist.github.com/user/605560c2961cb3025038/raw/b75d2 ... 6e8 / img.png

est que la b75d2...6e8partie varie selon le fichier (une expérimentation rapide confirme qu'il s'agit de l'identifiant git blob). Cependant, vous pouvez supprimer cette partie, ce qui entraîne une URL pointant vers la dernière version:

https://gist.github.com/user/605560c2961cb3025038/raw/img.png

ou pour prendre un exemple de travail:

https://gist.githubusercontent.com/cben/46d9536baacb7c5d196c/raw/dodgetocat_v2.png

Chemin relatif?

Cela fonctionne également comme chemin relatif raw/dodgetocat_v2.png!
Cependant (à la fin de 2017) github peut rendre le même contenu à partir de 2 URL:

[MISE À JOUR en décembre 2017. Les problèmes précédents de fichiers bruts servaient Content-Type: application/octet-streamet la réécriture des srcattributs des images camo.githubusercontent.comne se produisait plus, du moins pas pour les images du même contenu.]

Hélas, nous ne pouvons pas simplement utiliser la première URL et lui faire confiance pour toujours fonctionner.

  • Actuellement, aucun formulaire ne renvoie une redirection, ni ne sert un lien rel = canonical. Je ne parierais pas sur Github pour ne jamais changer cela!
  • Tous les liens internes essentiels (par exemple à partir de la page de l'utilisateur https://gist.github.com/cben/ ) omettent la barre oblique de fin :-(
  • Les éléments essentiels des résultats de recherche Google omettent la barre oblique de fin :-(

(Vous pouvez utiliser un chemin relatif 46d9536baacb7c5d196c/raw/dodgetocat_v2.pngqui ne fonctionnerait que sans barre oblique, mais c'est aussi une idée discutable, et qui en vaut moins la peine - pas vraiment plus flexible que l'URL complète.)

Vous utilisez un proxy?

Les deux peuvent être contournés avec un proxy fixant le Content-Type, par exemple Rawgit ou Bl.ocks.org (pas par Github, ne les abusez pas). Malheureusement, Rawgit ne rend pas Markdown, ne sert que les fichiers tels quels et Bl.ocks.org rend le markdown mais la structure de l'URL est telle que les liens relatifs ne fonctionneront pas. Cela signifie que vous pouvez référencer l'URL externe complète dans Markdown, ou relative en HTML :-(

Voir https://gist.github.com/cben/46d9536baacb7c5d196c/ bifurqué votre essence, et son index.html consulté via:

Beni Cherniavsky-Paskin
la source
2

Oui, le lien relatif fonctionne pour moi. J'utilise pancake.io pour héberger mes pages. http://pancake.io/2c8aa8/topics/cpp/cpp.md

Les images de cette page sont dans le cppdossier.

Le code de démarque utilisé pour la première image est

![C++ Var Types](basic_cpp_var_types.png)

Le code de démarque (en fait html) utilisé pour la deuxième image est

<div style='float: center'>
  <img style='width: 600px' src="prefixpostfixincrement.png"></img>
</div>

REMARQUE: j'ai raté l'essentiel. Essayez la méthode html si gist ne prend pas en charge la syntaxe du chemin relatif de l'image markdown.

Kaushal Modi
la source
La méthode HTML ne fonctionne pas. C'est plus un problème de Gist que de Markdown
alienlebarge
2

testé tout à l'heure ... je n'ai pas pu utiliser les URL relatives sur le wiki github.

J'ai dû ajouter l'image au dépôt wiki, puis parcourir le dépôt et demander à github de me le montrer (pour que je puisse saisir l'URL). puis utilisez l'url complète dans le démarque. mais heureusement, les URL sont simples à prédire:https://github.com/*username*/*reponame*/wiki/*imagename.png*

J'ai soumis cette isse au support github.

xero
la source