Small utilities and source files for generating my static website.
Getting started
Building the static website
The generation is handled by the shell script bin/ssg. It uses functions
from bin/func as abstraction layers to process source files.
The generation of the rss file is handled in bin/rssg. Same as the above
for the shell functions.
Building the static website is as simple as typing:
make website
# building small parts is possible
./bin/ssg
./bin/rssg
Previewing
Run a local webserver, e.g.: python3 -m http.server out/. Preview the results
on your favorite web browser.
make && python3 -m http.server out/
Uploading the output directory
The content of the out/ directory is uploaded to a remote directory, thanks
to rsync over ssh.
make deploy
Media
Storing medias
Any media files, such as images or video can be stored in a separate media
branch . Any files or directory at its root will be copied to the out/
directory in the trunk branch when generating the static website.
Compressing images
Files in jpg format can be compressed with one of the following command:
convert "${in}" -interlace Plane -sampling-factor 4:2:0 -quality 75% "${out}"convert "${in}" -interlace Plane -gaussian-blur .05 -quality 85% "${out}"
Additionaly, the option -strip can be used for removing metadata. Moreover,
the -quality, -gaussian-blur and -sampling-factor can be swapped between
the example above. Once again, it is a manual process and difficult -time
consumming ?- to automate it with good results.
Dithering images
It is preferred to use the png format with dithered images. Moreover, using
a maximum width of 600 pixeles makes sense, since the dithered will lose
informations anyway. Some of the following commands can be used, with different
results or colored output. Moreover, changing the order of the parameters
changes the final output!
convert "${in}" -resize 600x -ordered-dither 3x3 -colorspace gray "${out}"convert "${in}" -resize 600x -ordered-dither 3x3 -colors 16 "${out}"
The use of -colors 16 is encouraged for colored pictures.