Merge branch 'main' into update/ru/Glossary/Blink

mdn · Dec 5, 2024 · b4cc662 · b4cc662
2 parents 3d009e0 + 6c4353a
commit b4cc662
Show file tree

Hide file tree

Showing 197 changed files with 2,204 additions and 1,004 deletions.
diff --git a/docs/ru/README.md b/docs/ru/README.md
@@ -4,7 +4,9 @@
 
 ## Использование ссылок
 
-При переводе документов не забывайте изменять язык (`en-US` на `ru`) во внутренних ссылках на сайт MDN так, чтобы они вели на соответствующие локализованные страницы. Также для внутренних ссылок необходимо сохранять только путь в URL-адресе (без схемы и имени домена).
+### Внутренние ссылки
+
+Во внутренних ссылках на сайт MDN необходимо изменять язык (`en-US` на `ru`) и сохранять только путь в URL-адресе (без схемы и имени домена) так, чтобы они вели на соответствующие локализованные страницы.
 
 Рассмотрим пример:
 
@@ -18,6 +20,30 @@ If you are new to HTML, CSS, JavaScript, etc., try our [Learn web development](/
 Если вы только начинаете изучение HTML, CSS и JavaScript, попробуйте наши руководства по [Изучению веб-разработки](/ru/docs/Learn).
 ```
 
+### Внешние ссылки
+
+При переводе ссылок на сторонние сайты следует придерживаться следующих правил:
+
+- Если у документа есть локализованная версия, то заменять ссылку на неё, включая название документа и URL-адрес (это применительно к таким ресурсам как [Википедия](https://ru.wikipedia.org/)). В случаях, когда локализованная версия статьи уступает англоязычной (по объёму или дате обновления) до потери ценности, можно оставить оригинальную ссылку.
+- Если у документа нет локализованной версии, то оставлять оригинальное название документа, и переводить только окружающий текст. Также можно добавлять информацию о языке документа (например, `(англ.)`).
+- В некоторых случаях в тексте ссылки вместо названия ресурса лучше указывать его описание на русском языке. Например, если в заголовке статьи есть «игра слов» или аббревиатура, понятная только на языке оригинала.
+
+Примеры ссылок на сторонние сайты:
+
+```md
+- [Global variable](https://en.wikipedia.org/wiki/Global_variable) on Wikipedia
+- [Class-based programming](https://en.wikipedia.org/wiki/Class-based_programming) on Wikipedia
+- [FAQ](https://www.chromium.org/blink/developer-faq/) on Blink
+```
+
+На русский язык следует перевести таким образом:
+
+```md
+- [Глобальная переменная](https://ru.wikipedia.org/wiki/Глобальная_переменная) в Википедии
+- [Class-based programming](https://en.wikipedia.org/wiki/Class-based_programming) в Википедии (англ.)
+- [Часто задаваемые вопросы](https://www.chromium.org/blink/developer-faq/) на сайте Blink (англ.)
+```
+
 ## Общие рекомендации по переводу на русский язык
 
 - «_Вы_» и его производные пишите с маленькой буквы.

diff --git a/files/ja/glossary/rdf/index.md b/files/ja/glossary/rdf/index.md
@@ -0,0 +1,14 @@
+---
+title: RDF
+slug: Glossary/RDF
+l10n:
+  sourceCommit: ada5fa5ef15eadd44b549ecf906423b4a2092f34
+---
+
+{{GlossarySidebar}}
+
+**RDF**（Resource Description Framework）は、W3C によって開発された、ウェブページなどのワールドワイドウェブ上の情報を表現するための言語です。RDF は、リソース情報をエンコードする標準的な方法を提供し、アプリケーション間で完全に自動化された方法で交換できるようにします。
+
+## 関連情報
+
+- Wikipedia：[Resource Description Framework](https://ja.wikipedia.org/wiki/Resource_Description_Framework)
diff --git a/files/ja/web/api/analysernode/getbytefrequencydata/index.md b/files/ja/web/api/analysernode/getbytefrequencydata/index.md
@@ -14,7 +14,7 @@ l10n:
 
 配列の各項目は、固有の周波数のデシベル値を表します。周波数はサンプルレートの 0 から 1/2 まで直線的に広がります。例えば、サンプルレートが `48000` の場合、配列の最後の項目は `24000` Hz のデシベル値を表します。
 
-配列の持つ要素が {{domxref("AnalyserNode.fftSize")}} より少なかった場合、余分な要素は削除されます。必要以上の要素があった場合、余分な要素は無視されます。
+配列の持つ要素が {{domxref("AnalyserNode.frequencyBinCount")}} より少なかった場合、余分な要素は削除されます。必要以上の要素があった場合、余分な要素は無視されます。
 
 ## 構文
 
@@ -25,8 +25,8 @@ getByteFrequencyData(array)
 ### 引数
 
 - `array`
-  - : 周波数領域データがコピーされる {{jsxref("Uint8Array")}}。無音のサンプルの場合、値は `-Infinity` です。
-    配列の持つ要素が {{domxref("AnalyserNode.fftSize")}} より少なかった場合、余分な要素は削除されます。必要以上の要素があった場合、余分な要素は無視されます。
+  - : 周波数領域データがコピーされる {{jsxref("Uint8Array")}}。
+    配列の持つ要素が {{domxref("AnalyserNode.frequencyBinCount")}} より少なかった場合、余分な要素は削除されます。必要以上の要素があった場合、余分な要素は無視されます。
 
 ### 返値
 

diff --git a/files/ja/web/css/element/index.md b/files/ja/web/css/element/index.md
@@ -1,6 +1,8 @@
 ---
 title: element()
 slug: Web/CSS/element
+l10n:
+  sourceCommit: 66944f622b6b51bc9c24bebbbea242138d910600
 ---
 
 {{CSSRef}}{{SeeCompatTable}}
@@ -24,13 +26,13 @@ element(id)
 
 ## 例
 
-この例を[ライブで見る](https://mdn.dev/archives/media/samples/cssref/moz-element.html)には、`-moz-element()` に対応している Firefox が必要です。
+以下の例は、 `-moz-element()` に対応している Firefox のビルドが必要です。
 
-<h3 id="A_somewhat_realistic_example">いくらか現実的な例</h3>
+### いくらか現実的な例
 
 この例では hidden 状態の {{HTMLElement("div")}} を背景に使います。背景要素はグラデーションを使うだけでなく、背景の一部として描画されるテキストも含んでいます。
 
-```html
+```html live-sample___a_somewhat_realistic_example
 <div
   style="width:400px; height:400px; background:-moz-element(#myBackground1) no-repeat;">
   <p>This box uses the element with the #myBackground1 ID as its background!</p>
@@ -40,31 +42,45 @@ element(id)
   <div
     id="myBackground1"
     style="width:1024px; height:1024px; background-image: linear-gradient(to right, red, orange, yellow, white);">
-    <p style="transform-origin:0 0; transform: rotate(45deg); color:white;">
+    <p style="transform-origin:0 0; rotate: 45deg; color:white;">
       This text is part of the background. Cool, huh?
     </p>
   </div>
 </div>
 ```
 
-"myBackground1" という ID を持つ {{HTMLElement("div")}} 要素が、"This box uses the element with the #myBackground1 ID as its background!" という段落を含むコンテンツの背景に使われています。
+{{EmbedLiveSample("A_somewhat_realistic_example")}}
 
-![](example1.png)
+"myBackground1" という ID を持つ {{HTMLElement("div")}} 要素が、"This box uses the element with the #myBackground1 ID as its background!" という段落を含むコンテンツの背景に使われています。
 
-<h3 id="A_somewhat_more_bizarre_example">いくらか突飛な例</h3>
+### ページプレビュー
 
-この例は hidden 状態の {{HTMLElement("button")}} 要素を、背景の繰り返しパターンとして使います。これは、好きな要素を背景として使うことができるという例ですが、すぐれたデザインとはいえないかもしれません。
+この [Vincent De Oliveira の例に基づいた例](https://iamvdo.me/en/blog/css-element-function)は、 `<div id="css-source">` のプレビューを `<div id="css-result">` の中に生成します。
 
-```html
-<div
-  style="width:400px; height:100px; background:-moz-element(#myBackground2);"></div>
+#### HTML
 
-<div style="overflow:hidden; height:0;">
-  <button id="myBackground2" type="button">Evil button!</button>
+```html live-sample___page_preview
+<div id="css-source">
+  <h1>Page Preview</h1>
 </div>
+<div id="css-result"></div>
 ```
 
-![](example2.png)
+#### CSS
+
+```css live-sample___page_preview
+#css-result {
+  background: -moz-element(#css-source) no-repeat;
+  width: 256px;
+  height: 32px;
+  background-size: 80%;
+  border: dashed;
+}
+```
+
+#### 結果
+
+{{EmbedLiveSample("Page_Preview")}}
 
 ## 仕様書
 
@@ -76,10 +92,9 @@ element(id)
 
 ## 関連情報
 
-- {{cssxref("image/image()", "image()")}}
-- {{cssxref("image/image-set()", "image-set()")}}
+- {{cssxref("image/image", "image()")}}
+- {{cssxref("image/image-set", "image-set()")}}
 - {{cssxref("&lt;image&gt;")}}
 - {{cssxref("&lt;gradient&gt;")}}
-- {{cssxref("element()")}}
-- {{cssxref("cross-fade()")}}
+- {{cssxref("cross-fade", "cross-fade()")}}
 - {{domxref("document.mozSetImageElement()")}}