====== Screenplay ======

**Screenplay** is a plugin for [[http://www.dokuwiki.org/dokuwiki|DokuWiki]] for writing correctly formatted screen and teleplays. It is designed to use a simple, intuitive, non-restrictive syntax to produce correctly formatted screen and teleplays easily and quickly.

===== Features =====
  * Powerful, intuitive syntax
  * Standard screenplay formatting ((To conserve space the standard margins have been collapsed to 0.25in. The actual content area, however, matches the standard size.))
  * Title page
  * Teleplay act headers
  * Dual (side-by-side) dialogue
  * Scene section edits
  * Valid XHTML & CSS

===== Usage =====
  * [[screenplay:usage|Usage Syntax]]
  * [[screenplay:example|Usage Example]]

===== Download =====
<note tip>
  * Screenplay works with DokuWiki's plugin manager using this ''[[http://liqd.org/wiki/_media/screenplay/screenplay-latest.zip|URL]]''.
  * To manually install, unzip the archive to DokuWiki's ''lib/plugins/'' directory.
  * The latest version is v0.7.4
</note>

{{filelist>:screenplay:*&order=desc&style=table&tableshowsize=1&tableheader=1}}

==== Change Log ====
  * **v0.7.4** [2009-04-23]
    * FEATURE: Rudimentary print stylesheet.
    * FEATURE: "by" is now translatable.
    * CHANGE: Added a right side margin to the section edit buttons for scenes.
    * CHANGE: Act heading syntax has changed to accomodate any number of '=' characters, the only requirement is that the number of '=' are balanced on either side of the act heading.
    * CHANGE: Removed unncessary log function.
    * CHANGE: Characters a-z now permitted in character names and scene titles.
    * CHANGE: Moved license information to separate file.
    * FIX: htmlentities() is not multibyte character safe which causes problems with internationalization. Switched to DokuWiki's _xmlEntities().
    * FIX: Master regular expression was too greedy, prevented multiple screenplays sections from being used on a single page.

++++ Older Vesions |
  * **v0.7.3** [2009-01-09]
    * ''FIX'': Scene section edits would corrupt adjacent scenes

  * **v0.7.2** [2009-01-08]
    * ''FIX'': Regular expression for scene headings matched too broadly, causing bad section edits

  * **v0.7.1** [2009-01-06]
    * ''FIX'': Some potential PHP warnings

  * **v0.7.0** [2009-01-06]
    * ''FEATURE'': Section edit buttons for individual scenes
    * ''CHANGE'': Syntax for scene headings changed to ''[EXT/INT. LOCATION - TIME]''
    * ''FIX'': Errors which caused page not to render correctly if some title page parameters were not set

  * **v0.6.3** [2008-07-25]
    * ''FIX'': CSS class ''action'' conflicts with DokuWiki's

  * **v0.6.2** [2008-06-08]
    * ''FIX'': opening tag matches too broadly

  * **v0.6.1** [2008-06-07]
    * ''FIX'': Warning due to sanitizing dual dialogue output

  * **v0.6.0** [2008-06-06]
    * ''FEATURE'': New parameter, ''force-courier'' which uses Courier by default instead of New Courier
    * ''CHANGE'': Significant code refactoring

  * **v0.5.0** [2008-06-04]
    * ''FEATURE'': Dual (side-by-side) dialogue
    * ''FEATURE'': Parameter to center character names
    * ''CHANGE'': Parameter to center screenplay is now ''center-page''
    * ''CHANGE'': Renamed CSS class names
    * ''FIX'': Plugin URL was incorrect

  * **v0.4.0** [2008-06-03]
    * ''CHANGE'': Title page delimiter is now a row of at least eight dashes
    * ''CHANGE'': Act headings now require at least six equal signs
    * ''CHANGE'': Significant code refactoring
    * ''FIX'': "by" appears on title page even if no authors are entered
    * ''FIX'': CSS is not fully valid
    * ''FIX'': Debug text being logged to file
    * ''FIX'': Internal server error when no title page is given
    * ''FIX'': Raw wiki markup is not escaped

  * **v0.3.0** [2008-06-02]
    * ''FEATURE'': Support for a title page
    * ''CHANGE'': Syntax for scene headings now require a single preceding space
    * ''CHANGE'': Tweaked border style

  * **v0.2.0** Released on [2008-06-02]
    * ''RELEASE''
++++

===== Known Issues =====
  * None. :-)

===== Discussion =====
Discussion and feedback for this plugin can be found in this [[http://forum.dokuwiki.org/thread/2200|thread]] on the DokuWiki forums.

===== Wish List =====
<note>Not all items on the wish list are guaranteed to be implemented.</note>

==== Screenplay Formatting ====
  * Pagination
  * More, Continued, etc.

==== Plugin Enhancements ====
  * Print layout support
  * Document (PDF, ODT, etc.) export
  * Notes/comments support
  * Option to use template or fixed colors



===== Acknowledgments =====
  * Based on Christopher Smith's DokuWiki syntax plugin [[http://www.dokuwiki.org/devel:syntax_plugin_skeleton|skeleton]].
  * CSS style sheet based on the [[http://johnaugust.com/archives/2004/screenbox|work]] of John August.
  * Screenplay formatting based on the recommended [[http://www.oscars.org/nicholl/format.html|guidelines]] of the Academy of Motion Picture Arts and Sciences.