코딩으로 글쓰는 슬기로운 탐구생활

class: kcd-title-slide

---
class: title-style
layout: false

# 목차

## 코딩 문서 기본기

## 코딩 문서 사례

## 코딩 문서를 넘어서

---
class: kcd-title-subslide

코딩 문서 기본기

---
class: title-style
layout: false

# 과거 코딩으로 글을 쓴다는 것 - `$LaTeX$`

.center[
  <img src="fig/writing-supply-chain.png" width="67%" />
  <img src="fig/writing_is_coding.png" width="57%" />
]

.footnote[
  [글을 쓰는 것은 소프트웨어 개발이다!](https://statkclee.github.io/ds-authoring/ct-writing.html)
]

---
class: title-style
layout: false

# 세가지 다른 언어 패러다임

.center[
  <img src="img/data-conference-three-languages.png" alt="세가지 패러다임" width="80%"/>
]

---
class: title-style
layout: false

# 현재 상황 요약

- **아래한글, 리브레오피스, MS 워드, 데스크톱 위지윅 도구** :지금까지 편지같은 단순한 저작물을 생성하는 가장 쉬운 방식이지만, 융통성이 없고, 불명확하고 수식 배치기능이 상대적으로 미약하고, 버젼제어 시스템과 궁합이 맞지 않음.
- **구글 독스, 웹기반 위지윅 도구**:  워드나 한글, 리브레오피스의 신속성을 갖추고, 더불어 협업을 수월(왜냐하면 모든이가 문서 사본 하나만 공유하기 때문)하게 한다. 하지만, 웹기반 위지윅 도구는 여전히 융통성이 없고 불명확하며, 책임을 질 수 없는 개인회사 바구니에 모든 달걀을 놓는 것에 많은 사람들이 불편해함.
- **데스크톱 LaTeX**: 강력한 조판언어로 수식과 참고문헌관리에 정말 훌륭한 기능을 제공한다. 버젼제어 시스템과 조화가 잘 되는데, 일반 텍스트로 문서를 저작하기 때문이다. 하지만, 지금까지 학습하기 가장 복잡하고, 텍스트와 그림을 원하는 곳에 배치시키는 작업이 고생스럽게도 수시간 소요될 수 있다.
- **Authorea, Overleaf 같은 웹기반 도구** : 위지윅 편집 인터페이스를 저자에게 제공하지만 문서는 LaTeX으로 저장되고, 변경사항을 타이핑해서 넣을 때마다 실시간으로 화면에 다시 출력해서 보여준다.
- **HTML** : 웹의 네이티브 언어로 `$LaTeX$` 보다 훨씬 더 단순하지만, 훨씬 더 적은 기능을 제공한다: 주석, 참고문헌관리, 절마다 번호매김 같은 단순한 기능도 직접적으로 지원안됨. 상당히 버보스하게 상세할 수도 있고, CSS는 변덕스러움으로 유명.
- **마크다운** : HTML에 대한 단순화 대안으로 개발. 마크다운은 일반-텍스트 전자우편 관례를 사용: 빈줄은 문단을 구분하고, 이탤릭체로 만드는데 `*별표*`로 감싸는 등등. HTML보다 더 적은 작업을 수행하지만, 타이핑 양은 훨씬 더 적지만, 불행히도 거의 모든 마크다운 구현결과물이 자체적인 기능이 추가되어서 “마크다운 표준”은 모순어법에 해당된다.

---
class: title-style
layout: false

# 한국인이기 때문에 알아야 되는 것

.center[
  <img src="fig/auth-unicode-utf-8.png" alt="사람과 기호 그리고 컴퓨터" width="80%" />
]

.footnote[
  [R 유니코드, 인코딩](https://statkclee.github.io/ds-authoring/regex-encoding.html)
]

---
class: title-style
layout: false

# 데이터 과학 글을 쓴다는 것: Compendium

.center[
  <img src="fig/compendium.png" width="77%" />
]

.footnote[
  출처: [Computational Documents - 개요서(Compendium) 시작하며](https://statkclee.github.io/comp_document/cd_compendium.html)
]

---
class: kcd-title-subslide

코딩 문서 사례

---
class: title-style
layout: false

# 책 -  `$LaTex$` 사례

.pull-left[
  <img src="fig/latex-how-it-works.png" alt="도구가 자동화하는 저작 업무" width="100%" />
]
.pull-right[
  <img src="fig/py4inf.jpg" alt="도구가 자동화하는 저작 업무" width="77%" />
]

.footnote[
  [정보교육을 위한 파이썬: 데이터 과학자로의 여정, 아마존 절찬 판매중](https://statkclee.github.io/pythonlearn-kr/01-py4inf-python2/)
]

---
class: title-style
layout: false

# 블로그

.center[
  <img src="fig/blogdown-deployment.png" alt="정적 웹콘텐츠 배포" width="100%" />
]

.footnote[
  [데이터 과학을 위한 저작도구: Computational Documents - 블로그 `blogdown`](https://statkclee.github.io/comp_document/ds-blogdown.html)
]

---
class: title-style
layout: false

# 이력서

.center[
  <img src="fig/resume.png" alt="정적 웹콘텐츠 배포" width="80%" />
]

.footnote[
- [데이터 과학을 위한 저작도구: Computational Documents - 이력서(Resume)](https://statkclee.github.io/comp_document/ds-resume.html)
- [데이터 과학 입문 - 2020 봄학기](https://statkclee.github.io/ds-intro-2020/)
]

---
class: title-style
layout: false

# 논문 - 재현가능한 글쓰기

.center[
  <img src="fig/data-science-authoring.png" alt="데이터 사이언스 저작" width="80%" />
]

.footnote[
  [데이터 과학: 재현가능한 저작 - R 마크다운 논문](https://statkclee.github.io/author_carpentry_kr/rmarkdown-authoring-paper.html)
]

---
class: title-style
layout: false

# 논문 - 재현가능한 글쓰기 환경

.center[
  <img src="fig/data-science-authoring-env.png" alt="데이터 사이언스 저작 환경" width="80%" />
]

.footnote[
  [데이터 과학: 재현가능한 저작 - R 마크다운 논문](https://statkclee.github.io/author_carpentry_kr/rmarkdown-authoring-paper.html)
]

---
class: title-style
layout: false

# 논문 - 한국디지털경영학회

.center[
  <img src="fig/paper-transition.png" alt="한국디지털경영학회" width="100%" />
]

.footnote[
  [자동화에 따른 노동시간 변화 분석, 한국디지털경영학회](https://statkclee.github.io/comp_document/automation-kasdba.html)
]

---
class: title-style
layout: false

# 파워포인트 - `slideshow`

.center[
  <img src="fig/instant-preview.gif" alt="한국디지털경영학회" width="67%" />
]

.footnote[
- [R 발표자료(Presentation) - xaringan 슬라이드쇼](https://statkclee.github.io/comp_document/ds-presn.html)
- [코딩으로 글쓰는 슬기로운 탐구생활, KCD 2020](https://statkclee.github.io/ds-authoring/KCD2020_Tidyverse.html#1)
]

---
class: title-style
layout: false

# GITHUB `readme.md`

.center[
  <img src="fig/github-readme.png" alt="GitHub ReadMe" width="57%" />
]

.footnote[
  [데이터 과학을 위한 저작도구: Computational Documents - GITHUB `readme.md`](https://statkclee.github.io/comp_document/ds-github-readme.html)
]

---
class: kcd-title-subslide

코딩 문서를 넘어서

---
class: title-style
layout: false

# 보고서 생성 자동화

.center[
  <img src="fig/report-many-automation.png" alt="보고서 자동화" width="40%" />
]

.footnote[
- [데이터 과학을 위한 저작도구 - 보고서 자동화](https://statkclee.github.io/comp_document/ds-report-automation.html)
]

---
class: title-style
layout: false

# Parameterized 문서

.pull-left[

```r
# 1. 시도명 ---------------------------------------
provinces <- c("강원도", "경기도", "경상남도", "경상북도", "광주광역시", "대구광역시", 
               "대전광역시", "부산광역시", "서울특별시", "세종특별자치시", "울산광역시", 
               "인천광역시", "전라남도", "전라북도", "제주특별자치도", "충청남도", 
               "충청북도")

# 2. 보고서 만들기 ---------------------------------------
for(province in provinces) {
  rmarkdown::render("election-province.Rmd", 
                    output_format="html_document",
                    params = list(province = province),
  output_file = str_c(paste0(province, "_report_"), Sys.Date(), ".html", sep=""),
  encoding = 'UTF-8', 
  output_dir = "report")
}
```
]

.pull-right[

```r
---
layout: page
title: "Computational Document"
subtitle: "`r params$province` 대통령 선거 득표 보고서"
author:
    name: 이광춘 (KPMG)
    affilates: 데이터 과학자
date: "`r Sys.Date()`"
always_allow_html: yes
params:
  province: "서울특별시"
output:
  html_document: 
    toc: yes
    toc_float: true
    highlight: tango
    code_folding: show
    number_section: true
---
```

]

.footnote[
- [기본문서](https://statkclee.github.io/comp_document/tutorial/02_parameterized_rmd/election.html)
- [매개변수 적용된 문서](https://statkclee.github.io/comp_document/tutorial/02_parameterized_rmd/election-province.html)
]

---
class: title-style
layout: false

# 전자책 저작

.center[
  <img src="fig/bookdown-netlify.png" alt="북다운" width="60%" />
]

.footnote[
- [데이터 과학을 위한 저작도구: Computational Documents - 북다운(`bookdown`)](https://statkclee.github.io/comp_document/bookdown-intro.html)
- [데이터과학을 위한 미적분학](https://calculus-book.netlify.app/)  
]

---
class: title-style
layout: false

# 대쉬보드

.center[
  <img src="fig/kcd-dashboard.png" alt="북다운" width="100%" />
]

.footnote[
- [데이터 과학을 위한 저작도구: Computational Documents - 대쉬보드(Dashboard)](https://statkclee.github.io/comp_document/cd-dashboard.html)
- [코로나19 대쉬보드](https://statkclee.github.io/comp_document/cd-corona.html)  
]