Skip to content

An Omeka S Theme customized for the HBCU/Smithsonian collaboration

License

Notifications You must be signed in to change notification settings

chnm/freedom-hbcu

This branch is 4 commits ahead of omeka-s-themes/freedom:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

061a38e · Jan 27, 2025
Jan 27, 2025
Jan 27, 2025
May 31, 2023
Jan 23, 2025
Jun 29, 2023
Mar 9, 2023
Mar 11, 2023
Jul 11, 2023
Mar 11, 2023
Mar 11, 2023
Nov 25, 2024
Nov 25, 2024
Mar 11, 2023

Repository files navigation

Freedom S: An Omeka S Theme

This is an Omeka S theme that offers some custom options and a clean design. Freedom Theme

Installation

For basic out-of-the-box use of the theme, follow the Omeka S User Manual instructions for installing themes.

For more advanced use, such as customizing the theme with Sass, you'll need to install the tools with NodeJS (0.12 or greater). Navigate to your theme directory and run npm install.

Theme settings

Theme's Primary Color

The color to be used as the theme's primary color. The default value is #e77f11 (RGB 231, 127, 17).

Header Layout

  • Inline logo and menu
  • Centered logo and menu

Top Navigation Depth

Maximum number of levels to show in the site's top navigation bar. Set to 0 to show all levels.

Logo

A custom logo (SVG, JPG, PNG)

Banner

  • Banner image
  • Heading
  • Description
  • Content position
  • Banner width
  • Banner height
  • Banner height for mobile devices
  • Banner image vertical position within the wrapper
  • Banner image horizontal position within the wrapper

Footer

  • Footer Logo
  • Footer Site description
  • Footer Menu
  • Footer Menu Depth
  • Footer Content
  • Footer Copyright

Social Media

  • Facebook
  • Twitter
  • LinkedIn
  • Instagram
  • Youtube
  • Mastodon

Image Settings

  • Decorative border for Media and/or Assets

Resource Tags

  • Show tags based on Resource Type or Class

Browse Settings

  • Layout for Browse Pages
  • Truncate Body Property

Customizing the Theme

If you want to customize the site with your own CSS, the CSS Editor module allows site administrators to write style overrides.

For advanced CSS and Sass users, this theme includes variables and mixins for managing and extending many styles.

Sass Tasks

Run these commands within the theme's root directory.

  • npm run start: While this task runs, it watches for changes to sass files and recompiles the CSS.
  • gulp css: This is the one-off task for compiling the current Sass/CSS.
  • gulp css:watch: This task watches for changes in the Sass, then compiles the CSS.

Sass File Structure

sass
    ├── abstracts
    │   ├── mixins
    │   └── variables
    │       ├── breakpoints
    │       ├── colors
    │       ├── layout
    │       └── typography
    ├── base
    │   ├── elements
    │   │   ├── body
    │   │   ├── buttons
    │   │   ├── caption
    │   │   ├── fields
    │   │   ├── hr
    │   │   ├── icons
    │   │   ├── language-tag
    │   │   ├── links
    │   │   ├── lists
    │   │   ├── media
    │   │   ├── resource-description
    │   │   ├── resource-tag
    │   │   ├── tables
    │   │   ├── titles
    │   │   └── tooltip
    │   ├── layout
    │   │   ├── layout
    │   │   └── regions
    │   └── typography
    │       ├── copy
    │       ├── headings
    │       └── typography
    ├── components
    │   ├── accordion
    │   ├── advanced-search
    │   ├── annotation
    │   ├── banner
    │   ├── blocks
    │   │   ├── assets
    │   │   ├── browse-preview
    │   │   ├── carousel
    │   │   ├── collecting
    │   │   ├── item-showcase
    │   │   ├── item-with-metadata
    │   │   ├── list-of-sites
    │   │   ├── media-embed
    │   │   ├── table-of-contents
    │   │   └── timeline
    │   ├── breadcrumbs
    │   ├── facets
    │   ├── footer
    │   ├── header
    │   ├── linked-resources
    │   ├── metadata
    │   ├── navigation
    │   ├── pagination
    │   ├── resources
    │   │   ├── browse-controls
    │   │   ├── resource-grid
    │   │   ├── resource-list
    │   ├── search-results
    │   ├── uri-dereferencer
    │   └── user-bar
    ├── generic
    │   ├── box-sizing
    │   └── normalize
    └── utilities
        ├── accessibility
        ├── alignments
        └── clearfix

Utility classes

Freedom S offers a set of predefined utiliy classes that will help you to add styles to certain elements by just assigning them these classes.

You can even combine multiple utility classes.

  • inline
  • alignleft
  • alignright
  • aligncenter
  • alignfull
  • alignwide
  • alignnarrow
  • textleft
  • textright
  • textcenter
  • clearfix
  • screen-reader-text

Copyright

Freedom S is Copyright © 2023-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org

The Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.

The Omeka name is a registered trademark of the Corporation for Digital Scholarship.

Third-party copyright in this distribution is noted where applicable.

All rights not expressly granted are reserved.

About

An Omeka S Theme customized for the HBCU/Smithsonian collaboration

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 44.7%
  • SCSS 44.3%
  • JavaScript 8.8%
  • PHP 2.2%