lmparppei / Beat

Beat - a simple and elegant screenwriting app for macOS
Other
175 stars 30 forks source link

Suggestion: Expand Fountain syntax with !! for shots #126

Closed ftolsson closed 1 year ago

ftolsson commented 2 years ago

This is a proposition that would probably be best directed at the creators of the Fountain language, but sadly there is no contact information on the fountain.io website, and their GitHub page has unanswered questions from years back.

Therefore, I propose this as a local extension of the Fountain syntax inside Beat, in hopes that the language may evolve as a result of usage.

PROBLEM:

With no dedicated SHOT element format in Fountain, entering a shot or sub-header can arguably only be done in one of two way:

  1. As action, but styled manually (all caps, choice of bold). Done this way, shot lines risk being the last line of a page, counter to screenplay standards.
  2. As a scene heading, forced by adding a period at the top of the line. This will solve the last-line-of-page issue, but instead the shot will be interpreted as a SCENE for purposes of numbering, presence in outlines, and not least when exporting to other apps (including scheduling software). This presents a bunch of other problems and will take a lot of cleaning up.

PROPOSITION:

Interpret double leading exclamation mark as SHOT/SUB-HEADER.

SAMPLE SYNTAX:

He walks up to the kitchen cabinets. Slowly opens one of them, and RECOILS:

!!INSIDE THE CUPBOARD

dozens of rats are scavenging among the age-old boxes of food.

PARSING/STYLING RULES:

EXPORT RULES:

Most apps (and most importantly Final Draft FDX) have a built-in, default format for shots. So any !! shot lines should export as such.

BACKWARDS COMPATABILITY:

For apps not parsing !! as shots, shot lines will print/display as an action line with a leading exclamation mark. While not ideal, this will not break readability, and while waiting for adaption will cause the only a cosmetic, non-fatal, error (just as was probably the case in 2014 when ! @ and ~ was introduced in Fountain 1.1).

For your consideration!

lmparppei commented 2 years ago

One of the original creators of Fountain is actually present on the Beat Discord. We could try to open up a wider discussion about this, because it's an interesting question, one which I've stumbled upon myself, too.

I'm still a bit hesitant to add Fountain features that aren't somehow supported by other apps. I did it with strikethrough, but walked back after realizing the confusion it could create.

Let's discuss this further.

ftolsson commented 2 years ago

Oh, really? Introductions, please! 😊

I had actually prepared this suggestion for the Fountain website (hence its formal nature) but realized too late that it is a one-way communication platform only.

I would love to discuss it further — I love the idea of Fountain — but the SHOT format is really missing for all the aforementioned reasons...

ftolsson commented 2 years ago

So, here goes!

Some proposed "RULES" for a SHOT format:

Line has to meet three criteria:

No automatic detection, only explicitly forced lines become shots.

Behavior & Format:

Ideal implementation:

Discussion:

Reasons for selecting !! as format code:

lmparppei commented 2 years ago

The dual-character markup turns out to be a bit tricky parser-wise, but the prototype is kind of working now.

image

lmparppei commented 1 year ago

(Implemented a while back)