The Catalog

This is a simple Javascript catalog for building the LittleArduinoProjects GitHub Pages site.

It is a simple bootstrap/datatables page with the main entry point in index.html. Catalog data is loaded from catalog.json, which is consolidated from .catalog_metadata I've added to each project.

The make.py utility script is used to maintain the catalog:

catalog/make.py rebuild  # builds the catalog from catalog metadata

Jekyll Generation

The site now uses Jekyll for page generation.

Atom Feed

The make.py script also generates the atom.xml feed file. This is a best-effort conversion to an atom feed. Currently includes all projects in the feed.

• feed validator
• published feed location

Hosting

I'm using Netlify to run the catalog site directly from the GitHub repository.

Note: I previously used GitHub Pages, but switched to Netlify as that allows me to use free SSL certificates from LetsEncrypt.

Running Locally

The site is generated with Jekyll. To run locally:

bundle exec jekyll serve

The generated site will be in the _site folder. This can be trashed after testing (it is not checked into the repo).

Credits and References

• Netlify
• LetsEncrypt
• GitHub Pages
• bootstrap
• datatables
• ..as mentioned on my blog