Naming convention for assets

Mikes Notes

Here is a standardised directory structure for each Ajabbi website, which the Content Management System (CMS) will automatically render and provision.

This is now in production.

Notes

• Use the 3-letter language codes from ISO 639-3, e.g. "eng".

• Use the 2-letter county codes from ISO 3166-1 alpha-2, e.g. "nz".

• Each localisation directory has its own assets subdirectory structure.

Directory Structure

• eng/
• eng-uk/
• _assets/
• ...
• eng-us/
• fra/
• fra-ca/
• ...
• robots.txt
• index.html
• site.manifest
• fravicon.ico
• sitemap
• assets/ (for static content used by the client (browser))
• data/ (xml etc)
• image/ (photos)
• lib/ (unmodified libraries)
• github/
• [path]
• [library/project name]
• vX.Y.Z (version)
• htmx/
• jquery.com/
• jquery/
• jquery-migrate-3.4.1/ (version)
• jquery-3.7.1.min/
• react.dev/
• ...
• media/ (video, audio)
• script/
• js/
• ts/
• style/
• css/
• all/
• component/
• page/
• print/
• screen/
• component/
• page/
• font/
• adobe/
• google/
• img/ (icons)

Resources

• https://en.wikipedia.org/wiki/ISO_639-3

• https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

• https://stackoverflow.com/questions/2071687/naming-convention-for-assets-images-css-js