The dramatist package User Guide
Contents
1. 122 printcasttitle 298 printscenename 168 printscenenum 168 printscenetitle 170 printsep 120 168 S ASTM moe ote a a eet 3 sGerie aca Sits eye 8 Bote 3 scenecontentsline sceneheadstart 165 scenemark 4 68 142 scenename 141 142 156 160 352 356 scenenamefont 353 355 scenenumfont 354 scenetitlefont 355 speaker obec iad eg 5 speaksdel 184 186 234 236 350 351 362 357 358 359 361 150 136 352 377 160 357 357 358 359 232 368 33 speaksfont 184 225 234 367 409 speaksindent 7 36 400 401 speakslabel 7 40 408 speaksskip 381 394 395 speakstab 184 225 234 381 speakswidth 7 35 398 399 speechskip 7 37 402 403 StageDin mir 5 330 Astagedir uta a Reseed 335 stagedir environment 6 StageDirCloseSettings 337 339 342 StageDirConf 6 340 StageDirOpenSettings 336 338 341 starrederror 326 410 ASELUE 4 540 ados 210 215 307 T NEOSTOSP outon tsap 274 277 theact 25 93 94 108 112 344 350 358 thescene 26 141 142 156 160 352 3582. Each licensee is addressed as you 18 Activities other than copying distribution and modification are not covered by this License they are outside its scope The act of running the Program is not restricted and the output from the Program is covered only if its contents constitute a work based on the Program independent of having been made by running the Program Whether that is true depends on what the Program does You may copy and distribute verbatim copies of the Program s source code as you receive it in any medium provided that you conspicuously and appro priately publish on each copy an appropriate copyright notice and disclaimer of warranty keep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee You may modify your copy or copies of the Program or any portion of it thus forming a work based on the Program and copy and distribute such modifications or work under the terms of Section 1 above provided that you also meet all of these conditions a You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change b You must cause any work that you distribute or publish that in whole
3. m kescenehead m kescenehead actually prints the headings 64 newcommand m kescenehead 1 65 sceneheadstart 66 parindent z 67 ifnum c secnumdepth gt z 68 printscenename printsep printscenenum 69 Mi 70 printscenetitle 1 71 afterscene 72 3 5 Defining characters Character The macro Character performs three different tasks First it creates being name the third argument the command name for use in stage directions in order to achieve this task it uses namedef and a new defined command intsp ce which takes care of inserting spaces when needed and which is inspired by text command both for this and for namedef see the latex source In second place it creates a name speaks command used for printing the speaker s name It uses for this purpose a n me ppend nddef macro which is similar to namedef A conditional if drverse produces different formatting for the verse and the prose environment Finally in third place if the first optional argument is given and xcharacter is called it creates an internal command still using n me ppend nddef in the form persona count where count is a counter expressed in roman lowercase numerals increasing by one every time Character is called This family of com mands is used by DramPer when it prints the list of the characters 73 newcommand Character 74 ifnextchar xcharacter character 75 def xcharacter 1 2
4. A eee ea hd 42 drama environment 3 DramPer ia Ldooa ca foals 5 285 drampermark 69 292 32 environments drama ii ek hoes Eee eS 3 drama oi ops d aer E kee te oe eS 2 Shtagedil Venida Sas 6 F foundfile 424 429 G GCharacter 2 5 4 4 4505s 5 220 NETOUPLIST citado 195 198 GroupWidth 0 5 I if drverse 5 183 224 233 314 322 E iesi eatas tea tie els 9 28 79 Gf lnpd isere Da sas g raae eet 11 if lnps 10 31 127 if poemscol 6 17 44 58 81 129 if stagedir o oooo oo ooo 8 inputfilewarning 419 429 NINE SP ee Ee 358 360 intsp ce 181 222 238 L Inpa option 000 2 Inps Option wss raeas eae 2 lnpwarning 29 32 417 M m ke cthead 95 99 113 116 m kedramperhead 293 295 296 m kescenehead 143 147 161 164 maybe sp 253 269 maybe sp 269 270 N n me ppend nddef feted 178 182 189 199 223 229 namefont 181 222 366 nospace 238 248 252 254 nospacelist 273 284 O options TIPA iio do A hes 2 A h 4 is Be el 3 2 P ParenWidth 5 209 371 372 phantomsection Meats of 66 92 106 140 154 290 poemlines 51 55 printactname 4 120 349 printactnum 4 120 printacttitle
5. Dedi cations You must delete all sections Entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and other documents released under this License and replace the individual copies of this License in the various documents with a single copy that is included in the collection pro vided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 7 AGGREGATION WITH INDEPENDENT WORKS 28 A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium is called an aggregate if the copyright resulting from the compilation is not used to limit the legal rights of the compilation s users beyond what the individual works permit When the Document is included in an aggregate this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one half of the entire aggregate the Document s
6. J 414 Only the verse option supports a starred version of this 415 command 416 417 newcommand lnpwarning 1 The option lnp 1 is meaningless outside the 418 drama environment 419 newcommand inputfilewarning PackageWarningNoLine dramatist J7 J 42 0 ARREARS CASSIE GIGI II ICI I II ICR I okk J Y 421 No Configuration file found using default settings J 420 FERRARO ARORA RAR Ka KR a 77 JY 423 424 newcommand foundfile PackageWarningNoLine dramatist J J 425 0000000000000 JY 426 Using Configuration file dramatist cfg J 427 FERRO BOBO o ORR 77 JY 428 3 9 Local configuration file The following code inputs the local configuration file dramatist cfg 429 InputIfFileExists dramatist cfg foundfile inputfilewarning 430 dramatist In Appendix are given the terms under which the package and his documenta tion are released A The GNU General Public License THE GNU GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright 1989 1991 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble 17 The licenses for most software are designed to take away your freedom to share and change it By contrast the GNU General Public License is intended to guarantee your freedom to share and change free softw
7. speechskip itemsep Dparsep z Dlabelsep labelsep Table 1 Sectioning commands speaksindent is the indentation of that label Dlabelsep is the space between the label and the text Dparsep is the space between paragraphs inside the dialogue speechskip is the space between two subsequent speeches You can see default settings for these macros in Table 1 A conditional expression checks the eventual presence of a line numbering option in which case a warning is sent to the user in the log file about the meaninglessness of the option The starred form switches to drversetrue this is used by the commands that define characters see Section 2 4 calls the verse environment or the poem environment if poemscol package has been loaded this is automatically recognized by the package and needs no additional option and if poemlines is defined the value of the poemline counter is restored at the beginning and saved at the end of the environment this is needed because by default the aforesaid counter is reset to 1 every time the verse environment is called In case poemscol has been loaded the same operations are performed for counters linenumber and printlineindex 2 3 Sectioning Commands The package provides two series of commands in order to get a proper sectioning of the text a lowercase series and an uppercase series The difference between them is that the lowercase form takes no mandatory argum
8. in accord with Subsection b above The source code for a work means the preferred form of the work for making modifications to it For an executable work complete source code means all the source code for all modules it contains plus any associated interface definition files plus the scripts used to control compilation and installation of the executable However as a special exception the source code distributed need not include anything that is normally distributed in either source or binary form with the major components compiler kernel and so on of the operating system on which the executable runs unless that component itself accompanies the executable If distribution of executable or object code is made by offering access to copy from a designated place then offering equivalent access to copy the source code from the same place counts as distribution of the source code even though third parties are not compelled to copy the source along with the object code 4 You may not copy modify sublicense or distribute the Program except as expressly provided under this License Any attempt otherwise to copy modify sublicense or distribute the Program is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 5 You are not required to accept th
9. or in part contains or is derived from the Program or any part thereof to be licensed as a whole at no charge to all third parties under the terms of this License c If the modified program normally reads commands interactively when run you must cause it when started running for such interactive use in the most ordinary way to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty or else saying that you provide a warranty and that users may redis tribute the program under these conditions and telling the user how to view a copy of this License Exception if the Program itself is inter active but does not normally print such an announcement your work based on the Program is not required to print an announcement These requirements apply to the modified work as a whole If identifiable sections of that work are not derived from the Program and can be rea sonably considered independent and separate works in themselves then this License and its terms do not apply to those sections when you distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program the distribution of the whole must be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardless of who wrote it Thus it is not the intent of this section to claim rights or
10. printacttitle 1 23 afteract 24 According to the option loaded for line numbering openscene performs the needed operations 25 newcommand openscene 26 stepcounter scene 27 if lnps 28 setcounter storelineno 0 29 if poemscol 30 setcounter storeprintlineindex 0 31 else 32 refstepcounter storelineno 33 fi 34 fi 35 scene switches between scene and sscene in the first case a line is added to the table of contents and an argument is assigned to scenemark The actual task of printing the heading is left to m kescenehead 36 newcommand scene 37 openscene 38 secdef scene sscene 39 newcommand scene 1 14 40 phantomsection 41 addcontentsline toc section scenename thescene 42 scenemark scenename thescene 43 m kescenehead 1 44 afterindentfalse 45 afterheading 46 newcommand sscene 1 14 47 m kescenehead 1 48 afterindentfalse 49 afterheading Scene is defined in the standard way for sectioning commands For its starred version relies upon sscene 150 newcommand Scene 151 openscene 10 52 secdef Scene sscene 53 def Scene 1 2 54 phantomsection 55 ifnum c secnumdepth gt z 56 addcontentsline toc section scenename thescene 1 57 else 58 addcontentsline toc section 1 59 fi 60 scenemark scenename thescene 1 61 m kescenehead 2 62 afterindentfalse 63 afterheading
11. so that distribution is permitted only in or among countries not thus excluded In such case this License incorporates the limitation as if written in the body of this License The Free Software Foundation may publish revised and or new versions of the General Public License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns Each version is given a distinguishing version number If the Program spec ifies a version number of this License which applies to it and any later 21 10 11 12 version you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Founda tion If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is copyrighted by the Free Software Founda tion write to the Free Software Foundation we sometimes make exceptions for this Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally No WARRANTY BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE THERE IS N
12. 79 if lnpa 80 setcounter storelineno 0 81 if poemscol 82 setcounter storeprintlineindex 0 83 else 84 refstepcounter storelineno 85 fi 86 fi 87 act switches between act and sact in the first case a line is added to the table of contents and an argument is assigned to actmark The actual task of printing the heading is left to m ke cthead 88 newcommand act 89 openact 90 secdef act sact 91 newcommand act 1 14 92 phantomsection 93 addcontentsline toc chapter actname theact 94 actmark actname theact 95 m ke cthead 1 96 afterindentfalse 97 afterheading 98 newcommand sact 1 99 m ke cthead 1 100 afterindentfalse 101 afterheading Act is defined in the standard way for sectioning commands For its starred version relies upon sact 02 newcommand Act 03 openact 04 secdef Act sact 05 def Act 1 2 06 phantomsection 07 ifnum c secnumdepth gt m ne 08 addcontentsline toc chapter actname theact 1 09 else 10 addcontentsline toc chapter 1 m ke cthead openscene scene Scene 11 fi 12 actmark actname theact 1 13 m ke cthead 2 14 afterindentfalse 15 afterheading m ke cthead actually prints the headings 16 newcommand m ke cthead 1 17 actheadstart 18 parindent z 19 ifnum c secnumdepth gt m ne 20 printactname printsep printactnum 21 fi 22
13. and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Each version of the License is given a distinguishing version number If the Document specifies that a particular numbered version of this License or any later version applies to it you have the option of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License you may choose any version ever published not as a draft by the Free Software Foundation 29 ADDENDUM How to use this License for your documents To use this License in a document you have written include a copy of the License in the document and put the following copyright and license notices just after the title page Copyright YEAR YOUR NAME Permission is granted to copy dis tribute and or modify this document under the terms of the GNU Free D
14. contest your rights to work written entirely by you rather the intent is to exercise the right to control the distribution of derivative or collective works based on the Program 19 In addition mere aggregation of another work not based on the Program with the Program or with a work based on the Program on a volume of a storage or distribution medium does not bring the other work under the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution a complete machine readable copy of the corresponding source code to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or c Accompany it with the information you received as to the offer to dis tribute corresponding source code This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer
15. functional and useful document free in the sense of freedom to assure everyone the effective freedom to copy and redistribute it with or without modifying it either commer cially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modifications made by others This License is a kind of copyleft which means that derivative works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is published as a printed book We recommend this License principally for works whose purpose is instruction or reference 1 APPLICABILITY AND DEFINITIONS This License applies to any manual or other work in any medium that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License Such a notice grants a world wide royalty free license unlimited in duration to use that work under the conditions stated herein The Document below re
16. groups in the dramatis persone list drama Added hooks for customiza tion drama Added support for poem scol Scene Introduced macro Scene for sections with a title scene Shared code moved to penscene vl 2a General Fixed a bug in the vertical spacing of DramPer Changed name of counter linenumber in verselinenumber in order to man tain compatibility with package poemscol 11 11 15 12 Numbers written in italic refer to the page where the corresponding entry is de scribed numbers underlined refer to the code line of the definition numbers in roman refer to the code lines where the entry is used Symbols NGAGE i a isa 104 105 MOST it a a 152 153 act 2c eel o bad 90 91 character 174 177 180 direct oir bees 312 313 dramper 288 289 drversefalse 65 drversetrue 43 ifnextchar 174 NOT patri unid wane ad 12 lnpstrue 13 openact 70 89 103 31 openscene 125 137 poemscolfalse poemscoltrue ppendname 182 191 NOSact conan 90 98 NOSCenes cosine eta was ain 138 NOsdirect ia 312 sdramper 288 Ossceri oi gs ea cases 138 146 stagedirtrue xcharacter 174 A tata hes ee ae oo lee 223 104 139 321 294 152 337 175 209 Nit Sede 93 94
17. in the text and the third is the base for the construction of the commands typesetting the occurrence of that name in 3The argument mandatory until version 1 1 has been made optional by suggestion of Chris tian Ebert in version 1 2 This avoids issuing a Character command with a dummy first argument after DramPer when you need a character not appearing in the Dramatis Persone list DramPer speaker CharacterGroup GCharacter CharWidth ParenWidth GroupWidth StageDir direct direct Commands Default settings printcasttitle centering casttitlefont casttitlename casttitlefont Large scshape casttitlename Dramatis Personee castfont normalfont namefont scshape speaksfont scshape speaksdel Table 3 Parameters for characters commands the stage direction and as a speaker Shortly if name is given as third argument the macro will return the following commands name is used in stage direction name speaks is used as speaker The first argument when present is passed to the macro DramPer printing the list of Dramatis Persone The parameters of this macro are also customizable the list of default settings can be seen in Table 3 Other parameters related to the customization of name and name speaks commands are added You can also use a speaker name command in the place you want the character with name name to appear in this case no command
18. long as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to fit legibly you should put the first ones listed as many as fit reasonably on the actual cover and continue the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a computer network location from which the general network using public has access to download using public standard network protocols a complete Transparent copy of the Document free of added material If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that
19. number v1 2a dated 2005 05 21 1npa Inps drama B GNU Free Documentation License 23 1 Introduction The edition of a drama requires special treatment for many typographical elements The purpose of the present package is that of providing full support for these specialities So besides the standard document divisions new ones are introduced reflecting the peculiar nature of the document itself environments are provided for introducing dialogues and a set of macros is placed at the user s disposal to handle characters automatically generate a dramatis person list and control the appearance of stage directions All these features I have tried to make fully customizable with the idea that typographical conventions are hints rather than laws and the fully conscious user should be enabled to override them The decision to write a package rather than a class is due to similar consider ations about user s freedom The package strictly provides what is meant in his name and doesn t involve itself in the layout design of the document This task is left to the class chosen by the user In particular the package does not provide explicit support for text in verse though it provides support for those features that are peculiar to a drama in verse However dramatist is integrated with the main packages dealing with verse such as verse or poemscol so that the user can for instance use line numbering defined by one of the aforesaid pa
20. of Invariant Sections and required Cover Texts given in the Document s license notice Include an unaltered copy of this License Preserve the section Entitled History Preserve its Title and add to it an item stating at least the title year new authors and publisher of the Modified Version as given on the Title Page If there is no section Entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Title Page then add an item describing the Modified Version as stated in the previous sentence Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of the version it refers to gives permission For any section Entitled Acknowledgements or Dedications Preserve the Title of the section and preserve in the section all the substance and tone of each of the contributor acknowledgements and or dedications given therein Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles Delete an
21. 108 112 141 142 156 160 344 351 352 359 361 A NAGE esses ce RAG hat ates hed tats 3 102 Nati ida 3 88 Nactcontentsline 344 actheadstart 117 375 Nactmark isos 4 67 94 112 actname 93 94 108 112 344 348 349 actnamefont 345 347 349 actnumfont 346 350 acttitlefont lucida 347 351 NAEtEPACE fo nenm ae eke es 123 376 afteractskip 376 384 385 aftercasttitle 299 380 aftercasttitleskip 380 392 393 afterscene 171 378 aftersceneskip 378 388 389 B beforeactskip 375 382 383 beforecastskip 379 390 391 beforesceneskip 377 386 387 C castfont 178 210 230 365 castheadstart 297 379 casttitlefont 362 363 casttitlename 291 292 362 364 CastWidth 210 373 374 Character mee minari ia 4 173 CharacterGroup 5 192 CharWidth 5 208 369 370 check nospace 248 252 check spr 181 222 239 243 246 253 260 265 D dirdelimiter 316 318 324 329 NAPO eos ee a ee alien 5 311 direct oig ria a Sedans 5 dirwidth 316 324 396 397 Dlabelsep 7 39 406 407 dodramperlist 301 304 308 dogrouplist 204 212 216 Dparsep 7 38 404 405 drama oo ns ale lacy AAs a NE A 27 drama environment 2 drama
22. 3 7 76 stepcounter character 77 character 2 3 78 n me ppend nddef persona roman character castfont 1 79 80 def character 1 2 81 Qnamedef 2 namefont 1 intsp ce 1 check spr 82 n me ppend nddef 2 ppendname 7 83 VifOdrverse 84 speakstab speaksfont 1 speaksdel par nobreak addvspace parskip 11 CharacterGroup GCharacter 85 else 86 item 1 speaksdel 87 Mi 88 89 newcommand n me ppend nddef 2 7 90 expandafter def csname 1 2 endcsname 91 newcommand ppendname speaks This environment is used for groups of characters in the Dramatis Persone list The main idea is that each group of characters should be treated as a single persona count when called by DramPer while inside it should behave like DramPer itself in this case dogrouplist which is identical in structure The main feature is that every instance of CharacterGroup defines an internal counter whose name depends by another counter namely character and this is used by the correspondent call to dogrouplist 192 newenvironment CharacterGroup 1 193 stepcounter character 194 newcounter g roman character 195 grouplist 1 196 HF The name and the first specification of the characters the big parentheses and the common denomination are arranged in boxes whose length can be specified by the user by means of ad hoc commands 197 newsavebox tbox 198 newcomma
23. 6 newcommand actnumfont actnamefont 347 newcommand acttitlefont actnamefont 15 348 newcommand actname Act 349 newcommand printactname centering actnamefont actname 350 newcommand printactnum actnumfont theact 351 newcommand printacttitle 1 acttitlefont 1 352 newcommand scenecontentsline 1 scenename thescene 353 newcommand scenenamefont scshape large 354 newcommand scenenumfont scenenamefont 355 newcommand scenetitlefont scenenamefont 356 newcommand scenename Scene 357 newcommand printscenename centering scenenamefont scenename 358 newcommand printscenenum scenenumfont theact intersep thescene 359 newcommand printscenetitle 1 scenetitlefont 1 360 newcommand intersep 361 newcommand printsep 362 newcommand printcasttitle centering casttitlefont casttitlename 363 newcommand casttitlefont Large scshape 364 newcommand casttitlename Dramatis Person ae 365 newcommand castfont normalfont 366 newcommand namefont scshape 367 newcommand speaksfont scshape 368 newcommand speaksdel 369 newlength CharWidth 370 setlength CharWidth 3 textwidth 371 newlength ParenWidth 372 setlength ParenWidth 05 textwidth 373 newlength CastWidth 374 setlength CastWidth 6 textwidth 375 def actheadstart vspace beforeactskip 376 def afteract par nobreak vskip afteractskip 377 def scen
24. Cover Texts may be placed on covers that bracket the Document within the aggregate or the electronic equivalent of covers if the Document is in electronic form Otherwise they must appear on printed covers that bracket the whole aggregate 8 TRANSLATION Translation is considered a kind of modification so you may distribute transla tions of the Document under the terms of section 4 Replacing Invariant Sections with translations requires special permission from their copyright holders but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections You may include a translation of this License and all the license notices in the Document and any Warranty Dis claimers provided that you also include the original English version of this License and the original versions of those notices and disclaimers In case of a disagree ment between the translation and the original version of this License or a notice or disclaimer the original version will prevail If a section in the Document is Entitled Acknowledgements Dedications or History the requirement section 4 to Preserve its Title section 1 will typically require changing the actual title 9 TERMINATION You may not copy modify sublicense or distribute the Document except as expressly provided for under this License Any other attempt to copy modify sublicense or distribute the Document is void
25. O WAR RANTY FOR THE PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITH OUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED INCLUD ING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABIL ITY AND FITNESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU SHOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVICING REPAIR OR CORRECTION IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAMAGES INCLUDING ANY GENERAL SPECIAL IN CIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES END OF TERMS AND CONDITIONS Appendix How to Apply These Terms to Your New Pro grams If you develop a new program and you want it to be of the greatest possible use to the public the best way to achieve this is to make it free software which everyone can redistribute and change under these terms To d
26. The dramatist package User Guide Massimiliano Dominici mlgdominici intrefree it 2005 05 21 Abstract The present package provides support for drama both in verse and in prose The following facilities are given two environments for typesetting dialogues in prose or in verse new document divisions corresponding to acts and scenes macros that control the appearance of characters and stage directions and automatical generation of a dramatis persone list Contents 1 Introduction 2 2 User interface 2 2 1 Package Options rial aaa o y A is 2 2 2 The drama environment 2 2 3 Sectioning Commands e 3 ZA Defining scharacters o e 08 eS eee ade a A 4 2 4 1 Grouped characters e e e 5 2 5 Stage direction s s ia Gewese OR GOR AA eS EA 5 2 6 Local configuration file ooa e 6 2 7 Acknowledgements e 6 2 8 Known bugs sa eses a a ee 6 3 Code 6 3 1 Package identification o e e 6 3 2 Conditionals options and counters o e e 7 3 31 HNVITOHMENtS eve di a e 7 3 4 Sectioning commands e 8 3 5 Defining characters eee ee eee 11 3 6 Stage direction es 3 Sine ee Bae e RR oY 14 3 7 Configuration settings 2 2 00 00 0000 000004 15 3 8 Error messages handling o 17 3 9 Local configuration file o oo 17 A The GNU General Public License 17 This file has version
27. are to make sure the software is free for all its users This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it Some other Free Software Foundation software is covered by the GNU Library General Public License instead You can apply it to your programs too When we speak of free software we are referring to freedom not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software and charge for this service if you wish that you receive source code or can get it if you want it that you can change the software or use pieces of it in new free programs and that you know you can do these things To protect your rights we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too receive or can get the source code And you must show them these terms so they know their rights We protect your rights with two steps 1 copyright the software and 2 offer you this license which gives you legal permission to copy distribute and or modify th
28. ckages in a meaningful way inside a drama environment 2 User interface 2 1 Package Options The package provides two options both concerning line numbering in verse drama By default none of the options is used and the counter holding the line number is not reset throughout the document If you like it better you can choose line numbering per act or per scene issuing one of the options namely 1npa or 1nps Issuing the options when typesetting a play in prose has no effect on the document but a package warning is typed in the log file every time a drama environment is called 2 2 The drama environment The drama environment is the heart of the package Two versions of this environ ment are provided the normal version used for typesetting dramas in prose and the starred version drama for typesetting dramas in verse The unstarred form arranges the items given by the macros for defining characters see Section 2 4 in a sort of description like environment but the parameters can be managed and adjusted to get every kind of list the user desires These are the hooks provided for customizing the look of the environment speakswidth is the width of the label in which the name of the character is printed lFor this parametrization of the drama environment I m in debt with Christian Ebert drama act scene Act Scene Commands Default settings speakswidth z speaksindent leftmargin
29. command speaker 1 7 if drverse speakstab speaksfont 1 speaksdel par nobreak addvspace parskip else item 1 speaksdel1 fi For details about this code you may have a look to Itfntcmd dtx 238 239 240 2 2 2 2 2 2 24 24 24 250 251 OMAN DOA FF WN 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 let nospace relax let check spr empty def intsp ce 1 def reserved a 1 ifx reserved a empty let check spr empty else ifx reserved a space let check spr empty else check nospace 1 nospace nil fi fi def check nospace 1 2 nospace 3 nil let check spr maybe sp def reserved a nospace def reserved b 1 def reserved c 3 ifx reserved a reserved b ifx reserved c empty else let check spr empty fi else ifx reserved c empty else let check spr empty fi fi def maybe sp futurelet let token maybe sp0 13 DramPer direct 270 def maybe sp 1 271 tempswatrue 272 expandafter tfor expandafter reserved a expandafter expandafter 273 nospacelist 274 do t st sp 275 if tempswa space fi 276 277 def t st sp 4 278 expandafter let expandafter reserved b expandafter reserved a relax 279 ifx reserved b let token 280 tempswafalse 281 break tfor 282 fi 283 284 def nospacelist The macro DramPer
30. d complete customization the latter was the formal model and the source of solution for many among the problems which arose in the proceeding of the code writing I highly recommend the use of the class memoir and the study of Matt Swift s ambitious bundle Frankenstein but I hope you want use dramatist package instead I also wish to thank Christian Ebert whose suggestions have been so useful to me in solving and often in merely recognizing many problems and whose help and stimulating conversation is at the basis of the present v1 2 revision of the package 2 8 Known bugs The user should issue an empty line after act or scene and two empty lines after DramPer especially when it s followed by scene used without argument Using option lnpa or 1nps together whith package hyperref causes a long series of warning to be typed in the log file This is due I think because hyperref finds duplicates of the same entry every time the drama environment resets the poemline counter However there are no effects on the document because the counter itself is by no way used by hyperref If you encounter new bugs or have suggestions about the solution of the known ones please send me a mail to this address mlgdominici interfree it 3 Code 3 1 Package identification 1 xdramatist 2 ProvidesPackage dramatist 2005 05 21 v1 2a Package for typesetting drama Author Massimiliano Dominici drama speakswidth speaksind
31. drama 55 56 57 58 59 60 61 62 63 64 65 3 4 ifx poemlines undefined else setcounter storelineno value poemline fi if poemscol end poem setcounter storelineno value verselinenumber setcounter storeprintlineindex value printlineindex else end verse fi drversefalse Sectioning commands The sectioning commands act and scene have been made wholly customiz able via m ke cthead and m kescenehead just like the sectioning commands of memoir class see 2 for further details phantomsection is needed for compatibility with the hyperref package It is defined to do nothing when hyperref is not loaded 66 providecommand phantomsection 67 newcommand actmark 1 68 newcommand scenemark 1 69 newcommand drampermark 1 openact act Act openact must check if a class defining if openright has been loaded In this case it provides an if statement to control switching between openany and openright behaviour By default the option loaded with the class is inherited If the class loaded behaves like article only the openany option is allowed According to the option loaded for line numbering Copenact performs the needed operations 70 newcommand openact 71 ifundefined if openright clearpage 72 if openright 73 clearpage thispagestyle empty cleardoublepage 74 else 75 clearpage 76 Mi Th thispagestyle plain 78 refstepcounter act
32. e old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version 5 COMBINING DOCUMENTS You may combine the Document with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice and that you preserve all their Warranty Disclaimers The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are mul tiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work In the combination you must combine any sections Entitled History in the various original documents forming one section Entitled History likewise com bine any sections Entitled Acknowledgements and any sections Entitled
33. e software Also for each author s protection and ours we want to make certain that ev eryone understands that there is no warranty for this free software If the software is modified by someone else and passed on we want its recipients to know that what they have is not the original so that any problems introduced by others will not reflect on the original authors reputations Finally any free program is threatened constantly by software patents We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses in effect making the program proprietary To prevent this we have made it clear that any patent must be licensed for everyone s free use or not licensed at all The precise terms and conditions for copying distribution and modification follow TERMS AND CONDITIONS FOR COPYING DISTRIBUTION AND MODIFICATION 0 This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License The Program below refers to any such program or work and a work based on the Program means either the Pro gram or any derivative work under copyright law that is to say a work containing the Program or a portion of it either verbatim or with modifi cations and or translated into another language Hereinafter translation is included without limitation in the term modification
34. eheadstart vspace beforesceneskip 378 def af terscene par nobreak vskip aftersceneskip 379 def castheadstart vspace beforecastskip 380 def aftercasttitle par nobreak vskip aftercasttitleskip 381 newcommand speakstab hspace speaksskip 382 newlength beforeactskip 383 setlength beforeactskip baselineskip 384 newlength afteractskip 385 setlength afteractskip baselineskip 386 newlength beforesceneskip 387 setlength beforesceneskip Opt 388 newlength aftersceneskip 389 setlength aftersceneskip baselineskip 390 newlength beforecastskip 391 setlength beforecastskip Opt 392 newlength aftercasttitleskip 393 setlength aftercasttitleskip Opt 394 newlength speaksskip 395 setlength speaksskip 1lem 396 newlength dirwidth 397 setlength dirwidth 6 textwidth Default settings for the drama environment 398 newdimen speakswidth 399 speakswidth z 16 400 newdimen speaksindent 401 speaksindent leftmargin 402 newdimen speechskip 403 speechskip itemsep 404 newdimen Dparsep 405 Dparsep z 406 newdimen Dlabelsep 407 Dlabelsep labelsep 408 newcommand speakslabe1 1 7 409 hspace labelsep speaksfont 1 3 8 Error messages handling 410 newcommand starrederror PackageError dramatist 411 The starred version of this command is not available under the 412 option you have chosen 413 You probably misspelled the command
35. ent Dlabelsep Dparsep speechskip speakslabel 3 NeedsTeXFormat LaTeX2e 3 2 Conditionals options and counters The following line checks wether a class defining if openright has been loaded if not it defines that conditional expression 4 ifundefined if openright newif if openright 5 newif if drverse The following lines provide support for the poemscol package 6 newif if poemscol 7 ifpackageloaded poemscol poemscoltrue Cpoemscolfalse The conditional if stagedir is switched to true at the end of a stage direction 8 newif if stagedir The two options for line numbering are defined to switch to true a conditional expression 9 newif if lnpa 10 newif if lnps 11 newif if lnpd 12 DeclareOption 1npa lnpatrue 13 DeclareOption 1nps lnpstrue 14 ProcessOptions This is needed for saving and restoring the value of the poemline counter in the case it is defined and used 15 newcounter storelineno 16 setcounter storelineno 0 17 if poemscol else 18 refstepcounter storelineno fi 19 newcounter storeprintlineindex 20 newcounter character 21 newcounter temp 22 newcounter gtemp 23 newcounter act 24 newcounter scene act 25 renewcommand theact roman fact 26 renewcommand thescene roman scene 3 3 Environments The unstarred version of the drama environment defines a list with negative item indentation and whose label is the speaker s name A previous c
36. ent and can be used absolutely while the uppercase form take one mandatory argument and should be used only when a title is specified as a part of the act scene heading I chose to introduce this peculiar form of sectioning commands without argument and as the default one because I think that in most cases the user only wants to get something like Act J and should not bore himself issuing a pair of curly braces So act and scene print by default only the act or scene name e g Act and its ordinal number They and DramPer also may take an optional argument this feature is useful for inserting footnotes or endnotes in the act scene headings but causes an undesirable consequence the user should issue a blank line after each of these commands when used without argument two blank lines for DramPer followed by a void scene Act and Scene take as mandatory argument the title of the act or of the This is provided by the memoir 2 class and the verse 3 package for line numbering purpose printactname printactnum actmark scenemark Character Commands Default settings printactname centering actnamefont actname printactnum actnumfont theact printacttitle acttitlefont 1 actname Act actnamefont scshape Large actnumfont actnamefont acttitlefont actnamefont theact romanfact actcontentsline actname theact printscenename cen
37. ering added a speaker act act is now defined in a stan command changes made to dard way and has an optional 30 argument to use for footnotes and the like DramPer DramPer is now defined in a standard way and has an optional argument to use for footnotes and the like drama Environment drama has been completely restyled Now it automatically calls environ ment verse 14 scene scene is now defined in a standard way and has an op tional argument to use for foot notes and the like Command speaker aa i 10 speaker added 13 v1 2 General Added support for po emscol package introduced an uppercase series of sec tioning commands first ar gument in Character made optional added environment CharacterGroup for characters groups in the Dramatis Per sone list added various hooks for user customization Act Introduced macro Act for sections with a title act Shared code moved to ope nact Character Added hook for insert Index ing a delimiter after the charac ter s name speakdel The first argument of Char acter has been made optional so that documents printed with previous versions are not com patible with the present and the future versions direct Parbox length made cus tomizable GCharacter Added macro for in troducing a single character in side a group in the dramatist persone list CharacterGroup Added environ ment for characters
38. fers to any such manual or work Any member of the public is a licensee and is addressed as you You accept the license if you copy modify or distribute the work in a way requiring permission under copyright law A Modified Version of the Document means any work containing the Doc ument or a portion of it either copied verbatim or with modifications and or translated into another language A Secondary Section is a named appendix or a front matter section of the Document that deals exclusively with the relationship of the publishers or au thors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject Thus if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of histori cal connection with the subject or with related matters or of legal commercial philosophical ethical or political position regarding them The Invariant Sections are certain Secondary Sections whose titles are designated as being those of Invariant Sections in the notice that says that the Document is released under this License If a section does not fit the above def inition of Secondary then it is not allowed to be designated as Invariant The 24 Document may contain zero Invariant Sections If the Document does not identify any Invariant Sections then there are n
39. formats that can be read and edited only by proprietary word processors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML PostScript or PDF produced by some word processors for output purposes only The Title Page means for a printed book the title page itself plus such following pages as are needed to hold legibly the material this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title preceding the beginning of the body of the text A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language Here XYZ stands for a specific section name mentioned below such as Acknowledgements Dedications Endorse ments or History To Preserve the Title of such a section when you modify the Document means that it remains a section Entitled XYZ according to this definition The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document These Warranty Disclaimers are considered to be included by reference in this License but only as regards disclaiming warranties any other implication that these Warranty Disclaimers may have i
40. free redistribution of the Program by all those who receive copies directly or indirectly through you then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program If any portion of this section is held invalid or unenforceable under any particular circumstance the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices Many people have made generous contributions to the wide range of software dis tributed through that system in reliance on consistent application of that system it is up to the author donor to decide if he or she is willing to dis tribute software through any other system and a licensee cannot impose that choice This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License If the distribution and or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces the original copyright holder who places the Program under this License may add an explicit geographi cal distribution limitation excluding those countries
41. heck is made for an option and in the case it has been issued a warning is typed out to the log file Hooks for user customization are provided speakswidth is the width of a label in which the name of the character is printed speaksindent is the indentation of the same label Dlabelsep is the space between this la bel and the text of the dialogue Dparsep controls the space between para graphs inside the dialogue speechskip controls the space between two subsequent speeches speakslabel formats the appearance of the name of the character 27 newenvironment drama 28 if lnpa 29 PackageWarning dramatist lnpwarning a drama 30 31 32 33 34 35 36 37 38 39 40 Al fi if lnps PackageWarning dramatist lnpwarning s fi list labelwidth speakswidth itemindent speaksindent itemsep speechskip parsep Dparsep labelsep Dlabelsep let makelabel speakslabel endlist The starred version calls the verse environment or the poem environment if po emscol is loaded after switching to drversetrue controls line numbering if any and after closing verse restores drversefalse 53 42 Qnamedef drama drversetrue if poemscol begin poem setcounter verselinenumber value storelineno setcounter printlineindex value storeprintlineindex else begin verse fi ifx poemlines undefined else setcounter poemline value storelineno fi 54 namedef end
42. is License since you have not signed it However nothing else grants you permission to modify or distribute the Pro gram or its derivative works These actions are prohibited by law if you do not accept this License Therefore by modifying or distributing the Program 20 or any work based on the Program you indicate your acceptance of this License to do so and all its terms and conditions for copying distributing or modifying the Program or works based on it Each time you redistribute the Program or any work based on the Pro gram the recipient automatically receives a license from the original licen sor to copy distribute or modify the Program subject to these terms and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or otherwise that contradict the conditions of this License they do not excuse you from the conditions of this License If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not distribute the Program at all For example if a patent license would not permit royalty
43. is defined to print the name of the character inside a stage direction 2 4 1 Grouped characters Characters in the Dramatis Persone list may need to be grouped under a com mon denomination For this occurrence the package provides an environment CharacterGroup taking as mandatory argument the denomination common to each character belonging to the current group Inside this environment the char acters have to be defined by GCharacter whose syntax is the same of Character except that the first argument is here obviously mandatory The result will be that the characters will be grouped by a big parentheses on whose right will be printed centered the common denomination The user can define the amount of space reserved to the characters names the parentheses and the common denom ination by means of CharWidth ParenWidth and GroupWidth The commands appearing in this section especially DramPer and Character i e the most crucial part of the whole work have been inspired by Matt Swift s package drama 2 5 Stage direction Two commands are provided for printing stage directions the first StageDir is used for the very setting of the stage and calls a quote environment The second is used for specifications in the middle of the speaker s text In connection with the verse environment a starred version exists also to be used at the end of a stanza 4Thanks to Christian Ebert for having submitted the problem to my atte
44. nd direct 312 ifstar sdirect direct 313 newcommand direct 1 314 if drverse 315 vskip2 normallineskip 316 parbox b dirwidth dirdelimiter emph 1 centercr 317 else 318 dirdelimiter emph 1 unskip 319 fi 320 321 newcommand sdirect 1 322 if drverse 323 vskip2 normallineskip 324 parbox b dirwidth dirdelimiter emph 1 325 else 326 starrederror 327 fi 328 329 newcommand dirdelimiter 1 1 It s a very simple command StageDir it merely calls the stagedir environment No more talking of it 330 newcommand StageDir 1 331 begin stagedir 332 1 333 end stagedir 334 The stagedir environment calls by default the quote environment but can be re defined by the user to do everything by means of StageDirConf I use here em instead of emph in order to avoid strange indentations thanks to Christian Ebert for having recognized and solved the problem 335 newenvironment stagedir 336 StageDirOpenSettings 337 StageDirCloseSettings global stagedirtrue 338 newcommand StageDirOpenSettings begin quote em 339 newcommand StageDirCloseSettings end quote 340 newcommand StageDirConf 2 341 renewcommand StageDirOpenSettings 1 342 renewcommand StageDirCloseSettings 2 343 3 7 Configuration settings 344 newcommand actcontentsline 1 actname theact 345 newcommand actnamefont scshape Large 34
45. nd grouplist 114 199 global n me ppend nddef persona roman character 200 begin 1rbox tbox 201 begin minipage c 65 textwidth raggedright 202 Meftmargini 0pt 203 begin list itemsep 0pt 204 dogrouplist 205 end list 206 end minipage 207 end 1rbox 208 parbox CharWidth usebox tbox 209 parbox ParenWidth left rule Opt ht tbox right 210 parbox CastWidth castfont 1 strut 211 212 newcommand dogrouplist 213 ifnum value g roman temp gt value gtemp 214 stepcounter gtemp 215 item nameuse gpersona Roman temp roman gtemp strut 216 dogrouplist 217 fi 218 setcounter gtemp 0 219 This is the version of Character to be used inside a CharacterGroup environment In this case the first argument is obviously mandatory 220 newcommand GCharacter 3 221 stepcounter g roman character 222 global namedef 3 namefont 2 intsp ce 2 check spr 12 speaker intsp ce 223 224 225 226 227 228 229 230 231 global n me ppend nddef 3 ppendname if drverse speakstab speaksfont 2 par nobreak addvspace parskip else item 2 fi global n me ppend nddef gpersona Roman character 7 roman g roman character castfont 1 This command is provided for defining characters which must not appear in the Dramatis Person list and are not mentioned in stage directions 232 233 234 235 236 237 new
46. ntion 5This works only with the verse environment provided by the verse package and by the memoir class You can use the normal not starred version of the command with the standard verse environment stagedir A stagedir environment is finally provided for extremely long stage directions it differs in nothing from his command version StageDir and the stagedir environment can be customized by means of StageDirConf StageDirConf The command takes two arguments related to the code to be executed at the beginning and at the end of StageDir or stagedir 2 6 Local configuration file As my chief aim has been the one of giving the user the support for a complete customization of the provided commands I have taken under consideration the case of a stable local configuration set up by the user So I introduced the pos sibility of reading a set of user definitions from a local configuration file called dramatist cfg dramatist cfg You must create this file if you need it and place it in a suitable directory either the working directory or the package directory if you don t need it no problem the package will merely print in your log file a message claiming the absence of such a file but nor interruptions neither error will take place 2 7 Acknowledgements I must acknowledge a debt of inspiration toward both Peter Wilson s all purpose class package memoir and Matt Swift s drama While the former inspired me with a peculiar care towar
47. o so attach the following notices to the program It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty and each file should have at least the copyright line and a pointer to where the full notice is found 22 one line to give the program s name and a brief idea of what it does Copyright C yyyy name of author This program is free software you can redistribute it and or modify it under the terms of the GNU General Public License as published by the Free Software Foundation either version 2 of the License or at your option any later version This program is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR POSE See the GNU General Public License for more details You should have received a copy of the GNU General Public License along with this program if not write to the Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Also add information on how to contact you by electronic and paper mail If the program is interactive make it output a short notice like this when it starts in an interactive mode Gnomovision version 69 Copyright C yyyy name of author Gnomovision comes with ABSOLUTELY NO WARRANTY for de tails type show w This is free software and you are welcome to redistribute it under certain c
48. ocumentation License Version 1 2 or any later version published by the Free Software Foundation with no Invariant Sections no Front Cover Texts and no Back Cover Texts A copy of the license is in cluded in the section entitled GNU Free Documentation License If you have Invariant Sections Front Cover Texts and Back Cover Texts re place the with Texts line with this with the Invariant Sections being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of program code we recommend releasing these examples in parallel under your choice of free software license such as the GNU General Public License to permit their use in free software References 1 Donald Knuth The TRXbook Addison Wesley Reading MA 1996 2 Peter Wilson The Memoir Class The Herries Press Normandy Park WA 2001 Available from CTAN macros latex contrib supported memoir 3 Peter Wilson Typesetting simple verse with ATX Available from CTAN macros latex contrib supported verse Change History v1 0 the drama environment made General First public release 1 act scene and DramPer vil more compliant to the standard document division commands 1 General Added support for line numb
49. onditions type show c for details The hypothetical commands show w and show c should show the appropriate parts of the General Public License Of course the commands you use may be called something other than show w and show c they could even be mouse clicks or menu items whatever suits your program You should also get your employer if you work as a programmer or your school if any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker signature of Ty Coon 1 April 1989 Ty Coon President of Vice This General Public License does not permit incorporating your program into proprietary programs If your program is a subroutine library you may consider it more useful to permit linking proprietary applications with the library If this is what you want to do use the GNU Library General Public License instead of this License B GNU Free Documentation License GNU FREE DOCUMENTATION LICENSE 23 Version 1 2 November 2002 Copyright 2000 2001 2002 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble The purpose of this License is to make a manual textbook or other
50. one The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A Front Cover Text may be at most 5 words and a Back Cover Text may be at most 25 words A Transparent copy of the Document means a machine readable copy rep resented in a format whose specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text for matters A copy made in an otherwise Transparent file format whose markup or absence of markup has been arranged to thwart or discourage subsequent modifi cation by readers is not Transparent An image format is not Transparent if used for any substantial amount of text A copy that is not Transparent is called Opaque Examples of suitable formats for Transparent copies include plain ASCII with out markup Texinfo input format LaTeX input format SGML or XML using a publicly available DTD and standard conforming simple HTML PostScript or PDF designed for human modification Examples of transparent image for mats include PNG XCF and JPG Opaque formats include proprietary
51. prints in the list of Dramatis Person the characters pre viously defined by the first argument of Character This is done via the dodramperlist macro which recursively calls the persona count commands and put them in the list defined by DramPer 285 newcommand DramPer 286 ifundefined if openright clearpage 287 if openright cleardoublepage else clearpage fi 288 secdef dramper sdramper 289 newcommand dramper 1 14 290 phantomsection 291 addcontentsline toc chapter casttitlename 292 drampermark casttitlename 293 m kedramperhead 1 294 newcommand sdramper 1 295 m kedramperhead 1 296 newcommand m kedramperhead 1 297 castheadstart 298 printcasttitle 1 299 aftercasttitle 300 begin list leftmargin 0pt itemsep Opt 301 dodramperlist 302 end list 303 304 newcommand dodramperlist 305 ifnum value character gt value temp 306 stepcounter temp 307 item nameuse persona roman temp strut 308 dodramperlist 309 fi 310 3 6 Stage direction In the prose environment direct merely encloses its argument in plain braces and emphasizes it and has no starred version In the verse environment things 14 StageDir stagedir are a little more complicated a parbox is involved and I have to admit the result is not really perfect yet I found no better solution The starred version must be used at the end of a stanza 311 newcomma
52. s void and has no effect on the meaning of this License 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commer cially or noncommercially provided that this License the copyright notices and the license notice saying this License applies to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this Li cense You may not use technical measures to obstruct or control the reading or 25 further copying of the copies you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cover Both covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as
53. tering scenenamefont scenename printscenenum scenenumfont theact intersep thescene printscenetitle scenetitlefont 1 scenenamefont scshape large scenenumfont scenenamefont scenetitlefont scenenamef ont scenename Scene thescene roman scene scenecontentsline scenename thescene printsep u intersep Muy Table 2 Sectioning commands scene An optional argument has the same meaning as for standard section ing commands Achapter section etc The title is printed by means of printacttitle or printscenetitle Each command is fully customizable in the style of Peter Wilson s memoir class see for the documentation 2 via commands like printactname or printactnum These commands can be redefined by the user according with his own desire Table 2 shows the commands and their default settings actmark and scenemark defined by default to do nothing can be useful for printing marks in the headers and have the same meaning of chaptermark and sectionmark in the standard classes A starred version also is provided for Act act Scene and scene As in standard classes the starred form does not make an entry for the table of contents and does not print the section mark in the headers 2 4 Defining characters The introduction of a new character is made by the command Character It takes three arguments the first optional is the entry for the list of Dramatis Persone the second is the name appearing
54. y section Entitled Endorsements Such a section may not be included in the Modified Version Do not retitle any existing section to be Entitled Endorsements or to con flict in title with any Invariant Section Preserve any Warranty Disclaimers If the Modified Version includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To 27 do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements provided it contains nothing but endorsements of your Modified Version by various parties for example state ments of peer review or that the text has been approved by an organization as the authoritative definition of a standard You may add a passage of up to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace th
55. you release the Modified Ver sion under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it In addition you must do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a previous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities respon sible for authorship of the modifications in the Modified Version together 26 with at least five of the principal authors of the Document all of its prin cipal authors if it has fewer than five unless they release you from this requirement State on the Title page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the N O other copyright notices Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below Preserve in that license notice the full lists
Download Pdf Manuals
Related Search