Omeka S supports themes, a way to customize the presentation of Omeka S sites. Omeka S comes with a default theme, and officially supports the Center Row, Cozy, and The Daily themes. The following is a guide for modifying existing themes as well as starting a theme from scratch.
Themes for Omeka S live within the
themes directory within the root directory of an Omeka S installation. They typically include the following directories and files:
config/theme.ini: This is a required file for a theme to be recognized by Omeka S. It includes the theme name, author, support information, theme version, Omeka S version requirements, and theme configuration options for users.
application/assetwithin an Omeka S installation.
view: Files within this directory are the meat of a theme. These customized theme files override Omeka S default view template files located in
Exploring Existing Themes
One of the best ways to start working with themes is to experiment with existing themes. Omeka S does not use a consistent pool of CSS selectors across our officially supported themes, but most web browsers provide beginner themers tools for exploring the HTML and CSS of a given site.
Themes officially supported by the Omeka team (the Omeka S default theme, Center Row, Cozy, and The Daily), use SASS to generate their CSS. For users who want to start using SASS, here are recommended tutorials for installation.
Those who simply want to edit the CSS without getting into preprocessors can ignore the 'asset/sass' folder completely and focus on .css files. Note: if you edit a .css file but later decide to use Sass, you should back up and make note of your changes before compiling for the first time. Changes made in .scss files overwrite any changes made to .css files.