Introduction

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.

Theme Basics

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.
  • asset: Theme creators use this directory to house assets such as CSS, Javascript, images, and more. It mimics the directory structure of application/asset within 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 application/views/.

Sass

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.