[コレクション型、属性、ジェネリックパラメータと引数]画像からコードへ変更

Author: stzn

language-guide/collection-types.md

@@ -78,7 +78,9 @@ var sixDoubles = threeDoubles + anotherThreeDoubles
 
 配列リテラルからも配列を初期化できます。これは、1 つ以上の要素を持った配列コレクションの簡略記法です。配列リテラルはカンマ区切りの角括弧\(`[]`\)で囲んだ値のリストです:
 
-![Array Literal](../assets/arrayliteral_2x.png)
+```swift
+[<#value 1#>, <#value 2#>, <#value 3#>]
+```
 
 下記の例は、`String` を保持する `shoppingList` という配列を作成しています。
 

language-reference/attributes.md

@@ -9,7 +9,10 @@ Swift には、宣言に適用される属性と型に適用される属性の 2
 
 `@` 記号に続けて属性の名前と、属性が受け入れる引数を書き込むことにより、属性を指定します。
 
-![属性](../assets/attributes.png)
+```swift
+@<#attribute name#>
+@<#attribute name#>(<#attribute arguments#>)
+```
 
 一部の宣言属性は、属性とそれが特定の宣言にどのように適用されるかについての詳細情報を指定する引数を受け入れます。これらの _attribute arguments_ は括弧\(`()`\)で囲まれ、その形式は属する属性によって定義されています。
 
@@ -64,31 +67,41 @@ Swift には、宣言に適用される属性と型に適用される属性の 2
 * `unavailable` 引数は、指定されたプラットフォームで宣言が使用できないことを示します。この引数は、Swift のアベイラビリティバージョンを指定している場合は使用できません
 * `introduced` 引数は、宣言が導入された特定のプラットフォームまたは言語の最初のバージョンを示します。形式は次のとおりです:
 
-![introduced &#x5F15;&#x6570;](../assets/introduced.png)
+  ```swift
+  introduced: <#version number#>
+  ```
 
 _version number_ は、ピリオド\(`.`\)で区切られた 1〜3 個の正の整数で構成されます。
 
 * `deprecated` 引数は、宣言が非推奨になった特定のプラットフォームまたは言語の最初のバージョンを示します。形式は次のとおりです:
 
-![deprecated &#x5F15;&#x6570;](../assets/deprecated.png)
+  ```swift
+  deprecated: <#version number#>
+  ```
 
 任意の _version number_ は、ピリオド\(`.`\)で区切られた 1〜3 個の正の整数で構成されます。バージョン番号を省略すると、deprecated がいつ発生したかについての情報を提供せずに、宣言が現在 deprecated になっていることのみを示します。バージョン番号を省略する場合は、コロン\(`:`\)も省略してください。
 
 * `obsoleted` 引数は、宣言が廃止された特定のプラットフォームまたは言語の最初のバージョンを示します。宣言が廃止されると、指定されたプラットフォームまたは言語から削除され、使用できなくなります。形式は次のとおりです:
 
-![obsoleted &#x5F15;&#x6570;](../assets/obsoleted.png)
+  ```swift
+  obsoleted: <#version number#>
+  ```
 
 _version number_ は、ピリオド\(`.`\)で区切られた 1〜3 個の正の整数で構成されます。
 
 * `message` 引数は、deprecated または obsoleted された宣言に使用した際に、コンパイラが表示する警告またはエラーのテキストメッセージを提供します。形式は次のとおりです:
 
-![message &#x5F15;&#x6570;](../assets/message.png)
+  ```swift
+  message: <#message#>
+  ```
 
 _message_ は文字列リテラルで構成されます。
 
 * `renamed` 引数は、名前が変更された宣言の新しい名前を示すテキストメッセージを提供します。コンパイラは、名前が変更された宣言が使用された際にエラーを発行し、新しい名前を表示します。形式は次のとおりです:
 
-![renamed &#x5F15;&#x6570;](../assets/renamed.png)
+  ```swift
+  renamed: <#new name#>
+  ```
 
 _new name_ は文字列リテラルで構成されます。
 
@@ -115,7 +128,10 @@ typealias MyProtocol = MyRenamedProtocol
 
 `available` 属性がプラットフォームまたは言語名の引数に加えて `introduced` 引数を指定するだけの場合は、代わりに次の省略構文を使用できます:
 
-![available&#x5C5E;&#x6027;](../assets/available.png)
+```swift
+@available(<#platform name#> <#version number#>, *)
+@available(swift <#version number#>)
+```
 
 `available` 属性の省略構文は、複数のプラットフォームのアベイラビリティを簡潔に表しています。2 つの形式は機能的に同等ですが、可能な限り省略形が推奨されます。
 

language-reference/generic-parameters-and-arguments.md

@@ -13,11 +13,15 @@ Swift のジェネリクスの概要については、[Generics\(ジェネリク
 
 ジェネリックパラメータ句は、ジェネリック型または関数の型パラメータを指定し、それらのパラメータに関連する制約や要件とともに指定します。ジェネリックパラメータ句は、山括弧\(`<>`\)で囲まれており、形式は次のとおりです。
 
-![&#x30B8;&#x30A7;&#x30CD;&#x30EA;&#x30C3;&#x30AF;&#x30D1;&#x30E9;&#x30E1;&#x30FC;&#x30BF;&#x30EA;&#x30B9;&#x30C8;](../assets/generic-parameter-list.png)
+```swift
+<<#generic parameter list#>>
+```
 
 _generic parameter list_ は、ジェネリックパラメータのカンマ区切りのリストで、その各形式は次のとおりです。
 
-![&#x578B;&#x30D1;&#x30E9;&#x30E1;&#x30FC;&#x30BF;&#x5236;&#x7D04;](../assets/type-parameter-constraint.png)
+```swift
+<#type parameter#>: <#constraint#>
+```
 
 _type parameter_ の後に任意の _constraint_ を付けて構成します。_type parameter_ は、単にプレースホルダ型の名前です\(例えば、`T`、`U`、`V`、`Key`、`Value` など\)。関数またはイニシャライザのシグネチャを含む型や関数の残りの部分から型パラメータ\(およびその関連型の全ての型\)にアクセスできます。
 
@@ -43,7 +47,9 @@ simpleMax(3.14159, 2.71828) // T は Double に推論されます
 
 型または関数の本文の開始中括弧\(`{`\)の直前にジェネリック `where` 句を含むことによって、型パラメータとその関連型に追加要件を指定できます。ジェネリック `where` 句は、`where` キーワードで構成され、その後に 1 つ以上の要件のカンマ区切りのリストが続きます。
 
-![&#x30B8;&#x30A7;&#x30CD;&#x30EA;&#x30C3;&#x30AF; where &#x53E5;](../assets/generic-where-clauses.png)
+```swift
+where <#requirements#>
+```
 
 ジェネリック `where` 句の _requirements_ は、型パラメータがクラスを継承するか、プロトコルまたはプロトコル合成に準拠することを指定します。ジェネリック `where` 句は型パラメータのシンプルな制約を表現するための糖衣構文\(シンタックスシュガー\)を提供しますが\(例えば、`<T: Comparable>` は `<T> where T: Comparable` などと同等\)、それを使用して複雑な制約を型パラメータや関連型に提供することもできます。例えば、プロトコルに準拠するために、関連型の型パラメータを制限することができます。`<S: Sequence> where S.Iterator.Element: Equatable` は、`S` が `Sequence` プロトコルに準拠し、関連型 `S.Iterator.Element` が `Equatable` プロトコルに準拠することを指定します。この制約は、シーケンスの各要素が `Equatable` だということを保証します。
 
@@ -84,7 +90,9 @@ extension Collection where Element: SomeProtocol {
 
 _ジェネリック引数句_は、ジェネリック型の型引数を指定します。ジェネリック引数句は山括弧\(`<>`\)で囲まれており、形式は次のとおりです。
 
-![&#x30B8;&#x30A7;&#x30CD;&#x30EA;&#x30C3;&#x30AF;&#x5F15;&#x6570;&#x53E5;](../assets/generic-argument-list.png)
+```swift
+<<#generic argument list#>>
+```
 
 _generic argument list_ は、型パラメータのカンマ区切りのリストです。_型引数_は、ジェネリック型のジェネリックパラメータ句に対応する型パラメータを置き換えた実際の具象型の名前です。つまり、そのジェネリック型の具象型バージョンです。下記の例は、Swift 標準ライブラリのジェネリックな辞書型のシンプルなバージョンを示しています。