모두를 위한 파이썬: 환경설정

1. 모두를 위한 파이썬 (파이썬3)

“정보교육을 위한 파이썬 - 데이터 과학자로의 여정”은 원제가 Python for Informatics: Exploring Information 영문이고 LaTeX 으로 작성된 반면 모두를 위한 파이썬 (파이썬3), 원제는 Python for Everybody - Exploring Data In Python 3pandoc마크다운을 기반으로 하고 있다. 즉, 마크다운으로 파이썬3 책 콘텐츠를 저작하고 .pdf, .html, .epub 전자책은 pandoc이 작업을 담당하는 구조를 갖추고 있다.

1.2. 작업환경 구출

데비안계열 리눅스(우분투, 민트 등)는 다음 명령어로 번역을 위한 작업환경을 갖추게 된다.

$ sudo apt-get install texlive-full
$ sudo apt-get install pandoc

맥사용자는 다음 웹사이트를 참조하여 필요한 소프트웨어를 설치한다.

1.1. PDF, HTML, EPUB 전자책

bash book.sh 명령어를 실행시키면 x.pdf, x.epub 파일 생성된다. 주의할 점은 book.sh 빌드 스크립트는 파이썬2 기반으로 하여 꼭 파이썬2 를 사용한다. 맥에서 파이썬2, 파이썬3를 함께 사용하는 방법은 stackoverflow QnA를 참조한다. 1

$ bash book.sh

아마존 킨들, KindleGen 전자책 파일 .mobix.mobi로 생성된다.

https://www.amazon.com/gp/feature.html?docId=1000765211

리눅스 사용자의 경우 다음 명령어를 실행시키면 된다.

$ curl -O http://kindlegen.s3.amazonaws.com/kindlegen_linux_2.6_i386_v2_9.tar.gz
$ tar xfv kindlegen_linux_2.6_i386_v2_9.tar.gz 
$ cp kindlegen /usr/local/bin

1.3. 한국어 번역

본인 운영체제에 맞는 작업환경을 구축했다면, 세브란스 교수님이 작성한 빌드 스크립트를 콘솔창에서 실행하여 bash book.sh 명령어를 실행했을 때 제대로 되는지 확인을 먼저한다. 빌드 스크립트를 실행했는데 문제가 생기면 다시 위로 올라가서 제대로 번역환경을 설정했는지 재검토한다. bash book.sh가 정상적으로 실행되면 .pdf 파일이 생성된다. 그러면 이제 본격적으로 한글번역을 위한 작업환경을 설정한다. 중요한 것은 아래 정보교육을 위한 파이썬 (파이썬2)에서 LaTeX 한글 환경을 잘 설정했다면 GitHub에서 클론하고 나서 bash book.sh 빌드 스크립트를 실행하면 문제가 없을 것이다.

  1. GitHub 계정을 생성한다.
  2. 모두를 위한 파이썬 - 파이썬3 한국어 번역 GitHub 저장소를 포크한다.
  3. 포크해서 본인 GitHub 계정으로 가져온 후에 클론(clone)하여 작업 컴퓨터로 내려받는다.
    • 번역에 대한 모든 파일은 다운로드 받은 저장소 아래 book3 디렉토리에 저장되어 있다. book3/mkd_files 디렉토리에는 마크다운 영어 전체 원문이 각 장별로 구분되어 저장되어 있다.
  4. 마크다운으로 번역 작업을 해서 Push하고, 풀요청(Pull Request)를 보낸다.

마크다운 한글 번역

2. 정보교육을 위한 파이썬 (파이썬2)

“정보교육을 위한 파이썬 - 데이터 과학자로의 여정”은 원제가 Python for Informatics: Exploring Information 영문이고 LaTeX 으로 작성되었다. 따라서, 번역을 위한 기본 작업흐름은 LaTeX 으로 문서를 저작하는 것과 동일하다. 다만, 최종 결과물이 .pdf 파일 뿐만 아니라 HTML 웹사이트 .html, 전자책 .epub, .mobi 로 변환을 하는 작업과정이 추가된다.

2.1. PDF, HTML, EPUB 전자책

book.tex 파일이 최종 작업 .tex 파일로 각장 파일과 00-cover.tex, AD-copyright.tex 파일을 모두 포함하고 있다. LaTeX 파일에 오류가 없다면 다음 명령어로 .pdf 파일을 만들어 낸다.

$ bash book.sh

HTML 웹사이트 .html 파일을 생성하려면 다음과 같이 명령어를 입력하면 html 디렉토리가 생성되고 그 내부에 .html 파일이 저장된다.

$ bash html.sh

.epub, .mobi 확장자를 갖는 전자책을 생성하고 한다면 Calibre 소프트웨어를 사용해서 제작한다.

  1. HTML 파일을 zip 파일로 압축한다.
  2. 압축한 .zip 파일을 Calibre에 끌어 넣는다.
  3. EPUB 으로 변환한다.
    • 제목과 저자를 설정한다.
    • Cover를 설정한다.
    • Do not do heuristic processing
    • Blank out the Insert page breaks before regex
  4. 디렉토리를 정하고 디스크에 저장한다.

2.2. 파이썬2 작업환경

맥 사용자

맥환경에서 파이썬2 기반 번역을 할 경우 mactex 만 설치하면 된다. 다만, hevea 관련 HTML을 생성하려면 mactextras를 갖고 시도를 해보고 문제가 있는 경우 리눅스를 활용한다.

리눅스 사용자

리눅스 사용자의 경우 다음 LaTeX 작업 환경을 순차로 설치한다.

$ sudo apt-get install texlive-latex-base
$ sudo apt-get install texlive-latex-recommended
$ sudo apt-get install texlive-fonts-recommended 
$ sudo apt-get install texlive-latex-extra
$ sudo apt-get install hevea
$ sudo apt-get install imagemagick

1.3. 한국어 번역 파이썬2 작업환경

파이썬2 작업환경에서 한국어 번역을 위해서 LaTeX를 한국어 환경에 맞춰 설치를 한다. 자세한 내용은 아래 데이터 과학을 위한 저작도구 한글 LaTeX 을 참조한다.

  1. How can I use Homebrew to install both Python 2 and 3 on Mac?