ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Sphinx Office

Here you find a sublime text plugin for creating letters, reports, or books from reStructured Text files using sphinx.

Details

Installs

  • Total 1K
  • Win 442
  • OS X 319
  • Linux 303
Jun 25 Jun 24 Jun 23 Jun 22 Jun 21 Jun 20 Jun 19 Jun 18 Jun 17 Jun 16 Jun 15 Jun 14 Jun 13 Jun 12 Jun 11 Jun 10 Jun 9 Jun 8 Jun 7 Jun 6 Jun 5 Jun 4 Jun 3 Jun 2 Jun 1 May 31 May 30 May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12
Windows 0 0 0 0 0 1 1 1 0 1 0 0 0 0 0 2 0 1 0 1 0 0 1 0 1 0 0 1 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0
OS X 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 2 0 0 0 0 1
Linux 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 0 0 1 1 1 0 0 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
bitbucket.​org

Sphinx Office

This package provides you an easy to use package for creating print-ready PDF documents from reStructuredText files using Sphinx.

If you are viewing this file with Sublime Text, then you can simply run "Sphinx Office: Create Sphinx HowTo (PDF)" from command palette.

Prerequisites

For this package to work you need following third party software:

Documents

Sphinx Office Documents can override any latex settings, which are defined in sphinx (and some more) in the first fieldset in the document. So you should typically start your document with:

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

:Author: My Name

Following field names are allowed (case insensitive):

papersize a4paper a4paper, letterpaper, a5paper, etc. pointszie 12pt 10pt, 11pt, etc. basefont sans sans, times, etc

fontpkg use package specified by basefont \\usepackage{times}, \\usepackage{sans} extraclassoptions: Here you can specify more classoptions to documentclass.

'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',

Letter

Here an example letter:

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

Then run "Sphinx Office: Create DIN Brief (PDF)" from Command Palette. This will create a PDF file next to current rst file.

Well this was the convenience way for creating a letter. It is intended to interprete the most natural textual way of writing a letter as letter. Here what is automatically recognized:

Beginning of document:
  • backaddress as a one-line-paragraph separated by ","
  • address is something where all lines together are not longer than 60*line_count and at least one new-line. There may be one or two addresses. If one, then it is interpreted as recipient's address, if there are two, the first is the sender's address and the second the recipient's.
  • place and date is a single line paragraph with a "," in the line and the line ends with a four-digit year.
  • Subject is a one-line-paragraph and something emphasized either by default role `like this` or by *this* or **that** or whatever.
  • another one-line-paragraph is interpreted as opening
End of document:
  • if there is a one-line-paragraph in the end of the document, it is interpreted as signature
  • if there is another one-line-paragraph before, it is interpreted as signature

You can specify all these parameter as fields in the beginning of the letter:

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

Or you can even use the letter-directive:

.. letter::
    Sublime HQ Pty Ltd
    Sydney
    Australia

    :subject: **what a great editor**

    Here the letter text.

If you specify a letter directive without letter body, these values will be taken as defaults for subsequent letter directives. Using letter directive you can create multiple letters within one document.