Upgrade to Pro — share decks privately, control downloads, hide ads and more …

プロフィールページ(ポートフォリオサイト)を
 Swift-DocC で作れるか? / Can we create a profile page (portfolio site) in Swift-DocC?

プロフィールページ(ポートフォリオサイト)を
 Swift-DocC で作れるか? / Can we create a profile page (portfolio site) in Swift-DocC?

プロフィールページ(ポートフォリオサイト)を
 Swift-DocC で作れるか?
@treastrain

NEW DEBUG!!!! v4.0-fix52 World Wintu Daifugou Conference @ CASPUR 2022/06/17 22:00~

More Decks by treastrain / Tanaka Ryoga

Other Decks in Technology

Transcript

  1. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    /&8%(W
    fi
    Y8PSME8JOUV%BJGVHPV$POGFSFODF!$"4163+VOF
    ϓϩϑΟʔϧϖʔδʢϙʔτϑΥϦΦαΠτʣΛ

    4XJGU%PD$Ͱ࡞ΕΔ͔ʁ
    !USFBTUSBJO
    1

    View Slide

  2. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 2
    /// Eat the provided specialty sloth food.


    ///


    /// Sloths love to eat while they move very slowly through their rainforest habitats. They


    /// are especially happy to consume leaves and twigs, which they digest over long periods


    /// of time, mostly while they sleep.


    ///


    /// When they eat food, a sloth's ``energyLevel`` increases by the food's


    /// ``Food/energy``.


    mutating public func eat(_ food: Food, quantity: Int = 1) -> Int {


    energyLevel += food.energy * quantity


    return energyLevel


    }
    4PVSDF"QQMF

    View Slide

  3. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 3
    Swift-DocC
    4PVSDF"QQMF

    View Slide

  4. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    4XJGU%PD$Ͱग़ྗͰ͖Δ΋ͷ
    w ιʔείʔυ಺γϯϘϧυΩϡϝϯτʢ"1*ϦϑΝϨϯεʣ

    ʢ*OTPVSDFTZNCPMEPDVNFOUBUJPOʣ
    w ٕज़هࣄ

    ʢ5FDIOJDBMBSUJDMFTʣ
    w ϦονͰॆ࣮ͨ͠νϡʔτϦΞϧ

    ʢ3JDIUVUPSJBMTʣ
    4

    View Slide

  5. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 5
    /// Eat the provided specialty sloth food.


    ///


    /// Sloths love to eat while they move very slowly through their rainforest habitats. They


    /// are especially happy to consume leaves and twigs, which they digest over long periods


    /// of time, mostly while they sleep.


    ///


    /// When they eat food, a sloth's ``energyLevel`` increases by the food's


    /// ``Food/energy``.


    mutating public func eat(_ food: Food, quantity: Int = 1) -> Int {


    energyLevel += food.energy * quantity


    return energyLevel


    }
    4PVSDF"QQMF

    View Slide

  6. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 6
    # Getting Started with Sloths


    Create a sloth and assign personality traits and abilities.


    ## Overview


    Sloths are complex creatures that require careful creation and a
    suitable habitat.
    4PVSDF"QQMF

    View Slide

  7. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 7
    IUUQTEFWFMPQFSBQQMFDPNUVUPSJBMTTXJGUVJDSFBUJOHBOEDPNCJOJOHWJFXT

    View Slide

  8. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    4XJGU%PD$Ͱग़ྗͰ͖Δ΋ͷ
    w ιʔείʔυ಺γϯϘϧυΩϡϝϯτʢ"1*ϦϑΝϨϯεʣ

    ʢ*OTPVSDFTZNCPMEPDVNFOUBUJPOʣ
    w ٕज़هࣄ

    ʢ5FDIOJDBMBSUJDMFTʣ
    w ϦονͰॆ࣮ͨ͠νϡʔτϦΞϧ

    ʢ3JDIUVUPSJBMTʣ
    8

    View Slide

  9. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 9

    View Slide

  10. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    4XJGU%PD$ͰϓϩϑΟʔϧϖʔδΛ࡞Δ
    4XJGU1BDLBHFΛ࡞Δ
    .BSLEPXOͰϖʔδΛ࡞Δ
    ϓϨϏϡʔ͢Δ
    ग़ྗ͢Δ
    10

    View Slide

  11. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    4XJGU1BDLBHFΛ࡞Δ
    w 4XJGU%PD$͸ɺ4XJGU1BDLBHFɺ'SBNFXPSLɺ"QQͷ͍ͣΕ͔͕ඞཁ
    w த਎͕ۭͬΆͷ4XJGU1BDLBHFΛ࡞Δ
    11
    % swift package init

    View Slide

  12. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 12

    View Slide

  13. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 13

    View Slide

  14. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 14

    View Slide

  15. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 15

    View Slide

  16. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 16

    View Slide

  17. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    .BSLEPXOͰϖʔδΛ࡞Δ
    w 9DPEFͷ৔߹
    w ʮ'JMFʯʮ/FXʯʮ'JMFʜɹ㵰/ʯ͔Βʮ%PDVNFOUBUJPO$BUBMPHʯ
    w 9DPEFҎ֎ͷ৔߹
    w ʮEPDDʯͰऴΘΔσΟϨΫτϦΛ࡞Δ
    w ʮEPDDʯͰऴΘΔσΟϨΫτϦͷதʹ.BSLEPXOϑΝΠϧΛ࡞Δ
    17

    View Slide

  18. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 18

    View Slide

  19. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 19

    View Slide

  20. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 20

    View Slide

  21. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 21

    View Slide

  22. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    ϓϨϏϡʔ͢Δ
    w 9DPEFͷ%PDVNFOUBUJPOʹग़ྗ͢Δ৔߹
    w ʮ1SPEVDUʯʮ#VJME%PDVNFOUBUJPOɹ?‐㵰%ʯ
    w 8FCαΠτ޲͚ʹग़ྗ͢Δ৔߹ͳͲ
    w 4XJGUͷ4XJGU1BDLBHF.BOBHFS$PNNBOE1MVHJOTػೳΛ

    ׆༻ͨ͠ɺ4XJGU%PD$1MVHJOΛ࢖͏
    22

    View Slide

  23. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 23
    Swift-DocC Plugin
    github.com/apple/swift-docc-plugin
    📦

    View Slide

  24. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 24

    View Slide

  25. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 25
    % swift package --disable-sandbox preview-documentation --target


    View Slide

  26. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 26
    % swift package --disable-sandbox preview-documentation --target


    Building for debugging...


    Build complete!


    Input: /path/to//Sources//.docc


    Template: /Applications/Xcode.app/Contents/Developer/Toolchains/
    XcodeDefault.xctoolchain/usr/share/docc/render


    ========================================


    Starting Local Preview Server


    Address: http://localhost:8000/documentation/


    ========================================


    Monitoring /path/to//Sources//.docc for changes…

    View Slide

  27. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 27

    View Slide

  28. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 28

    View Slide

  29. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    ϥϯσΟϯάϖʔδΛฤू͢Δ
    ख௚͠
    w ϥϯσΟϯάϖʔδͱ͍ͨ͠.BSLEPXOϑΝΠϧͷϖʔδλΠτϧʹ͸ɺ

    Ϟδϡʔϧ໊ΛೋॏόοΫΫΥʔτͰғΈɺγϯϘϧϦϯΫΛೖྗ͢Δ
    w γϯϘϧϦϯΫ͸ίʔυิ׬͞ΕΔ
    29

    View Slide

  30. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 30

    View Slide

  31. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 31

    View Slide

  32. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    <43><4XJGU%PD$>

    4VQQPSUDVTUPNEPDVNFOUBUJPONPEVMFLJOET
    32

    View Slide

  33. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    ϞδϡʔϧछผදࣔͷΧελϚΠζ
    w ίϚϯυϥΠϯҾ਺ʹΑΔࢦఆ
    w --fallback-default-module-kind
    w *OGPQMJTUʹΑΔࢦఆ
    w CDDefaultModuleKind
    33

    View Slide

  34. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    *OGPQMJTUͰCDDefaultModuleKindΛࢦఆ
    w *OGPQMJTUΛEPDDσΟϨΫτϦԼʹ࡞੒
    34

    View Slide

  35. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    *OGPQMJTUͰCDDefaultModuleKindΛࢦఆ
    w ,FZʹCDDefaultModuleKindɺ7BMVFʹ෇໊͚͍ͨલΛࢦఆ
    35

    View Slide

  36. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 36

    View Slide

  37. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved. 37

    View Slide

  38. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    ·ͱΊ
    ఻͔͑ͨͬͨ͜ͱ
    w 4XJGU%PD$ͰϓϩϑΟʔϧϖʔδ͘Β͍͸࡞ΕΔ
    w 9DPEFͰ΋ɺͦ͏͡Όͳ͚Ε͹4XJGU͕ಈ͘؀ڥͳΒ࡞ΕΔ
    w "QQMFͷυΩϡϝϯτͬΆ͍γϯϓϧͳσβΠϯʹͳΔ
    w 8FCͷμʔΫςʔϚʹࣗಈͰରԠͰ͖Δ
    w ϒϥ΢βͰͷϓϨϏϡʔ΋؆୯
    38

    View Slide

  39. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    ·ͱΊ
    ఻͑ΒΕͳ͔ͬͨ͜ͱ
    w ੩తͳ8FCαΠτͱͯ͠ϗεςΟϯά͢ΔͨΊͷॻ͖ग़͠ํ๏
    w ग़ྗ͞ΕΔ8FCαΠτͷσβΠϯ͸4XJGUͷόʔδϣϯʹґଘ͢Δ
    w 4XJGUͷόʔδϣϯʹґଘͯ͠΄͘͠ͳ͚Ε͹ɺ

    (JU)VCͷBQQMFTXJGUEPDDΛ͖࣋ͬͯͯϏϧυˠ࣮ߦ͢Ε͹Αͦ͞͏
    w ͍Ζ͍ΖΧελϚΠζͰ͖ΔՕॴ͕ଞʹ΋͋ΔʢͨͿΜʣ
    39

    View Slide

  40. Copyright © 2022 treastrain / Tanaka RyogaɹAll rights reserved.
    /&8%(W
    fi
    Y8PSME8JOUV%BJGVHPV$POGFSFODF!$"4163+VOF
    ϓϩϑΟʔϧϖʔδʢϙʔτϑΥϦΦαΠτʣΛ

    4XJGU%PD$Ͱ࡞ΕΔ͔ʁɹ‎ɹ࡞Εͦ͏ʂ
    !USFBTUSBJO
    40
    ͋Γ͕ͱ͏͍͟͝·ͨ͠ʂɹɹɹɹɹɹɹɹɹIUUQTUSFUKQɹ⏩

    View Slide