smashcut uses parslet to help parse the fountain input and transform it into a rich Screenplay object. That object can be used to produce a PDF (using prawn to produce the PDF). It can also be used to produce a Fountain document, and in theory could be taught to produce other formats like HTML or FDX. I'm not currently interested in implementing those, but can imagine it would be useful.
Because this is not useful yet I haven't pushed it to the rubygems site. If you'd like to try it, you can follow these steps:
git clone firstname.lastname@example.org:maxjacobson/smashcut.git
At this point, the gem is installed on your system and you can require it from your ruby programs or from within irb.
tests and style
If you'd like to run the tests and linter, just run
bundle exec rake. Another
option you have is to run
bundle exec guard, which will auto-run tests when
you edit files.
If you'd like to browse the docs, run
bundle exec yard server -r which spins
up a server you can visit in your browser at http://localhost:8808. When
adding inline documentation (comments above classes, methods, etc) please use
the yard syntax.
(Haven't actually done this yet, but) to release a new version of the gem, you will need to:
- decide what is the new version number
- edit the version.rb file with a new version number
- edit the CHANGELOG.md file to describe the new release, and make sure there's an "unreleased" section at the top for future unreleased changes.
- The commit these changes
bundle exec rake release, which will generate a git tag, push the tag to GitHub, create a new
.gemfile under the
pkgfolder, and release that pkg to rubygems.org
- create a new GitHub release (https://github.com/maxjacobson/smashcut/releases) describing the changes in the new version
Bug reports and pull requests are welcome on GitHub at https://github.com/maxjacobson/smashcut. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.