Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(ja): content clean up for markdown-lint-cli bump #17239

Merged
merged 3 commits into from
Dec 9, 2023
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions files/ja/.markdownlint.jsonc
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"extends": "../../.markdownlint.jsonc",
"no-trailing-punctuation": {
"punctuation": ".,;:。:"
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ If you leave all the testing to the end of a project, any bugs you uncover will

The workflow for testing and bug fixes on a project can be broken down into roughly the following four phases (this is only very rough — different people may do things quite differently to this):

**Initial planning > Development > Testing/discovery > Fixes/iteration**
**Initial planning** > **Development** > **Testing/discovery** > **Fixes/iteration**

Steps 2–4 will tend to be repeated as many times as necessary to get all of the implementation done. We will look at the different parts of the testing process in much greater detail in subsequent articles, but for now let's just summarize what may occur in each step.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ l10n:

![A basic vanilla macOS terminal](mac-terminal.png)

### ターミナルへのアクセス方法を教えてください
### ターミナルへのアクセス方法を教えてください

今日、多くの開発者は Unix ベースのツールを使用しています (例: ターミナルと、そこからアクセスできるツール)。今日ウェブ上に存在する多くのチュートリアルやツールは、Unix ベースのシステムをサポートしています (残念ながらそれを想定しています) が、心配する必要はありません。ほとんどのシステムで利用できます。このセクションでは、選択したシステムの端末にアクセスする方法を見ていきます。

Expand Down
22 changes: 10 additions & 12 deletions files/ja/mdn/at_ten/history_of_mdn/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,15 @@ l10n:

### MDN とは?誰のためのサイト?<br>オープンウェブコミュニティのための場所

_0:00:00 - 0:07:15_
タイム:_0:00:00 - 0:07:15_

MDN は有益なウェブテクノロジーの情報を提供し、オープンなウェブコミュニティで学んだり、共有したり、教えたりすることを助けます。 MDN では、あなたも一緒になってあなた自身のため、また他者のために何かを作りあげることになります。

MDN はまた、Gecko や Firefox をハックする人々、アドオン開発者、 Firefox OS 貢献者などの Mozilla に携わる技術者のための場所でもあります。

### MDN の歴史<br>Wiki より前の時代 – Netscape DevEdge

_0:07:15 - 0:08:17_
タイム:_0:07:15 - 0:08:17_

古くは、いくつかの MDN ドキュメントの基礎を形作ることになった Netscape 社の _DevEdge_ というものがありました。その頃の様子は [archive.org](https://web.archive.org/web/20020819120942/http://devedge.netscape.com/) で見ることができます。

Expand All @@ -46,24 +46,23 @@ Deb Richardson が Mozilla Foundation に技術編集者として加わり、新

### MediaWiki 最初の Wiki エンジン

_0:08:17 - 0:14:55_
タイム:_0:08:17 - 0:14:55_

MediaWiki を新しいプロジェクトのプラットフォームとして、Mozilla の開発者文書は 2005 年 7 月より誰でも編集できるようになりました。Mozilla の新しい協同的な要素が打ち立てられ、それ以来 "いいもの" を作ることを助ける人や知見を共有する人は誰でも歓迎しています。技術文書を他の言語に翻訳する新しい国際的なコミュニティが成長し始めました。

[![MDC MediaWiki](mediawiki.png)](https://web.archive.org/web/20051226031957/https://developer.mozilla.org/en/docs/Main_Page)

### DekiWiki<br>2 つ目の Wiki エンジン

_0:14:55 - 0:26:08_
タイム:_0:14:55 - 0:26:08_

2008 年 8 月、Mozilla Developer Center は技術文書のためのパワフルで新しいコンテンツ管理システム (CMS) であり、Wiki システムでもある [MindTouch DekiWiki](https://sourceforge.net/projects/dekiwiki/) に乗り換えました。この乗り換えはコミュニティ内でとても大きい議論が巻き起こりました。MediaWiki は 2005 年から使われており、その周辺にツールもビルドされてきたからです。

[![MDC DekiWiki](screenshot_2018-07-24_16.06.55.png)](https://web.archive.org/web/20080907231611/https://developer.mozilla.org/en)

### Kuma<br>3 つ目の、そして現行の Wiki エンジン

_0:26:08 - 0:31:50_
_0:43:52 - 0:51:35_
タイム:_0:26:08 - 0:31:50_、_0:43:52 - 0:51:35_

[Kuma](https://github.com/mdn/kuma) は 2011 年諸島頃に [Kitsune](https://github.com/mozilla/kitsune) からフォークされ、2012 年 8 月 3 日に立ち上がりました。 Django をベースに Mozilla が構築した Wiki プラットフォームで Node.js を使った [KumaScript](/ja/docs/MDN/Tools/KumaScript) マクロシステムも付随してます。

Expand All @@ -73,36 +72,35 @@ _0:43:52 - 0:51:35_

### MDN の再設計<br>新しいデザインと Kuma

_0:31:50 - 0:32:22_
_0:51:35 - 0:58:05_
タイム:_0:31:50 - 0:32:22_、_0:51:35 - 0:58:05_

MDN の再設計はビッグプロジェクトでした。 [Sean Martell](https://twitter.com/mart3ll) が新しい MDN の VI (visual identity; 法人以外のロゴのこと) をデザインしました。次には、3000 人の MDNer のベータユーザーグループと共に数か月かけた反復的プロセスでした。新しい見た目は "ワッフルフラグ" (MDN の機能フラグシステム) に隠れています。[David Walsh](https://twitter.com/davidwalshblog/) にも大きく感謝します。彼は全体の再デザインに挑戦して、MDN にふさわしいフロントエンドデザインをもたらしました。

![Waffle flag](waffle-flag.jpg)

### Openウェブ文書の周りのコミュニティ<br>コミュニティが動かす、特定のブラウザーに限らないオープンなウェブのためのドキュメンテーション

_0:32:22 - 0:36:55_
タイム:_0:32:22 - 0:36:55_

2010 年代に、特に[コミュニティメンバーやテクニカルライターがパリに集まった](https://hacks.mozilla.org/2010/10/web-standards-doc-sprint-finis/)時、MDN の目標は 「Firefox のすべてのドキュメントを書こう!」から「ウェブのドキュメントを書こう!」に確実にシフトしました。ドキュメントは整理され、数年かけて再編成され MDN のオープンウェブドキュメントは 特定のブラウザーにとらわれないものになりました。これは、ウェブに関わる開発をするあらゆる人々の手助けとなり、そして私たちのコンテンツの中で、もっとも広く使われるものとなりました。

いつも、いろいろなブラウザーベンダーが MDN を形作る手助けをしてくれています。このブラウザー間のコラボレーションは非常に成功していて、MDN の読者たちに高く評価されています。

## 翻訳コミュニティ<br>MDN はグローバルな利用者に向けて数々の言語に翻訳されています

_0:36:55 - 0:43:52_
タイム:_0:36:55 - 0:43:52_

ローカライゼーションは Mozilla コミュニティの大きなパートです。これはほぼすべてのプロジェクトや製品で当てはまります。Kuma を使っている MDN も翻訳しやすく、私達の [L10n コミュニティ](/ja/docs/MDN/Contribute/Localize)のニーズに適しています。W3C の仕様や他のウェブの機能を記述しているリソースには直接的な目標はありません。そして仕様書を複数の言語で提供するコミュニティを持っています。特に初心者にとって、MDN はウェブの技術を探求する最初のステップであり、すべての人々にとってそうなることが私達の目標です。MDN は広いユーザーを持ち、英語を母語としない人も対象です。これは世界中の人々から高く評価されています。

## 学習領域

_0:58:05 - 1:02:46_
タイム:_0:58:05 - 1:02:46_

MDN の [学習領域](/ja/docs/Learn) はウェブの基礎スキルを教える新しい取り組みです。 これまでの 10 年を通して、MDN はたくさんの応用的な記事と貴重な情報をエキスパートの為に提供し続けてきました。このプロジェクトでは初心者に焦点を当てた記事を書き、知識ギャップを埋めることを目標としています。

## MDN の未来 20 周年を祝う時 MDN はどうなっているだろうか?

_1:02:46 - 1:11:39_
タイム:_1:02:46 - 1:11:39_

MDNに関わる誰もが、ウェブがオープンでアクセシビリティに富んでいることを本当に大切にしています。だからこそ、ローカライゼーションチームやすべての人々が貢献してくれているのです。MDNは、ウェブをあるべき姿に保つためのキープレイヤーであり続けたいと願っています。

Expand Down
2 changes: 1 addition & 1 deletion files/ja/mdn/writing_guidelines/what_we_write/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ MDN Web Docs で、私たちは常に新しいウェブ標準技術を適切に

一般的に、私たちが新しい技術の文書化を検討する時期について、次のように定義しています。

_「その機能が標準化の流れにあって、どこかに実装されたとき」_
「_その機能が標準化の流れにあって、どこかに実装されたとき_」

私たちは、次のような場合、新しい技術を文書化することを考えます。

Expand Down
4 changes: 2 additions & 2 deletions files/ja/mozilla/firefox/releases/16/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,11 +52,11 @@ Firefox 16 は、2012 年 10 月 9 日にリリースされました。この記

### WebGL

_変更なし_
_変更なし。_

### SVG

_変更なし_
_変更なし。_

### MathML

Expand Down
2 changes: 1 addition & 1 deletion files/ja/mozilla/firefox/releases/64/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ _変更なし。_

### プラグイン

_変更なし_
_変更なし。_

### WebDriver conformance (Marionette)

Expand Down
4 changes: 2 additions & 2 deletions files/ja/mozilla/firefox/releases/65/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ l10n:

### SVG

_変更なし_
_変更なし。_

### JavaScript

Expand Down Expand Up @@ -140,7 +140,7 @@ _変更なし。_

### プラグイン

_変更なし_
_変更なし。_

### WebDriver conformance (Marionette)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ fromPoint(sourcePoint);
const point2D = DOMPointReadOnly.fromPoint({ x: 25, y: 25 });
```

### 既存の点を使用して三次元の点を作成します
### 既存の点を使用して三次元の点を作成します

この例では、 {{domxref("DOMPoint")}} を用いて、 {{domxref("DOMPoint.DOMPoint", "new DOMPoint()")}} 型の点 `origPoint` を作成しています。そして、その点は `fromPoint()` の入力として使用され、新しい点 `newPoint` を作成します。

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/popstateevent/state/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ l10n:

以下のコードでは、 {{domxref("History.pushState","pushState()")}} メソッドを使って値を履歴にプッシュしたときの `state` の値を記録しています。

```js
```js
// Log the state of
addEventListener("popstate", (event) => {
console.log("State received: ", event.state);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -104,8 +104,6 @@ new RTCPeerConnection(configuration);

資格情報を提供しない場合、新しい資格情報が自動的に生成されます。自分で資格情報を用意することの明らかな利点は、 ID キーの継続性です。次回以降の呼び出しに同じ資格情報を使用すると、リモートピアーは同じ呼び出し元であることを指示することができます。また、新しい鍵を生成するコストもかかりません。

**<<<--- add link to information about identity --->>>**

## 仕様書

{{Specifications}}
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/svgelement/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ SVG 言語における要素に直接対応する SVG DOM インタフェース

## 属性

_Also inherits properties from: {{DOMxRef("Element")}}, {{DOMxRef("HTMLOrForeignElement")}}_
_Also inherits properties from: {{DOMxRef("Element")}}, {{DOMxRef("HTMLOrForeignElement")}}_

- {{domxref("SVGElement.dataset")}}{{ ReadOnlyInline }}
- : 要素に付与された[カスタム・データ属性](/ja/docs/Web/Guide/HTML/Using_data_attributes)に対応する名前つきデータ属性の、キーと値の対のリストを与える、{{domxref("DOMStringMap")}} オブジェクトです。{{SVGAttr("data-*")}} の形の属性を使って、これらの対を SVG で定義することもでき、ここで `*` は、その対のキーの名前です。これは、HTML の {{domxref("HTMLElement.dataset")}} 属性および HTML の [`data-*`](/ja/docs/Web/HTML/Global_attributes/data-*) グローバル属性とちょうど同様に、うまく機能します。
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/usb/disconnect_event/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ondisconnect = (event) => {};

## イベントプロパティ

_以下に挙げるプロパティに加え、親インターフェイス {{domxref("Event")}} のプロパティも利用できます_
_以下に挙げるプロパティに加え、親インターフェイス {{domxref("Event")}} のプロパティも利用できます_

- {{domxref("USBConnectionEvent.device", "device")}} {{ReadOnlyInline}}
- : イベントが発火した対象の {{domxref("USBDevice")}} です。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,7 @@ slug: Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API
4. 例えばあなたのシステムのスピーカーなど、音声の最終的な行き先の選択。
5. 音声効果を(あるのならば)かけた後、最後に選択した行き先へ届いて終了する、音声源からの接続の確立。

**チャンネルの記法**

信号上で利用できるオーディオチャンネルの数字は、2.0 や 5.1 のように、しばしば、数値の形式で表現されます。これは[channel notation](https://en.wikipedia.org/wiki/Surround_sound#Channel_notation)と呼ばれます。最初の数値は、該当の信号が含んでいるオーディオチャンネルの数です。ピリオドの後にある数値は、低音増強用出力として確保されているチャンネルの数を示しています。それらはしばしば**サブウーファー**とも称されます。
> **メモ:** 信号上で利用できるオーディオチャンネルの数字は、2.0 や 5.1 のように、しばしば、数値の形式で表現されます。これは[channel notation](https://en.wikipedia.org/wiki/Surround_sound#Channel_notation)と呼ばれます。最初の数値は、該当の信号が含んでいるオーディオチャンネルの数です。ピリオドの後にある数値は、低音増強用出力として確保されているチャンネルの数を示しています。それらはしばしば**サブウーファー**とも称されます。

![A simple box diagram with an outer box labeled Audio context, and three inner boxes labeled Sources, Effects and Destination. The three inner boxes have arrow between them pointing from left to right, indicating the flow of audio information.](webaudioAPI_en.svg)

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/web_authentication_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ create() と get() メソッドが全体像の中でどのように位置づけ

![ウェブ認証 API のコンポーネントの登録とデータフロー図](webauthn_registration_r4.png)

_図 1 - ウェブ認証による登録手順と各アクションに関連する重要なデータの流れを示す図_
_図 1 - ウェブ認証による登録手順と各アクションに関連する重要なデータの流れを示す図。_
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We usually omit the last punctation for a caption of a diagram.

Suggested change
_図 1 - ウェブ認証による登録手順と各アクションに関連する重要なデータの流れを示す図。_
_図 1 - ウェブ認証による登録手順と各アクションに関連する重要なデータの流れを示す図_

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @mfuji09. This would cause the "Emphasis used instead of a heading" error with the new version of markdown lint if the whole sentence is emphasized without the tailing punctuation.

As the en-US document has removed the sentence. Is it okay if I add the ignore expression (<!-- markdownlint-disable -->) to this sentence for now (in a future update to this article, we can remove the ignore expression)

image

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 48e4765

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!


まず(図中のステップ 0)、アプリケーションは最初の登録要求を行います。このリクエストのプロトコルとフォーマットは、ウェブ認証 API の範囲外です。

Expand Down
4 changes: 2 additions & 2 deletions files/ja/web/api/xmldocument/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@ slug: Web/API/XMLDocument

## プロパティ

_また、 {{DOMxRef("Document")}} からプロパティを継承します_
_また、 {{DOMxRef("Document")}} からプロパティを継承します。_

- {{DOMxRef("XMLDocument.async")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : {{DOMxRef("XMLDocument.load()")}} と併用して、非同期リクエストを示します。

## メソッド

_また、 {{DOMxRef("Document")}} からメソッドを継承します_
_また、 {{DOMxRef("Document")}} からメソッドを継承します。_

- {{DOMxRef("XMLDocument.load()")}} {{Non-standard_Inline}} {{Deprecated_Inline}}
- : XML ドキュメントをロードします。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ function ShowProperties(obj) {
}
```

_このような単純な結果ではありません (特にサイレントエラートラップがエラーメッセージを隠していた場合)_
_このような単純な結果ではありません (特にサイレントエラートラップがエラーメッセージを隠していた場合)_

```js
ob={}; ob.po=oco; ob.pn=ocn; // 上記のテストオブジェクトをプロパティ値として使用して、複合オブジェクトを生成します。
Expand All @@ -106,7 +106,7 @@ ob={}; ob.po=oco; ob.pn=ocn; // 上記のテストオブジェクトをプロパ
最初のプロパティのみが表示されることに注意してください。
```

_(しかし、同じオブジェクトが単に順番が違うだけで作成されている場合 — 少なくともいくつかの実装では...)_
(_しかし、同じオブジェクトが単に順番が違うだけで作成されている場合 — 少なくともいくつかの実装では..._)

```js
ob={}; ob.pn=ocn; ob.po=oco; // 同じ複合オブジェクトを再度作成しますが、同じプロパティを異なる順序で作成します。
Expand Down Expand Up @@ -192,7 +192,7 @@ ocn = Object.create(null); // "null" オブジェクトを生成 (既出と同
Object.setPrototypeOf(ocn, Object.prototype); // 新しいオブジェクトのプロトタイプを (標準オブジェクトではなく) 「ジェネリック」オブジェクトに設定
```

_(上記の文字列関連の関数に加えて、以下の関数も追加されています)_
(_上記の文字列関連の関数に加えて、以下の関数も追加されています_)

```js
> ocn.valueOf() // {} と表示
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/javascript/reference/strict_mode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -282,7 +282,7 @@ JavaScript の言語仕様では、当初からブロック文の中に関数宣

厳格モードでは [`arguments`](/ja/docs/Web/JavaScript/Reference/Functions/arguments) および [`eval`](/ja/docs/Web/JavaScript/Reference/Global_Objects/eval) の奇妙さを低減します。通常のコードではどちらも不思議な動作がかなりあります。 `eval` でバインドを追加や削除したり、バインドする値を変更したり、 `arguments` の添字つきプロパティが名前付き引数の別名になることです。厳格モードでは、 `eval` と `arguments` をキーワードとして扱うことに大きく舵を切りました。

#### eval や arguments にバインドしたり代入したりしないようにする
#### eval や arguments にバインドしたり代入したりしないようにする

`eval` および `arguments` という名前に対して言語構文でのバインドや代入を不可にしています。以下のような試みはすべて構文エラーになります。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Firefox 23 では HTML5 WebM のための DASH は削除されました。これ

まず、 WebM ビデオをさまざまなビットレートのビデオファイルとともに DASH マニフェストに変換する必要があります。 まず、 ffmpeg.org の ffpmeg プログラム、 libvpx と libvorbis の WebM ビデオとオーディオ、少なくともバージョン 2.5 (おそらく、これは 3.2.5 でテスト済みです) を必要とします。

### 1. すでに存在する WebM ファイルを使って一つの音声と複数の動画ファイルを作成する
### 1. すでに存在する WebM ファイルを使って一つの音声と複数の動画ファイルを作成する

たとえば:

Expand Down
Loading
Loading