Mac 에서 Sphinx+latex 를 사용 하여 중국어 PDF 출력

3941 단어 문서.공구.
아주 오래 전에 sphinx 로 문 서 를 쓰 는 방법 을 소개 한 글 이 있 었 다.이전에 Sphinx 를 사용 하여 중국어 문 서 를 쓴 적 이 없 기 때문에 아무런 문제 도 없 었 다.최근 에 중국어 문 서 를 썼 는데 Sphinx 가 중국어 에 대한 지원 이 그다지 우호 적 이지 않 아서 중국어 PDF 를 돌 릴 때 많은 구 덩이 를 만 났 습 니 다.인터넷 에서 많은 검색 을 했 고 많은 시 도 를 한 후에 마침내 해결 되 었 습 니 다.여기에 글 을 써 서 기록 하 세 요.여러분 에 게 도움 이 되 기 를 바 랍 니 다.
Mac 에 Sphinx 설치
easy_install sphinx

Sphinx 프로젝트 만 들 기
sphinx-quickstart

Sphinx 직접 컴 파일 출력 PDF
sphinx 출력 pdf 문 서 를 사용 하려 면 추가 플러그 인 을 설치 해 야 합 니 다.rst2pdf 를 사용 할 수 있 습 니 다.python 에서 개발 한 플러그 인 으로 설치 와 사용 이 편리 합 니 다.
rst2pdf 설치
easy_install rst2pdf

conf.py 에 rst2pdf 설정
  • rst2pdf 확장 추가
    extensions = ['rst2pdf.pdfbuilder']
  • pdf 문서 의 변 수 를 증가
    # index - master document
# rst2pdf - name of the generated pdf
# Sample rst2pdf doc - title of the pdf
# Your Name - author name in the pdf
pdf_documents = [('index', u'rst2pdf', u'Sample rst2pdf doc', u'Your Name'),]
    • pdf 문서 컴 파일
    make pdf

    sphinx 는 중국 어 를 지원 하지 않 기 때문에 rst2pdf 를 통 해 중국 어 를 포함 하 는 PDF 문 서 를 출력 하 는 것 은 좀 번 거 롭 습 니 다.설정 을 변경 하여 중국 어 를 지원 할 수 있 는 글꼴 을 변경 하 는 방식 으로 이 루어 져 야 합 니 다.중국어 문 서 를 출력 하기 위해 latex 를 사용 하지 않 습 니 다.
    Latex 로 중국어 PDF 출력
    latex 를 설치 하면 전체 설 치 를 선택 하고 latex-base 버 전 을 설치 할 수 있 습 니 다.전체 설 치 는 패키지 만 약 2.7G 이 고 latex-base 는 기본 패키지 로 패키지 100 M 정도 설치 되 며 설치 에 400 M 미 만 의 공간 이 필요 합 니 다.우 리 는 현재 latex 를 통 해 PDF 문 서 를 출력 해 야 하기 때문에 완전한 설 치 를 설치 할 필요 가 없다.latex-base 를 사용 하면 됩 니 다.그러나 latex-base 설치 후 직접 사용 할 수 없고 추가 작업 이 있어 야 중국어 형식 을 정상적으로 지원 할 수 있 습 니 다.
    Latex 는 Mac OS 에서 MacTex 라 고 합 니 다.
    Basic Tex 설치
  • 홈 페이지 에서 BaisicTex 설치 패 키 지 를 다운로드 하고 링크 를 다운로드 합 니 다.http://tug.org/cgi-bin/mactex-download/BasicTeX.pkg
  • 다운로드 가 완료 되면 바로 더 블 클릭 으로 설치 하면 된다.구덩이:설치 가 완료 되면 해당 도구 모음 의 경 로 는 환경 변수 에 추가 되 지 않 습 니 다.따라서 이 때 해당 도 구 를 직접 실행 하거나 컴 파일 을 설정 하면 해당 도구 의 오 류 를 찾 을 수 없습니다.
  • 환경 변수$PATH에 도구 경 로 를 추가 합 니 다.도구 경 로 는 보통/usr/local/texlive/2016basic/bin/universal-darwin/에 있 습 니 다.(주:"2016 basic"는 제 가 설치 한 버 전 입 니 다.설치 한 버 전이 다 르 면 이 파일 의 이름 이 다 를 수 있 습 니 다.)1)수정.bash_profile,다음 줄 과 같이 추가:
    export PATH=$PATH:/usr/local/texlive/2016basic/bin/universal-darwin/
    2)수정 을 발효
    source ~/.bash_profile
    • 추가 tex 패키지 설치
    설치 가 완료 되면 sphinx 설정 파일 을 직접 설정 하고 pdf 를 컴 파일 하면 많은 오류 가 발생 할 수 있 습 니 다.이것 은 우리 가 단지 basic latex 패 키 지 를 설 치 했 기 때 문 입 니 다.중국어 pdf 의 출력 을 지원 하려 면 추가 패키지 가 필요 합 니 다.
    MacTex 는 tlmgr 라 는 패키지 관리 도 구 를 제공 합 니 다.우 리 는 이 도 구 를 통 해 필요 한 패 키 지 를 직접 설치 할 수 있 습 니 다.Basic Tex 가 설 치 된 후에 도 이 도 구 는 앞에서 언급 한 도구 경로 에 설치 되 었 다.환경 변수 에 경 로 를 추 가 했 기 때문에 이 명령 을 직접 수행 할 수 있 습 니 다.
  • tlmgr 업데이트
    sudo tlmgr update --self
  • 해당 도 구 를 설치 할 때 설치 해 야 할 도 구 는 titlesec,framed,threeparttable,wrapfig,multirow,enumitem,bbding,titling,tabu,mdframed,tcolorbox,textpos,import,varwidth,needspace,tocloft,ntheorem,environ,trimspace,collection-fonts recommended,capt-of,eqparbox,cjk
    • 이다.
    프로필 수정config.pylatex_elements = {...}에 다음 과 같은 내용 을 추가 합 니 다.
    sudo tlmgr install titlesec framed threeparttable wrapfig multirow enumitem bbding titling tabu mdframed tcolorbox textpos import varwidth needspace tocloft ntheorem environ trimspaces collection-fontsrecommended capt-of eqparbox cjk

    주:
    와\b는 모두 Python 의 전의 문자 이기 때문에 설정 중의
    obreakspace    와\begin는 두 개\\를 사용 해 야 합 니 다.
    컴 파일
    모든 것 이 준 비 된 후에 실행make latexpdf하면build/latex디 렉 터 리 에서 pdf 문 서 를 직접 생산 할 수 있 습 니 다.
    주:컴 파일 과정 에서 신문! Undefined control sequence.의 오 류 를 만 날 수 있 습 니 다.블 로 거들 은 직접 차 로 돌아 가 이 오 류 를 무시 하고 중국어 PDF 를 정확하게 생 성 할 수 있 기 때문에 이 오 류 를 깊이 연구 하지 않 았 습 니 다.
    es6 함수 매개 변수의 기본 값 과 재 구성 할당 의 기본 값 을 결합 하여 이해 합 니 다.
    파충류 가 정 보 를 추출 하 는 세 가지 방법

    좋은 웹페이지 즐겨찾기

    개발자 우수 사이트 수집

    개발자가 알아야 할 필수 사이트 100선 추천 우리는 당신을 위해 100개의 자주 사용하는 개발자 학습 사이트를 정리했습니다
    best100-homepage