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 512
  • OS X 362
  • Linux 334
Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14 Apr 13 Apr 12 Apr 11 Apr 10 Apr 9 Apr 8 Apr 7 Apr 6 Apr 5 Apr 4 Apr 3 Apr 2 Apr 1 Mar 31 Mar 30 Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11 Mar 10 Mar 9
Windows 0 2 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0
OS X 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 1 0 0 0 1 0 0 0 0 0 1
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 0 0 0 0 1 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.