斯芬克斯办公室

本软件包为您提供一款易于使用的软件包，用于从 reStructuredText 文件使用 Sphinx 创建可打印的 PDF 文档。

如果您正在使用 Sublime Text 浏览此文件，则可以从命令板中运行“Sphinx Office：创建 Sphinx HowTo（PDF）”。

先决条件

要使此软件包正常运行，您需要以下第三方软件

• Python - Windows: http://www.activestate.com/activepython
• Sphinx
• LaTex

文档

Sphinx Office 文档可以覆盖在 sphinx（以及更多）中定义的任何 LaTeX 设置，在文档的第一个字段集中。因此，通常您应该以以下方式开始文档：

Document Title
==============

:Author: My Name

以下字段名称是允许的（不区分大小写）

papersize a4paper a4paper，letterpaper，a5paper，等。 pointszie 12pt 10pt，11pt，等。 basefont sans sans，times，等

fontpkg 使用由 basefont 指定的包 \\usepackage{times}，\\usepackage{sans} extraclassoptions：在此处，您可以指定更多的 classoptions 供文档类使用。

'classoptions':    '',
'extraclassoptions': '',
'inputenc':        '\\usepackage[utf8]{inputenc}',
'utf8extra':       '\\DeclareUnicodeCharacter{00A0}{\\nobreakspace}',
'cmappkg':         '\\usepackage{cmap}',
'fontenc':         '\\usepackage[T1]{fontenc}',
'babel':           '\\usepackage{babel}',
'fncychap':        '\\usepackage[Bjarne]{fncychap}',
'longtable':       '\\usepackage{longtable}',
'preamble':        '',
'title':           '',
'date':            '',
'release':         '',
'author':          '',
'logo':            '',
'releasename':     'Release',
'makeindex':       '\\makeindex',
'shorthandoff':    '',
'maketitle':       '\\maketitle',
'tableofcontents': '\\tableofcontents',
'footer':          '',
'printindex':      '\\printindex',
'transition':      '\n\n\\bigskip\\hrule{}\\bigskip\n\n',

信函

以下是一个示例信件：

My Name, My Street, My City

Sublime HQ Pty Ltd
Sydney
Australia

Place, 12. September 2013

**What a great Editor!**

Dear Sir or Madam,

I just wanted to say, that I really love this editor.  It is the
best one, I ever had.  There are three major points about SublimeText:

- Because I am a pretty old fashioned vim-user, I never could find an
  editor, which I simply could use because of the lack of
  vim-key-bindings.

- GotoAnything Feature is the fastest file navigation I ever had.

- Great Plugin API, which lets you customize the editor to you
  your needs.

Sincerly,

My Signature

然后从命令板运行“Sphinx Office：创建 DIN Brief（PDF）”。这将在当前 rst 文件旁边创建一个 PDF 文件。

这只是一个创建信件的方便方式。它的目的是按照最自然的文本方式解读信件。以下是自动识别的内容：

文档开头

• backaddress 作为一行段落，用逗号分隔
• address 是一些行，其总长度不超过 60*line_count 并至少有一个新行。可能会有一个或两个地址。如果只有一个，则解释为收件人地址；如果有两个，第一个是发件人地址，第二个是收件人地址。
• place 和 date 是一行段落，其中包含逗号，并以四位数的年份结束。
• Subject 是一行段落，并且通过默认角色 `like this` 或 *this* 或 **that** 或任何其他方式突出显示的内容。
• 另一行段落被认为是《开始》

文档结束

• 如果文档末尾有一行段落，它被认为是《签名》
• 如果之前还有一行段落，它也被认为是《签名》

您可以在信件的开始指定所有这些参数作为字段

:backaddress: this backaddress can be anything
:place: My Place
:date: some date
:subject: subject
:opening: Dear Sir or Madam,
:closing: Sincerly,
:signature: My Signature

或者甚至可以使用《信件》指令

.. letter::
    Sublime HQ Pty Ltd
    Sydney
    Australia

    :subject: **what a great editor**

    Here the letter text.

如果您未指定信件正文而只指定了信件指令，这些值将作为后续信件指令的默认值。使用信件指令，您可以在一个文档内创建多个信件。