Smile Engineering Blog

ジェイエスピーからTipsや技術特集、プロジェクト物語を発信します

GitHub Wiki でのファイル添付

はじめに

みんな大好き GitHub。issue や PR に補足資料としてパワポやエクセルのファイル、イメージを張り付けるなんてことは良くやります。この場合、Edit 欄にファイルを Drag & Drop するだけで自動的にアップロードしてリンク作成されるのですが、同じノリで Wiki ページにも貼り付けようとすると、、これができません。

さてどうすれば?

やりかた

実は Wiki ページも Git で管理されていてローカルに clone することができます。clone してみましょう。アドレスは Wiki ページの右下、Clone this wiki locally にあります。

f:id:jspnet:20200614151852p:plain

リポジトリを覗いてみると、ページが md ファイルとしてフラットに格納されているのがわかりますね。

f:id:jspnet:20200614151916p:plain

ここまで分かればあとはご想像どおり。images/ でも files/ でもディレクトリを掘り、そこにファイルを格納してリンクしてあげればよいです。

こんな感じでファイルを格納し、

f:id:jspnet:20200614151937p:plain

Wiki ページにリンクを編集します。

![overview](images/overview.png "images")

[specsheet](files/specsheet.xlsx "other type of attachments")

preview では正しく表示(ダウンロード)できないので注意です

commit & push してブラウザで表示してみると、

f:id:jspnet:20200614151958p:plain

イメージが表示されていますね。リンクをクリックするとエクセルファイルもダウンロードできます。

さいごに

GitHubWiki は Git で管理されており、リポジトリの操作でファイルのアップロードもできて、かつ Wiki ページからの参照も可能だよ、というお話でした。

参考