diff --git a/docs/ru/README.md b/docs/ru/README.md index 67006709ae4b22..a720d16757d0b2 100644 --- a/docs/ru/README.md +++ b/docs/ru/README.md @@ -1,6 +1,6 @@ # Участие в переводе -Для начала ознакомьтесь с [правилами внесения изменений в MDN][https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md], [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [Руководством по составлению документации](/ru/docs/MDN/Guidelines). +Для начала ознакомьтесь с [правилами внесения изменений в MDN](https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md), [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [руководствами по составлению документации](/ru/docs/MDN/Writing_guidelines). ## Использование ссылок diff --git a/docs/zh-cn/glossary.md b/docs/zh-cn/glossary.md index 6c6faf8b8ede9e..0e4e6a90ea4b10 100644 --- a/docs/zh-cn/glossary.md +++ b/docs/zh-cn/glossary.md @@ -42,19 +42,19 @@ ### JavaScript -| 英文词汇 | 翻译 | 备注 | 引用来源 | -| ------------------ | ---------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -| bare module | 裸模块 | Vite.js 官方将其翻译为“裸模块”,其意为“没有任何路径的模块”。 | https://github.com/mdn/translated-content/pull/12852#discussion_r1174339277 | -| brand check | 特定类型检查 | 通过一段代码来对特定的数据类型进行检查。 | https://github.com/mdn/translated-content/pull/13381#discussion_r1205437483 | -| constructor | 构造函数 | | https://github.com/mdn/translated-content/issues/18211 | -| exotic object | 特异对象 | | | -| handler | 处理器 | | https://github.com/mdn/translated-content/issues/18211 | -| interface | 接口 | | https://zh.wikipedia.org/wiki/介面_(資訊科技) | -| normative optional | 可选标准 | | https://github.com/mdn/translated-content/pull/13627#discussion_r1224014687 | -| primitive | 原始值/类型 | 基本类型包括对象,而原始类型不包括对象。 | https://github.com/mdn/translated-content/pull/14040#discussion_r1276966303 | -| unscopable | 非作用域(属性) | | https://github.com/mdn/translated-content/pull/12793#discussion_r1170694183 | -| well-known symbol | 内置通用符号 | | https://github.com/mdn/translated-content/pull/10338#discussion_r1036997921 | -| tree shake | 摇树优化 | 入口文件虽然依赖了某个模块,但实际只使用其中的某些功能,通过该优化可以删除未使用的代码。 | https://github.com/mdn/translated-content/pull/18335#discussion_r1505225794 | +| 英文词汇 | 翻译 | 备注 | 引用来源 | +| ------------------ | ---------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | +| bare module | 裸模块 | Vite.js 官方将其翻译为“裸模块”,其意为“没有任何路径的模块”。 | https://github.com/mdn/translated-content/pull/12852#discussion_r1174339277 | +| brand check | 特定类型检查 | 通过一段代码来对特定的数据类型进行检查。 | https://github.com/mdn/translated-content/pull/13381#discussion_r1205437483 | +| constructor | 构造函数 | | https://github.com/mdn/translated-content/issues/18211 | +| exotic object | 特异对象 | | | +| handler | 处理器 | | https://github.com/mdn/translated-content/issues/18211 | +| interface | 接口 | | https://zh.wikipedia.org/wiki/介面_(資訊科技) | +| normative optional | 可选标准 | | https://github.com/mdn/translated-content/pull/13627#discussion_r1224014687 | +| primitive | 原始值/类型 | 基本类型包括对象,而原始类型不包括对象。 | https://github.com/mdn/translated-content/pull/14040#discussion_r1276966303 | +| unscopable | 不可绑定作用域(属性) | | https://github.com/mdn/translated-content/pull/12793#discussion_r1170694183 | +| well-known symbol | 内置通用符号 | | https://github.com/mdn/translated-content/pull/10338#discussion_r1036997921 | +| tree shake | 摇树优化 | 入口文件虽然依赖了某个模块,但实际只使用其中的某些功能,通过该优化可以删除未使用的代码。 | https://github.com/mdn/translated-content/pull/18335#discussion_r1505225794 | ## 标题/表格 diff --git a/files/fr/web/progressive_web_apps/tutorials/cycletracker/service_workers/index.md b/files/fr/web/progressive_web_apps/tutorials/cycletracker/service_workers/index.md index c482e99d31b220..f6cd9e1e205887 100644 --- a/files/fr/web/progressive_web_apps/tutorials/cycletracker/service_workers/index.md +++ b/files/fr/web/progressive_web_apps/tutorials/cycletracker/service_workers/index.md @@ -1,7 +1,7 @@ --- title: "CycleTracker : les service workers" -slug: Web/Progressive_web_apps/Tutorials/CycleTracker/Service_workers short-title: Service workers +slug: Web/Progressive_web_apps/Tutorials/CycleTracker/Service_workers --- {{PWASidebar}} diff --git a/files/ja/glossary/sdk/index.md b/files/ja/glossary/sdk/index.md new file mode 100644 index 00000000000000..e37c1062a0be46 --- /dev/null +++ b/files/ja/glossary/sdk/index.md @@ -0,0 +1,20 @@ +--- +title: SDK (Software Development Kit) (ソフトウェア開発キット) +slug: Glossary/SDK +l10n: + sourceCommit: d1e0c2b95f6f77e775dcf532b5b6ddc30dbd5129 +--- + +{{GlossarySidebar}} + +**SDK**(**Software Development Kit**)とは、開発者が特定のフレームワーク、オペレーティングシステム、その他のプラットフォーム向けのソフトウェアを作成するために使用できる統合されたツール群です。SDK には以下が含まれます: + +- エディター +- コンパイラー +- デバッガー +- エミュレーターまたはシミュレーター。対象のプラットフォームがプログラムを作成したプラットフォームと異なる場合。 +- 配布のためのプログラムのテストとパッケージを支援するツール。 + +SDK は通常、ソフトウェアプラットフォームの所有者によって提供され、そのプラットフォームを対象とする開発者をサポートします。例えば、Google は Android アプリを書く開発者のために [Android SDK](https://developer.android.com/studio) を提供しています。 + +多くの点で、最近のウェブブラウザーに組み込まれている{{Glossary("developer tools","開発者ツール")}}は、ウェブ開発者に同様の機能を提供しています。 diff --git a/files/ja/learn_web_development/core/css_layout/floats_skills/index.md b/files/ja/learn_web_development/core/css_layout/floats_skills/index.md index 9f7d6a885ebbb4..d72c81780db2cf 100644 --- a/files/ja/learn_web_development/core/css_layout/floats_skills/index.md +++ b/files/ja/learn_web_development/core/css_layout/floats_skills/index.md @@ -22,7 +22,7 @@ l10n: 以下のライブコードを更新して、完成例を再現してみてください。 -```html live-sample___float1 +```html-nolint live-sample___float1
One
Two
diff --git a/files/ja/learn_web_development/core/css_layout/media_queries/index.md b/files/ja/learn_web_development/core/css_layout/media_queries/index.md index 63bf07ca0a3476..6929a3cd6b41ee 100644 --- a/files/ja/learn_web_development/core/css_layout/media_queries/index.md +++ b/files/ja/learn_web_development/core/css_layout/media_queries/index.md @@ -142,7 +142,7 @@ l10n: } ``` -```html hidden live-sample___orientation +```html-nolint hidden live-sample___orientation

1782 年 11 月のある夜、 2 人の兄弟がフランスの小さな町アノネーで冬の暖炉の火を囲み、暖炉から立ち上る灰色の煙が広い煙突を登っていくのを見ながら、話を実行したという話があります。彼らの名前はステファンとジョセフ・モンゴルフィエで、紙職人でした。また、思慮深い頭脳を持ち、科学的な知識と新しい発見すべてに深い関心を持っていることで知られていました。

@@ -165,7 +165,7 @@ l10n: } ``` -```html hidden live-sample___hover-example +```html-nolint hidden live-sample___hover-example

1782 年 11 月のある夜、 2 人の兄弟がフランスの小さな町アノネーで冬の暖炉の火を囲み、暖炉から立ち上る灰色の煙が広い煙突を登っていくのを見ながら、話を実行したという話があります。彼らの名前はステファンとジョセフ・モンゴルフィエで、紙職人でした。また、思慮深い頭脳を持ち、科学的な知識と新しい発見すべてに深い関心を持っていることで知られていました。

@@ -215,7 +215,7 @@ l10n: } ``` -```html hidden live-sample___and +```html-nolint hidden live-sample___and

1782 年 11 月のある夜、 2 人の兄弟がフランスの小さな町アノネーで冬の暖炉の火を囲み、暖炉から立ち上る灰色の煙が広い煙突を登っていくのを見ながら、話を実行したという話があります。彼らの名前はステファンとジョセフ・モンゴルフィエで、紙職人でした。また、思慮深い頭脳を持ち、科学的な知識と新しい発見すべてに深い関心を持っていることで知られていました。

@@ -235,7 +235,7 @@ l10n: } ``` -```html hidden live-sample___or +```html-nolint hidden live-sample___or

1782 年 11 月のある夜、 2 人の兄弟がフランスの小さな町アノネーで冬の暖炉の火を囲み、暖炉から立ち上る灰色の煙が広い煙突を登っていくのを見ながら、話を実行したという話があります。彼らの名前はステファンとジョセフ・モンゴルフィエで、紙職人でした。また、思慮深い頭脳を持ち、科学的な知識と新しい発見すべてに深い関心を持っていることで知られていました。

@@ -255,7 +255,7 @@ l10n: } ``` -```html hidden live-sample___not +```html-nolint hidden live-sample___not

1782 年 11 月のある夜、 2 人の兄弟がフランスの小さな町アノネーで冬の暖炉の火を囲み、暖炉から立ち上る灰色の煙が広い煙突を登っていくのを見ながら、話を実行したという話があります。彼らの名前はステファンとジョセフ・モンゴルフィエで、紙職人でした。また、思慮深い頭脳を持ち、科学的な知識と新しい発見すべてに深い関心を持っていることで知られていました。

diff --git a/files/ja/learn_web_development/core/css_layout/positioning/index.md b/files/ja/learn_web_development/core/css_layout/positioning/index.md index d1072105671bb8..fe612de365e7f7 100644 --- a/files/ja/learn_web_development/core/css_layout/positioning/index.md +++ b/files/ja/learn_web_development/core/css_layout/positioning/index.md @@ -620,7 +620,7 @@ body { {{ EmbedLiveSample('Scrolling_index', '100%', 200) }} -粘着要素は「スクロール機構」を持つ最も近い祖先([overflow](/en-US/docs/Web/CSS/overflow) プロパティによって決定する)に相対的に「粘着」します。 +粘着要素は「スクロール機構」を持つ最も近い祖先([overflow](/ja/docs/Web/CSS/overflow) プロパティによって決定する)に相対的に「粘着」します。 > [!NOTE] > このライブ例は [`7_sticky-positioning.html`](https://mdn.github.io/learning-area/css/css-layout/positioning/7_sticky-positioning.html) にあります([ソースコードを見る](https://github.com/mdn/learning-area/blob/main/css/css-layout/positioning/7_sticky-positioning.html))。 diff --git a/files/ja/learn_web_development/core/css_layout/responsive_design/index.md b/files/ja/learn_web_development/core/css_layout/responsive_design/index.md index 7965126328dc54..6fcb9e066ee6d7 100644 --- a/files/ja/learn_web_development/core/css_layout/responsive_design/index.md +++ b/files/ja/learn_web_development/core/css_layout/responsive_design/index.md @@ -378,7 +378,7 @@ h1 { これは、見出しのフォントサイズを指定する必要があるのは一度だけで、モバイル用にメディアクエリーで再定義せずともよいことを意味します。ビューポートのサイズを大きくするにつれて、フォントは徐々に大きくなります。 -```html live-sample___type-vw +```html-nolint live-sample___type-vw

このサイズを見てください

diff --git a/files/ja/learn_web_development/core/structuring_content/index.md b/files/ja/learn_web_development/core/structuring_content/index.md index 418fbbae26b3c8..b17133d244fb35 100644 --- a/files/ja/learn_web_development/core/structuring_content/index.md +++ b/files/ja/learn_web_development/core/structuring_content/index.md @@ -69,7 +69,7 @@ HTML は、あらゆるウェブサイトのコンテンツと構造を定義す ## 関連情報 - [Learn HTML and CSS](https://v2.scrimba.com/learn-html-and-css-c0p?via=mdn), Scrimba _MDN カリキュラムパートナー_ - - : [Scrimba](https://scrimba.com?via=mdn) の _Learn HTML and CSS_ コースでは、知識豊富な講師陣による楽しい対話形式のレッスンと課題を通じて、 5 つの素晴らしいプロジェクトを構築し展開しながら、HTML と CSS を学んでいきます。 + - : [Scrimba](https://scrimba.com?via=mdn) の _Learn HTML and CSS_ コースでは、知識豊富な講師陣による楽しい対話形式のレッスンと課題を通じて、 5 つの素晴らしいプロジェクトを構築し展開しながら、HTML と CSS を学んでいきます。 - [The basics of semantic HTML](https://v2.scrimba.com/the-frontend-developer-career-path-c0j/~0xid?via=mdn), Scrimba _MDN カリキュラムパートナー_ - : この対話型のレッスンでは、HTML は有益な記述を提供しており、その意味論的な側面がなぜ重要なのかという具体的な説明に重点を置いています。 - [Learn HTML](https://v2.scrimba.com/the-frontend-developer-career-path-c0j/~0xid?via=mdn), Codecademy diff --git a/files/ja/learn_web_development/core/structuring_content/planet_data_table/index.md b/files/ja/learn_web_development/core/structuring_content/planet_data_table/index.md index ff58dfa4f524e7..d5a7a9644048a9 100644 --- a/files/ja/learn_web_development/core/structuring_content/planet_data_table/index.md +++ b/files/ja/learn_web_development/core/structuring_content/planet_data_table/index.md @@ -1,5 +1,5 @@ --- -title: "課題: 惑星データ表の構造化" +title: "課題: 惑星データの構造化" slug: Learn_web_development/Core/Structuring_content/Planet_data_table l10n: sourceCommit: 5b20f5f4265f988f80f513db0e4b35c7e0cd70dc @@ -9,7 +9,7 @@ l10n: {{PreviousMenuNext("Learn_web_development/Core/Structuring_content/Table_accessibility", "Learn_web_development/Core/Structuring_content/HTML_forms", "Learn_web_development/Core/Structuring_content")}} -この課題では、太陽系の惑星に関するいくつかのデータを提供し、それを HTML テーブルに構造化しましょう。 +テーブルの評価では、太陽系の惑星に関するいくつかのデータを提供し、それを HTML テーブルに構造化しましょう。 ## 出発点 diff --git a/files/ja/learn_web_development/core/structuring_content/structuring_documents/index.md b/files/ja/learn_web_development/core/structuring_content/structuring_documents/index.md index a24829172968ca..f041dabcfabd4c 100644 --- a/files/ja/learn_web_development/core/structuring_content/structuring_documents/index.md +++ b/files/ja/learn_web_development/core/structuring_content/structuring_documents/index.md @@ -134,39 +134,39 @@ HTML コードでは、それらの*機能*に基づいてコンテンツのセ

-

Subsection

+

Subsection

-

+

Donec ut librero sed accu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aenean ut gravida lorem. Ut turpis felis, pulvinar a semper sed, adipiscing id dolor. -

+

-

- Pelientesque auctor nisi id magna consequat sagittis. Curabitur +

+ Pelientesque auctor nisi id magna consequat sagittis. Curabitur dapibus, enim sit amet elit pharetra tincidunt feugiat nist imperdiet. Ut convallis libero in urna ultrices accumsan. Donec sed odio eros. -

+

-

Another subsection

+

Another subsection

-

- Donec viverra mi quis quam pulvinar at malesuada arcu rhoncus. Cum - soclis natoque penatibus et manis dis parturient montes, nascetur +

+ Donec viverra mi quis quam pulvinar at malesuada arcu rhoncus. Cum + soclis natoque penatibus et manis dis parturient montes, nascetur ridiculus mus. In rutrum accumsan ultricies. Mauris vitae nisi at sem facilisis semper ac in est. -

+

-

- Vivamus fermentum semper porta. Nunc diam velit, adipscing ut - tristique vitae sagittis vel odio. Maecenas convallis ullamcorper +

+ Vivamus fermentum semper porta. Nunc diam velit, adipscing ut + tristique vitae sagittis vel odio. Maecenas convallis ullamcorper ultricied. Curabitur ornare, ligula semper consectetur sagittis, nisi diam iaculis velit, is fringille sem nunc vet mi. -

+

diff --git a/files/ja/learn_web_development/core/styling_basics/getting_started/index.md b/files/ja/learn_web_development/core/styling_basics/getting_started/index.md index 907f3e9ca6e0a6..d34b1d80a94660 100644 --- a/files/ja/learn_web_development/core/styling_basics/getting_started/index.md +++ b/files/ja/learn_web_development/core/styling_basics/getting_started/index.md @@ -14,7 +14,7 @@ l10n: - +
前提知識:前提条件: ` および `` タグの間に、次のスニペットを追加してください。 ```html - + } + ``` 保存して再読み込みすると、すべての段落が紫色に変わります。 @@ -360,6 +360,7 @@ a:hover { {{EmbedLiveSample("started-states", "", "240px")}} 私たちは、リンクの上にカーソルを置いた際に表示される下線を除去しました。リンクのすべての状態から下線を除去することができます。ただし、実際のサイトでは、リンクがリンクであることを訪問者に確実に認識させることが重要であることを覚えておく価値があります。下線を付けたままにしておくことは、段落内のテキストがクリックできることを認識する上で、人々にとって重要な手がかりとなる可能性があります。これは、人々が使用することに慣れている動作です。 CSS のすべてにおいて、変更することで文書内のアクセシビリティが低下する可能性があるため、注意すべき場所で都度強調するようにしたいと思います。 + > [!NOTE] > MDN の記事で、[アクセシビリティ](/ja/docs/Learn_web_development/Core/Accessibility)についての注意をたびたび目にするでしょう。アクセシビリティについて語る際、私たちは、マウスやトラックパッド付きのコンピューター、タッチスクリーン付きの携帯電話、キーボードのみを使用して操作する人、あるいは文書内のコンテンツを読み上げるスクリーンリーダーを操作する人など、誰もが理解でき、利用できるウェブページの必要性を意味しています。 @@ -405,7 +406,7 @@ h1 + p .special { この例には、 CSS 内で簡単な計算を実行できる `calc()` 関数があります。 -```html live-sample___the_calc_function +```html-nolint live-sample___the_calc_function
内部のボックスは 90% - 30px です。
``` diff --git a/files/ja/learn_web_development/core/styling_basics/handling_different_text_directions/index.md b/files/ja/learn_web_development/core/styling_basics/handling_different_text_directions/index.md index 08c1c906e52b01..39ddacfe01e41a 100644 --- a/files/ja/learn_web_development/core/styling_basics/handling_different_text_directions/index.md +++ b/files/ja/learn_web_development/core/styling_basics/handling_different_text_directions/index.md @@ -296,7 +296,7 @@ h2 { この例の書字方向を `vertical-rl` に変更して、画像がどうなるかを確認します。 `inline-start` を `inline-end` に変更して、浮動を変更します。 -```html live-sample___float +```html-nolint live-sample___float
diff --git a/files/ja/learn_web_development/core/styling_basics/index.md b/files/ja/learn_web_development/core/styling_basics/index.md index 338873c15d80ed..b1e0d4d99a4c5c 100644 --- a/files/ja/learn_web_development/core/styling_basics/index.md +++ b/files/ja/learn_web_development/core/styling_basics/index.md @@ -75,7 +75,7 @@ CSS (カスケーディングスタイルシート)は、ウェブページ ## 関連情報 - [Learn HTML and CSS](https://v2.scrimba.com/learn-html-and-css-c0p?via=mdn), Scrimba _MDN カリキュラムパートナー_ - - : [Scrimba](https://scrimba.com?via=mdn) の _Learn HTML and CSS_ コースでは、知識豊富な講師陣による楽しい対話形式のレッスンと課題を通じて、 5 つの素晴らしいプロジェクトを構築し展開しながら、HTML と CSS を学んでいきます。 + - : [Scrimba](https://scrimba.com?via=mdn) の _Learn HTML and CSS_ コースでは、知識豊富な講師陣による楽しい対話形式のレッスンと課題を通じて、 5 つの素晴らしいプロジェクトを構築し展開しながら、HTML と CSS を学んでいきます。 - [Write your first lines of CSS!](https://v2.scrimba.com/the-frontend-developer-career-path-c0j/~015?via=mdn), Scrimba _MDN カリキュラムパートナー_ - : この対話型のレッスンでは、 CSS 構文の有益な入門編を提供して指定されています。 diff --git a/files/ja/mdn/writing_guidelines/howto/creating_moving_deleting/index.md b/files/ja/mdn/writing_guidelines/howto/creating_moving_deleting/index.md index e9eef64494ad9b..927b1b1eff72a1 100644 --- a/files/ja/mdn/writing_guidelines/howto/creating_moving_deleting/index.md +++ b/files/ja/mdn/writing_guidelines/howto/creating_moving_deleting/index.md @@ -2,7 +2,7 @@ title: ページの作成、移動、削除、編集方法 slug: MDN/Writing_guidelines/Howto/Creating_moving_deleting l10n: - sourceCommit: 6e22ea863f8fc322648870bf5bbce00f95e99bda + sourceCommit: 5b20f5f4265f988f80f513db0e4b35c7e0cd70dc --- {{MDNSidebar}} @@ -58,11 +58,11 @@ MDN Web Docs のすべてのページは Markdown 形式で書かれています yarn content move [locale] ``` -移動したい既存の文書のスラッグ(例: `Learn/Accessibility`)と新しい場所のスラッグ(例: `Learn/A11y`)を指定し、それに続いてオプションで既存の文書のロケール(既定では `en-US`)を指定するだけです。 +移動したい既存の文書のスラッグ(例: `Learn_web_development/Core/Accessibility`)と新しい場所のスラッグ(例: `Learn_web_development/A11y`)を指定し、それに続いてオプションで既存の文書のロケール(既定では `en-US`)を指定するだけです。 移動させたい既存の文書に子文書がある場合(つまり文書ツリーを表している場合)、 `yarn content move` コマンドはツリー全体を移動します。 -例えば、 `/en-US/Learn/Accessibility` のツリー全体を `/en-US/Learn/A11y` に移動させたい場合、次のような手順を実行します +例えば、 `/en-US/Learn_web_development/Core/Accessibility` のツリー全体を `/en-US/Learn_web_development/A11y` に移動させたい場合、次のような手順を実行します 1. 作業用に新しいブランチで始めます。 @@ -79,7 +79,7 @@ yarn content move [locale] 2. 移動を実行します(新しいファイルを作成するだけでなく、既存のファイルを削除、変更します)。 ```bash - yarn content move Learn/Accessibility Learn/A11y + yarn content move Learn_web_development/Core/Accessibility Learn_web_development/A11y ``` 3. ファイルを移動したら、他のコンテンツファイル内のそれらのファイルへの参照も更新する必要があります。以下のコマンドを使用すると、すべての参照を自動的に一括更新します。 @@ -92,7 +92,7 @@ yarn content move [locale] ```bash git add . - git commit -m "Move Learn/Accessibility to Learn/A11y" + git commit -m "Move Learn_web_development/Core/Accessibility to Learn_web_development/A11y" git push -u origin my-move ``` @@ -113,11 +113,11 @@ yarn content delete [locale] > [!NOTE] > MDN Web Docs からページを削除するには `yarn content delete` コマンドを使用する必要があります。リポジトリーからディレクトリーを削除するだけではいけません。 `yarn content delete` コマンドは `_wikihistory.json` ファイルの更新など、他にも必要な変更を処理します。 -削除したい既存の文書のスラッグ(例: `Learn/Accessibility`)を指定し、オプションで既存の文書のロケール(既定では `en-US`)を続けてください。 +削除したい既存の文書のスラッグ(例: `Learn_web_development/Core/Accessibility`)を指定し、オプションで既存の文書のロケール(既定では `en-US`)を続けてください。 削除したい既存の文書に子文書がある(つまり文書ツリーを表している)場合は、 `-r, --recursive` オプションも指定しなければなりません。 -例えば、 `/en-US/Learn/Accessibility` のツリー全体を削除したい場合は、以下の段階を踏むことになります: +例えば、 `/en-US/Learn_web_development/Core/Accessibility` のツリー全体を削除したい場合は、以下の段階を踏むことになります: 1. 作業用に新しいブランチで始めます。 @@ -134,7 +134,7 @@ yarn content delete [locale] 2. 削除を実行します。 ```bash - yarn content delete Learn/Accessibility --recursive + yarn content delete Learn_web_development/Core/Accessibility --recursive ``` 3. リダイレクトを追加します。対象とするページは外部 URL でも MDN Web Docs の別のページでもかまいません。 diff --git a/files/ja/web/javascript/reference/global_objects/promise/then/index.md b/files/ja/web/javascript/reference/global_objects/promise/then/index.md index 379799b27b00d9..f0dd44911ef685 100644 --- a/files/ja/web/javascript/reference/global_objects/promise/then/index.md +++ b/files/ja/web/javascript/reference/global_objects/promise/then/index.md @@ -27,7 +27,7 @@ then(onFulfilled, onRejected) - `value` - : このプロミスが履行されたときの値。 - これが関数ではない場合は、内部的に、履行された値を送るための _識別_ 関数 (`(x) => x`) に置き換えられます。 + これが関数ではない場合は、内部的に、履行された値を送るための _恒等_ 関数 (`(x) => x`) に置き換えられます。 - `onRejected` {{optional_inline}} diff --git a/files/ja/web/javascript/reference/lexical_grammar/index.md b/files/ja/web/javascript/reference/lexical_grammar/index.md index 3538a808405bcd..2c019de016f2b9 100644 --- a/files/ja/web/javascript/reference/lexical_grammar/index.md +++ b/files/ja/web/javascript/reference/lexical_grammar/index.md @@ -391,7 +391,7 @@ false 0b11101001010101010101n // 955733 ``` -長整数リテラルは、古い 8 進数と混同しないよう、`0` 出始めることはできません。 +長整数リテラルは、古い 8 進数と混同しないよう、`0` で始めることはできません。 ```js-nolint example-bad 0755n; // SyntaxError: invalid BigInt syntax diff --git a/files/ko/web/javascript/reference/global_objects/json/israwjson/index.md b/files/ko/web/javascript/reference/global_objects/json/israwjson/index.md new file mode 100644 index 00000000000000..1fbe1626494c58 --- /dev/null +++ b/files/ko/web/javascript/reference/global_objects/json/israwjson/index.md @@ -0,0 +1,116 @@ +--- +title: JSON.isRawJSON() +slug: Web/JavaScript/Reference/Global_Objects/JSON/isRawJSON +l10n: + sourceCommit: 47962c4ebad5a138673422ec63a282ab9a63d454 +--- + +{{JSRef}} + +**`JSON.isRawJSON()`** 정적 메서드는 값이 {{jsxref("JSON.rawJSON()")}}에 의해 반환된 객체인지 확인합니다. + +## 구문 + +```js-nolint +JSON.isRawJSON(value) +``` + +### 매개변수 + +- `value` + - : 테스트할 값입니다. + +### 반환 값 + +`value`가 {{jsxref("JSON.rawJSON()")}}에 의해 생성된 경우 `true`, 그렇지 않으면 `false`를 반환합니다. + +## 설명 + +"Raw JSON" 객체는 JSON으로 직렬화될 때 이미 JSON의 일부로 간주됩니다. 게다가 {{jsxref("JSON.rawJSON()")}}의 작동 방식으로 인해 Raw JSON은 문법적으로 유효한 JSON임이 보장됩니다. Raw JSON 객체의 모양과 동작에 대한 자세한 내용은 {{jsxref("JSON.rawJSON()")}}를 참조하십시오. 이 메서드는 다른 직렬화 라이브러리들이 Raw JSON 객체에 대해 `JSON.stringify()`와 유사한 동작을 구현할 수 있도록 하기 위해 존재합니다. + +## 예제 + +### JSON.isRawJSON() 사용하기 + +아래 예제는 `JSON.isRawJSON()`을 사용하여 객체가 `JSON.rawJSON()`에 의해 반환되었는지 확인하는 방법을 보여줍니다. 이 예제에서는 데이터를 YAML과 같은 형식으로 직렬화하는 사용자 정의 직렬화 코드를 구현합니다. + +```js +function mySerializer(value, indent = "") { + if (typeof value !== "object" || value === null) { + return JSON.stringify(value); + } + if (JSON.isRawJSON(value)) { + return value.rawJSON; + } + const subIndent = `${indent} `; + if (Array.isArray(value)) { + return `- ${value.map((v) => mySerializer(v, subIndent)).join(`\n${indent}- `)}`; + } + return Object.entries(value) + .map(([key, value]) => { + const subValue = mySerializer(value, subIndent); + if (subValue.includes("\n")) { + return `${key}:\n${subIndent}${subValue}`; + } + return `${key}: ${subValue}`; + }) + .join(`\n${indent}`); +} + +console.log( + mySerializer({ + name: "Josh", + userId: JSON.rawJSON("12345678901234567890"), + friends: [ + { name: "Alice", userId: JSON.rawJSON("9876543210987654321") }, + { name: "Bob", userId: JSON.rawJSON("56789012345678901234") }, + ], + }), +); + +// name: "Josh" +// userId: 12345678901234567890 +// friends: +// - name: "Alice" +// userId: 9876543210987654321 +// - name: "Bob" +// userId: 56789012345678901234 +``` + +위 예제에서 `userId` 값이 `JSON.rawJSON()`으로 생성되지 않고 숫자로 직접 전달되었다면, JS의 부동소수점 정밀도 제한으로 인해 값이 정확도를 잃게 됩니다. + +```js +console.log( + mySerializer({ + name: "Josh", + userId: 12345678901234567890, + friends: [ + { name: "Alice", userId: 9876543210987654321 }, + { name: "Bob", userId: 56789012345678901234 }, + ], + }), +); + +// name: "Josh" +// userId: 12345678901234567000 +// friends: +// - name: "Alice" +// userId: 9876543210987655000 +// - name: "Bob" +// userId: 56789012345678900000 +``` + +## 명세서 + +{{Specifications}} + +## 브라우저 호환성 + +{{Compat}} + +## 같이 보기 + +- [`JSON.isRawJSON`의 `core-js` 폴리필](https://github.com/zloirock/core-js#jsonparse-source-text-access) +- {{jsxref("JSON")}} +- {{jsxref("JSON.stringify()")}} +- {{jsxref("JSON.rawJSON()")}} diff --git a/files/ko/web/security/same-origin_policy/index.md b/files/ko/web/security/same-origin_policy/index.md index 5f5d128a0e3ec2..475cad2221271e 100644 --- a/files/ko/web/security/same-origin_policy/index.md +++ b/files/ko/web/security/same-origin_policy/index.md @@ -87,7 +87,7 @@ document.domain = "company.com"; ### 교차 출처 접근을 막는 방법 - 교차 출처 쓰기를 방지하려면 [CSRF(Cross-Site Request Forgery)](https://owasp.org/www-community/attacks/csrf) 토큰이라고 하는 요청에서 추측할 수 없는 토큰을 확인하십시오. 이 토큰이 필요한 페이지의 교차 출처 읽기를 막아야 합니다. -- 리소스의 교차 출처 읽기를 방지하려면 리로스를 삽입 할 수 없도록 설정하세요. 리소스 삽입 과정에서 일부 정보가 새어 나가므로 삽입을 방지하는 경우가 많습니다. +- 리소스의 교차 출처 읽기를 방지하려면 리소스를 삽입 할 수 없도록 설정하세요. 리소스 삽입 과정에서 일부 정보가 새어 나가므로 삽입을 방지하는 경우가 많습니다. - 교차 출처 삽입을 방지하려면 리소스가 앞서 나열된 삽입 가능 형식 중 하나로 해석되지 않도록 해야 합니다. 브라우저는 `Content-Type` 헤더를 준수하지 않을 수 있습니다. 예를 들어 HTML 문서에서 `