DocC対応の検討

[stzn]

公式の言語ガイドがSwift5.8でDocC対応版をリリースする模様。それに合わせてDocC対応を進めたい(詳細は何も決まっていないので検討して追記する)

やるとした場合、別ブランチで対応を進めていくのが良いのかなと。

参考リンク(対応後のコンテンツのリンクが貼ってある)
https://forums.swift.org/t/tspl-review-pass/61852

[stzn]

現在このBranchで検討中
https://github.com/stzn/the-swift-programming-language-jp/tree/docc

残りの課題:

• DocCの不具合で日本語のAnchorリンクがうまく動作しない。doc anchor doesn't work for strings which need to encode in URL swiftlang/swift-docc#458 修正後Anchorリンクをdoc:形式にする
• (優先度は高くない)doccコマンドを試してみたがうまくいかない。調べて導入方法を検討する

[stzn]

DocCの不具合で日本語のAnchorリンクがうまく動作しない。

これが入れば対処できそう
swiftlang/swift-docc#345

[stzn]

(優先度は高くない)doccコマンドを試してみたがうまくいかない。調べて導入方法を検討する

READMEの説明の改善がされて解決
https://github.com/apple/swift-book/blob/main/README.md#building