the-swift-programming-language-jp icon indicating copy to clipboard operation
the-swift-programming-language-jp copied to clipboard

DocC対応の検討

Open stzn opened this issue 2 years ago • 3 comments

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

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

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

stzn avatar Dec 28 '22 19:12 stzn

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

残りの課題:

  • [ ] DocCの不具合で日本語のAnchorリンクがうまく動作しない。https://github.com/apple/swift-docc/issues/458 修正後Anchorリンクをdoc:形式にする
  • [x] (優先度は高くない)doccコマンドを試してみたがうまくいかない。調べて導入方法を検討する

stzn avatar Feb 19 '23 00:02 stzn

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

これが入れば対処できそう https://github.com/apple/swift-docc/issues/345

stzn avatar Aug 12 '23 23:08 stzn

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

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

stzn avatar Aug 12 '23 23:08 stzn