Xcode 15のDocCプレビュー機能の紹介

Xcode 15の DocCプレビュー機能の紹介 宇佐見公輔 / 株式会社ゆめみ 2023-11-08 Xcode 15のDocCプレビュー機能の紹介 1

自己紹介 宇佐見公輔（うさみこうすけ） 株式会社ゆめみ / iOSテックリード Xcode 15のDocCプレビュー機能の紹介 2

Swift-DocC Swiftのドキュメント作成ツール APIドキュメント チュートリアル 現在の公式ドキュメントの多くがSwift-DocCで作成されている Xcode 13に含まれる形でリリース（2021） Xcode 15のDocCプレビュー機能の紹介 3

Swift-DocCの更新 (1) Xcode 14に含まれる形でアップデート（2022） Appプロジェクト対応 SwiftPMプラグイン対応 Objective-C対応 その他、細かな改善 Xcode 15のDocCプレビュー機能の紹介 4

余談 SwiftPMプラグイン Swiftパッケージには対応している Appのマルチモジュール構成ではうまくいかない 情報求む Xcode 15のDocCプレビュー機能の紹介 5

Swift-DocCの更新 (2) Xcode 15に含まれる形でアップデート（2023） プレビュー機能 Swift extension対応 その他、細かな改善 Xcode 15のDocCプレビュー機能の紹介 6

Xcode向けのサンプル SlothCreator: Building DocC Documentation in Xcode | Apple Developer Documentation https://developer.apple.com/documentation/xcode/slothcreat or_building_docc_documentation_in_xcode Xcode 15のDocCプレビュー機能の紹介 7

• https://developer.apple.com/documentation/xcode/slothcreator_building_docc_documentation_in_xcode

プレビュー機能（Xcode 15） Xcode 15のDocCプレビュー機能の紹介 8

使いかた Assistantウィンドウ で「Documentation Preview」を選ぶ Xcode 15のDocCプレビュー機能の紹介 9

プレビュー機能のメリット 実際の出力と同じ見た目でプレビューできる 他のエディターでもプレビューできるが見た目が変わる 固有の機能をプレビューできる Markdown拡張ディレクティブ チュートリアル Xcode 15のDocCプレビュー機能の紹介 10

拡張ディレクティブ レイアウトのためのディレクティブがある（Swift 5.8以降） / @Row @Column @TabNavigator @Small @Links これらを使うときはプレビュー機能が便利 Xcode 15のDocCプレビュー機能の紹介 11

@Row / @Column
@Row {
@Column {
@Image(source: "icon-power-icon", alt: "A blue square containing a snowflake.") {
Ice power
}
}
@Column {
@Image(source: "fire-power-icon", alt: "A red square containing a flame.") {
Fire power
}
}
}

Xcode 15のDocCプレビュー機能の紹介

12

@Row / @Column Xcode 15のDocCプレビュー機能の紹介 13

@TabNavigator @TabNavigator { @Tab("Powers") {  } @Tab("Excerise routines") {  } @Tab("Hats") {  } } Xcode 15のDocCプレビュー機能の紹介 14

@TabNavigator Xcode 15のDocCプレビュー機能の紹介 15

まとめ Swift-DocCは少しずつ進化している Xcodeのサポートも少しずつ増えている 機会があれば使ってみると良さそう Xcode 15のDocCプレビュー機能の紹介 16