Nhúng hình ảnh bên trong kho lưu trữ wiki (gollum) GitHub?

Các wiki Github được hỗ trợ bởi một kho lưu trữ git riêng biệt sau đó là kho lưu trữ dự án chính.

Bài đăng này của nhóm Github khiến bạn có vẻ như có thể liên kết đến các hình ảnh được lưu trữ trong kho wiki bên trong đánh dấu wiki.

Hình ảnh và Thư mục

Bây giờ bạn có thể tham khảo các hình ảnh được lưu trữ bên trong kho lưu trữ Git.

Tôi đã kiểm tra kho lưu trữ của wiki và đẩy một thư mục tài nguyên và một hình ảnh vào đó. Câu hỏi của tôi là, làm cách nào để sử dụng hình ảnh này ?

Điều này thậm chí có thể xảy ra hay tôi đã hiểu lầm điều gì đó?

Để sử dụng các đường dẫn tương đối, hãy làm:

[[foo.jpg]]

Để biết thêm thông tin, hãy xem trang wiki demo trên hình ảnh .

Đối với những người xem muốn xem hình ảnh trên github wiki, tôi thấy phương pháp sau hoạt động:

• Chuyển đến tab "Git Access" bên trong trang wiki của kho lưu trữ của bạn và truy xuất đường dẫn SSH sẽ giống như: git@github.com: USER / REPO.wiki.git trong đó USER là tên tài khoản của bạn và REPO là tên kho.

• Trên máy cục bộ của bạn, hãy sử dụng bất kỳ công cụ dòng lệnh Git nào bạn muốn để cd vào thư mục cục bộ mà bạn chọn và tải kho lưu trữ qua

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

• Bây giờ trong kho lưu trữ này, hãy tạo một thư mục hình ảnh, tôi sẽ gọi nó là "hình ảnh" và đặt bất kỳ hình ảnh nào bạn muốn vào thư mục

• Và sau đó đẩy thư mục wiki git của bạn lên github

• Bạn sẽ không thể nhìn thấy các hình ảnh trong tab "Trang", nhưng nếu bạn chỉ đơn giản là tham khảo các hình ảnh trong một liên kết cục bộ, bạn sẽ có thể xem chúng. Ví dụ với Markdown bên dưới:

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

• Bạn cũng có thể nhúng hình ảnh dưới dạng một liên kết bằng cách thêm nó vào như sau:

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

Bạn cũng có thể thêm các thư mục con trong bản sao cục bộ của mình để giúp tổ chức wiki vì tab "trang" chỉ đơn giản là liệt kê chúng ra. Tuy nhiên, hãy nhớ rằng ngay cả khi thư mục mới được đẩy, tab "trang" không liệt kê thư mục.

Dường như không có câu trả lời nào hoạt động khi thêm hình ảnh vào readme.md. Tôi có một giải pháp mặc dù:

Nếu URL của hình ảnh là:

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

Thay thế blobbằng rawcung cấp cho bạn URL của hình ảnh thô:

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

Bây giờ, bạn sẽ nhúng hình ảnh bằng cách sử dụng đánh dấu bình thường:

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

CẬP NHẬT: Hiện tại, GitHub cũng cung cấp hình ảnh thô từ một miền phụ khác raw.github.com. Vì vậy, bạn cũng có thể sử dụng:

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

THÍ DỤ: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png

Đường dẫn tương đối làm việc cho tôi như thế này:

trang chủ của wiki:

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

trang phụ của wiki:

![text](images/someimage.png)

Lưu ý rằng khi thực hiện xem trước, hình ảnh sẽ không hiển thị, tôi đã lưu nó.

Nếu bạn muốn nhanh chóng tải lên một hình ảnh bằng cách kéo / thả, bạn có thể thực hiện các thao tác sau (mặc dù hơi khó):

Tạo một vấn đề giả; kéo & thả hình ảnh của bạn vào đó; sao chép / dán mã hình ảnh đánh dấu đã tải lên vào wiki của bạn;

Sau khi bạn tạo vấn đề một lần, bạn có thể sử dụng nó bất kỳ số lần nào để thực hiện việc này.

Hy vọng điều này sẽ giúp bất kỳ ai đang tìm cách sửa lỗi nhanh chóng, mà không cần phải có hình ảnh nằm trong repo.

Đây là một cách thực tế để làm điều đó:

• Chuyển đến bất kỳ vấn đề nào trên github
• Trong phần bình luận, bạn có thể đính kèm tệp, chỉ cần kéo / thả, chọn hoặc dán hình ảnh của bạn
• Sao chép mã / liên kết được hiển thị trong vùng văn bản
• Dán nó vào wiki
• Lợi nhuận !

Bạn thậm chí không phải tạo hoặc sửa đổi bất kỳ vấn đề nào so với giải pháp @tiby!

Tìm ra.

Url được định dạng như sau

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

pathtoimage Là tùy chọn

Định dạng URL của James không phù hợp với tôi, có lẽ nó đã được thay đổi. Tôi đã sử dụng:

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

Đâu pathtoimagelà tùy chọn.

Cuối cùng, các hình ảnh đã được đưa vào kho lưu trữ bằng phương pháp được mô tả bởi nerdwin và hiển thị chúng trong wiki bằng cách sử dụng ![test](test.jpg)

Các markdown sau đây sẽ tham khảo một hình ảnh trong GitHub bạn repo từ bên trong GitHub tương ứng của bạn wiki

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

Ví dụ trên giả định rằng bạn có cấu trúc tệp sau trong repo của mình

• Con đường
  • ToAssets
    • Trong
      • Repo.png

Đối với một ví dụ trong thế giới thực, nếu tôi muốn tham chiếu hình ảnh này trong github từ wiki tương ứng, tôi sẽ sử dụng đánh dấu này

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

Cảnh báo

1. Vấn đề trường hợp
2. Nếu bạn đang ở trên Trang chủ đặc biệt của wiki, bạn không cần phải nâng cấp với ../ Trong ví dụ của tôi ở trên, liên kết chính xác sẽ là

Đối với Trang chủ:

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

Sử dụng đường dẫn tương đối

Wiki được đặt tại [repositoryname]/wiki

Các tệp trong kho được đặt tại [repositoryname]/raw/master/[file path in repository]

Vì vậy, chỉ cần sử dụng đường dẫn tương đối: ../raw/master/[file path in repository]

Tôi đưa cả hình ảnh và tệp PDF vào wiki của mình. Tôi sao chép wiki và thêm một imagesvà một filesthư mục, sau đó sử dụng dấu xuống sau để nhúng các liên kết hình ảnh và thêm liên kết tệp:

Hình ảnh:

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

Dấu gạch chéo ở đầu không cần thiết nếu các trang wiki của bạn đều ở cấp cơ sở, nhưng tôi sử dụng các thư mục con và một đường dẫn tuyệt đối giải quyết chính xác và giữ mọi thứ đơn giản.

Các tập tin:

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

Lưu ý, không có dấu gạch chéo ở đầu cho filesđường dẫn wiki để phân giải chính xác dưới dạng liên kết ở định dạng này.

Tôi đã ghi lại điều này với nhiều chi tiết hơn trong ý chính GitHub

Để nhúng hình thu nhỏ hình ảnh bên ngoài, hãy sử dụng cách sau, ![Image](<external link to the image>)

Nhận xét từ @ Drew Noakes cho câu hỏi ban đầu đã giúp tôi:

Cú pháp cho hình ảnh tôi muốn được hiển thị:

[[/images/imageName.png]]

Hình ảnh này chỉ được hiển thị khi đổi tên:

wikiPage.md --> wikiPage.wiki

Cấu trúc thư mục sau đã được sử dụng trong kho lưu trữ wiki:

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

NHƯNG:

Cú pháp trong .wiki khác với tệp .md.

Nhiều câu trả lời không phù hợp với tôi, đây là những gì cuối cùng đã hoạt động:

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

Sử dụng chế độ chỉnh sửa "Markdown" và một trang phụ như:

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

-John