Quartoを使ってみませんか / quarto_get_started

2022-05-22 Tokushima.R#1での発表スライド http://github.com/uribo/tokushimar

Transcript

1. ӝੜਅ໵ !VSJCP
   
   2VBSUPΛ࢖ͬͯΈ·ͤΜ͔
   
   

   View Slide

2. ֓ཁ
   1BOEPD্ʹߏங͞Εͨ৽͍͠ग़൛γεςϜͷ2VBSUPͷ࢖͍উख͕ྑ͍ײ͡
   ίʔυͱͦͷ࣮ߦ݁ՌΛ൐͏จॻͷଟ༷ͳܗࣜͰͷग़ྗ͕Մೳ
   3.BSLEPXOʹೃછΈਂ͍3Ϣʔβ͸ಋೖͷෑډ͕௿͍
   3.BSLEPXO͕ഇΕΔΘ͚Ͱ͸ͳ͍
   +VQZUFSͰͷ࣮ߦ݁ՌΛڞ༗͢Δ࣌ͷ࠷ળࡦͱͳΓಘΔ
   ެࣜϖʔδ͔ΒΠϯετʔϧ͕Մೳ
   ࠷৽൛ͷ34UVEJPͰ֤छػೳ͕ࢼͤΔঢ়ଶʹͳ͍ͬͯΔ
   2VBSUPͳΒͰ͸ͷԸܙ΋͋Δ
   https://quarto.org
   

   View Slide

3. Quarto
   3.BSLEPXOΛ͢΂ͯͷਓʹ
   

   View Slide

4. 3.BSLEPXOͷੈքΛ1ZUIPOͰ΋
   3ɺ1ZUIPOɺ+VMJBɺ0CTFSWBCMF+4ͷίʔυΛهड़ɺ݁ՌΛ൐͏ग़ྗ෺Λੜ੒
   ϨϯμϦϯά࣌ʹίʔυΛ࣮ߦ
   1BOEPDʹΑΓ๛෋ͳग़ྗܗ͕ࣜ༗ޮ
   ࠶ݱੑݚڀͷͨΊʹ3.BSLEPXOɺ+VQZUFS͕࢖ΘΕΔ
   3NEͰ΋1ZUIPOͷ࣮ߦ͕Մೳʢͨͩ͠3ͷΠϯετʔϧ΋ඞཁʣ
   3ͷ໊Λף͢ΔͨΊ͔1ZUIPOϢʔβʹ޿͘࢖ΘΕͳ͍
   JQZOC͸ςΩετϑΝΠϧ͕ͩɺͦͷ࣮ଶ͸ෳࡶ
   ݸผͷηϧͷڍಈΛ੍ޚ͢Δ͜ͱ͸೉͍͠
   2VBSUPͰ͸3.BSLEPXOͷػೳΛαϙʔτ͠ɺ
   +VQZFSͷΑ͏ʹ1ZUIPOɺ+VMJB΋࣮ߦՄೳʹ
   

   View Slide

5. ಋೖํ๏
   2VBSUPίϚϯυϥΠϯΠϯλʔϑΣΠεͷΠϯετʔϧ
   https://quarto.org/docs/get-started/
   ΤϯδϯͱͳΔLOJUS·ͨ͸+VQZUFSͷΠϯετʔϧ
   ࣮ߦ͍ͨ͠ݴޠͷΠϯετʔϧ
   RNEϑΝΠϧΛฤू͢ΔΞϓϦέʔγϣϯͷ༻ҙ
   3 1ZUIPO +VMJB
   34UVEJP
   74$PEF
   \RVBSUP^ύοέʔδ
   ػೳ֦ு͕༻ҙ
   
   
   
   
   

   View Slide

6. RNEϑΝΠϧͷߏ੒
   :".-ϑϩϯτϚλʔ
   จষ
   ίʔυϒϩοΫ \S^ \QZUIPO^ \KVMJB^ͷΑ͏ʹ
   ࣮ߦ͢ΔݴޠΛࢦఆ͢Δ
   NBSLEPXO IUNM -B5F9ʹΑΔ
   ελΠϦϯά͕Մೳ
   ,FZ7BMVFͷܗࣜͰهड़͢Δ
   จॻͷઃఆ
   
   
   
   SNEͷॻ͖ํ͕ར༻Ͱ͖Δ
   

   View Slide

7. 2VBSUPʹ͓͚ΔSFOEFSͷ࢓૊Έ
   1BOEPD
   Τϯδϯ
   +VQZUFS
   LOJUS
   JQZOC
   RNE
   +VQZUFS
   NE
   ίʔυΛ࣮ߦ
   ग़ྗ݁ՌΛؚΜͩNEΛੜ੒
   ࢦఆ͞ΕͨΤϯδϯʹΑΓ
   

   View Slide

8. จॻ࡞੒
   1BOEPDNBSLEPXOʹΑΔ૷০
   ίʔϧΞ΢τϒϩοΫ
   ਤදͷॊೈͳ഑ஔ
   Օ৚ॻ͖ɺ਺ࣜɺμΠΞάϥϜ
   ݟग़͠ɺଠࣈɺࣼମɺఴࣈɺଧͪফ͠ઢ
   :::{.callout-note}
   
   
   コールアウトブロックの例
   
   
   Noteとして表示
   
   
   :::
   ਤදͷ૬ޓࢀর !
   fi
   H !UCM QBUI
   \
   fi
   H^
   

   View Slide

9. ଟ༷ͳදݱܗࣜ
   )5.- 1%' .48PSE
   1SFTFOUBUJPOT .BSLEPXO
   3FWFBMKT
   1PXFS1PJOU
   #FBNFS
   (JU)VC
   $PNNPO.BSL
   :".-ϑϩϯτϚλʔͷGPSNBUύϥϝʔλͰࢦఆ
   ---
   
   
   fotmat: html
   
   
   ---
   ---
   
   
   format:
   
   
   docx:
   
   
   toc: true
   
   
   ---
   ֤ܗࣜͰͷΦϓγϣϯ͸ೖΕࢠͰࢦఆ
   

   View Slide

10. 34UVEJPͷWJTVBMΤσΟλʹΑΔฤू
    㵰Λԡ͢͜ͱͰ֤छཁૉΛૠೖ͢ΔγϣʔτΧοτ
    *OTFSU$JUBUJPO *OTFSU$SPTT3FGFSFODF
    3FOEFSϘλϯΛԡ͢͜ͱͰίʔυ͕࣮ߦɺϑΝΠϧΛग़ྗ
    ϝχϡʔ͔Βจࣈͷ૷০ɺ֤छཁૉͷૠೖ͕Մೳ
    จࣈ૷০ɺਤදɺίʔυͷग़ྗ݁ՌΛࢹ֮తʹ͔֬Ίͳ͕Β
    2NEϑΝΠϧͷฤू͕ՄೳʢSNEͰ΋Մʣ
    

    View Slide

11. 74$PEFʹΑΔฤू
    3FOEFSϘλϯΛԡͯ͠ίʔυ͕࣮ߦɺ
    +VQZUFSͱಉ͘͡ɺίʔυͷ݁ՌΛ֬ೝ͠ͳ͕Β
    2NEϑΝΠϧͷฤू͕Մೳ
    quarto preview python.ipynb
    ϓϨϏϡʔ͕දࣔ
    

    View Slide

12. ࣮ߦΦϓγϣϯ
    άϩʔόϧʹจॻશମͷதͰػೳ͢ΔFYFDVUFΦϓγϣϯWTݸผͷίʔυϒϩοΫ
    ίʔυϒϩοΫͷग़ྗɺਤʹؔ͢ΔڍಈΛ੍ޚΛ͢ΔͨΊͷࢦఆ
    3NEͰߦ͍ͬͯͨLOJUSPQUT@DIVOL
    ͕ෆཁʢ˞Ұ෦ͷΈ༗ޮʣ
    ```{r setup, include=FALSE}
    
    
    knitr::opts_chunk$set(echo = TRUE,
    
    
    fig.path = "img/",
    
    
    fig.width = 6)
    
    
    ```
    ---
    
    
    …
    
    
    execute:
    
    
    echo: true
    
    
    fig-width: 6
    
    
    knitr:
    
    
    opts_chunk:
    
    
    fig.path: "img/"
    
    
    ---
    SNE
    RNE
    

    View Slide

13. ίʔυϒϩοΫ಺Ͱͷ࣮ߦΦϓγϣϯ
    cʢϋογϡύΠϓʣʹΑͬͯ:".-ͱͯ͠هड़
    ```{r}
    
    
    #| echo: false
    
    
    2 * 2
    
    
    ```
    LOJUS͔Β3.BSLEPXOͰ΋༗ޮ
    ࿦ཧ஋͸͢΂ͯখจࣈͳͷͰ஫ҙ
    ֤ίʔυϒϩοΫͰͷࢦఆ͸άϩʔόϧͰͷࢦఆΑΓ༏ઌ͞ΕΔ
    ෳ਺ͷΦϓγϣϯΛࢦఆ͢Δͱ͖ɺҰߦ͝ͱʹΦϓγϣϯΛهड़Ͱ͖ΔͷͰ
    ݟ௨͕͠ྑ͘ͳΔ
    

    View Slide

14. +VQZUFS JQZOC
    Ͱ2VBSUPΛར༻
    ηϧͷதͰ࣮ߦΦϓγϣϯΛهड़
    :".-ϑϩϯτϚλʔ
    จষ
    ίʔυηϧ
    
    
    
    NBSLEPXOʹΑΔ૷০
    ϚʔΫμ΢ϯηϧΛར༻ͯ͠هड़
    

    View Slide

15. +VQZUFS JQZOC
    Ͱ2VBSUPΛར༻
    quarto render hoge.ipynb —to html
    RNEͱͯ͠+VQZUFSΤϯδϯΛར༻ͯ͠QZUIPOΛ࣮ߦ͢Δ
    RNEϑΝΠϧͷ৽ن࡞੒࣌ɺΤϯδϯͱΧʔωϧΛࢦఆ
    ---
    
    
    title: "Untitled"
    
    
    format: html
    
    
    editor: visual
    
    
    jupyter: python3
    
    
    ---
    

    View Slide

16. จॻͷݴޠࢦఆ
    MBOHKB
    https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/language/_language-ja.yml
    ݴޠʹԠͨ͡ग़ྗͷมߋ
    ྫ͑͹ɺ೔ຊޠͷจॻͰਤΛࢀর͢Δͱ͖ʮ'JHʯͱ͢ΔͷͰ͸ͳ͘ʮਤʯͱ͢Δ
    MBOHFO ॳظ஋
    
    ೔ຊޠͷରԠύλϯҰཡɻΧελϚΠζ΋Մೳ
    

    View Slide

17. ࠓޙͷల։
    2VBSUPWΛൃද༧ఆʁ
    ࠓ೥ͷ݄຤ʹ։࠵͞ΕΔSTUVEJPDPOG
    2VBSUPʹؔ͢ΔϫʔΫγϣοϓ
    3.BSLEPXOͷ։ൃ͸ܧଓ
    2VBSUP͕ςʔϚͷ,FZOPUF
    2VBSUP։ൃνʔϜɺ
    SNBSLEPXO LOJUSͷύοέʔδ։ൃऀ
    :JIVJ9JF͕3.BSLEPXO։ൃͷఀࢭΛ൱ఆ
    

    View Slide

18. ࢀߟϖʔδ
    We don't talk about Quarto | Alison Hill, PhD
    
    https://www.apreshill.com/blog/2022-04-we-dont-talk-about-quarto/
    With Quarto Coming, is R Markdown Going Away? No. - Yihui Xie | ྆ၭߩ
    
    https://yihui.org/en/2022/04/quarto-r-markdown/
    Quarto
    
    https://quarto.org/
    I Use & Like R Markdown, Why Should I Try Out Quarto? - R Markdown - RStudio Community
    
    https://community.rstudio.com/t/i-use-like-r-markdown-why-should-i-try-out-quarto/133752
    Quarto: A scienti
    fi
    c and technical publishing system built on Pandoc
    
    https://brianlovin.com/hn/30042831
    Quarto ͕׬੒͢Δͱ Jupyter Ͱ΋ R Markdown ͷΑ͏ʹ؆୯ʹεϥΠυ΍จॻΛ࡞ΕΔ͔΋͠Εͳ͍
    
    - ill-identi
    fi
    ed diary
    
    https://ill-identi
    fi
    ed.hatenablog.com/entry/2021/10/02/161123
    

    View Slide

19. ENJOY
    

    View Slide