summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-09-20 20:15:11 +0000
committerKarl Berry <karl@freefriends.org>2006-09-20 20:15:11 +0000
commit6a6d5f181aa8135830479076d5d8ecec404c9241 (patch)
tree55b1a4878b6b823caecddd9202d2e3e6a35af381 /Master
parente49a756e3775cc3430c93f9cb0255c2bba0411d8 (diff)
screenplay update (20sep06)
git-svn-id: svn://tug.org/texlive/trunk@2169 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/screenplay/README41
-rw-r--r--Master/texmf-dist/doc/latex/screenplay/example.tex81
-rw-r--r--Master/texmf-dist/tex/latex/screenplay/screenplay.cls193
-rw-r--r--Master/texmf-dist/tpm/screenplay.tpm8
4 files changed, 155 insertions, 168 deletions
diff --git a/Master/texmf-dist/doc/latex/screenplay/README b/Master/texmf-dist/doc/latex/screenplay/README
index e165ea11401..7d1f7640260 100644
--- a/Master/texmf-dist/doc/latex/screenplay/README
+++ b/Master/texmf-dist/doc/latex/screenplay/README
@@ -1,17 +1,32 @@
-This is a LaTeX .cls file to provide formatting as recommended by the
+LaTeX2e .cls file to provide formatting as recommended by the
Academy of Motion Picture Arts and Sciences.
-Potential users need to read the information from the Academy, and
-a few example scripts, and draw their own conclusions. The current
-version of `screenplay.cls' (v 1.417 at time of writing) seems to me to be
-`good enough' to produce a fair copy for the Nicholl Fellowships
-Competition - if you do your part - which was the point of it (weeks ago
-when I started!). Whether ScriptTeX would, in fact, be a better solution
-if I managed to get my head around it is another question. It looks to
-me, however, that installing ScriptTeX and modifying it will be more work
-than using `screenplay.cls.' As a more generalised solution ScriptTeX
-may be better though (but then again, is that the UNIX way?).
+Potential users need to read the information from the Academy,
+and a few example scripts, and draw their own conclusions.
+The current version of `screenplay.cls' (v 1.440 at time of
+writing) seems to me to be `good enough' to produce a fair
+copy for the Nicholl Fellowships Competition - if you do your
+part - which was the point of it (weeks ago when I started!).
-Academy: http://www.oscars.org/nicholl/format.html
+Really we're attempting to emulate a typewriter with this -
+which TeX is not meant for! So I doubt it can ever be perfect.
-ScriptTeX: http://www.aidtopia.com/software/scripttex/index.html
+Read all the comments in the .cls file, they may help you out.
+
+Whether ScriptTeX would, in fact, be a better solution if I
+managed to get my head around it is another question. It looks
+to me, however, that installing ScriptTeX and modifying it
+will be more of a pain than using `screenplay.cls.' As a more
+generalised solution ScriptTeX may be better though (but then
+again, is that the UNIX way?).
+
+Academy:
+ http://www.oscars.org/nicholl/format.html
+
+ScriptTeX:
+ http://www.aidtopia.com/software/scripttex/index.html
+
+--
+John Pate <johnny@dvc.org.uk>
+http://dvc.org.uk/
+Tue Sep 19 14:05:33 BST 2006
diff --git a/Master/texmf-dist/doc/latex/screenplay/example.tex b/Master/texmf-dist/doc/latex/screenplay/example.tex
index 2fa0120aa78..2cf6f5c2c35 100644
--- a/Master/texmf-dist/doc/latex/screenplay/example.tex
+++ b/Master/texmf-dist/doc/latex/screenplay/example.tex
@@ -1,11 +1,11 @@
-% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/example.tex,v 1.70 2006/09/17 07:45:50 johnny Exp $
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/example.tex,v 1.107 2006/09/18 21:17:06 johnny Exp $
%
\documentclass{screenplay}
% http://dvc.org.uk/sacrific.txt/screenplay.cls
-% make sure you have the latest versions so they match
-% and the page-breaking is right
-% this example.tex was built for screenplay.cls v 1.417
+% make sure you have the latest version of this
+% file example.tex and screenplay.cls
+
\begin{document}
@@ -22,9 +22,9 @@ Your address\\
here if you're\\
going postal\\
UK\\
-\\
+\vspace{2ex} % skip a line
+44~(0)131~999~9999\\
-johnny@dvc.org.uk%
+johnny@dvc.org.uk
}
%
% ... or use ...
@@ -104,6 +104,8 @@ 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}
@@ -111,70 +113,12 @@ 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. Give me a Scanalysis.
-\dialbreak[to Tom]{Fred}
+Lock on to that.
+\dialbreak[to Tom]{Fred}%
Establish planetary orbit, stationary
above this thing.
\end{dialogue}
-\begin{dialogue}{Mark}
-It seems to be solid with a high
-metallic content and be the source of
-the radio energy.
-\end{dialogue}
-
-\begin{dialogue}{John}
-The gravity map shows there's some kind
-of cavern directly beneath it.
-\end{dialogue}
-
-\begin{dialogue}{Fred}
-Get me the fullest details you can.
-Survey that cavern and see what you can
-make of it. Looks like this is what we
-came all the way to see.
-\end{dialogue}
-
-\begin{dialogue}{Brown}
-You'd better prep the Galileo for a
-planet-fall. Looks like we've got some
-digging to do. Unless Bliar objects
-that is.
-\end{dialogue}
-
-\begin{dialogue}{Fred}I didn't come all this way to see the
-first signs of alien life then turn
-around and ignore it.\paren{beat} I wonder how this
-will fit into Bliar's theology.\end{dialogue}
-
-\begin{dialogue}{Brown}
-Perhaps when you've done some digging
-we'll have some answers.\end{dialogue}
-
-\begin{dialogue}{Parrot}
-Or maybe more questions.
-\end{dialogue}
-
-
-
-\begin{dialogue}{Brown}
-Who said that?
-\end{dialogue}
-
-\begin{dialogue}[to radio]{Fred}
-Now hear this. Shuttle to be prepared
-for launch.
-\end{dialogue}
-\pagebreak%
-
-\intslug{Atlantis -- SHIP'S HOLD}
-
-The Hold is large, has various piles of crates and
-equipment
-stored in it. Near the door is a large coffin-shaped packing
-crate standing on its end.
-
-
\intextslug[day]{in or out}
Apparently some people do this.
@@ -194,8 +138,7 @@ It isn't the done thing to hyphenate for formatting purposes.
Use the source, Luke.
-\intslug[illumination]{title over environment or centred title}
-
+\intslug[illumination]{title over}
\begin{titleover}There's a titleover environment for dialogue-like layout if you're
doing the "Star Wars" thing.\end{titleover}
@@ -218,7 +161,7 @@ http://www.oscars.org/nicholl/format.html
\end{document}
-% $Id: example.tex,v 1.70 2006/09/17 07:45:50 johnny Exp $
+% $Id: example.tex,v 1.107 2006/09/18 21:17:06 johnny Exp $
% +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
%
% Copyright (C) 2006 John Pate <johnny@dvc.org.uk>
diff --git a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
index b59362ddbde..186a3ec309a 100644
--- a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
+++ b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
@@ -1,4 +1,6 @@
-% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.440 2006/09/19 12:58:41 johnny Exp $
+%
+%
% Provides markup mostly along the lines of
% http://www.oscars.org/nicholl/format.html
%
@@ -6,8 +8,6 @@
% John Pate <johnny@dvc.org.uk>
% http://dvc.org.uk
%
-% See http://dvc.org.uk/sacrific.txt/example.tex
-%
% See specs, licence, at end.
% ``It works for me.''
% I'm no kind of TeXpert! YOUR MILEAGE MAY VARY
@@ -38,7 +38,8 @@
% see http://www.gwydir.demon.co.uk/jo/units/print.htm
-% MUST have Courier as font (may cause warnings about font stuff, ignore) ...
+% MUST have Courier as font (may cause warnings about
+% font stuff, ignore) ...
%
\usepackage{courier}
\renewcommand*\familydefault{\ttdefault}
@@ -51,85 +52,109 @@
% can load hyphenation ability for non-standard font ...
%\usepackage[htt]{hyphenat}
-% (comment out raggedright here and in dialogue & titleover envs)
-% you really DO NOT want hyphenation
+% but DON'T, you should NOT hyphenate for Nicholl format
% you want this ...
%
\raggedright
%
-% between this and the typewriter font we're likely to
-% have to live with a few `Overfull \hbox' warnings
+% you'll have to nuke \raggedright wherever found to test out
+% hyphenation
+%
+% between this and the `fixed pitch' typewriter font we may
+% want to live with one or two `Overfull \hbox' warnings in
+% final copy (a word going into the right margin). You will
+% likely have to add a few \\ to some of the dialogue text
+% blocks to help TeX out with linebreaks so the formatting
+% works, or you'll get extra space where you don't want it.
+%
+% LaTeX isn't really meant for fixed pitch but we're
+% pretending to be a typewriter here.
% page numbers top right ...
-%
-\def\ps@myheadings{%
- \let\@oddfoot\@empty\let\@evenfoot\@empty
- \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
- }
\pagestyle{myheadings}
-% margins and such
-% fiddle if you must, see specs at end ...
+% margins and such see specs at end ...
+% -- fudge factors are apparent in `script.pdf' (use a ruler)
+% they're needed to approach the `correct' margins with tt font ...
%
-% left margin, default 1in + ...
+% left margin 1.5", default 1" + ...
\setlength{\evensidemargin}{0.5in}
\setlength{\oddsidemargin}{0.5in}
%
-% top margin ...
-\setlength{\topmargin}{-0.7in}
-\setlength{\headsep}{0.2in}
+% top margin (0.5" to number, 1" to body) ...
+\setlength{\topmargin}{-0.5in}
+\setlength{\headsep}{0.4in}
\setlength{\topskip}{0in}
%
-% reckon this gives a reasonable bottom margin ...
-\setlength{\textheight}{9.7in}
+% 11" - (1" top margin) - (0.5" bottom) =
+\setlength{\textheight}{9.5in}
+% bottom can go to 1.5" for page breaking purposes
+%
+% 6" for 1" right margin ...
+\setlength{\textwidth}{6.1in} % 0.1" fudge
%
-% 6in for 1in right margin ...
-\setlength{\textwidth}{6.0in}
+% tabbing / spacing for dialogues ...
+\newcommand{\dialwidth}{3.2in} % 3" wide with 0.2" fudge
+\newcommand{\dialtab}{\hspace{1.5in}} % 3" from left edge
+\newcommand{\dialnametab}{\hspace*{1.2in}} % NAME, tab in 4.2" from left
+\newcommand{\parenwidth}{1.7in} % parenthetical 1.5" with 0.2" fudge
+\newcommand{\parentab}{\hspace{0.7in}} % paren, tab in 3.7" from left
%
-% tabbing / spacing for dialogues
-\newcommand{\dialwidth}{3.2in}
-\newcommand{\dialtab}{\hspace{1.5in}}
-\newcommand{\dialnametab}{\hspace*{1.2in}}
-\newcommand{\parenwidth}{2.1in}
-\newcommand{\parentab}{\hspace{0.7in}}
+% kludgy fix for formatting of parenthetical ...
+\newcommand{\parenkludge}{\vspace{5pt}}
+% multi-line parentheticals require this be in, tested with
+% TeX 3.141592 (Web2C 7.5.4)
+% pdfeTeX 3.141592-1.21a-2.2 (Web2C 7.5.4)
+% kpathsea version 3.5.4
-% skip one line between paras ...
+% line spacing / pitch / parindent
%
-\setlength{\parskip}{1.0em plus0.1em minus0.1em}
+% fixed pitch, 10pt ...
+\setlength{\baselineskip}{10pt plus 0pt minus 0pt}
+% LaTeX floats minipages and centring (I assume) so fix them ...
+\setlength{\floatsep}{\baselineskip}
+\setlength{\textfloatsep}{\baselineskip}
+\setlength{\intextsep}{\baselineskip}
%
+% skip one line between paras ...
+\setlength{\parskip}{\baselineskip}
% no paragraph indent ...
-%
\setlength{\parindent}{0in}
% for title page - author details ...
%
% use one of \titleauthor, \nicholl, \titleextra to taste ...
-% this has to be the first command after \begin{document}
-% (if you shrink \textwidth you will need to adjust \hspace here)
+% this must be the first command after \begin{document}
+%
+% you may have to adjust the \vspace if you put in a lot of text
%
% \titleauthor[year]{title}{author's name}{contact details\\email etc}
-% -- don't fuss about warnings if it looks OK
-% (the copyright notice doesn't fit the spec so optional... if you
-% put it on the web tho, copyright certainly won't hurt!)
+% [the copyright notice doesn't fit the spec so optional... if you
+% put it on the web tho, copyright certainly won't hurt!]
%
\newcommand{\titleauthor}[4][]{
- \thispagestyle{empty}
- \parbox{1em}{ \ }
- \vspace{2.2in}
- \begin{center}{\textbf{\MakeUppercase{#2}}\\}
- \vspace{1em}by\\\vspace{1em}#3
+ \thispagestyle{empty} % no page number
+ \vspace*{2.25in}
+ \begin{center}{\textbf{\MakeUppercase{#2}}}\\
+ \vspace{\baselineskip}
+ by\\
+ \vspace{\baselineskip}
+ #3
\ifthenelse{\not\equal{#1}{}}
{
- \\\vspace{1em}\scriptsize\copyright\normalsize#1\\
- }{}
+ \\\vspace{\baselineskip}\scriptsize\copyright\normalsize#1%
+ \end{center}
+ \vspace{4.0in}
+ }{%
\end{center}
- \vspace{4.25in}
- \hspace{4.0in}\parbox{2.0in}{#4}
+ \vspace{4.2in}
+ }
+ \hspace{4.0in}\parbox[t]{2.0in}{\raggedright#4}
% reset page numbers for actual blurb ...
\newpage\setcounter{page}{1}
} %titleauthor
@@ -139,8 +164,7 @@
%
\newcommand{\nicholl}[1]{
\thispagestyle{empty}
- \parbox{1em}{ \ }
- \vspace{2.2in}
+ \vspace*{2.25in}
\begin{center}\MakeUppercase{#1}\end{center}
% reset page numbers for actual blurb ...
\newpage\setcounter{page}{1}
@@ -149,17 +173,18 @@
% \titleextra{extra blurb}{title}{author's name}{contact details\\email etc}
% for title page - author details with extra blurb
% not recommended by the Academy but by popular request, apparently
-% -- don't fuss about warnings if it looks OK
+% some people like to put in copyright and WGA registration details
%
\newcommand{\titleextra}[4]{
\thispagestyle{empty}
- \parbox{1em}{ \ }
- \vspace{2.2in}
- \begin{center}{\textbf{\MakeUppercase{#2}}\\}
- \vspace{1em}by\\\vspace{1em}#3
- \end{center}
- \vspace{4.25in}
- \parbox[t]{2.0in}{#1}\hspace*{2.0in}\parbox[t]{2.0in}{#4}
+ \vspace*{2.25in}
+ \begin{center}{\textbf{\MakeUppercase{#2}}}\\
+ \vspace{\baselineskip}
+ by\\
+ \vspace{\baselineskip}
+ #3\end{center}
+ \vspace{4.2in}
+ \parbox[t]{2.0in}{\raggedright#1}\hspace*{2.0in}\parbox[t]{2.0in}{\raggedright#4}
% reset page numbers for actual blurb ...
\newpage\setcounter{page}{1}
} %titleextra
@@ -173,7 +198,7 @@
% only for _very short_ text (directions) within dialogue env
%
\newcommand{\paren}[1]{%
-\\\parentab\parbox{\parenwidth}{(#1)}\\
+\\\parentab\parbox[t]{\parenwidth}{\raggedright(#1)\parenkludge}\\
} %paren
@@ -182,21 +207,20 @@
% \begin{dialogue}[directions]{character name} ... \end{dialogue}
% \begin{dialogue}{character name} ... \end{dialogue}
%
-% also uses above parenthetical logic but without the newlines
% minipage won't allow pagebreaks, see below for new manual
% pagebreak command for this env
% (you can centre the NAME but tabbing is more typewriter-esque)
%
\newenvironment{dialogue}[2][]{
-\dialtab\begin{minipage}{\dialwidth}
+\dialtab\begin{minipage}[b]{\dialwidth}
\raggedright
-\dialnametab\hbox{\MakeUppercase{#2}}\\
+\dialnametab\hbox{\MakeUppercase{#2}}
%\centerline{\MakeUppercase{#2}}
\ifthenelse{\not\equal{#1}{}}
{
-\parentab\parbox{\parenwidth}{(#1)}\\
-}{}
+\paren{#1}
+}{\\}
}{ \end{minipage}
}% end dialogue
@@ -207,7 +231,7 @@
% \dailbreak[directions]{Character}
%
% (need to know character name -- LaTeX scoping rules don't seem to
-% like global vars, somebody tell me howto fix it)
+% like global vars, somebody tell me otherwise)
% NOTE:
% only do any manual pagebreaks when you absolutely positively
% have killed every muthafucka in the room! ...
@@ -235,9 +259,10 @@
\MakeUppercase{INT. #2}
\ifthenelse{\not\equal{#1}{}}
- {%
+ {% 1em = width of `M'
\hspace{1em}\MakeUppercase{#1}
}{}
+\nopagebreak
}% intslug
@@ -251,6 +276,7 @@
{%
\hspace{1em}\MakeUppercase{#1}
}{}
+\nopagebreak
}% extslug
@@ -265,6 +291,7 @@
{%
\hspace{1em}\MakeUppercase{#1}
}{}
+\nopagebreak
}% intextslug
@@ -279,6 +306,7 @@
{%
\hspace{1em}\MakeUppercase{#1}
}{}
+\nopagebreak
}% extintslug
@@ -295,8 +323,9 @@ TITLE OVER (#1):\\
}{%false
TITLE OVER:\\
}%ifthenelse
-\vspace{1em}
-\dialtab\begin{minipage}{\dialwidth}
+\vspace{\baselineskip}
+\nopagebreak
+\dialtab\begin{minipage}[b]{\dialwidth}
\raggedright
}{
@@ -321,9 +350,9 @@ TITLE OVER:\\
\newcommand{\centretitle}[1]{
TITLE OVER:
-
-\vspace{1.0em}
-\centerline{#1}
+\vspace{\baselineskip}
+\nopagebreak
+\centerline{#1}\\
} %titleover
@@ -343,9 +372,9 @@ FADE IN:
%
\newcommand{\fadeout}{
-\vspace{-1.0em}
+\vspace{-\baselineskip}
\begin{flushright}FADE OUT:\end{flushright}
-\vspace{-1.0em}
+\vspace{-\baselineskip}
} %fadeout
@@ -354,9 +383,9 @@ FADE IN:
%
\newcommand{\intercut}{
-\vspace{-1.0em}
+\vspace{-\baselineskip}
\begin{flushright}INTERCUT WITH:\end{flushright}
-\vspace{-1.0em}
+\vspace{-\baselineskip}
} %intercut
@@ -376,22 +405,22 @@ FADE IN:
% http://www.oscars.org/nicholl/format.html
%
% Letter paper 8.5"x11.0"
-% Courier 12pt
+% Courier 12pt, 10 pitch
%
% PAGE
-% Top margin: 0.75"
-% Bottom margin:0.5"
+% Top margin: 1.0"
+% Bottom margin:0.5"-1.5"
% Left margin: 1.5"
% Right margin: 1.0"
%
% DIALOGUE
-% centre NAME over dialogue
-% or tab to 4.2"
+% centre NAME over dialogue (deprecated)
+% tab NAME to: 4.2"
% Left margin: 3.0"
-% Right margin: 2.3"
-% Parenthetical
+% Right margin: 2.5"
+% Parenthetical
% Left margin: 3.7"
-% Right margin: 3.0"
+% Right margin: 3.3"
%
% Numbering: Top Right, Arabic
% Top margin: 0.5"
@@ -400,7 +429,7 @@ FADE IN:
% INT/EXT. SLUG LINE DESCRIPTION DAY/NIGHT
% ^^^ some kind of extra spacing
%
-% $Id: screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
+% $Id: screenplay.cls,v 1.440 2006/09/19 12:58:41 johnny Exp $
% +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
%
% Latest version is available as:
diff --git a/Master/texmf-dist/tpm/screenplay.tpm b/Master/texmf-dist/tpm/screenplay.tpm
index a10429eb521..f00b8077b8b 100644
--- a/Master/texmf-dist/tpm/screenplay.tpm
+++ b/Master/texmf-dist/tpm/screenplay.tpm
@@ -3,19 +3,19 @@
<rdf:Description about="http://texlive.dante.de/texlive/Package/screenplay.zip">
<TPM:Name>screenplay</TPM:Name>
<TPM:Type>Package</TPM:Type>
- <TPM:Date>2006/09/17 23:08:00</TPM:Date>
+ <TPM:Date>2006/09/19 12:07:00</TPM:Date>
<TPM:Version></TPM:Version>
<TPM:Creator>karl</TPM:Creator>
<TPM:Title>The screenplay package.</TPM:Title>
<TPM:Description></TPM:Description>
<TPM:Author></TPM:Author>
- <TPM:Size>11121</TPM:Size>
+ <TPM:Size>17616</TPM:Size>
<TPM:Build/>
- <TPM:RunFiles size="10666">
+ <TPM:RunFiles size="11980">
texmf-dist/tex/latex/screenplay/screenplay.cls
texmf-dist/tpm/screenplay.tpm
</TPM:RunFiles>
- <TPM:DocFiles size="6950">
+ <TPM:DocFiles size="5859">
texmf-dist/doc/latex/screenplay/README
texmf-dist/doc/latex/screenplay/example.tex
</TPM:DocFiles>