2장 저자

이 장에서는 저자로서 개인 컴퓨터에서 LaTeX으로 작성한 책을 MathPage에 출판하는 과정을 설명합니다. Linux 환경의 터미널(terminal)에서 작업하는 것으로 가정합니다.

1절 출판 준비

터미널을 엽니다. Windows에서는 WSL 설치 후에 만들어진 Ubuntu 앱을 시작 메뉴에서 실행합니다.

스크립트 설치

다음 파일

을 내려받습니다.¹ Windows에서는 explorer.exe .(마지막에 마침표 주의) 명령으로 폴더 탐색기를 열어 내려받은 파일을 Linux 폴더로 옮깁니다. 이제 내려받은 파일이 들어 있는 폴더에서

ls

명령을 실행하여 mp 파일이 있는 것을 확인합니다. 마지막으로

    chmod 755 mp

를 수행하여 실행 파일로 만든 후에 어디서든 실행할 수 있도록 적당한 장소에 옮겨 놓습니다.

ssh 열쇠 등록

책을 출판하려면 ssh 열쇠를 등록하여야 합니다. 터미널을 열고 홈 폴더 안의

.ssh

폴더로 이동합니다. 이 폴더가 없다면 먼저 만들어야 합니다.² 점으로 시작하는 이름을 가진 폴더 또는 파일은

ls

명령으로 보이지 않는 것에 유의하기 바랍니다.

다음 명령으로 개인열쇠

mathpage

와 공개열쇠

mathpage.pub

을 생성합니다.

    ssh-keygen -f mathpage

다음 명령으로 공개열쇠의 내용을 볼 수 있습니다.

    cat mathpage.pub

이 내용을 복사하여 MathPage 홈페이지의 저자 메뉴 “저자 > ssh 열쇠 관리”에 붙여 넣습니다.

패스파일 준비

다음 명령으로 홈 폴더 아래에

.mathpage

폴더를 생성합니다.

    cd ~
    mkdir .mathpage

다음으로 진행하기 전에

passfile

의

AUTHOR

는 저자로 등록된 사용자 아이디,

SHELF

는 LaTeX 소스 파일들을 저장하는 폴더의 경로,

KEY

는 앞서 준비한 ssh 열쇠의 경로,

•

|PUBLISHER|는 변경하지 않음에 주의하기 바랍니다.

이제 다음 명령으로

passfile

을

    cd .mathpage
    cat > passfile

열고 다음과 같이

    PUBLISHER=mathpage@publisher.mathpage.dev
    AUTHOR=judy
    SHELF=~/shelf/
    KEY=~/.ssh/mathpage

입력한 후에

CTRL-D

키를 누르면 파일이 저장됩니다. 다음 명령으로

passfile

의 내용을 다시 확인합니다.

    cat passfile

마지막으로 위에서

SHELF

에 입력한

~/shelf

폴더가 실제 존재하여야 합니다. 새로 폴더를 만들려면

cd ~; mkdir shelf

명령을 사용합니다.

LaTeX 파일 올리기

SHELF

에 있는 파일들을 MathPage에 올리기 위해서 다음 명령

    mp publish

(또는

mp

파일이 있는 폴더에서

./mp publish

)를 사용합니다. 이 명령을 수행하면

SHELF

의 파일들을 MathPage에 올린 후 수정된 책들은 새로 출판됩니다.

만약

passfile

의 위치나 이름을 바꾼 경우에는 다음 명령을

    ./mp -p ~/.mathpage/passfile publish

사용합니다.

Edge 또는 Safari 웹브라우저는 내려받은 파일을 mp.txt 이름으로 저장할 수 있습니다. 이 경우에는 이름을 mp로 바꿉니다.

mkdir .ssh; cd .ssh

2절 저자 메뉴

저자 정보 관리

“이름”은 책의 저작권 표시에 사용됩니다. 예를 들어 “홍길동”으로 입력하고 “성”은 비워 둡니다. 영문 이름의 경우 “이름”에 first name을 “성”에 last name을 입력합니다. “별명”은 책의 저자 표시에 사용되므로 필명을 기입합니다. “언어”는 저자에게 보내는 이메일 등에 사용하는 언어입니다.

ssh 열쇠 관리

출판 준비 단계에서 생성한 ssh 열쇠의 내용을 복사하여 비어 있는 입력란에 붙여넣습니다. 이후에 ssh 열쇠가 변경되면 기존의 내용을 지우고 다시 입력해 주어야만 합니다.

책 관리

새로운 책을 추가할 때는 “제목”, “표지”, “슬러그”를 입력하고 “소스 파일”에서 책의 LaTeX 파일을 선택한다. “표지”에는 책표지 이미지 파일을 개인 컴퓨터에서 선택합니다. 아직 책표지가 준비되지 않았으면 비워 둡니다. 슬러그(slug)는 책의 URL에 사용되는 짧은 문자열이므로 a부터 z까지의 영문자와 숫자 그리고 “-” 또는 “_”를 조합하여 간단하게 정합니다. 예를 들어 선형대수학 책인 경우 영어 linear algebra의 첫글자를 따서 “슬러그”에 la라고 입력할 수 있습니다. “언어”는 영어 또는 한국어 중에 선택할 수 있습니다. 책이 여러 개의 파일로 이루어져 있고 주 파일에서

\include

를 사용하여 묶여져 있다면 “소스 파일”에 주 파일을 선택합니다.

내 서재 열기

서재에는 MathPage에 출판된 책이 표시됩니다. 서재의 책은 일반에게 공개되지 않습니다.

책의 판매

온라인으로 출판된 책은 MathPage를 이용하는 강사 또는 독자에게 판매할 수 있습니다. 이를 위해서는 MathPage에 판매 요청을 하여야 합니다. 저자 메뉴의 책 관리 메뉴에서 “판매 요청”을 합니다.

3절 출판 실습

LaTeX 사용하기

서재 폴더에 새로운 폴더

my_book

을 만듭니다. 이 새로운 폴더로 다음 파일을 내려받습니다.

my_book.tex

이 파일을 LaTeX 시스템을 사용하여 조판합니다. 문제없이 조판이 되면 생성된

my_book.pdf

를 확인합니다.

이제 터미널에서

mp publish

명령을 실행하여 서재 파일들을 MathPage에 올립니다. 저자 메뉴에서 책 추가를 하여 새로운 책

My Book

을 생성합니다. MathPage의 내 서재에서 생성된 책을 확인합니다.

XeLaTeX으로 한글 문서 출판하기

LaTeX에서 한글을 사용하기 위해서는 XeLaTeX 엔진을 사용하여 조판하여야 합니다. 서재 폴더에 새로운 폴더

my_book_ko

를 만듭니다. 새로운 폴더에 다음 중에 사용 중인 운영체제에 맞는 파일을 내려받습니다.

	my_book_ko.tex			Windows
	my_book_ko.tex			Mac
	my_book_ko.tex			Linux

이 파일을 XeLaTeX(LaTeX 시스템에서 XeLaTeX 엔진 사용)으로 조판합니다. 조판이 완료되면 생성된

my_book_ko.pdf

를 확인합니다.

이제

mp publish

명령을 실행하여 서재 파일들을 MathPage에 올립니다. 저자 메뉴에서 책 추가를 하여 새로운 책

나의 책

을 생성합니다. 책의 언어로 한국어를 선택합니다. MathPage의 내 서재에서 생성된 책을 확인합니다.

한글 문서 클래스 사용하기

앞서 생성된

my_book_ko.pdf

를 자세히 보면 한글 문서에서 자연스러운 “장”, “절” 대신에 “Chapter”, “Section”의 영문 표현이 사용된 것을 볼 수 있습니다. 이는 문서 클래스로 영문 문서를 위한

book.cls

을 사용했기 때문입니다. 한글 문서 클래스를 사용하기 위해서 다음 파일을 내려받아

my_book_ko.tex

와 같은 폴더에 넣습니다.

book-ko.cls

그리고

my_book_ko.tex

를 열어 첫 줄을 다음과 같이 수정합니다.

\documentclass{book-ko}

이제 다시 XeLaTeX으로 조판한

my_book_ko.pdf

를 확인하면 자연스러운 한글 문서를 볼 수 있습니다.

LaTeX으로 글쓰기

MathPage는 LaTeX의 대부분의 기능을 지원합니다. 한편 MathPage는 미디어와 상호적 내용물을 지원하기 위해서 LaTeX의 기능을 확장합니다. 자세한 사항은 5 장을 참고합니다.