글쓰기는 코딩

class: center, middle, inverse, title-slide

# 글쓰기는 코딩
## 글쓰기를 <del>잘</del>하기 위해서 알아야 되는 코딩
### 데이터 과학자 이광춘
### 2018/05/26

---

class: inverse, middle, center

# 책 만들기
 
---
## 전통적 작업 흐름

.center[
<img src="fig/latex-writing-supply-chain.png" alt="저작물을 생산, 유통, 고객 소비까지 이르는 공급망" width="77%" />
]

- 저작자와 독자 사이에 다수 중간단계 존재
    - 편집 및 디자인
    - 출판
    - 배송
    - 서점 : 전통 책방, 온라인 서점, 전자책 등
- 각 단계별 인력, 소프트웨어, 기계장비 등 필요

---
class: inverse, middle, center

# 글쓰기 패러다임

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

---
## 현재 상황 요약

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

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

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

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

---
class: inverse, middle, center

# 21세기 저작

---
## 마크다운과 `\(LaTeX\)`

- **GUI 저작 시스템**
    - 데스크톱 위지윅 저작시스템: 아래한글, MS 워드
    - 클라우드 위지윅 저작시스템: 구글독스
- **마크다운** : 웹사이트와 블로그
    - 장점: HTML로 원하는 모든 것을 적은 타이핑하지 않고도 가능.
    - 단점: 
        - 저널 대부분이 제출형식으로 받아주지 않기 때문이다.
        - 고위 연구협력자가 이를 받아줄 가능성은 없다. (물론, 고위 연구협력자가 LaTeX을 사용하지 않았다면, LaTeX으로 전환하지도 않을 것이다…).
        - 과학연구원이 원하는 기능 상당수를 마크다운이 지원하는 않는다. (예를 들어, 참고문헌 서지관리)
- **LaTeX** : 원고저작 및 출판
    - 장점
        - PDF와 다른 표준형식으로 컴파일 작업을 수행한다.
        - 그림과 표를 배치하는데 탁월한 성능을 보여준다.
        - 버젼제어와 잘 묶어 작업할 수 있고, 서지관리 소프트웨어 상당수와 호환됨.
        - 많은 저널에서 받아주는 형식. (하지만, 학문 분야마다 다양성이 존재.)
    - 단점

---
## 저작 흐름

.center[
  <img src="fig/latex-writing_is_coding.png" alt="저작자와 고객을 중간과정 자동화를 통한 저작물 직접 유통" width="100%" />
]

---
## 저작 흐름 비교

.center[
<img src="fig/latex-writing-supply-chain.png" alt="저작물을 생산, 유통, 고객 소비까지 이르는 공급망" width="100%" />
]

-----

.center[
  <img src="fig/latex-writing_is_coding.png" alt="저작자와 고객을 중간과정 자동화를 통한 저작물 직접 유통" width="80%" />
]

---
## 도구가 자동화하는 저작 업무

.pull-left[
### 1. `\(LaTex\)` 사례
  <img src="fig/latex-how-it-works.png" alt="도구가 자동화하는 저작 업무" width="100%" />
  
  [정보교육을 위한 파이썬: 데이터 과학자로의 여정, 아마존 절찬 판매중](https://statkclee.github.io/pythonlearn-kr/01-py4inf-python2/)
]

.pull-right[
### 2. 북다운(Bookdown)

.center[
  <img src="fig/00_cover_boy_girl.png" alt="컴퓨터 과학 언플러그드" width="100%" />
]
[컴퓨터 과학 언플러그드, 이광춘 번역](https://statkclee.github.io/unplugged/)
]

---
## 도구가 자동화하는 저작 업무

.pull-left[
### 3. 파이썬 스핑크스
  <img src="fig/latex-sphinx.png" alt="파이썬 스핑크스 저작 흐름" width="100%" />

- [Welcome to Reeborg's world!](http://reeborg.ca/index_en.html)
- [리보그 한국어 버젼](http://reeborg.ca/docs/ko/index.html)
- [프로그래밍과 문제해결: 파이썬, 리보그, 러플](https://statkclee.github.io/code-perspectives/)

]

.pull-right[
### 4. 블로그

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

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

---
## 도구가 자동화하는 저작 업무

### 5. 슬라이드쇼(slideshow)

.center[
  <img src="fig/slideshow.png" alt="슬라이드쇼" width="50%" />
]

.footnote[
  [소프트웨어에 물들다(왕곡초등학교, 2018-05-26)](somul_20180525.html) -  글쓰기를 잘하기 위해서 알아야 되는 코딩
]

---
class: inverse, middle, center

# 책을 넘어서

---
## 데이터로 저작하는 방법

.center[

-----

]

.footnote[
 [데이터야 놀자 발표자료(2017)](https://statkclee.github.io/ds-authoring/slides/ds_data_product.html)
]

---
## MLB 투수 유전자는 유전이 될까?

.center[
  <img src="fig/pe-mlb-regression.png" alt="야구 회귀분석 개요" width="100%" />
]

.footnote[
 [회귀분석 - MLB 투수 유전자는 유전이 될까?](http://statkclee.github.io/politics/pe-baseball-era.html)
]

---
## 데이터 저널리즘

.center[
  <img src="fig/data-journalism.png" alt="데이터 저널리즘 그래프" width="70%" />
]

.footnote[
- [제9회 R Meetup 데이터 저널리즘 -백 마디 말보다 그래프 하나](https://github.com/KaggleBreak/xwmooc_Rmeetup)
- [국제노동기구(ILO) 생산가능인구(2000-2017)](https://statkclee.github.io/data-product/data-journalism-working-pop.html)
]

---
## 참고문헌

### 강서양천일보('15.08월)
- [글을 쓰는 것은 소프트웨어 개발이다!](https://goo.gl/RiXTIb)
- [컴퓨터 사고력과 소프트웨어 교육](https://goo.gl/IXIW4n)

### 데이터과학자를 위한 저작 툴체인
- [데이터 과학을 위한 저작도구](https://statkclee.github.io/ds-authoring/)
- [Modern Scientific Authoring](http://swcarpentry.github.io/modern-scientific-authoring/)