From 6a6d5f181aa8135830479076d5d8ecec404c9241 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 20 Sep 2006 20:15:11 +0000 Subject: screenplay update (20sep06) git-svn-id: svn://tug.org/texlive/trunk@2169 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/screenplay/README | 41 +++-- Master/texmf-dist/doc/latex/screenplay/example.tex | 81 ++------- .../texmf-dist/tex/latex/screenplay/screenplay.cls | 193 ++++++++++++--------- Master/texmf-dist/tpm/screenplay.tpm | 8 +- 4 files changed, 155 insertions(+), 168 deletions(-) (limited to 'Master/texmf-dist') 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 +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 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 % 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 @@ screenplay Package - 2006/09/17 23:08:00 + 2006/09/19 12:07:00 karl The screenplay package. - 11121 + 17616 - + texmf-dist/tex/latex/screenplay/screenplay.cls texmf-dist/tpm/screenplay.tpm - + texmf-dist/doc/latex/screenplay/README texmf-dist/doc/latex/screenplay/example.tex -- cgit v1.2.3