jumpcut 2.0.1

JumpCut is a library and CLI for converting Fountain-formatted text files into FDX, HTML, JSON, text, and PDF formats.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# Formatting reference

 Put these options on a `Fmt:` line in the yaml frontmatter of a fountain file, separated by spaces. Names are case-insensitive.

Example:

```text
Title: Night Shift
Author: Alex Morgan
Fmt: industry bold-scene-headings single-space-before-scene-headings no-auto-act-breaks
```


## Profiles and paper sizes

- `multicam`: Use a multicamera TV layout.
- `a4`: Use A4 paper instead of US Letter, with a matching line count.
- `jumpcut`: Use the default opinionated pagination profile.
- `industry`: Use Final Draft-style pagination.

## Styles

- `bold-scene-headings`: Makes scene headings bold. Alias: `bsh`.
- `underline-scene-headings`: Underlines scene headings. Alias: `ush`.
- `all-caps-action`: Converts action text to uppercase. Alias: `acat`.
- `single-space-before-scene-headings`: Reduces the extra blank space before scene headings. Alias: `ssbsh`.
- `double-spaced-dialogue`: Double-spaces dialogue lines. Alias: `dsd`.
- `no-auto-act-breaks`: Keeps `NEW ACT` blocks from forcing a new page.
- `no-act-underlines`: Removes the default underline styling from cold openings and act markers.
- `courier-final-draft`: Uses "Courier Final Draft" instead of the default "Courier Prime". Alias: `cfd`.

## Margins and page size

You can also customize the margins for different element types. Measurements below are in inches, except `lpp`, which sets the number of body lines per page.

- `dl-X.XX`: Sets the dialogue left indent in inches.
- `dr-X.XX`: Sets the dialogue right indent in inches.
- `tm-X.XX`: Sets the page top margin in inches.
- `bm-X.XX`: Sets the page bottom margin in inches.
- `hm-X.XX`: Sets the page header margin in inches.
- `fm-X.XX`: Sets the page footer margin in inches.
- `lpp-X.XX`: Overrides the default body-page line count used by pagination and layout.

## Other options

- `allow-lowercase-title`: Keep the title’s original capitalization on a plain title page.
- `clean-dashes`: Keep interruption dashes and trailing `--` together. Enabled by default in the `jumpcut` profile.
- `no-dual-contds`: Exclude dual dialogue when counting automatic character continuations.

## Cheats / Paragraph adjustments

If you're trying to save space and you have a single element that you want to manually tweak, JumpCut lets you change the margins and spacing of individual elements by sticking special markup in fountain notes.

Use `.lift` and `.widen` inside `[[ ... ]]` notes:

| Modifier | Effect |
| --- | --- |
| `.lift` or `.lift-1` | Remove one line of space before the paragraph. |
| `.lift-N` | Remove N lines of space before the paragraph. |
| `.widen` or `.widen-1` | Widen the paragraph by 0.125 inches. |
| `.widen-N` | Widen the paragraph by N × 0.125 inches. |

Multiple modifiers add together, whether they share a note or appear in separate notes. Other text in the note is preserved. Unrecognized modifiers remain ordinary notes.

If you import from a Final Draft document that has individual paragraph cheats like these, JumpCut will try to preserve them and translate them into Fountain notes.

## Front matter / Vanity Quote Pages

Sometimes a screenplay begins with a quote page or cast page that shouldn't count against the script's page count. You can use the `Frontmatter-page-count` metadata option to exclude these pages as shown below:

```text
Title: Night Shift
Author: Alex Morgan
Frontmatter-page-count: 1

CAST

ALEX — the night manager

===

INT. HOTEL - NIGHT
```

JumpCut will attempt to add this metadata itself if you import from a Final Draft file with extra title pages.