README
¶
Farto
Static site generator for browsing fartos on S3.
Commands
farto site generate
farto site generate [-t, --custom-template <path>]
Generate static site locally in site directory.
Optionally use the --custom-template flag to use a custom index.html template.
This is recommended because the default template is super boring.
farto site publish
farto site publish
Push your static site to S3 from site directory. All files in site are
uploaded so you can other files if you want (css, js, or whatever).
farto fartos normalize
farto fartos normalize <path>
Create normalized versions of your fartos. As in, create new image files from the originals that are a consistent size and format (jpg).
path must be local. The images will be created in sibling directories:
<path>.farto.n<path>.farto.n.t
n = "normalized", t = "thumbnail".
ffmpeg is required if there are ".mov" or ".mp4" files in <path>.
farto fartos upload
farto fartos upload <path>
Uploads fartos in path and also uploads normalized sibling directories if
present.
Config
Expects farto.yaml file.
s3Region:
s3Bucket:
s3Prefix:
siteTitle: Farto # HTML title field
siteHeadline: A Farto Site # Content for h1 tag at top of page
siteCopy: |- # Content for p tag right below h1 tag
Welcome to this Farto site!
Access Control
Basic auth with Lambda & Cloudfront. Got the idea from this blog post.
Terraform
The terraform directory contains modules for creating all necessary AWS resources.
terraform/main.example.tf is an example of how you can use them.
Directories