Incorporare immagini all'interno di un repository wiki GitHub (gollum)?

I wiki di Github sono supportati da un repository git separato, quindi dal repository principale del progetto.

Questo post del team di Github fa sembrare che dovresti essere in grado di collegare le immagini archiviate nel repository wiki all'interno del markup wiki.

Immagini e cartelle

È ora possibile fare riferimento a immagini ospitate all'interno del repository Git.

Ho controllato il repository del mio wiki e ho inserito una cartella di risorse e un'immagine al suo interno. La mia domanda è: come posso utilizzare questa immagine ?

È anche possibile o ho frainteso qualcosa?

Per usare i percorsi relativi fai:

[[foo.jpg]]

Per ulteriori informazioni, vedere la pagina wiki demo sulle immagini .

Per gli spettatori che desiderano visualizzare le immagini su un wiki di GitHub, ho trovato il seguente metodo per funzionare:

• Vai alla scheda "Git Access" all'interno della pagina wiki del tuo repository e recupera il percorso SSH che dovrebbe essere qualcosa del tipo: git@github.com: USER / REPO.wiki.git dove USER è il nome del tuo account e REPO è il nome del repository.

• Sulla tua macchina locale usa qualsiasi strumento a riga di comando Git che desideri inserire nella directory locale preferita e ottieni il repository tramite

  git clone git@github.com: USER / REPO.wiki.git

• Ora all'interno di questo repository crea una directory di immagini, la chiamerò "immagini" e inserirò le immagini che desideri nella directory

• E poi spingere la tua directory wiki git su github

• Non sarai in grado di vedere fisicamente le immagini ad esempio nella scheda "Pagine", ma se fai semplicemente riferimento alle immagini in un collegamento locale dovresti essere in grado di vederle. Esempio con Markdown di seguito:

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

• Puoi anche incorporare l'immagine come collegamento stesso avvolgendola ulteriormente in questo modo:

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

Puoi anche aggiungere sottodirectory nella tua copia locale per aiutare a organizzare il wiki poiché la scheda "pagine" le elenca semplicemente. Tieni presente, tuttavia, che anche quando viene inserita la nuova directory, la scheda "pagine" non elenca la directory.

Nessuna delle risposte sembra funzionare quando si aggiunge un'immagine readme.md. Ho una soluzione però:

Se l'URL dell'immagine è:

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

La sostituzione blobcon rawti dà l'URL dell'immagine grezza:

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

Ora, incorporerai l'immagine usando il normale markdown:

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

AGGIORNAMENTO: A partire da ora, GitHub offre anche immagini grezze da un sottodominio diverso raw.github.com. Quindi, puoi anche usare:

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

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

Il percorso relativo funziona per me in questo modo:

home page del wiki:

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

sottopagina del wiki:

![text](images/someimage.png)

Si noti che quando si esegue un'anteprima l'immagine non verrà visualizzata, l'ho salvata.

Se vuoi caricare rapidamente un'immagine con il drag / drop, puoi eseguire le seguenti operazioni (anche se hackish):

Crea un problema fittizio; trascina e rilascia la tua immagine lì; copia / incolla il codice dell'immagine markdown caricato nel tuo wiki;

Dopo aver creato il problema una volta, puoi utilizzarlo un numero qualsiasi di volte per farlo.

Spero che questo aiuti chiunque cerchi una soluzione rapida, senza bisogno che l'immagine risieda nel repository.

Ecco un modo pratico per farlo:

• Vai a qualsiasi problema su GitHub
• Nella sezione commenti puoi allegare file, basta trascinare, selezionare o incollare la tua immagine
• Copia il codice / collegamento visualizzato nella textarea
• Incollalo nel wiki
• Profitto !

Non devi nemmeno creare o modificare alcun problema rispetto alla soluzione @tiby!

Capito.

L'URL è formattato come segue

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

pathtoimage è opzionale

Il formato dell'URL di James non ha funzionato per me, forse è stato cambiato. Ho usato:

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

Dove pathtoimageè facoltativo.

Finalmente ho ottenuto le immagini nel repository usando il metodo descritto da nerdwin e le ho mostrate nel wiki usando ![test](test.jpg)

Il markdown seguente farà riferimento a un'immagine nel repository GitHub dall'interno del wiki GitHub corrispondente

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

L'esempio precedente presuppone che tu abbia la seguente struttura di file nel tuo repository

• Sentiero
  • ToAssets
    • In
      • Repo.png

Per un esempio del mondo reale, se volessi fare riferimento a questa immagine in GitHub dal wiki corrispondente, userei questo markdown

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

Avvertenze

1. Il caso conta
2. Se ti trovi nella speciale Home page del wiki, non è necessario salire di livello con ../ Nel mio esempio sopra, il collegamento corretto sarebbe

Per la home page:

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

Usa il percorso relativo

il Wiki si trova in [repositoryname]/wiki

I file nel repository si trovano in [repositoryname]/raw/master/[file path in repository]

Quindi usa il percorso relativo: ../raw/master/[file path in repository]

Ho inserito sia immagini che PDF nei miei wiki. Clone il wiki e aggiungo un fileimages una filesdirectory e, quindi utilizzo il seguente markdown per incorporare i collegamenti alle immagini e aggiungere i collegamenti ai file:

Immagini:

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

La barra iniziale non è necessaria se le tue pagine wiki sono tutte a livello di root, ma io uso sottodirectory e un percorso assoluto si risolve correttamente e mantiene le cose semplici.

File:

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

Nota, nessuna barra iniziale per il wiki files percorso da risolvere correttamente come collegamento in questo formato.

L'ho documentato con maggiori dettagli in una sintesi di GitHub

Per incorporare una miniatura dell'immagine esterna, utilizzare quanto segue, ![Image](<external link to the image>)

Il commento di @ Drew Noakes alla domanda originale lo ha fatto per me:

La sintassi per l'immagine che volevo fosse visualizzata:

[[/images/imageName.png]]

Questa immagine è stata visualizzata solo durante la ridenominazione:

wikiPage.md --> wikiPage.wiki

La seguente struttura di cartelle è stata utilizzata nel repository wiki:

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

MA:

La sintassi in .wiki è diversa dai file .md.

Molte delle risposte non hanno funzionato per me, ecco cosa ha finalmente funzionato:

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

Utilizzando la modalità dell'editor "Markdown" e una sottopagina come:

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

-John