screenplay-pkg (16jul15)

git-svn-id: svn://tug.org/texlive/trunk@37874 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 304 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/screenplay-pkg/README b/Master/texmf-dist/doc/latex/screenplay-pkg/README
new file mode 100755
index 00000000000..5f39d80503c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay-pkg/README
@@ -0,0 +1,42 @@
+This is the screenplay-pkg package.
+ Copyright 2006 by John Pate
+ Copyright 2015 by Alan Munn
+
+ This package implements the tools of the screenplay document class
+ in the form of a package so that screenplay fragments can be included
+ within another document class.  For full documentation of the available commands,
+ please consult the screenplay class documentation.
+
+ All commands related to the titlepage in screenplay.cls have been
+ eliminated.
+
+ One new environment is implemented:
+
+    \begin{screenplay} ... \end{screenplay} 
+
+ Two additional user commands are added to allow for user adjustment of the
+ fragment font and linespacing (the setspace package is used for spacing).
+ American spellings of the centring commands are also added.
+
+    \screenspacing{} % sets the linespacing for screenplay fragments; default
+                       is \onehalfspacing
+    \screenfont{}    % sets the font for screenplay fragments; default is
+                       \ttfamily
+                       
+
+ This package may be distributed and/or modified under the
+ conditions of the LaTeX Project Public License, either version 1.3
+ of this license or any later version.
+ The latest version of this license is in
+   http://www.latex-project.org/lppl.txt
+ and version 1.3 or later is part of all distributions of LaTeX
+ version 2005/12/01 or later.
+
+ This package has the LPPL maintenance status `maintained'.
+ 
+ The Current Maintainer of this package is Alan Munn.
+
+ This package consists of the file screenplay-pkg.sty and documentation files
+ screenplay-pkg.tex, screenplay-pkg.pdf, screenplay-pkg-example.tex and screenplay-pkg-example.pdf.
+
+ Version 1.0 2015/07/11
diff --git a/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.pdf b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.pdf
new file mode 100644
index 00000000000..773136f59de
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.pdf
diff --git a/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.tex b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.tex
new file mode 100755
index 00000000000..4fab6fc5aff
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg-example.tex
@@ -0,0 +1,135 @@
+%%
+%% This is file `pkg-example.tex',
+%% +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
+%% 
+%% Original file Authored by and Copyright (C)2006 by
+%% John Pate <johnny@dvc.org.uk>
+%% http://dvc.org.uk
+% This file modified by Alan Munn to test the standalone package version
+%
+%
+%
+%This package may be distributed and/or modified under the conditions of
+%the LaTeX Project Public License, either version 1.3 of this license or
+%any later version. The latest version of this license is in
+%http://www.latex-project.org/lppl.txt and version 1.3 or later is part
+%of all distributions of LaTeX version 2005/12/01 or later.
+%
+%This package has the LPPL maintenance status `maintained'.
+%
+%
+
+\documentclass{article}
+\usepackage{screenplay-pkg}
+\usepackage{lipsum}
+\begin{document}
+
+%% TeX allows quite a lot of leeway in whitespace, so I've messed this
+%% up a bit.  I find keeping the format structured helps me a lot tho.
+%% Note: but don't have blank lines *inside* the body of text in
+%% a dialogue environment.
+%% I use vi (Elvis) with macros to make a lot of typing disappear.
+%% You can, of course, define LaTeX macros to shorten the command names.
+%%
+%% Anyhoo, on with the show ...
+
+%% for some reason this always happens at the start ...
+This is some normal text in the document. \lipsum[1]
+
+% To insert a screenplay fragment, use the screenplay environment
+\begin{screenplay}
+\fadein
+
+\intslug[illumination]{example sample -- screenplay.cls}
+
+In space, nobody knows what time of day it is.  Wait, there is no
+day.
+
+So BOB, a cross-dressing Republican, and BROWN, a Christian
+fundamentalist Democrat, are talking nonsense instead.
+
+\begin{dialogue}{Bob}
+That means that someone
+sabotaged the unit and killed the
+President! Was it one of us?
+\end{dialogue}
+\begin{dialogue}{Brown}
+Who else is mad but us, Condi\ldots
+ \paren{beat}
+and Bliar?
+\end{dialogue}
+
+Bob buries his head in his hands.
+
+\intslug{Atlantis -- somewhere ANyway}
+
+JOHN and MARK are at adjacent consoles. FRED is with them. TOM
+is at another console slightly further away.
+
+\begin{dialogue}{John}
+The planetoid seems to have a thin crust
+covering a nickel-iron core. Could have
+been an Earth-like planet at one time.
+\end{dialogue}
+
+\begin{dialogue}{Mark}
+We're coming up on the radio source now.
+\end{dialogue}
+
+Brown walks in and goes to a console.
+
+He has a PARROT on his shoulder.
+
+The Parrot has an air of quiet insouciance.
+
+\begin{dialogue}{Fred}
+Switch the visual to main screen so we
+can get a good look.\end{dialogue}
+
+They look up at the main screen.
+
+\begin{dialogue}[to John and Mark]{Fred}
+Lock on to that.
+\dialbreak[to Tom]{Fred}
+Establish planetary orbit.
+\end{dialogue}
+
+\intextslug[day]{in or out}
+Apparently some people do this.
+
+\intercut
+\extintslug[night]{out or in}
+Or even this.
+
+\extslug[day or nite]{NO WARRANTY -- EXPRESS OR IMPLIED}
+
+\pov\ I made the slugline DAY/NIGHT optional 'cause in space no-one can
+tell the time.  You probably will need to specify.
+
+Don't put in pagebreaks by hand until you're really, really
+finished editing!
+
+It isn't the done thing to hyphenate for formatting purposes.
+\centretitle{http://dvc.org.uk/sacrific.txt/}
+
+That was a centred titleover.
+\begin{titleover}There's a titleover environment for dialogue-like layout if you're
+doing the "Star Wars" thing.\end{titleover}\extslug[All Hail Discordia!]{where to find us}
+http://dvc.org.uk/sacrific.txt/screenplay.zip
+
+Use the source, Luke.
+
+\extslug[illumination]{for definitive info on layout}
+
+http://www.oscars.org/nicholl/format.html
+
+%% and this always happens at the end ...
+\fadeout
+
+\theend
+\end{screenplay}
+\end{document}
+%% 
+%% Hail Eris!  All Hail Discordia!
+%%
+%% End of file `pkg-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.pdf b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.pdf
new file mode 100644
index 00000000000..f1cc920bdf4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.pdf
diff --git a/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.tex b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.tex
new file mode 100644
index 00000000000..e425b99d0d6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay-pkg/screenplay-pkg.tex
@@ -0,0 +1,127 @@
+% !TEX TS-program = pdflatexmk
+
+\documentclass[11pt]{article}
+\title{\textbf{The \textsf{screenplay-pkg} package}}
+\author{\textbf{Alan Munn}\\Department of Linguistics and Languages\\Michigan State University\\\texttt{\href{mailto:amunn@msu.edu}{amunn@msu.edu}}}
+\date{Version 1.0\\July 11, 2015}
+\usepackage[T1]{fontenc}
+\usepackage[margin=1in]{geometry}
+\usepackage{titling}
+\usepackage[utf8]{inputenc}
+\usepackage{array, booktabs, multicol, fancyhdr, xspace,tabularx}
+\usepackage{enumitem}
+\usepackage{fancyvrb,listings,url}
+\usepackage[sf,compact]{titlesec}
+\usepackage{screenplay-pkg}
+\usepackage[colorlinks=true]{hyperref}
+
+
+\DefineShortVerb{\|}
+\newcommand*\bs{\textbackslash}
+
+\IfFileExists{luximono.sty}%
+{%
+  \usepackage[scaled]{luximono}%
+}
+{%
+  \IfFileExists{beramono.sty}%
+  {%
+    \usepackage[scaled]{beramono}%
+  }{}
+}
+
+  
+\lstset{%
+    basicstyle=\ttfamily\small,
+    commentstyle=\itshape\ttfamily\small,
+    showspaces=false,
+    showstringspaces=false,
+    breaklines=true,
+    breakautoindent=true,
+    captionpos=t
+    language=TeX
+}
+  
+\newcommand*{\pkg}[1]{\texttt{#1}\xspace}
+\setitemize[1]{label={}}
+\setitemize[2]{label={}}
+\setdescription{font={\normalfont}}
+\setlength{\droptitle}{-1in}
+
+\lhead{}
+\chead{}
+\rhead{}
+\lfoot{\emph{}}
+\cfoot{\thepage}
+\rfoot{}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+\pagestyle{fancy}
+
+
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+\renewcommand{\abstractname}{\sffamily Abstract}
+
+\abstract{\noindent\begin{quote}This is a package version of the \pkg{screenplay} document class. The class version is designed to produce a properly formatted screenplay manuscript. This package version allows portions of screenplays formatted using the class methods to be included into other document classes.
+\end{quote}
+\section{Introduction}
+This package arose out of a question asked on the StackExchange website: \href{http://tex.stackexchange.com/q/26227/}{Converting document classes into environments: is it possible?}. The question asked how easy it would be convert the class functionality into an environment.  This package is the result of that discussion.
+\section{Package use}
+To use the package just load it like any other package:
+
+\begin{lstlisting}
+    \usepackage{screenplay-pkg}
+\end{lstlisting}
+
+\subsection{New commands}
+The package implements one new environment and two formatting hooks for it.
+The |screenplay| environment provides an environment to wrap a screenplay fragment.  Within this environment, you should use any of the macros defined in the \href{https://www.ctan.org/pkg/screenplay}{\pkg{screenplay}} class. Please consult its  documentation for details.
+\begin{lstlisting}
+    \begin{screenplay}
+     
+    \end{screenplay} 
+\end{lstlisting}
+
+ Two additional user commands are added to allow for user adjustment of the
+ fragment font and linespacing (the \pkg{setspace} package is used for spacing). American spellings of the centring commands have also been created. British spellings of these commands are retained:
+
+\begin{center}
+
+\begin{tabular}{l>{\raggedright\arraybackslash}p{3.5in}}
+\toprule
+\textsf{Command}       & \textsf{Explantion}\\
+    |\screenspacing{}| & sets the linespacing for screenplay fragments\\
+    				   & default is |\onehalfspacing|\\
+    |\screenfont{}|    & sets the font for screenplay fragments\\
+    				   & default is |\ttfamily|\\
+    |\sccenter |	   & American spellings of centring commands now possible\\
+   |\centertitle|      & \\
+\bottomrule
+\end{tabular}
+
+
+\end{center}
+\subsection{Eliminated commands}
+All commands from the \pkg{screenplay} class that relate to creating the title page have been removed from the package version of the class.
+\section{Troubleshooting and package dependencies}
+\subsection{Package dependencies}
+Note that the package uses the \pkg{setspace} package for linespacing. If you are using the \pkg{memoir} class which provide its own linespacing methods you will need to turn them off and use \pkg{setspace} instead. The \pkg{memoir} package provides a |\DisemulatePackage| command to do this:
+\begin{lstlisting}
+    \documentclass{memoir}
+    \DisemulatePackage{setspace}
+    \usepackage{screenplay-pkg}
+    ...
+\end{lstlisting}
+\subsection{Bugs}
+You are welcome to report bugs and submit feature requests, but I should warn you that this package is extremely low priority for me in terms of maintenance, as I do not use it at all.  If you are interested in taking it over, please get in touch with me.
+
+\section{Sample document}
+The following is a sample document showing how the package is used. It can be found in the documentation folder for the package.
+\lstinputlisting{screenplay-pkg-example.tex}
+
+\end{document}
+
+
+