diff options
| author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2021-08-15 14:58:07 +0900 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-08-15 14:58:07 +0900 |
| commit | e9128564963422a2013bc70c655033a367087e40 (patch) | |
| tree | 41738a6ff7d4d626d79ca5f33e47d963df0827ed /files/ja/orphaned | |
| parent | c2405866c4d99a005e8d4213c0849a8febf2db04 (diff) | |
| download | translated-content-e9128564963422a2013bc70c655033a367087e40.tar.gz translated-content-e9128564963422a2013bc70c655033a367087e40.tar.bz2 translated-content-e9128564963422a2013bc70c655033a367087e40.zip | |
orphaned/MDN/Tools を削除 (#1966)
- 古いプラットフォーム向けのページであるため
Diffstat (limited to 'files/ja/orphaned')
| -rw-r--r-- | files/ja/orphaned/mdn/tools/add-ons_and_plug-ins/index.html | 34 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/feeds/index.html | 54 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/page_deletion/index.html | 62 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/page_moving/index.html | 58 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/page_regeneration/index.html | 35 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/page_watching/index.html | 50 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/put_api/index.html | 209 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/search/index.html | 159 | ||||
| -rw-r--r-- | files/ja/orphaned/mdn/tools/template_editing/index.html | 39 |
9 files changed, 0 insertions, 700 deletions
diff --git a/files/ja/orphaned/mdn/tools/add-ons_and_plug-ins/index.html b/files/ja/orphaned/mdn/tools/add-ons_and_plug-ins/index.html deleted file mode 100644 index 73fb536750..0000000000 --- a/files/ja/orphaned/mdn/tools/add-ons_and_plug-ins/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: MDN に関連するアドオンとプラグイン -slug: orphaned/MDN/Tools/Add-ons_and_plug-ins -tags: - - Landing - - MDN Meta - - Site-wide - - Tools -translation_of: MDN/Tools/Add-ons_and_plug-ins -original_slug: MDN/Tools/Add-ons_and_plug-ins ---- -<div>{{MDNSidebar}}</div><p><span class="seoSummary">MDN コミュニティのメンバーは多くの楽しく、便利なプロジェクトを立ち上げています。 MDN の利用や、内容への貢献を簡単にする、ツール、アドオン、ユーテリティを作成するものがあります。</span></p> - -<p>こうした数々のプロジェクトのリンクがここにあります。これらの多くは完成まで手助けも要るため、あなたが助けるものを探しているコーダーである場合、ここに機会が見つかるかもしれません!</p> - -<div class="twocolumns"> -<dl> - <dt><a href="https://github.com/mdn/doc-linter-webextension">MDN doc tests add-on</a></dt> - <dd>MDNの編集中に表示されるサイドバーを作成する Firefox アドオンで、コンテンツのテストと妥当性チェックを提供します。これは作業途中なので、より多くのテストを歓迎します!</dd> - <dt><a href="https://github.com/npny/mdn-automatic-translation">MDN automatic translation</a></dt> - <dd>{{Glossary("Regular_expression", "正規表現")}}ベースのルールを使って、自動的によくある用語を翻訳された形に置き換える。</dd> - <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/mdn-search/">MDN Search</a></dt> - <dd>URLバーで <code>"mdn <searchterm>"</code> とタイプすることですばやくMDN のリファレンス素材を検索することができる <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions">WebExtension</a>。 組み込みのMDN 検索をベースにしているが、より良い結果を出すようにロジックが追加されている。JavaScript と CSS リファレンスを探すのに最適化されている。</dd> - <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/mdn-interface-documentation-ge/">MDN Interface Documentation Generator</a></dt> - <dd>この Firefox アドオンは、XPCOM インターフェイス用に、適切にフォーマットされたスケルトン生成に役立ちます。しばらく更新されてないので、バージョン互換性の情報を正しく表示しませんが、いろいろと便利です。いくつか更新されたら、またかけがえないものに戻るでしょう。</dd> - <dt> </dt> - <dt><a href="https://github.com/a2sheppy/mdn-save-with-comment">Save with comment hotkey addon</a></dt> - <dd>MDNエディタのリビジョンコメント欄にすぐにスクロールさせる Firefox アドオン。つまりこれによって、あなたが編集したことに対する、小さな情報を簡単に追加できます。</dd> - <dt><a href="https://github.com/Elchi3/sublime-mdn">Sublime Text MDN search plug-in</a></dt> - <dd>コーディング中にドキュメントを得るのに、MDNをすぐに検索できる Sublime Text のプラグイン。</dd> - <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/lazarus-form-recovery/?src=mdn">Lazarus</a></dt> - <dd>定期的にフォームデータをlocal storageに自動保存する Firefox 拡張機能で、すべてのデータをクラッシュやエラーから保護します。これは MDN で作業する時に便利で、なぜなら MDN エディターのコンテンツも保存し、成果を保存する前に何か失敗した場合に戻すことができるためです。</dd> -</dl> -</div> diff --git a/files/ja/orphaned/mdn/tools/feeds/index.html b/files/ja/orphaned/mdn/tools/feeds/index.html deleted file mode 100644 index 33d383c70f..0000000000 --- a/files/ja/orphaned/mdn/tools/feeds/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: MDN の Feeds API について -slug: orphaned/MDN/Tools/Feeds -tags: - - Kuma - - MDN Meta - - Site-wide - - ツール - - リファレンス -translation_of: MDN/Tools/Feeds -original_slug: MDN/Tools/Feeds ---- -<div>{{MDNSidebar}}</div><p>MDN の wiki では、サイトの更新内容を追跡する為にフィード API が提供されています。この API はまだ作成中であるかもしれませんが、この情報は役立つかもしれません。</p> - -<h2 id="Accessing_the_feeds" name="Accessing_the_feeds">フィードへのアクセス</h2> - -<p>フィードは次の様な形式の ベース URL から始まります。</p> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/<strong><locale></strong>/docs/feeds/<strong><format></strong>/</pre> - -<p>ベース URL 内の各プレースホルダーはそれぞれ次の意味を持ちます。</p> - -<ul> - <li><code><locale></code> は、標準のロケール文字列の内の一つとします。英語版の内容を取得するのであれば "en-US"、日本語なら "ja" を指定します。URL に <code>?all_locales</code> オプションを追加しない限り、そのロケールの記事のエントリを含むようにフィルターリングされます。</li> - <li><code><format></code> は、フィードの形式です。「 <code>rss</code> 」、「 <code>atom</code> 」、「 <code>json</code> 」の何れかを選択可能です。</li> -</ul> - -<p><code>json</code> 形式を使用する場合、オプションとして <a href="http://en.wikipedia.org/wiki/JSONP">the JSONP convention</a> で JavaScript としてデータを読み込むための <code>?callback=<callback name></code> クエリパラメーターが指定可能です。</p> - -<h2 id="Available_Feeds" name="Available_Feeds">購読可能フィード</h2> - -<dl> - <dt><code>all</code></dt> - <dd>最近の記事の変更すべてを編集日付順で。新規に作成された記事も含む。すべての変更は各記事のフィードのエントリーに結ばれています。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/rss/all"> https://developer.mozilla.org/ja/docs/feeds/rss/all</a></dd> - <dt><code>revisions</code></dt> - <dd>特定の記事のリビジョンを編集日付順で。新規作成も含む。各リビジョンはフィードの別々のエントリーを持ちます。例えば: <a href="https://developer.mozilla.org/ja/docs/feeds/atom/revisions">https://developer.mozilla.org/ja/docs/feeds/atom/revisions</a></dd> - <dt><code>tag/<em><tagname></em></code></dt> - <dd>フィードの指定タグの付いた記事の更新情報のみを編集日付順で取得。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/json/tag/CSS?callback=loadFeed"> https://developer.mozilla.org/ja/docs/feeds/json/tag/CSS?callback=loadFeed</a></dd> - <dt><code>files</code></dt> - <dd>最近のファイルのアップロードまたは変更。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/atom/files"> https://developer.mozilla.org/ja/docs/feeds/atom/files</a></dd> - <dt><code>l10n-updates</code></dt> - <dd>翻訳ページの最終更新時以降に翻訳の元となる言語の記事が変更された記事のリスト (つまり、他の言語から翻訳された記事で、元の言語の記事が変更された場合)。例えば:<a href="https://developer.mozilla.org/fr/docs/feeds/atom/l10n-updates"> https://developer.mozilla.org/fr/docs/feeds/atom/l10n-updates</a></dd> - <dt><code>needs-review[/<em><reviewtype></em>]</code></dt> - <dd>要レビューとされた記事のリスト。<code>technical</code> 、<code>editorial</code> 、<code>kumascript</code> の何れかに絞って取得する事も可能。 - <ul> - <li><a href="https://developer.mozilla.org/ja/docs/feeds/json/needs-review">https://developer.mozilla.org/ja/docs/feeds/json/needs-review</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/feeds/rss/needs-review/technical">https://developer.mozilla.org/fr/docs/feeds/rss/needs-review/technical</a></li> - <li><a href="https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/editorial">https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/editorial</a></li> - <li><a href="https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/kumascript">https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/kumascrip</a></li> - </ul> - </dd> -</dl> - -<p> </p> diff --git a/files/ja/orphaned/mdn/tools/page_deletion/index.html b/files/ja/orphaned/mdn/tools/page_deletion/index.html deleted file mode 100644 index d1af0ac170..0000000000 --- a/files/ja/orphaned/mdn/tools/page_deletion/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: ページの削除 -slug: orphaned/MDN/Tools/Page_deletion -tags: - - Guide - - MDN - - MDN Project - - Page-level -translation_of: MDN/Tools/Page_deletion -original_slug: MDN/Tools/Page_deletion ---- -<div>{{MDNSidebar}}</div> - -<p>MDN からページを完全に削除することは滅多にありません。もっともよくある理由は、ページがスパムによって作成された、または間違って作成された場合です。かつては有用であったページが時代遅れの技術の記述となった場合には、削除するのではなく MDN の /Archive セクションに移動することでアーカイブされます。</p> - -<h2 id="Requesting_page_deletion" name="Requesting_page_deletion">ページの削除の申請</h2> - -<p><span class="seoSummary">MDN の<a href="/ja/docs/MDN/Community/Roles/Admins">管理者</a>だけがページを削除することができます。管理者以外のユーザーは、ページの削除をリクエストすることができます。</span></p> - -<p>ページを削除するには次のようにしてください。</p> - -<ol> - <li><strong>ページコンテンツの削除や変更はしないでください。</strong>ページ削除時にはその時点のコンテンツを記録しておきます。</li> - <li>ページに "Junk" タグを追加してください。他のタグは削除しないでください。</li> - <li>ページの削除に緊急を要する場合 (例えばコンテンツが不適切、攻撃的、あるいは技術的に危険なものである場合など) は、 <a href="mailto:mdn-admins@mozilla.org" title="Notify an administrator">MDN 管理者にお知らせください</a>。</li> -</ol> - -<p>管理者は削除が適切かどうか判断した上で、随時ページを削除していきます。</p> - -<h2 id="How_to_delete_a_page" name="How_to_delete_a_page">ページを削除するには</h2> - -<p>ページを削除すると決めた管理者は、以下のようにしてください。</p> - -<ol> - <li>削除したいページの右上隅付近にある<strong>詳細</strong>メニューを開いてください。</li> - <li><strong>このページを削除</strong>をクリックしてください。「ページの削除」画面が次のように現れます。<br> - <br> - 削除しようと選択したページのタイトルと、関連する一部のメタデータが表示されます。</li> - <li><strong>理由</strong>欄に "Spam" や "Junk" や "Created by mistake" など、適切な理由を入力してください。</li> - <li><strong>削除</strong>ボタンをクリックしてください。「文書が削除されました」画面が表示され、このページへのリンクがあれば表示されます。 (権限のないユーザーには、<strong>この文書を復元</strong>ボタンが表示されません。)</li> -</ol> - -<h2 id="Restricted_access" name="Restricted_access">アクセス制限</h2> - -<p>ページ削除ツールには文書の構造を破壊する可能性が存在するため、アクセスには上位の権限を必要とします。</p> - -<h3 id="Roles_that_have_this_permission" name="Roles_that_have_this_permission">この権限を持つロール</h3> - -<ul> - <li><a href="/ja/docs/MDN/Contribute/Admins"><strong>Admins</strong></a></li> -</ul> - -<h3 id="Conditions_for_gaining_this_permission" name="Conditions_for_gaining_this_permission">この権限を得るための条件</h3> - -<p>このツールにアクセスする権限を得るための条件は以下のとおりです。</p> - -<ul> - <li><strong>日常的に</strong>この権限を必要としていること (例えば、頻繁にスパムや間違いのページに対応する必要がある場合)。たまにしかページを削除する必要がないのであれば、管理者に依頼してください。</li> - <li>日常的に MDN を編集しており、建設的な協力の記録がある場合。</li> -</ul> - -<p>この権限を取得する手続については、<a href="/ja/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限の申請</a>を参照してください。</p> diff --git a/files/ja/orphaned/mdn/tools/page_moving/index.html b/files/ja/orphaned/mdn/tools/page_moving/index.html deleted file mode 100644 index 15c5194a7e..0000000000 --- a/files/ja/orphaned/mdn/tools/page_moving/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: ページの移動 -slug: orphaned/MDN/Tools/Page_moving -tags: - - Guide - - MDN Meta - - Page-level - - Tools -translation_of: MDN/Tools/Page_moving -original_slug: MDN/Tools/Page_moving ---- -<div>{{MDNSidebar}}</div> - -<p>なぜページ (またはページのツリー) を移動するのでしょう。サイトの階層の適切な場所ではなく、サイトの最上位に作成してしまったのかもしれません。あるいは既存の文書を整頓しているのかもしれませんね。古い内容をアーカイブする必要があるのかもしれません。このような理由で MDN はページを移動する機能を持っており、1つのページを移動するだけではなく、その下位のページをまとめて移動することもできます。</p> - -<p><span class="seoSummary"><strong>ページ移動ツール</strong>により、編集者は MDN ツリー内の文書およびそのすべてのサブページの URL またはスラッグを変更することができます。ページを整頓したり、間違った位置にあるページを修正したりするときに、とても手軽で強力なツールです。</span></p> - -<div class="note"> -<p><strong>メモ:</strong> 特別な権限を持つユーザーだけが MDN でページを移動することができます。<strong>この記事を移動</strong>という選択肢が<strong>詳細</strong> メニューに表示されない場合、使用するのに権限が必要です。この権限を得る方法については、下にある<a href="#Restricted_access">アクセス制限</a> を見てください。</p> -</div> - -<h2 id="How_to_move_pages" name="How_to_move_pages">ページを移動するには</h2> - -<p>ページまたはページのツリーを移動するには、以下のようにします。</p> - -<ol> - <li>MDN で移動したいページの右上の角にある<strong>詳細</strong> メニューを開いてください。<br> - <img alt="" src="https://mdn.mozillademos.org/files/14565/MDN_right_menu.png" style="height: 208px; width: 200px;"></li> - <li><strong>この記事を移動</strong> をクリックしてください。下のような「ページの移動」画面が表示されます。<br> - <img alt="" src="https://mdn.mozillademos.org/files/14567/MDN_page_move.png" style="height: 437px; width: 375px;"><br> - 一番上には、すべて (アルファベットが) 大文字で、移動しようとしているページのタイトルが表示され、続いてページを移動するためのフォームを正しく記入する方法についての注意書きの一覧が表示されます。ページタイトルは編集可能となっていますが、ここで変更しても反映されません。この問題の状態については、 {{bug(828533)}} を参照してください。</li> - <li><strong>新しい URL スラグ</strong>の隣の枠に、ページの移動先としたいスラグを入力してください。この行の上にあるのは <strong>URL のプレビュー</strong>で、ここに、<strong>新しい URL スラグ</strong>の値を反映した、ページ移動後のフルパスの URL が表示されます。</li> - <li>この移動操作によって影響を受ける全てのサブページの一覧が表示されます。<strong>N ページを移動</strong>ボタンと<strong>キャンセル</strong>ボタンの下にあります。サブページがなければ、その旨が表示されます。この一覧は、ページの移動が予測しなかった副作用を与えるのか判断するのに役立つかもしれません。閲覧の多いコンテンツの移動や、一度に大量のページを移動するのには注意を払ってください。</li> - <li>すべてが望み通り設定されていると分かったら、 <strong>N ページを移動する</strong>ボタンをクリックします。非同期のバックグラウンドプロセスが始まり、各ページを移動して<strong>かつ</strong>元のページにリダイレクトを設置します。ですので、古い URL もリダイレクトによって動作し続けます。移動のプロセスが完了したらメールが届きます。そのメールには、ページの新しい場所にクリックして移動できるリンクが含まれています。</li> -</ol> - -<h2 id="Restricted_access" name="Restricted_access">アクセス制限</h2> - -<p>内容をおかしな場所に移動することで害となる明らかな可能性が存在するため、このツールは誰もが使えるようにはなっていません。</p> - -<h3 id="Roles_that_have_this_permission" name="Roles_that_have_this_permission">この権限を持つロール</h3> - -<ul> - <li><a href="/ja/docs/MDN/Contribute/Admins"><strong>Admins</strong></a></li> - <li><a href="/ja/docs/MDN/Contribute/Topic_driver_role"><strong>Topic drivers</strong></a></li> - <li><a href="/ja/docs/MDN/Contribute/Localization_driver_role"><strong>Localization drivers</strong></a></li> -</ul> - -<h3 id="Conditions_for_gaining_this_permission" name="Conditions_for_gaining_this_permission">この権限を得るための条件</h3> - -<p>このツールにアクセスする権限を得るための条件は以下のとおりです。</p> - -<ul> - <li><strong>日常的に</strong>この権限を必要としていること (例えば、頻繁にページの移動を行う必要がある、あるトピックについて大きなリファクタリングを行っているなど)。たまにしかページを移動する必要がないのであれば、管理者に依頼してください。</li> - <li>日常的に MDN を編集していて、 <a href="/ja/docs/MDN/Contribute/Content/Style_guide#Page_titles">ページの命名</a> 規則に通じていること。</li> -</ul> - -<p>この権限を取得する手続については、<a href="/ja/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限の申請</a>を参照してください。</p> diff --git a/files/ja/orphaned/mdn/tools/page_regeneration/index.html b/files/ja/orphaned/mdn/tools/page_regeneration/index.html deleted file mode 100644 index 4f2e9f5cdd..0000000000 --- a/files/ja/orphaned/mdn/tools/page_regeneration/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: MDN 上のページのレンダリング -slug: orphaned/MDN/Tools/Page_regeneration -tags: - - Guide - - MDN Meta - - Page-level - - Tools -translation_of: MDN/Tools/Page_regeneration -original_slug: MDN/Tools/Page_regeneration ---- -<div>{{MDNSidebar}}</div> - -<p>MDN サイトは性能上の理由でページをキャッシュしています。 この結果、ページに対する保存済みの変更が、次回リロード時に反映されない場合があります。常にではないがしばしば、ページがの更新が処理中であることを示すバナーが表示されます。ブラウザーで強制リフレッシュしてサーバーからページをリロードできますが、サーバー上の更新が完了しないと効果がないことがあります。</p> - -<p>いくつかのページ (特に Landing ページ【訳注: 階層下のページの一覧を列挙するページ】) では、マクロを使って自動的に内容の生成と更新を行っています。Landing ページのためにこれを行うことで、作者が手動で更新しなくても、新しい記事が自動的にページに載ることが保証されます。これは長期間の貢献者には便利であり、新参者にはサイトの階層のどこにリンクすべきか分からずに成果を見失うことを避けるのに役立ちます。</p> - -<p>またあるページを別のページにトランスクルージョンする(例えば {{TemplateLink("Page")}} マクロを使って)のにも使います。</p> - -<p><span class="seoSummary">MDN は性能上の理由でレンダリングしたコンテンツをキャッシュしているため、元の素材（たとえばマクロの出力や引用されるページ）に加わった変更は自動的にはページに反映されません。そのような元の素材に頻繁に変更が加わることがわかっているならば、ページの自動生成を有効にすることを検討したくなるかもしれません。</span></p> - -<p>自動生成を有効にするには:<strong> </strong>【訳注: この機能は現在、英語版のページでのみ設定できます】</p> - -<ol> - <li><strong>EDIT</strong> ボタンをクリックし、編集モードに入ります。</li> - <li>ページタイトルの下にある <strong>Edit page title and properties</strong> をクリックします。ページのメタデータフィールドが現れます。</li> - <li><strong>Rendering max age</strong> に値を設定します。この値が、キャッシュされたページが(マクロの再実行も含めて)再生成されるスケジュールを決定します。普通は 4 または 8 Hours を指定します。 文書が頻繁に変更される技術に関しては、より少ない数値を指定しても良いでしょう。</li> - <li>変更を保存します。リビジョンコメントに、設定内容を記録しておくのは良い習慣です。例: "Rendering max age を 4 Hours に設定"</li> -</ol> - -<p>ページは指定したスケジュールに従って再生成されます。</p> - -<div class="note"> -<p><strong>注:</strong> "Edit page title and properties" オプションは、文書の作成時には現れませんので、一度保存してから開き直す必要があります。</p> -</div> diff --git a/files/ja/orphaned/mdn/tools/page_watching/index.html b/files/ja/orphaned/mdn/tools/page_watching/index.html deleted file mode 100644 index a0a92aab7a..0000000000 --- a/files/ja/orphaned/mdn/tools/page_watching/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: ページやページ群を監視・購読する -slug: orphaned/MDN/Tools/Page_watching -tags: - - Guide - - MDN Meta - - Page-level - - Tools -translation_of: MDN/Tools/Page_watching -original_slug: MDN/Tools/Page_watching ---- -<div>{{MDNSidebar}}</div> - -<p><span class="seoSummary">MDN ページを購読することで、そのページが更新・変更された時はいつでもメールで通知を受け取ることができます。</span>すべての MDN ページの右上の隅に、監視ボタンがあります。購読のオプションにアクセスするには、監視ボタンの上にポインターを動かして監視メニューを開くいてください。</p> - -<p><img alt="MDN の監視メニューのスクリーンショット" src="https://mdn.mozillademos.org/files/12551/MDN_-_Watch_Menu.png" style="border-style: solid; border-width: 1px; display: block; height: 298px; margin: 0 auto; width: 463px;"></p> - -<p>そのページだけを購読するか、サブページも一緒に購読するかをオプションで選択してください。</p> - -<h2 id="Subscribe_to_a_page" name="Subscribe_to_a_page">ページを購読する</h2> - -<p>ユーザーがそのページを編集するたびにメール通知を受け取るには、ページの上部にある詳細メニューの最初のオプション「この記事を購読」をクリックします。</p> - -<h2 id="Subscribe_to_a_page_and_all_its_sub-articles" name="Subscribe_to_a_page_and_all_its_sub-articles">ページとすべてのサブページを購読する</h2> - -<p>2つ目のオプション「この記事と全サブ記事を購読」をクリックすると、ユーザーがそのページとすべてのサブページを編集するたびにメール通知を受け取るようになります。これは購読を要求した後に追加されたサブページも含むため、将来多くのサブページが作られた場合、その通知も同様に受け取ります。</p> - -<h2 id="Unsubscribe_from_a_page" name="Unsubscribe_from_a_page">ページの購読解除</h2> - -<p>購読を解除してページの監視をやめる場合は、再び監視メニューを開いて「この記事の購読を中止」をクリックしてください。ページを購読していると「この記事の購読を中止」とだけ表示されています。ページが変更されるたびにメール通知を受けることはなくなります。</p> - -<h2 id="The_page_change_emails" name="The_page_change_emails">ページ変更のメール</h2> - -<p>ページを購読すると、ページが保存されるたびにメールを受け取ります。このメールは notifications@developer.mozilla.org から MDN アカウントに登録されたメールアドレスに送信されます。各メッセージにはこの形のタイトルがあります:</p> - -<pre class="notranslate">[MDN] ページ "<em>ページタイトル</em>" が <em>ユーザー名</em> によって変更されました</pre> - -<p>メッセージはタイトル情報の繰り返しで始まり、つぎにコンテンツの標準差分を表示して、正確に何が変更されたかを示します。変更は HTML ソースコードで表示され、 MDN のコンテンツに慣れていない場合少し読みにくいかもしれません。</p> - -<p>差分の下には、変更に対応するのに役立つ、次のようなリンクの一覧があります:</p> - -<ul> - <li>その変更を行ったユーザーの MDN プロファイルを表示する</li> - <li>MDN のオンサイト履歴機能を使ってページの新旧のバージョンを比較する</li> - <li>ブラウザーで記事自体を見る</li> - <li>記事を編集する</li> - <li>記事の履歴を見る</li> -</ul> - -<p>メールの最後には、"HTML element reference とその全サブ記事に対する編集の購読を開始しました" といった、どんな購読でメールが生成されたかの通知や、購読をやめるためのリンクがあります。購読をやめるリンクをクリックすると、その監視リクエストのメッセージを受け取らなくなります。</p> diff --git a/files/ja/orphaned/mdn/tools/put_api/index.html b/files/ja/orphaned/mdn/tools/put_api/index.html deleted file mode 100644 index 7ed48e7888..0000000000 --- a/files/ja/orphaned/mdn/tools/put_api/index.html +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: PUT API -slug: orphaned/MDN/Tools/PUT_API -tags: - - Advanced - - Automation - - Documentation - - Draft - - Guide - - MDN Meta - - PUT API - - Page-level - - Tools -translation_of: MDN/Tools/PUT_API -original_slug: MDN/Tools/PUT_API ---- -<div>{{MDNSidebar}}</div> - -<div> {{draft}}</div> - -<p><span class="seoSummary">MDN Wiki はページの全体、または一部の更新のための<strong>実験的な</strong> <a href="/ja/docs/Web/HTTP">HTTP</a> PUT API を提供しています。</span>この機能は、次のような時に便利です:</p> - -<ul> - <li>プロジェクトのページを作成し、自動ビルド、テスト、デプロイスクリプトからある節のコンテンツを更新することができる。これはコミュニティがプロジェクトの進捗の最新についていくのに役立ちます。</li> - <li>ソースコードと並行してドキュメントを提供する場合、HTML をプッシュして MDN のサブセクションにレンダリングできます。これでチームの作業フローにとって適切な方法でドキュメントを維持できて、MDN に貢献したりローカライズ担当がコンテンツを翻訳できるままになります。</li> -</ul> - -<h2 id="Testing_your_application" name="Testing_your_application">アプリケーションをテストする</h2> - -<p>MDN を実行するソフトウェアを開発する中で、次のようにいろいろなステージ上のサイトインスタンスをホストしています:</p> - -<ul> - <li>Production (<a href="http://developer.mozilla.org/">http://developer.mozilla.org/</a>), the real site with stable code and where changes to content matter.</li> - <li>Staging (<a href="http://developer.allizom.org/">http://developer.allizom.org/</a>), a version of the site where changes are throwaway and upcoming features are tested.</li> - <li>Development (<a href="http://developer-dev.allizom.org/">http://developer-dev.allizom.org/</a>), a version of the site running the absolute latest and untested code.</li> -</ul> - -<p>プロダクションサイトを無駄にしないようにするには、まずステージングに対してアプリケーションを開発する必要があります。それから、あなたが望むことを合理的に実行することができたら、それをプロダクションに反映するように再構成します。また、開発に取り組むこともできますが、問題が発生する可能性があります。</p> - -<h2 id="Creating_an_API_key" name="Creating_an_API_key">API キーを作成する</h2> - -<p>APIキーを使うと、毎回 Persona ログインするような介入を要求せずに、アプリケーションを代理人として動作させることができます。SSL 上の HTTP ベーシック認証を使ってユーザー名とパスワードを提供します。基本的な使用のトラッキングを集めて、どのように使われているかがわかるようにします。そして、たまたま持つべきでない人々に渡った場合は、アクセスを無効にするよう API キーを削除できます。</p> - -<p>If you have the correct privileges to do so, to create an API key, sign into MDN and <a href="https://developer.mozilla.org/ja/users/account/keys" title="https://developer.mozilla.org/ja/users/account/keys">visit the API keys management page</a>. This page lets you create and delete API keys, as well as inspect recent usage history. Only Mozillians in good standing can currently get API keys, since they grant abilities to automate changes to content rapidly, so unprivileged users must request the ability by filing a bug.</p> - -<p>{{NoteStart}}The above link goes to the Production site, and the same keys do not work between Production and Staging. You can also get to this page by visiting your profile on the respective site: Click on your username in the upper right of the site. On your profile page, you should see a "Manage API Keys" button.{{NoteEnd}}</p> - -<p>From there, clicking on the "<a href="https://developer.mozilla.org/ja/users/account/keys/new" title="https://developer.mozilla.org/ja/users/account/keys/new">Create a new API key</a>" button should take you to an entry form so you can submit a request for an API key.</p> - -<p>After filling out and submitting the form, you will receive a key ID and secret. These are your username and password, respectively. Copy these down somewhere safe (eg. to your application's configuration settings); the site will never display them again, and there is no recovery method. If you lose them, simply delete the API key and create another.</p> - -<h2 id="Making_a_PUT_request" name="Making_a_PUT_request">PUT リクエストを作成する</h2> - -<p>Since the PUT API works by way of HTTP, it should be compatible with the application environment and libraries of your choice. This first example uses <a href="http://curl.haxx.se/">the command-line tool cURL</a> and a UNIX shell to demonstrate how to issue a simple PUT request to MDN.</p> - -<h3 id="Request" name="Request">リクエスト</h3> - -<pre class="brush: bash notranslate"># Base URL and API key from staging (example only; substitute your own) -MDN_BASE_URL="https://developer.allizom.org" -MDN_KEY_ID="frsNFFR3w0yEALRE9IA9oN1KwoDno8vVGrzsBNvCofI" -MDN_SECRET="423PdCvnvraH0FkCDTKnizTmKGNkEdgQTi6RlEFTiWs" - -# Document-specific details -DOC_USERNAME="lmorchard" # Change this to your name -DOC_PATH=/ja//docs/User:$DOC_USERNAME/PutExample" -DOC_TYPE="text/html" -DOC_DATA="<b>HELLO WORLD</b>" - -# Putting it all together... -curl -si -X PUT -H"Content-Type: $DOC_TYPE" -d"$DOC_DATA" -u"$MDN_KEY_ID:$MDN_SECRET" "$MDN_BASE_URL$DOC_PATH"</pre> - -<p>Since there's a lot going on in this cURL invocation, the example is broken into variables:</p> - -<ul> - <li><code>MDN_BASE_URL</code> - as mentioned before, you should plan to switch your application between staging and production servers on MDN. This variable allows for that.</li> - <li><code>MDN_KEY_ID</code> - the key ID from the API key you created. Note that these are server-specific - the same keys do not work between staging and production.</li> - <li><code>MDN_SECRET</code> - the secret from the API key that corresponds with the key ID.</li> - <li><code>DOC_USERNAME</code> - change this to your MDN username.</li> - <li><code>DOC_PATH</code> - the URL path to the document with content you want to manipulate.</li> - <li><code>DOC_TYPE</code> - the content in the request will be <code>text/html</code></li> - <li><code>DOC_DATA</code> - the content sent in the PUT request body; this is the content that will be used in a new revision to the document</li> -</ul> - -<p>So, along with the variables, here are some general notes on the example and its use of the PUT API:</p> - -<ul> - <li>The key ID and secret are supplied as username and password, respectively, in HTTP Basic authentication over SSL.</li> - <li>The <code>DOC_PATH</code> for this example includes a username - presumably yours - but that's just for the sake of example and ensuring you have your own sample document to play with. You can use any URL path to any document on the wiki.</li> - <li>A <code>Content-Type</code> header is required, and lets MDN know how to process the content sent in the PUT request. Several content types are supported, and this feature will be described in greater detail shortly.</li> - <li>Content intended for the document is sent in the request body, using the representation promised in the <code>Content-Type</code> header</li> -</ul> - -<h3 id="Response" name="Response">レスポンス</h3> - -<p>There are several responses you may see if you try this example: <code>403</code>, <code>404</code>, <code>201</code>, or <code>205</code>. (You may see others, but those suggest something has gone wrong with the site. That will, hopefully, be rare.)</p> - -<h4 id="403_Forbidden" name="403_Forbidden">403 Forbidden</h4> - -<p>If either the key ID or secret are incorrect, you'll see a <code>403 Forbidden</code> response. Double check your key details and that you're using the right pair for the right server. Create a new API key, if necessary.</p> - -<h4 id="404_Not_Found" name="404_Not_Found">404 Not Found</h4> - -<p>If you've never created a document at the URL path <code>/en-US/docs/User:$MDN_USERNAME</code>, you'll see a <code>404 Not Found</code> response.</p> - -<p>{{NoteStart}}The PUT API will not automatically create parent documents. If you're creating a number of documents intended to comprise a subsection of MDN, make sure to create parent documents first from the top down in the hierarchy.{{NoteEnd}}</p> - -<h4 id="201_Created" name="201_Created">201 Created</h4> - -<p>If the parent document exists, but the path itself doesn't, you should see a <code>201 Created</code> response. This signifies that a new document was created, as opposed to an existing one having been updated.</p> - -<h4 id="205_Reset_Content" name="205_Reset_Content">205 Reset Content</h4> - -<p>In the case of an updated document, you'll see a <code>205 Reset Content</code> response. This means that the document content has been updated, and that you should reload the document if you happen to need to see the results.</p> - -<p>{{NoteStart}}MDN performs certain filtering and processing steps on content, so what you put in may not be exactly what gets served back.{{NoteEnd}}</p> - -<h2 id="Supported_Content_Types" name="Supported_Content_Types">サポートされるコンテンツのタイプ</h2> - -<p>The PUT API accepts one of several content types in the request body.</p> - -<h3 id="texthtml" name="texthtml">text/html</h3> - -<p>There are actually two forms of <code>text/html</code> accepted: fragment and document.</p> - -<h4 id="Fragment" name="Fragment">Fragment</h4> - -<p>An HTML fragment is just an arbitrary chunk of markup, and is used as-is to revise document content. This is the simplest way to update documents.</p> - -<h4 id="Document" name="Document">Document</h4> - -<p>However, if the request body consists of an <code><html></code> element containing <code><head></code> and <code><body></code> elements, it's treated as a full HTML document. In this case, the following processing happens:</p> - -<ul> - <li>From the <code><head></code> element, the contents of <code><title></code> is extracted and used as the title for the document on MDN.</li> - <li>The contents of <code><body></code> is extracted as the content for a new revision. </li> -</ul> - -<p>This is a more complex way to update documents, but is intended as a convenience to accomodate submission of existing HTML pages.</p> - -<h3 id="applicationjson" name="applicationjson">application/json</h3> - -<p>Although the <code>text/html</code> content type is handy, there are more fields belonging to documents that are useful to manage. These include the following:</p> - -<ul> - <li><code>title</code> - the document title</li> - <li><code>content</code> - the content intended for the new revision</li> - <li><code>tags</code> - tags used to organize documents: this is given as a single string, with tags separated by commas</li> - <li><code>review_tags</code> - tags used to request content reviews: this is given as a single string, with tags separated by commas</li> - <li><code>summary</code> - a comment describing the revision to be made</li> - <li><code>show_toc</code> - a flag (0/1) indicating whether the table of contents should be shown for this document</li> -</ul> - -<p>These fields can be supplied as string values in a JSON-encoded object with the <code>application/json</code> content-type in a PUT request.</p> - -<pre class="brush: bash notranslate"># Auth Stuff -DOC_USERNAME="lmorchard" # Change this to your name -MDN_KEY_ID="frsNFFR3w0yEALRE9IA9oN1KwoDno8vVGrzsBNvCofI" -MDN_SECRET="423PdCvnvraH0FkCDTKnizTmKGNkEdgQTi6RlEFTiWs" - -# Base Settings (for Staging Env) -MDN_BASE_URL="https://developer.allizom.org" -DOC_PATH=/ja//docs/User:$DOC_USERNAME/PutExample" -DOC_TYPE="application/json" - -<code class="language-bash"># Doc Content -echo '{"content": "<b>Hello World</b>", "title": "New Sample Title", "show_toc": 1, "tags": "Beginner, Tutorial", "review_tags": "editorial, technical", "summary": "Sample JSON update from the API"}' > /tmp/mdn.json - -# Submitting Content</code> -curl -X PUT -H "Content-Type: $DOC_TYPE" -d @/tmp/mdn.json -u"$MDN_KEY_ID:$MDN_SECRET" "$MDN_BASE_URL$DOC_PATH" -</pre> - -<h3 id="multipartform-data" name="multipartform-data">multipart/form-data</h3> - -<p>This content type is handled basically like <code>application/json</code> - the same fields are accepted. But, it might be less useful than JSON and is supported mainly for testing purposes.</p> - -<h2 id="Updating_a_single_section" name="Updating_a_single_section">1 つのセクションを更新する</h2> - -<p>Normally, an HTTP PUT request replaces the entirety of a document with the submitted content in a new revision. However, you can use the query parameter <code>?section</code> to constrain revision to a single section of the document and leave the rest of the content as-is. This is handy for automating changes to one part of a document that is otherwise managed by hand, or even for aggregating changes from many sources or scripts into one document.</p> - -<h3 id="Creating_document_sections" name="Creating_document_sections">文書のセクションを作成する</h3> - -<p>Documents on MDN can be broken up into sections. These sections are useful for building a table of contents, linking to specific parts, and editing subsets of document content.</p> - -<h4 id="Using_headers" name="Using_headers">Using headers</h4> - -<p>Headers (ie. <code><h2></code> .. <code><h6></code>) make sections in MDN documents. The text of each header is transformed automatically into an ID, and that's used for anchor links in the table of contents sidebar on most documents. Those auto-generated IDs can be overriden with the <code>name</code> attribute on headers. Either way, looking at the table of contents is the easiest way to see how a document is broken up into sections, and to discover the IDs for those sections.</p> - -<p>The contents of a section include its header and everything following the header up to (but not including) another header of the same or higher level. So, a section that starts with an <code><h2></code> continues until the next <code><h2></code>, including any subsections started by <code><h3></code> .. <code><h6></code>. That also means sections can be nested: An <code><h3></code> appearing after an <code><h2></code> creates a subsection, including any further nested subsections started by <code><h4></code> .. <code><h6></code>, up to the next <code><h3></code> or <code><h2></code>.</p> - -<p>@@TODO: Show an HTML example with headers, here. This is a bit confusing.</p> - -<h4 id="Using_container_elements" name="Using_container_elements">Using container elements</h4> - -<p>Setting an <code>id</code> attribute on a container element (eg. a <code><div></code> or <code><span></code> or <code><section></code>) in the source editor also creates a section, at least with respect to the PUT API. This is a bit more advanced and requires manual changes to raw HTML, rather than using the WYSIWYG editor. But, if you want to update a chunk of the page without the need for headers, this is how to do it.</p> - -<h3 id="Specifying_a_section" name="Specifying_a_section">セクションを指定する</h3> - -<ul> - <li>Look at the table of contents, note the anchor ID for the link (ie. the <code>#hash</code> part of the URL).<br> - Example: <code>https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API#Specifying_a_section</code></li> - <li>Take everything after the "#" character, and you have the section ID.<br> - Example: <code>Specifying_a_section</code></li> - <li>Add <code>?section={ID}</code> to the URL for the document, substituting the section ID for <code>{ID}</code>.<br> - Example: <code>https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section</code></li> - <li>If you view <a href="https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section" title="https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section">that URL</a> in a browser (ie. HTTP GET), you'll see just that section of the document.<br> - (For more details on what you can do with HTTP GET, see also: <a href="/ja/docs/Project:The_Kuma_API" title='/ja/docs/Project:The_Kuma_API""'>Project:The_Kuma_API</a>)</li> - <li>If you issue a PUT request to that URL, you'll modify just that section of the document.<br> - (But, don't do that to the example URL, or you'll clobber the page you're reading right now!)</li> -</ul> diff --git a/files/ja/orphaned/mdn/tools/search/index.html b/files/ja/orphaned/mdn/tools/search/index.html deleted file mode 100644 index 6bf48de476..0000000000 --- a/files/ja/orphaned/mdn/tools/search/index.html +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: MDN の検索機能 -slug: orphaned/MDN/Tools/Search -tags: - - Guide - - MDN Meta - - Site-wide - - Tools -translation_of: MDN/Tools/Search -original_slug: MDN/Tools/Search ---- -<div>{{MDNSidebar}}</div> - -<p class="summary"><span class="seoSummary">MDN のオンサイト検索機能では、外部の検索エンジンで MDN の記事を検索した時には得られない多くの機能が提供されます。この記事では MDN の検索エンジンを最大限に活用する方法を記します。</span></p> - -<h2 id="Basic_search_options" name="Basic_search_options">基本的な検索オプション</h2> - -<h3 id="Filtering_results" name="Filtering_results">結果をフィルタリングする</h3> - -<p>MDN で検索クエリの結果を表示する際に、トピック、技術レベル、文書タイプで結果をフィルタリングするオプションがあります。これは、関連するキーワードが複数の文脈で表示される可能性のあるメソッドを探している場合などに便利です。トピックフィルターを使用して、最も興味のある API の結果のみを表示することができます。これらのフィルターは、ページに設定されたタグによって、どのページを含めるか除外するかを決定します (ページを作成または編集する際に<a href="/ja/docs/MDN/Contribute/Howto/Tag">適切にタグ付けする</a>のはこれが理由です)。以下の種類のフィルターを適用することができます。</p> - -<dl> - <dt>トピック</dt> - <dd>トピックのタグに従って検索結果を絞り込む</dd> - <dt>技術レベル</dt> - <dd><strong>Beginner</strong>, <strong>Intermediate</strong>, <strong>Advanced</strong> の各タグで絞り込む</dd> - <dt>文書タイプ</dt> - <dd><strong>Example</strong>, <strong>Guide</strong>, <strong>Tools</strong> の各タグで絞り込む</dd> -</dl> - -<h2 id="Advanced_search_options" name="Advanced_search_options">高度な検索オプション</h2> - -<p>MDN 貢献者向けに特定のマクロや HTML 属性などを検索できるよう、マクロの出力ではなく生の HTML でページのソースを検索できる高度な検索機能を用意しています。</p> - -<p>今のところこの高度な検索用のユーザーインターフェイスは用意しておらず、URL で直接アクセスすることで利用できます。検索結果は通常の MDN の検索結果ページあるいは JSON フォーマットのいずれかで得られます (後者の検索結果は例えば KumaScript などから使うこともできます)。この節ではその使い方を説明します。</p> - -<p><strong>注:</strong> ここで紹介する検索クエリーは広く利用される目的で作る URL ではありません。ツールやユーティリティから使用するためのものであり、将来変更される可能性があります。クエリーのパフォーマンスも高くない場合があります。</p> - -<h3 id="Search_query_format" name="Search_query_format">検索クエリーの書式</h3> - -<p>高度な検索クエリーは検索に適切な引数を付けた URL で実行してください。ベースとなる URL は次のいずれかです。</p> - -<dl> - <dt><code>https://developer.mozilla.org/ja/search</code></dt> - <dd>通常の MDN 検索結果ページを出力とする場合はこちらを使います。</dd> - <dt><code>https://developer.mozilla.org/ja/search.json</code></dt> - <dd>JSON 形式で結果を取得する場合はこちらを使います。検索結果の書式については {{anch("JSON response body format")}} をご覧ください。</dd> -</dl> - -<p>これに続けて、欲しい結果を得るには適切なパラメータを追加してください。次のパラメータを組み合わせて利用できます:</p> - -<dl> - <dt><code>q=</code></dt> - <dd>マッチする検索クエリー。これは基本検索で使われるパラメーターと同じです。</dd> - <dt><code>locale=</code></dt> - <dd>検索対象とするロケール。既定ではすべてのロケールが対象となります。すべてのロケールを明示的に指定するにはワイルドカード "*" を指定することもできます。例えば、 <code>locale=ja</code> とすれば検索結果を日本語だけに絞り込めます。</dd> - <dt><code>css_classnames=</code></dt> - <dd>検索対象とする CSS クラス名。ページの HTML に少なくとも指定されたクラスが 1 つ以上含まれているページを検索します。</dd> - <dt><code>html_attributes=</code></dt> - <dd>検索対象とする HTML 属性テキスト。これは前方一致検索です。つまり、指定したテキストが HTML の属性文字列の始めにある場合、検索にマッチします。詳しくは下記をご覧ください。</dd> - <dt><code>kumascript_macros=</code></dt> - <dd>検索対象とする 1 つ以上の KumaScript のリスト。これをつかって特定のマクロを使った記事を検索できます。例えば、マクロを廃止する場合や、パラメータが変更され既存のページを更新する必要がある場合に便利です。</dd> - <dt><code>highlight=</code></dt> - <dd><code>true</code> か <code>false</code> のどちらかで、既定では <code>true</code> です。検索クエリーにマッチする結果の周りに <code><a href="/ja/docs/Web/HTML/Element/mark"><mark></a></code> 要素を含めるかどうかを決めます。</dd> - <dt><code>per_page=</code></dt> - <dd>100以下の数値です。既定では Kuma はページ当たり10個の結果を出力します。それとは異なる値を使用する場合にこの引数を使用してください。</dd> -</dl> - -<h3 id="Examples" name="Examples">例</h3> - -<p>検索例をいくつか示します。</p> - -<h4 id="Searching_by_locale" name="Searching_by_locale">ロケールによる検索</h4> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/en-US/search?locale=<var>ja</var></pre> - -<p>この例では日本語の記事のリストが得られます。言語 (ロケール) 以外での絞り込みはされません。このページの翻訳時点では 12092 ページが見つかります (もちろん翻訳ページは増え続けているのであなたが試すときにはもっと大きな数になっているはずです！)</p> - -<h4 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">CSS クラス名による検索</h4> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&css_classnames=<var>smaller</var></pre> - -<p>この例では CSS で <code>smaller</code> クラスを使っている記事のリストが得られます。ページ翻訳時点では 42 ページに絞り込まれます。</p> - -<h4 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">HTML 属性文字列による検索</h4> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&html_attributes=<var>style</var></pre> - -<p>この例では HTML 要素に <code>style</code> 属性が使われている記事のリストが得られます。ページ翻訳時点では 7277 ページが該当します。これらはダメなページで修正されるべきものです。少しずつ標準化したクラスで置き換えていく必要があります。</p> - -<p>属性値も含めて検索することはできますが、検索文字列に <code>=</code> や <code>/</code> を含める場合にはこれらを URL エンコードする必要があることに注意してください。例えば、www.mozilla.org にリンクしているページは次のように検索します:</p> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&html_attributes=<var>href%3D%22https%3A%2F%2Fwww.mozilla.org</var></pre> - -<p>この検索結果は 80 件になりました。www.mozilla.org にリンクしているページは意外と少ないですね！</p> - -<h4 id="KumaScript_マクロの使用状況による検索">KumaScript マクロの使用状況による検索</h4> - -<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&kumascript_macros=<var>TemplateLink</var></pre> - -<p>この例では {{TemplateLink("TemplateLink")}} マクロを使用しているページを検索します。マクロの引数が変更された時や、マクロの使用をやめたいときに検索することができます。</p> - -<h3 id="JSON_response_body_format" name="JSON_response_body_format">JSON レスポンス本文の書式</h3> - -<p>JSON で検索結果を取得する場合も、通常の検索結果ページ同様に数件ずつのページ単位で結果が返されます。各ページには検索結果に関するメタデータが含まれる KumaScript オブジェクトと、通常のページオブジェクトにページ編集用の URL フィールドが追加されたものの配列が返されます。</p> - -<p>結果のオブジェクトに含まれるデータは次の通りです。</p> - -<dl> - <dt><code>count</code></dt> - <dd>検索結果の総数</dd> - <dt><code>next</code></dt> - <dd>検索結果の次ページ URL (あるいは最終ページの場合は {{JSxRef("Global_Objects/null", "null")}})</dd> - <dt><code>previous</code></dt> - <dd>検索結果の前ページ URL (あるいは最初のページの場合は {{JSxRef("Global_Objects/null", "null")}})</dd> - <dt><code>query</code></dt> - <dd>結果を検索するのに使われた検索クエリー</dd> - <dt><code>page</code></dt> - <dd>このオブジェクトに含まれる検索結果ページ番号</dd> - <dt><code>pages</code></dt> - <dd>検索結果ページの総数</dd> - <dt><code>start</code></dt> - <dd>このページの結果のうち最初の項目の番号</dd> - <dt><code>end</code></dt> - <dd>このページの結果のうち最後の項目の番号</dd> - <dt><code>filters</code></dt> - <dd>さまざまな検索フィルターの設定を含めた配列。通常の検索に利用可能なフィルターです</dd> - <dt><code>documents</code></dt> - <dd>マッチしたページの{{anch("Page_objects", "ページオブジェクト")}}の配列</dd> -</dl> - -<h4 id="Page_objects" name="Page_objects">ページオブジェクト</h4> - -<p>各ページオブジェクトには次のものが含まれます。</p> - -<dl> - <dt><code>title</code></dt> - <dd>記事タイトル</dd> - <dt><code>slug</code></dt> - <dd>記事のスラグ。ページの URL のうち、ロケール名とスラッシュに続くものすべてです。</dd> - <dt><code>locale</code></dt> - <dd>ページのロケール</dd> - <dt><code>excerpt</code></dt> - <dd>ページコンテンツの断片 (スニペット)。これは記事本文の冒頭部分か、"SEO Summary" クラスが使われていればそのクラスで指定されたコンテンツ。<a href="/ja/docs/MDN/Contribute/Tools/Search$edit#Search_query_format">検索クエリ引数</a>内で <code>highlight=false</code> を指定しない限り、excerpt には <code><a href="/ja/docs/Web/HTML/Element/mark"><mark></a></code> 要素が入ります。</dd> - <dt><code>url</code></dt> - <dd>ページの完全な URL</dd> - <dt><code>edit_url</code></dt> - <dd>ページを編集モードで開く完全な URL</dd> - <dt><code>tags</code></dt> - <dd>ページのタグの配列</dd> - <dt><code>score</code></dt> - <dd>検索エンジンで割り当てられたスコア値</dd> - <dt><code>explanation</code></dt> - <dd>検索クエリーにどのように何故マッチしたかという検索エンジンからの雑多な情報。このコンテンツの詳細についてはこのページでは解説しません。</dd> -</dl> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<p>追加の<a href="/ja/docs/MDN/Kuma/Getting_started#Finding_pages">管理者のみの検索機能</a>がいくつかあり、例えばスラッグが特定の文字で始まっているページを検索したりすることができます。</p> diff --git a/files/ja/orphaned/mdn/tools/template_editing/index.html b/files/ja/orphaned/mdn/tools/template_editing/index.html deleted file mode 100644 index 932f6486ba..0000000000 --- a/files/ja/orphaned/mdn/tools/template_editing/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: テンプレートの編集 -slug: orphaned/MDN/Tools/Template_editing -tags: - - Page-level -translation_of: MDN/Tools/Template_editing -original_slug: MDN/Tools/Template_editing ---- -<div>{{MDNSidebar}}</div><p>MDNでは、 <a href="/ja/docs/MDN/Contribute/Tools/KumaScript">KumaScript</a> で書かれたテンプレートがコンテンツの自動生成、およびページのカスタマイズに使われています。 それぞれのテンプレートは、別々の Wiki ページに置かれていて、ページ名は以下のとおりです:<br> - <code>/en-US/docs/Template:<em>テンプレートの名前</em></code></p> - -<p><span class="seoSummary">MDN の Wikiを編集している人なら誰でも、マクロを通じてテンプレートを呼び出すことができます。KumaScript は強力なので、テンプレートの作成と編集のための権限は、必要な経験を持ち合わせた信頼できるユーザーのみに与えられています。</span></p> - -<h2 id="この権限を持つ役割の人">この権限を持つ役割の人</h2> - -<ul> - <li><a href="/ja/docs/MDN/Community/Roles/Admins"><strong>MDN管理者</strong></a></li> - <li><a href="/ja/docs/MDN/Community/Roles/Topic_driver_role"><strong>トピックドライバ</strong></a></li> - <li><a href="/ja/docs/MDN/Community/Roles/Localization_driver_role"><strong>ローカライゼーションドライバ</strong></a></li> -</ul> - -<h2 id="この権限を得るための条件">この権限を得るための条件</h2> - -<p>このツールにアクセスする権限を得るための条件は以下のとおりです:</p> - -<ul> - <li><strong>常に</strong>この権限を必要としていること。 例えば、新しいマクロの作成する、古いマクロを修正する、または多くをローカライズするなど。</li> - <li>MDN を定期的に編集していて、 JavaScript でのコードの書き方を知っていること、そしてKumaScript によるテンプレートの制約とリスクを知っていること。</li> - <li>"テンプレート編集権限を持っているpeer" のうち<strong>2人による</strong>保証があり、なおかつどの peer からも<strong>拒否</strong>されていないこと。</li> -</ul> - -<p>この権限を得るためのプロセスについては、<a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限のリクエスト</a> を見てください。</p> - -<h2 id="テンプレート編集の権限を持っている人（peer）たち">テンプレート編集の権限を持っている人（peer）たち</h2> - -<ul> - <li>現在の peer: <a href="/en-US/profiles/sheppy/">Sheppy</a>, <a href="/en-US/profiles/teoli">teoli</a>, <a href="/en-US/profiles/Fscholz">fscholz</a>, <a href="/en-US/profiles/wbamberg">wbamberg</a>, <a href="/en-US/profiles/Chrisdavidmills">chrisdavidmills</a>, <a href="/en-US/profiles/Jeremie">Jeremie</a>.</li> - <li>新たな peer の追加、peer の削除は、現在の peer の賛同を得ることで行われます。</li> -</ul> |