1. ホーム
  2. github

[解決済み] Markdownファイル内のGitHub相対リンク

2022-03-07 05:58:29

質問

URLのアンカーを作成する方法はありますか? <a> Markdownファイルから、同じリポジトリとブランチ内の別のファイルへのリンク(別名、現在のブランチからの相対リンク)ですか?

例えば、masterブランチにREADME.mdというファイルがあり、以下のようなことをしたいのですが。

# My Project
is really really cool. My Project has a subdir named myLib, see below.

## myLib documentation
see documentation [here](myLib/README.md)

これにより、同じブランチ内のある .md から別の .md にリンクする際に、どのブランチにいるのかを気にする必要がなくなります (github.com のブランチ名を含む絶対 URL を使用する必要がなくなります)。

以下は、私が言いたいことの実例です。

  1. 後藤 http://github.com/rynop/testRel リンクが機能しません。
  2. 後藤 http://github.com/rynop/testRel/blob/master/README.md リンクは有効です。

この時点では開始URLがブランチ内にあるため、これは予想されることです。さて、リポジトリのルートにあるREADME.mdで現在のブランチをピックアップさせるにはどうしたらいいでしょうか?

更新情報 : を開設しました。 課題 をGitHubに投稿してください。

解決方法は?

更新情報 2013年1月30日 それから16ヶ月が経ちました。

GitHubブログ記事 マークアップファイルの相対リンク :

<ブロッククオート

今日からスタート GitHub はマークアップファイルの相対リンクをサポートします。 .
GitHub 上でドキュメントを閲覧する場合でも、ローカルで別のマークアップ・レンダラーを使う場合でも、異なるドキュメント・ファイル間で直接リンクできるようになりました。

リンクの定義とその動作の例を知りたいですか?ここにあなたのためのMarkdownがあります。
絶対リンクの代わりに

[a link](https://github.com/user/repo/blob/branch/other_file.md)

...相対リンクを使用することができます。

[a relative link](other_file.md)
[a relative link](path%20with%20spaces/other_file.md)

とリンクされるようにします。 user/repo/blob/branch/other_file.md .

のような回避策を使っていた場合 [a workaround link](repo/blob/master/other_file.md) 新しい構文を使用するために、ドキュメントを更新する必要があります。

また、このことは 常にGitHubを参照することなく、ドキュメントを簡単に独立させることができるようになりました。 .

マルコノ1234 で追加されます。 コメント

<ブロッククオート

も便利です。リンクの先頭が / マークダウンファイルがサブディレクトリにネストされているかどうかに関係なく、リポジトリのルートからの相対パスです。


2011年12月20日更新

GitHub マークアップ課題 84 が現在クローズしています。 テクノウィーニー を、コメント付きで紹介します。

<ブロッククオート

を追加してみました。 <base> タグを使用していますが、サイト内の他の相対リンクで問題が発生します。


2011年10月12日

を見ると の生ソースは README.md のMarkdown自体(!)、相対パスはサポートされていないようです。
というようなリファレンスが見つかります。

[r2h]: http://github.com/github/markup/tree/master/lib/github/commands/rest2html
[r2hc]: http://github.com/github/markup/tree/master/lib/github/markups.rb#L13


で述べたように インビジブルウルフ 's 回答 の場合、リンク先がディレクトリでスペースがある場合は %20 をスペースごとに指定します。