Tags

Version 2.2.2

- Added an option to automatically upcase scene headings
- Page breaks now export to Final Draft (FDX) files
- Use outline- prefixes and create aliases for Emacs before 25.1
- Fixed a show-stopping bug if autoinsert was loaded before Fountain
  Mode #66
- Rearranged code by functional topics

Version 2.2.1

- Fixed forced action being parsed as character.
- Fixed forced action exporting leading !.
- When using fountain-upcase-line-and-newline with an argument (C-u C-c
  RET), only make a forced scene heading if not already (prevents adding
  ..).
- Fixed scene heading gap between heading and scene number being
  fontified on minimum decoration setting.

Version 2.2.0

Directives Syntax in Templates

In keeping with Fountain's upcoming "directives" syntax, formatting
templates has changed. Instead of ${key} you now use {{key}}.

This change affects:

- fountain-export-title-template
- fountain-export-contact-template
- fountain-export-html-template
- fountain-export-tex-template
- fountain-export-fdx-template
- fountain-export-fountain-template
- fountain-note-template

This may cause some annoyance, but it allows for a very flexible use of
directives in the future. This also allows for recursive template
replacement in LaTeX documents (where $ is special).

Further Changes

- Removed fountain-export-title-format. Instead, to edit the title
  format, edit fountain-export-title-template with normal Fountain
  emphasis syntax, e.g. _**{{title}}**_ would make it so the title is
  always bold and underlined. Control like this was previously not
  possible.
- Added section headings to LaTeX and HTML export templates.
- Fixed issue where HTML and LaTeX export would ignore
  fountain-export-title-template (#59)
- Collapse multiple lines of whitespace in HTML template strings.
- Fixed an issue with LaTeX template strings with line breaks.
- Patch known Emacs bugs with named functions to make debugging easier.
- Fixes an issue where messages Parsing... and Exporting... would be
  printed on startup. (#60)
- Fixes an issue where exporting would fail on Emacs 25.1.

Version 2.1.5

Patched bug in outline-invisible-p with advice override to return
non-nil only if invisible text property is 'outline. This allows the .
on forced scene headings to be hidden when fountain-hide-syntax-chars is
non-nil (toggled with C-c C-x !). This advice is future-proof such that
when outline if fixed it will still work as expected. (#26)

Version 2.1.4

- Split up the export templates, so you can make edits to one without
  saving every template to your init file. fountain-export-templates has
  become:

  fountain-export-html-template
  fountain-export-tex-template
  fountain-export-fdx-template
  fountain-export-fountain-template

- Added export hooks for all formats. These are useful for triggering a
  LaTeX compile (#51) or opening an exporting HTML file in your browser.
- Added local variables to make tex-mode use XeTeX engine for LaTeX
  export. Unfortunately Emacs will nag you about this being a risky
  local variable, so see [Silencing risky variables warning][1]
- Fixed scene number regular expression. Previously #N would be
  recognised as a scene number when the spec asks for #N#
- Made the default fountain-note-template begin with a space (looks
  neater).
- Fixed obsolete variable warnings

[1]: https://github.com/rnkn/fountain-mode/wiki/Silencing-risky-variables-warning

Version 2.1.3

- Set default scene heading prefixes to match http://fountain.io
- Fixed fountain-export-page-size option mismatch error
- Fixed fountain-export-standalone option mismatch error
- Fixed exporting to Fountain attempting to overwrite current
  buffer/file #58
- Removed s.el dependencies
- Removed fountain-insert-template
- and just some neatening up doc strings

Version 2.1.2

- Fix key binding for GUI/terminal compatibility:
    S-RET for fountain-upcase-line-and-newline
    S-TAB for fountain-outline-cycle-global

- Integration with auto-insert (replaces fountain-insert-metadata with
  skeleton)
- Huge speed boost to parsing export by rewriting fountain-comment-p to
  always search forwards
- Fix character regular expression to allow names starting with numbers
  (e.g. "23B")
- Fix scene number regular expression to look for trailing "#"
- Fix for HTML template: added viewport tag
- Merged fountain-short-time-format and fountain-long-time-format into
  fountain-time-format
- Prompt to overwrite export buffer contents
- Automatic saving export file with prompt to overwrite existing file
- Removed fountain-metadata-template
- Temporary workaround for #56

Version 2.1.1

- Fixed errant newlines in LaTeX dialogue output
- Updated file Commentary

Version 2.1.0

- Fountain Mode now uses [lexical binding][1]
- HTML export template [McQueen][2] is now mobile responsive
- LaTeX export template now indents dialogue to 1 in instead of 1.5 in
- *.fountain files now automatically load Fountain Mode
- Emacs page functions now work with Fountain forced page breaks
- Documentation strings for all functions and variables
- Bug fix: export templates now include fountain-export-contact-template
  (fixes #50)
- Removed option for using external stylesheet with HTML export
- Removed omit from scene element property list
- Removed fountain-additional-template-replace-functions
- Use function quoting for better byte compilation

[1]: https://www.gnu.org/software/emacs/manual/html_node/elisp/Lexical-Binding.html
[2]: https://github.com/rnkn/mcqueen

Version 2.0.1

- Fixed "wrong version" problem with Final Draft export template

Version 2.0.0

Exporting

- Export to LaTeX, HTML, Final Draft, Fountain or your very own custom
  formats (Huh? Why export Fountain? See #33)
- Separation of the [LaTeX template][1] project and the [HTML
  template][2] project
- Skip the Lisp export entirely and use fountain-export-shell command
  with ['afterwriting][3] or [TextPlay][4] or whatever you like
- New parsing engine reads Fountain text into Lisp data for further
  magic
- New export engine allows much faster export—to virtually any format
- Choice of export to standalone document or a snippet
- All export templates are totally customizable

Not just screenplays

- Auto-align elements to different columns for different formats (e.g.
  screenplay or stageplay), just include format: stageplay or whatever
  in your metadata
- Action is now a first-class element that can be auto-aligned (like,
  for stageplays)

n.b. the export templates are really geared towards screenplays, so if
you're a playwright and feel lost please get in touch and we'll see what
we can do

New abilities

- Scene numbers optionally align to the right margin
- fountain-upcase-line with C-c C-c (fountain-continued-dialog-refresh
  is moved to C-c C-d)
- Prefix fountain-upcase-line or fountain-upcase-line-and-newline with
  C-u to make insert . at the beginning to make a forced scene heading
- Terminal-friendly key map
- Align the title page contact info to the left or right

Better existing abilities

- imenu regular expression now show section heading prefixes (e.g. # act
  II instead of act II)
- fountain-mark-scene now excludes marking a following outline heading
- For those writers who like to include blank lines _within_ dialogue,
  you should be golden
- It should now be impossible to get into an endless loop

Removing the cruft

- Removed reliance on Prince for PDF export (use LaTeX instead)
- Reduced reliance on s.el
- Removed fountain-uuid and related variables
- Title page templates now only use a single contact box instead of a
  left and right

Notes on upgrading

As this is a major version upgrade, some backwards compatibility is
lost. I've tried to document this as much as possible here:
https://github.com/rnkn/fountain-mode/wiki/Upgrading-From-1.x-to-2.0

If you have any trouble, please get in touch.

[1]: https://www.sharelatex.com/project/54ed9180966959cb7fdbde8e
[2]: https://github.com/rnkn/mcqueen
[3]: https://github.com/ifrost/afterwriting-labs/blob/master/docs/clients.md
[4]: https://github.com/olivertaylor/Textplay

Version 1.5.1

- Adds Emacs 24.4.0 as dependency #38 #39
- Adds partial fix for problematic two-space rule #40

Version 1.5.0

- Implemented basic Imenu functionality.

Version 1.4.5

- Workaround bug where forced scene headings would behave properly in
  outline cycling, but means the syntax character . cannot be hidden
  (fixes #25 and introduces #26)

Version 1.4.4

- Optimization (removed use of extremely slow thingatpt functions)

Version 1.4.3

- Major update to integrate with outline, providing structure navigation
  and editing, including:
- TAB cycle outline visibility of the current section/scene
- S-TAB cycle visibility of the entire buffer
- C-c C-f move forward the same outline level
- C-c C-b move backward the same outline level
- C-c C-n move to next section/scene
- C-c C-p move to previous section/scene
- C-c C-u move up outline level
- C-c C-v shift the current section/scene down (swap with follow)
- C-c C-^ shift the current section/scene up (swap with previous)
- C-c C-SPC mark the current section/scene
- Added fountain-outline-startup-level, the outline visibility level to
  show on startup, which can also be set per-file with the startup-level
  metadata key
- Added navigation by character:
- M-n move forward character
- M-p move backward character
- Options set in the menu can now be saved _en masse_ with Save Options
  (custom-save-all)
- Improved the menu layout
- Improved element regular expression matching
- Improved font-lock extend region function
- Improved various navigation functions
- Fixed scene heading margin-bottom in HTML export (feature screenplays
  should now be about two pages shorter)
- Fixed edge-case errors when working with font-lock-maximum-decoration
- Optimized fountain-comment-p
- Comments now use syntax instead of regular expressions
- Removed INT/EXT from default fountain-scene-heading-prefix-list
- Other changes to pave the way for an overhaul of the way fountain-mode
  works with screenplays (exporting, statistics, etc.)

Version 1.3.4

- Fixed a bug where font-lock-extra-managed-props was being set at a
  global instead of buffer-local level

Version 1.3.3

- Changed template keys: point is now $@ and mark is now $?
- Documentation updates

Version 1.3.2

- Fixes (_really_ fixes) issue that prevented customizing scene heading
  prefixes and transitions.