The s3/ directory is built automatically from the resources contained in content/ via the build script build-s3.sh.

All images should be put in the corresponding directories. The directory structure is:

content/ monthX/ weekY/ day-problems.docx day-images/ SVG and resulting PNG files for Day X Challenge exam.html (problems and solutions) exam-images/ SVG and resulting PNG files for Weekly practice

Naming conventions for the images should be:

MXWY-day-.(svg|png) MXWY-exam-.(svg|png)

The original SVG version of the image file should be in the corresponding directory. Copy the PNG export to the s3 bucket. Only put 3000x3000 PNG files in the s3 bucket. SVG does not render consistently, especially if fonts do not match. All images should have square aspect ratio. PNG is preferred over JPG because it is sharper for line drawings, but use JPG if you have an photo-style image.

The build-s3.sh script will find all PNG files in the exam-images/ directories, and first verify that the naming conventions have been followed. If there are no issues at all, it will copy all PNG files into the s3/ bucket.

After this, it is safe to sync the S3 bucket with the bucket at poshenloh.dailyimg using sync-s3.sh.

LaTeX can be rendered to SVG by installing MathJax Node on your machine:

npm install --global mathjax-node-cli

And also installing inkscape.

Save the actual LaTeX code in the exam-images/ directory as well. To render to SVG and PNG, use the script tex2svgpng.pl in this repository, by invoking it within the directory which contains the .tex file, where you want SVG and PNG files to output:

tex2svgpng.pl M1W2-choose-100-98-multiply (Call this only with the prefix of the .tex file)

The  tag will be sent to standard output, and also copied to the clipboard if xclip is installed.

Formatting style guide:

Set line wrap at 80 columns.

Leave exactly one space after each period.

Image style guide:

Use Inkscape to generate images. All Brillium images should be squares, and should have consistent line weight. Copy an old SVG file to use as a template for new SVG files. Also, use Gotham Light as the font.