Markdownファイル内のGitHub相対リンク 質問する

Markdownファイル内のGitHub相対リンク 質問する

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

たとえば、マスター ブランチに 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 に問い合わせてください。

ベストアンサー1

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.mdMarkdown 自体では、相対パスはサポートされていないようです。
次のような参照が見つかります。

[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

前述の通りインビジブルウルフ答えターゲット リンクがディレクトリであり、スペースがある場合は、%20スペースごとに を使用する必要があります。

おすすめ記事