Spexcript -- easy layout for theater scripts

## SpeXcript – makes your spex script beautiful

SpeXcript is a markup and layout system for scripts of theater plays or musicals etc. I originally made it for Fyysikkospeksi, a spex made every other year by mostly Engineering Physics undergraduate and graduate students at Aalto University. For now, it has only been for our internal use, but I am now (2015) releasing it for free and as open source. It would make me happy if someone else finds this useful.

Any feedback or suggestions are very welcome: koos.zevenhoven@aalto.fi.

## Getting Started

### Requirements

• Python 3.4 (May work with older versions, but no official support)

### Installation

spexcript can be installed with pip (make sure you have it installed):

$pip install spexcript  or directly from the source code: $ git clone https://github.com/k7hoven/spexcript.git
$cd spexcript$ python setup.py install


## Basic Usage

The documentation for the markup language itself is on its way, but if you have a spexcript file, say myspex.sxt, you can lay it out as pdf from the command line as follows:

\$ python -m spexcript myspex.sxt


The interface and documentation will be further improved in the future.

## Changelog

### 0.3.0 (2017-04-27) – SpeXcript

• Improve command-line interface
• Cleaner pdftex operation from user’s perspective
• Spexcript succeeds even with empty source file
• Minor refactoring
• Filter out unwanted characters that can mess up typesetting

### 0.2.0 (2015-06-17) – SpeXcript

• Rebranded as SpeXcript
• Python 3 compatibility (3.4)
• Added @mentions with expanded names
• Bugfixes
• Refactoring
• Open sourced

### spextex 2 (2013)

• Rewrote and redesigned C and bash parts, now in Python 2.7
• Revised and more extensible syntax
• Some original features still missing
• Integrated version control removed (use your favorite existing VCS)
• More customizability for different layouts and languages

### spextex 0.0-1.0 (2007-2012)

• Original version written in C, bash scripts and LaTeX for Fyysikkospeksi

## Project details

Uploaded source