Xamarin ドキュメント、docs.microsoft.com でリリース
この投稿は、Xamarin のプリンシパル プログラム マネージャーである Craig Dunn によって執筆されました。
注意
このお知らせは Xamarin ブログからのクロスポストです。
今日はまず、モバイル開発者向けドキュメントである Xamarin ドキュメントの新しい章について説明します。このドキュメントは docs.microsoft.com/xamarin でご覧いただけるようになりました。 新しいドキュメント エクスペリエンスの概要をいくつか以下に示します。
ドキュメントのすべてのオプションには、docs.microsoft.com/xamarin から 1 回または 2 回クリックすることで移動できます。 ヘッダーの [Xamarin] をクリックすると、任意のページからここに戻ります。 モバイル開発者向けドキュメントを表示するには、プラットフォーム リンクを使用します。SkiaSharp、Workbooks、Xamarin Live Plyer などの関連トピックの詳細を確認する場合は、[グラフィックスとゲーム] タブまたは [ツール] タブに切り替えます。
docs.microsoft.com では、次のように、Xamarin ドキュメントを移動するための新しいオプションがいくつか提供されます。
- プラットフォームのホーム ページ – 各プラットフォームで利用可能なドキュメントの概要とクイック リファレンスです。 青いヘッダー バーのリンクを使用して、各プラットフォーム ページ (Android、iOS、Mac、Xamarin.Forms) にアクセスします。
- 検索 – Xamarin のコンテンツを検索する場合は、ヘッダーの右側にある虫眼鏡をクリックします。
- 階層リンク – ヘッダーの下にある階層リンクは、関連ドキュメントを見つけるのに役立ちます。
- ナビゲーション ツリー – ツリー ビューを使用することで、すばやくドリルダウンできます。
- ナビゲーション フィルター – ナビゲーション ツリーをフィルタリングして、トピックの見出しを見つけます。
- この記事の内容 – 記事ごとに目次が生成されます。ドキュメント内のスクロール位置の便利なインジケーターが含まれます。
- イメージ ズーム – 右下隅にある虫眼鏡アイコンのイメージをクリックすることで、詳細を表示できます。
次の「Xamarin.Forms レイアウト」トピックなど、エバンジェリストや Xamarin University からのプレゼンテーションおよびレッスンをオンラインで利用できるようになりました。
各ページには [編集] リンクが含まれているため、コミュニティは修正や更新を投稿することができます。 ドキュメントのコメントは GitHub の Issue になるため、ドキュメントに関するフィードバックの進行状況を追跡できます。 変更の送信手順については、投稿ガイドラインをお読みください。
翻訳手法を組み合わせて使用することで、Xamarin 開発者向けドキュメントを英語のほかに 13 言語 (簡体中国語、繁体中国語、チェコ語、フランス語、イタリア語、韓国語、ドイツ語、日本語、ポーランド語、ポルトガル語 (ブラジル)、ロシア語、スペイン語、トルコ語) でご利用いただけるようになりました。 国際化機能の詳細については、docs のブログを参照してください。
場合によっては、コード エディター (Visual Studio 2017 または Visual Studio for Mac) に固有の手順が必要になります。 これらは、次のように各ページ内のタブに配置されるようになりました。
次のように、コード スニペットが構文強調表示されます。[コピー] ボタンをクリックすることで、アプリのスニペットを簡単に取得できます。
Xamarin BCL API ドキュメントは .NET API ブラウザーで既に利用可能です。プラットフォーム固有の API は近日中にご利用になれます。
携帯電話、タブレット、デスクトップのいずれの場合も、次のようにナビゲーションにアクセスできる状態で、docs.microsoft.com サイトをスケーリングすることでコンテンツが明確で読みやすくなります。
濃色テーマを使用してドキュメントを読むこともできます。
API ドキュメント、ブック、サンプルなど、一部のコンテンツはまだ古いサイトでホストされていることがわかります。 チームは統合エクスペリエンスを作成するためにこれらの移行に取り組んでいます。
developer.xamarin.com の古いサイトに別れを告げるのはつらいのですが、docs.microsoft.com/xamarin で利用可能な新機能を提供できることは喜ばしいことです。Xamarin 開発者向けのドキュメント エクスペリエンスがより充実することを期待しています。 ご意見、ご要望はフォーラムからお寄せください。
追伸: 古い開発者サイトへのリンクにブックマークしている場合やブログしている場合でも心配はありません。新しいサイトの該当するページに自動的にリダイレクトされます。