nyousefi / Fountain

An open source implementation of the Fountain screenplay formatting language.
http://fountain.io
MIT License
538 stars 55 forks source link

[EPIC] Fountain syntax extension #50

Open shaedrich opened 1 year ago

shaedrich commented 1 year ago
I thought, it might be a good idea, to collect all issues concerning syntax extension to have kind of an overview of where we stand on these issues (maybe @nyousefi can create a label for that): Title Status Proposed syntax Rendered as Suggested by
Stage directions discussion +stage directions+ <div style="text-align:right;">stage directions</span> @Reaper10
Sound effects discussion
  • ^sound effect
  • <sound effect
  • &sound effect
  • ^sound effect^
@Reaper10
Scene metadata discussion @severdia
Element references discussion [{label}]({type}:{identifier}) <a href="[{type}:{identifier}">{label}</a> utilizing CURIE/URN @shaedrich
dramatis personae discussion table https://scriptigo.com/help/fountain-format/133-improvements-to-the-fountain-format @severdia
Script lining discussion [[ and ]], starting with the word "LINE" vertical lines with different colors @shaedrich
Annotations discussion extended markdown syntax to highlight text (== and ==) in connection with footnotes ([^1] and [^abbr]: endnote text or ^[inline footnote]) <mark title="{label}">{text selection}</mark> @shaedrich
stovak commented 4 months ago

I am +1 on the script lining.

I would, however prefer something like

[[SHOT "Scene 3 shot 3"]]
Tom shot himself in the head and
[[/SHOT]]
[[SHOT "Scene 3 shot 4"]]
The gun fell to the floor.
[[/SHOT]]

Then you could run a production report and get a shot list.

shaedrich commented 4 months ago

Would you say, that a line and a shot are entirely identical?

stovak commented 3 months ago

Would you say, that a line and a shot are entirely identical?

yes. My bad. Line is the visual implementation of a shot item. Either work, IMHO

stovak commented 3 months ago
[[LINE <label>]]
Tom shot himself in the head and
[[LINE <label2>]]
The gun fell to the floor.
[[/LINE]] [[/LINE]]

or you could do them like HTML tags... <line label="blah"></line>

stovak commented 3 months ago

If you implemented them as "html-style" tags, you could have a writing view that ignores production tags, and a production view that you can match up to storyboards.

<line label="blah" storyboard="storyboard.svg">
   Tom shot himself in the head and
     <line label="blah2" storyboard="storyboard2.svg">
        The gun fell to the floor.
     </line>
</line>
shaedrich commented 3 months ago

Would you say, that a line and a shot are entirely identical?

yes. My bad. Line is the visual implementation of a shot item. Either work, IMHO

@stovak Thank you for your suggestions, much appreciated 👍🏻 Sorry for my late reply. I needed to settle on how to put my understanding into words 😅

My understanding was, that they are similar, yet not entirely identical, however, they could happen to point to the same thing, just not in general. What I mean, is that in my head (correct me if I'm wrong), a line is more synonymous with a camera setup than a shot since a camera setup can consist of one shot only but can also consist of multiple. But I'm not an expert, so I might be mistaken. Also, while line is a pre-production term, shot is a principal photography term and that might feel like mixing two very different workflows of two very different crew members.

What I like about your XML/HTML style tags is the ability to add additional attributes like the storyboards 👍🏻