この翻訳は不完全です。英語から この記事を翻訳 してください。
MDN の Kuma プラットフォームは内蔵のライブサンプルシステムを提供して単純な(時にはそう単純でない)コードのサンプルをその出力と共にページの中で表示する機能を提供していますが、この機能では許可されていないことがあり、またサーバへの通信を必要とするサンプルもあります。私たちは MDN サンプルサーバを用意し、このような、またその他の問題も合わせて、解決することにしました。 この記事は、そのサンプルサーバを利用するためのガイドです。
サンプルへの参照を追加する
各サンプルのコードは Github で管理されており, and we have a server instance which provides access to executable/usable installations of all of the samples. 各サンプルには固有の名前があり、リンクされる際には常にその名前のみで参照されます。以下のマクロの1つを使います。
GithubSampleLink
GithubSampleLink
は Github にある与えられた名前を持つサンプルのサンプルコードへのリンクを作成します。リンクのテキストとして使用する文字列を変更することもできます。
GithubSampleFileLink
GithubSampleFileLink
は Github にあるサンプルコードの中の指定された名前のファイルへのリンクを作成します。引数として、サンプルの名前、 リンクしたいファイルへのサンプルコード゜内での相対パスがあり、リンクのテキストを指定することもできます。
SampleServerLink
SampleServerLink
inserts a link to a user-interactive sample on the sample server. This is used to let the user go to a sample and play with it in the browser; it's not used in cases where a sample is a server-only construct referenced by client-side code found elsewhere. It accepts as input the name of the sample and, optionally, alternative text to use for the link.
進行中の作業
このページそのもの、そしてここに記述されているサーバについては、作業が継続中です。