나는 내 문서를 만들기 위해 스핑크스를 사용하는 장고 프로젝트를 가지고 있습니다. 나는 sphinx-apidoc을 거쳐 'make latexpdf'를 실행했다. 결과 문서에는 여백에서 벗어나는 꽤 많은 행이 있습니다. 여백 문제 위에 인덱스의 행이 서로 오버플로되기 시작합니다.스핑크스가 만든 PDF에서 여백을 어떻게 수정합니까?
이러한 문제를 해결하는 쉬운 방법 (또는 PDF 문서를 만들 수있는 쉬운 방법이) 거기에 ? 인덱스에 넘쳐 줄 상황이 conf.py이 추가로 개선 될 전망이다
(내가 LaTeX의에 정통한 아니에요)
ELI5 가능한 경우 :
latex_elements = {
'printindex': '\\footnotesize\\raggedright\\printindex',
}
을 또는 당신이로 전환 할 수 있습니다
TeX는 항상 줄 바꿈을 삽입하는 방법을 항상 알지 못합니다. 결국에는 하이픈을 넣는 것이 좋습니다. 자연 언어. 그러나 Sphinx는 LaTeX가 1.4.2 버전부터 긴 코드 라인을 처리하도록 강요하고 있습니다.
최근 1.5.3 이후 사용자가 페이지 여백을 사용자 정의 할 수 있으며 'sphinxsetup'을 통해 구성 할 수있는 hmargin 및 vmargin에 대한 문서는 http://www.sphinx-doc.org/en/stable/latex.html#the-sphinx-latex-style-package-options을 확인하십시오.
1.6.3을 사용하면이 제안이 크게 향상되었지만 불행하게도 색인 페이지의 첫 번째 열에서 두 번째 열로 넘치는 행이 완전히 제거되지 않았습니다. 그러나 나는 아주 긴 끈이 있었다. –
파이썬과 스핑크스의 재현 가능한 예제와 버전을 제공하십시오. 이것이 없다면, 모노 스페이스 글꼴을 사용하지 않거나, 모노 스페이스 글꼴을 더 작은 크기로 설정하거나, 더 좁은 글꼴을 사용하지 않는 것이 좋습니다. [Pyramid PDF documentation] (http://readthedocs.org/projects/pyramid/downloads/pdf/latest/) 색인 항목에서 모노 스페이스 글꼴은 사용하지 않습니다. 우리는 긴 줄의 코드 블록을 올바르게 래핑하지 않는 문제가 있었지만 최근 버전의 스핑크스에서는 해결 된 것으로 보입니다. 우리의 [소스 코드 repo] (https://github.com/Pylons/pyramid/tree/master/docs)에서 예제를 찾으십시오. –