assets.md

Best Practices for Assets

General

• Use the app-template assets rig. Do not commit them to the project repository.

Photos

• Images should be stored with the following path convention: www/assets/img/$SECTION_NAME/$SLUG$VERSION.jpg
• $SECTION_NAME can be whatever project specific section slug is appropriate (chapter, slide, page, etc.)
• $SLUG should follow URL conventions: all lowercase, no whitespace, dashes instead of underscores.
• $VERSION may be:

$VERSION	aspect ratio	target	resolution
	original	archival	full
-16x9	16x9	archival	full
-sq	square	archival	full
-16x9-d	16x9	desktop	1200x675
-16x9-m	16x9	mobile	400x225
-sq-m	square	mobile	420x420

• File extenions should always be lowercase.

Audio

• Audio should be encoded as OGG (for Firefox) and MP3 (for other browsers).
• Music should be encoded as 128bps CBR Stereo:
  • MP3: lame -m s -b 128 input.wav output.mp3
  • OGG: oggenc -m 128 -M 128 -o output.oga input.wav
• Voice should be encoded as 96bps CBR Mono:
  • MP3: lame -m m -b 96 input.wav output.mp3
  • OGG: oggenc -m 96 -M 96 -o output.oga input.wav

Video

• TKTK