狮身人面像定制 Latexpdf 输出? [英] sphinx customization of latexpdf output?

问题描述

只是好奇是否有人知道在使用 latexpdf 目标时如何自定义 sphinx 输出?我见过很多用于 html 输出的自定义内容，但似乎找不到任何自定义 pdf 输出的示例.

Just curious if anyone knows how to customize the sphinx output when using the latexpdf target? I've seen lots of custom stuff for html output, but cant seem to find any example of custom pdf output.

具体来说，我有兴趣自定义标题页、页眉、页脚，并可能在内容之前添加几页头版内容.

Specifically, I'd be interested in customizing the title page, headers, footers, and possibly adding a few pages of front matter before the contents.

有没有人见过这种自定义的任何例子，或者人们在生成 pdf 时几乎只是使用stock"sphinx 输出?谢谢！

Has anyone seen any examples of this kind of customization, or do people pretty much just use the "stock" sphinx output when generating pdfs? Thanks!

推荐答案

是的，我认为乳胶样式的更好或更清晰的文档会很好，并且一些例子.

Yes i think better or clearer documentation for latex styling would be nice and some examples.

这里有一个关于 sphinx 邮件列表的问题，是关于使用包的.

Here is a question on the sphinx mailing list, which is about about using packages.

sphinx 在名为 sphinxmanual.cls 或sphinxhowto.cls，如果我没记错的话，它是一个用作基础的报告文档类.然后有2个样式文件，它们是包，就是那些文件的内容当您编写 usepackage{mylatexstilefile}

sphinx has its own latex documentclass in a file called sphinxmanual.cls or sphinxhowto.cls, if i remember correctly its a report documentclass that is used as base. then there is 2 style files, which are the packages, it is those files contents that are called on when you write usepackage{mylatexstilefile}

关于使用latex包的问题http://groups.google.com/group/sphinx-dev/browse_thread/thread/890dab5e53fff004

Question about using latex packages http://groups.google.com/group/sphinx-dev/browse_thread/thread/890dab5e53fff004

这是我的 conf.py.

Here is my conf.py.

preamb_old = ur'''
  %documentclass{memoir}
  makeatletter
  fancypagestyle{normal}{
    fancyhf{}
    fancyfoot[LE,RO]{{py@HeaderFamily	hepage}}
    fancyfoot[LO]{{py@HeaderFamily
ouppercase{
ightmark}}}
    fancyfoot[RE]{{py@HeaderFamily
ouppercase{leftmark}}}
    fancyhead[LE,RO]{{py@HeaderFamily @title}} % here's the change
    
enewcommand{headrulewidth}{0.4pt}
    
enewcommand{footrulewidth}{0.4pt}
  }
  makeatother
  %color {blue}
  %
ormalcolor {dark blue}
  pagecolor [RGB]{255, 247, 226}
  definecolor{VerbatimColor}{rgb}{0.95,0.85,0.65}
  definecolor{VerbatimBorderColor}{rgb}{0.5,0.95,0.1}
'''

f = open('graph/static/latexstyling.tex', 'r+')
PREAMBLE = f.read();


latex_elements = {
   'papersize':'a4paper',
   'pointsize':'11pt',
   'classoptions': ',openany',
   'babel': '\usepackage[english]{babel}',
   'preamble': PREAMBLE

}

我不再使用 preamble_old，但它是直接在conf.py，你的乳胶序言.

i don't use preamble_old anymore, but it is an example of changes directly in conf.py, to your latex preamble.

查看 sphinx 文档中的 latex_elements 和 latex_additional_files一个起点.

Check out latex_elements and latex_additional_files in the sphinx docs as a starting point.

这篇关于狮身人面像定制 Latexpdf 输出?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！