Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
screenwriter [2015/06/01 01:50]
slackermedia created
screenwriter [2021/06/03 19:48] (current)
Line 1: Line 1:
-screenwriter.el 
  
-------------------------------------------------------------------------------- 
  
-The most universal and simple ​solution ​is Screenwriter.el a fork of  +====== Screenwriter ====== 
-Screenplay.el by Vance L. Simpson. ​This is an excellent screenplay ​(majormode + 
-for GNU Emacs that is easy to use, efficient, and will work on any and every +One of the most universal and simple ​solutions for writing screenplays ​is [[http://​www.nongnu.org/​screenwriter|Screenwriter]], ​a fork of  
-platform that the ubiquitous and revered GNU Emacs works on.+Screenplay-Mode by Vance L. Simpson. ​Screenwriter ​is a plugin for the famous GNU Emacs text editor ​(or in Emacs terminology,​ it is a [major] "mode"). 
 + 
 +Screenwriter mode is easy to use, efficient, and works on any and every platform that the ubiquitous and revered GNU Emacs works on. 
 + 
 + 
 +<WRAP notice prewrap 50%> 
 +<WRAP rightalign>​ 
 +===== Strengths [Weaknesses] ===== 
 +</​WRAP>​ 
 + 
 +**WYSIWIG** 
 + 
 +<WRAP indent>​ 
 +Write screenplays with on-the-fly formatting, but in the universal format of plain text. This is not a markup language, so what you see is what you will get on the page. 
 +</​WRAP>​ 
 + 
 +**Plugin** 
 + 
 +<WRAP indent>​ 
 +Screenwriter is a plugin for an existing popular editor, meaning that there'​s nothing to install aside from one ''​.el''​ file. And if you're using Emacs on a daily basis anyway, this fits nicely in with your existing workflow. 
 +</​WRAP>​ 
 + 
 +**Simple** 
 +<WRAP indent>​ 
 +Emacs is a complex editor, with a high ceiling that frightens many tech-hesitant users, but Screenwriter mode is easy to use and involves only the simplest keyboard shortcuts. 
 +</​WRAP>​ 
 + 
 +<WRAP rightalign>​ 
 +===== Weaknesses [Strengths] ===== 
 +</​WRAP>​ 
 + 
 +**Formatted** 
 + 
 +<WRAP indent>​ 
 +Plain text is eternal, but Screenwriter //does// format the text, so the output is intended for print. It being plain text, the formatting can be easily reversed, but Screenwriter output is not as unstructured as [[fountain|Fountain]] markup. 
 +</​WRAP>​ 
 + 
 +**Emacs** 
 + 
 +<WRAP indent>​ 
 +There'​s no denying that the Emacs interface is unique. Even though Screenwriter uses only the most basic features of Emacs, it's common for users to find complexity in the most unexpected places. For a more familiar interface that acts more like a modern word processor, try [[trelby|Trelby]]. 
 +</​WRAP>​ 
 +</​WRAP>​ 
 + 
 +===== Install =====
  
 If you are running a default install of Slackware, as Slackermedia recommends, If you are running a default install of Slackware, as Slackermedia recommends,
 then you will have Emacs installed already. If you have not installed Emacs, then you will have Emacs installed already. If you have not installed Emacs,
-you will find it in the e package set.+you will find it in the ''​e'' ​package set and is available on your install media, Slackpkg, or directly from a [[http://​mirrors.slackware.com/​slackware|Slackware mirror]].
  
-Installing .el files for Emacs is as simple as placing the .el in a user-owned +Installing ​''​.el'' ​files for Emacs is as simple as placing the ''​.el'' ​in a user-owned 
-~/elisp directory, and then adding that ~/elisp directory into Emacs' load+''​~/elisp'' ​directory, and then adding that ''​~/elisp'' ​directory into Emacs'load
 directory if it is not already there: directory if it is not already there:
  
 +<​code>​
 $ mkdir ~/elisp $ mkdir ~/elisp
-$ wget +$ wget http://nongnu.org/​screenwriter/​download/​screenwriter-X.Y.Z.tar.gz 
-http://cvs.savannah.gnu.org/​viewvc/​*checkout*/​screenwriter/​screenwriter/​screenwriter-1.5.tar.bz2 +$ tar -xf screenwriter-X.Y.Z.tar.gz
-$ tar -xf screenwriter-1.5.tar.bz2+
 $ mv ./​screenwriter-mode/​screenwriter.el ~/elisp $ mv ./​screenwriter-mode/​screenwriter.el ~/elisp
- echo "​(add-to-list '​load-path \"​~/​elisp\"​)"​ >> .emacs ​+$ echo "​(add-to-list '​load-path \"​~/​elisp\"​)"​ >> .emacs ​
 $ echo "​(require '​screenplay)"​ >> .emacs $ echo "​(require '​screenplay)"​ >> .emacs
 +</​code>​
  
-Start emacs and press meta x, and type screenwriter-mode. You are now in  +===== Usage =====
-screenplay-mode and can start writing in proper screenplay format. Read the +
-comments in ~/​elisp/​screenplay.el for instructions on how to use the +
-application,​ or read on for use and optimization,​ Slackermedia style.+
  
-Using and Optimizing Screenwriter-mode+Start Emacs from either the **K Menu** or from a terminal. Once Emacs is open, press ''​alt''​ ''​x'', ​and type ''​screenwriter-mode''​. You are now in screenplay-mode and can write in proper screenplay format.
  
-There are three elements ​in screenplays:​+[{{ screenwriter.jpg | Screenwriting ​in Emacs. }}]
  
-  * Slug Lines (scene headings, such as INT. CAFE - NIGHT) +There are three elements ​in screenplays:​
- +
-  * Screen Direction (blocks of action text, wherein the screenwriter describes +
-    what a character is doing physically during a scene) +
- +
-  * Dialogue (heavily indented blocks of text in which characters speak)+
  
-Accessing each element ​is done with keyboard commands that can be easily +  * Slug Lines - scene headings, such as INT. CAFE - NIGHT 
-remembered with the mnemonic SAD:+  * Screen Direction (or "​action"​) - text describing what a character ​is doing physically during a scene 
 +  * Dialogue - heavily indented blocks of text in which characters speak 
 +  * Transitions - FADE IN, FADE OUT, DISSOLVE TO, and so on
  
-  * Control-c s Slugline 
  
-  * Control-c a Action ​(Screen direction)+Accessing each element is done with keyboard commands that can be easily remembered with the mnemonic ​(more or less**SAD**:
  
-  * Control-c d Dialogue+  * ''​ctrl''​ ''​c'',​ ''​s''​ Slugline 
 +  * ''​ctrl''​ ''​c'',​ ''​a''​ Action (Screen direction) 
 +  * ''​ctrl''​ ''​c'',​ ''​d'' ​Dialogue
  
-Additionally,​ you can use Control-c t to insert Transitions (indented and 
-capitalized blocks for CUT TO:, FADE IN, FADE OUT, and so on). 
  
-Whitespace is handled for you, so there is no need to place a blank line +Plus the straggler, and infrequently used:
-between the actor'​s lines, or between a slugline and the beginning of the +
-action, and so on.+
  
-Note+  * ''​ctrl''​ ''​c'',​ ''​t''​ Transition
  
-Alternate keybindings for each element type centers around the tab key: 
  
-  * tab return Slugline+Or for refugees of closed source screenwriting applications that used the ''​Tab''​ key for control:
  
-  * tab tab return Action+  * ''​tab'',​ ''​return''​ Slugline 
 +  * ''​tab'',​ ''​tab'',​ ''​return'' ​Action 
 +  * ''​tab'',​ ''​tab'',​ ''​tab'',​ ''​return''​ Dialogue 
 +  * ''​tab'',​ ''​tab'',​ ''​tab'',​ ''​tab'',​ ''​return''​ Transition
  
-  * tab tab tab return Dialogue 
  
-  * tab tab tab tab return Transition+Regardless of how you trigger different line types, whitespace is handled for you; there is no need to explicitly place a blank line between the actor'​s lines, or between a slugline and the beginning of the action, and so on.
  
-Streamlining Screenwriter-mode+===== Streamlining Screenwriter ​=====
  
-Make screenwriter-mode a quicker launch from within emacs by adding a global +Make ''​screenwriter-mode'' ​a quicker launch from within emacs by adding a global 
-keyboard shortcut for it, and defining the expected file suffix:+keyboard shortcut for it, and defining the expected file suffix ​in your ''​~/​.emacs''​ file:
  
 +<​code>​
 +; quick and easy way to enter screenwriter-mode
  
-  ; a quick and easy way to enter screenplay-mode +(global-set-key (kbd "<​f5>"​) 
-  +'​screenwriter-mode)
  
-  (global-set-key (kbd "<​f5>"​) +; open .scp or .screenplay 
-  '​screenplay-mode+; files in screenwriter-mode
-  ​+
  
-  ; open any file with a .scp or .screenplay suffix in +(setq auto-mode-alist (cons '​("​\\.scp" ​screenwriter-mode) 
-  screenplay-mode +auto-mode-alist))
-  +
  
-    ​(setq auto-mode-alist (cons '​("​\\.scp" . screenplay-mode) +(setq auto-mode-alist (cons '​("​\\.screenplay" . screenwriter-mode) 
-    auto-mode-alist)) +auto-mode-alist)) 
-  +</​code>​
  
-  (setq auto-mode-alist (cons '("\\.screenplay" ​screenplay-mode) +Save your ''.emacs''​ file and launch Emacs
-  auto-mode-alist)) +
-  ​+
  
-Save your .emacs file and launch Emacs. ​Pressing F5 should place you in  +Pressing ​''​F5'' ​should place you in Screenwriter ​mode. 
-screenplay-mode. Pressing control-c s will start a new slugline for you,  +
-control-c a an action block, and control-c d a dialogue block.+
  
-Save a sample screenplay (sample.scp,​ for example), and then close Emacs. Open  +Save a sample screenplay (''​sample.scp''​, for example), and then close Emacs. Open Emacs again and open a file via the **File** menu → **Open File** ​or by using the ''​ctrl''​ ''​x''​ ''​ctrl''​ ''​f'' ​key sequence. Open your ''​sample.scp'' ​and note that Emacs opens it in  
-Emacs again and open a file via the File menu or by using the control- +''​screenwriter-mode''​.
-control-f key sequence. Open your sample.scp and note that Emacs opens it in  +
-screenplay-mode.+
  
-In Dolphin, ​you can right-click on sample.scp and choose ​to Open With Emacs, +In Dolphin, right-click on ''​sample.scp'' ​and choose ​''​Open With Emacs''​. 
-and it will be opened in screenplay-mode in Emacs. However, default KDE uses +The file will be opened in ''​screenwriter-mode'' ​in Emacs. However, default KDE uses 
-the much faster single-click method, so it would be nice if a single click on +the much faster single-click method, so it would be nice if a single click on any ''​.scp'' ​or ''​.screenplay'' ​file would open in Emacs, and Emacs in turn would start Screenwriter ​mode.
-any .scp or .screenplay file would open prompt KDE to launch ​Emacs, and Emacs +
-in turn to open in screenplay ​mode.+
  
-Emacs is already set for .scp and .screenplay,​ so only KDE now needs to be +Emacs is already set for ''​.scp'' ​and ''​.screenplay''​, so only KDE needs to be configured:
-configured:+
  
- ​1. ​Open System Settings; open it and select ​the File Associations panel.+  - Open ''​System Settings'' ​and click the ''​File Associations''​ icon. 
 +  - Click the **Add...** button on the left of the panel to add a new file type. 
 +  - Place your new file type in the **Text** category. It will be placed at the bottom of the text list; select it and configure it on the right side of the panel. 
 +  - You may give your file type a custom icon or just use the default. 
 +  - Define the file extension as both ''​*.scp''​ and ''​*.screenplay''​ (or whatever custom extension you want to use, if neither of these appeal to you). 
 +  - Give the **Application Preference Order** a sensible set of applications. The documents are in plain text, so they may be opened in any text editor; **Emacs** as the first is obvious, but **Kate** and **KWrite** are likely candidates for fallback applications. 
 +  - Click the **Apply** button in the lower right corner to save your configuration.
  
- 2Click the Add... button on the left of the panel to add a new file type.+Now if you click on ''​sample.scp''​ from Dolphin, KDE will open the file in Emacs, and Emacs will enter screenwriter-mode upon detecting the ''​.scp''​ suffix.
  
- 3. Place it in the Text category. It will be placed at the bottom of the text +You now have a screenplay authoring program for Slackermedia, ​and quite likely for any other platform you could possibly run.
-    list; select it and configure it on the right side of the panel.+
  
- 4. You may give it a custom icon, such as something from the Oxygen Icon set +====== Screenplay-Tools ======
-    that suggests movies or the default Emacs Document icon, and define the +
-    file extension as both *.scp and *.screenplay.+
  
- 5. Give the Application Preference Order sensible ​set of applications. The +The ''​screenplay-tools''​ suite is a set of shell scripts to help with page breakdownsscheduling, and planning a shoot. They are bundled with ''​screenwriter-mode''​ but do not run in Emacs. They run in a terminal.
-    documents are in plain textso they may be opened in any text editor;  +
-    Emacs as the first is obviousKate and KWrite ​are likely candidates for +
-    fallback applications.+
  
- 6. Click the Apply button ​in the lower right corner to save your +Full documentation is included ​in the download, and also on [[http://​www.nongnu.org/​screenwriter/​tools/​intro.html]].
-    configuration.+
  
-Now if you click on sample.scp from Dolphin, KDE will open it in Emacs, and  +<WRAP tip> 
-Emacs will enter screenwriter-mode.+**See Also** \\ 
 +[[trelby|Trelby]] \\ 
 +[[fountain|Fountain]] 
 +</​WRAP>​
  
-You now have a screenplay authoring program for Slackermedia,​ and quite likely 
-for any other platform you possibly run. 
  
 +<WRAP centeralign>​
 +<wrap fa>​[[screencapture|R]]</​wrap>​ <wrap fa>​[[start|S]]</​wrap>​ <wrap fa>​[[scribus|Q]]</​wrap>​
 +</​WRAP>​