Visual Studio Team Service における readme.md から別ページに対するリンク

Question

Visual Studio Team Service で readme.md から他のページへのリンクですが、うまくいきません。

[プロジェクトルール](./doc/page1.md)

と記述し、git リポジトリには、上記リンク先に従い ルート直下に doc ディレクトリを作成し、この中に page1.md を配置しています。ですが、実際にリンクをクリックすると 404 Page not found になってしまいます。
ちなみに、この時のリンク先 URL は http://foo.visualstudio.com/SandboxProject/doc/page1.md となります。

きっと記述方法が正しくないのかと思いますが、ご存知の方がいらっしゃったらアドバイスいただけると幸いです。

Answer 1

こんにちは。

どこで確認を行っていますか？VSTS上のwelcomeボードでしょうか。

単純に試した限りでは期待どおりに動きましたが、

まずは以下のガイダンスに従って新規ページを作成できるかどうか確認してください。

Markdown guidance

Answer 2

英語のサイトになりますが、こちらにマークダウンのリンクの説明がありました。

Create a link to another Markdown page

Team Service内のファイルへのリンクでしたら、http://***ではなく

• 相対パスは：[表示するテキスト](./target.md)
• Gitリポジトリ内の絶対パスは：[表示するテキスト](/folder/target.md)
• TFVC内の絶対パスは：[テキストを表示する]($/project/folder/target.md)

というようにすることでできるようです。

また、どうしてもURLで表現する場合は

[表示するテキスト](https://[ユーザー名].visualstudio.com/DefaultCollection/_git/SandboxProject?path=%2Fpage1.md&version=GBmaster&_a=contents)

というURLになるかと思います。

Answer 3

返信ありがとうございます。少々説明不足でした。

リンクが上手く機能しなかったのは、Welcome ページではなく Overview ダッシュボードに追加した MarkDown のウィジェットからのリンクでした。そもそも Welcomeボードを使ったこともなかったので、そちらで動作確認したら問題ありませんでした。失礼しました。

Wiki 的なダッシュボードを作成しようかなと思っていたのですが、Welcome ボードを使っていこうと思います。
（ウィジェットからのリンクがうまくいかないのはちょっと納得がいきませんが）。

Answer 4

返信ありがとうございます。

Tak1wa さんへの返信にも書きましたが、Welcome ボードでは問題ありませんでした。
教えていただいた通りの記入方法で問題なさそうです。

Answer 5

こちらで確認してみましたが、確かにOverviewダッシュボード上では404エラーになりました。
当面はwelcomeボードを使用されたほうが良いかもしれません。

以下を確認した限りでは制限らしき文言は見当たらないのですが…
Widget catalog

あとはUserVoiceで要望を上げてみても良いと思います。
https://visualstudio.uservoice.com/forums/330519-team-services