Skip to content
An Omeka S theme based on the Papers of the War Department.
CSS HTML JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
asset
config
view
.gitignore
README.md
gulpfile.js
package-lock.json
package.json
theme.jpg

README.md

Papers

An Omeka S theme based on the Papers of the War Department. It comes packaged with a Scripto theme.

Using the Scripto Theme

The only requirement for a Scripto theme is a stylesheet (.css) file within the Scripto module in the following subdirectory: Scripto\asset\css\site-themes\. The stylesheet name must match the name of your site theme directory.

This theme includes its companion Scripto theme in the following path: asset/css/scripto/papers.css. There are two ways to enable this theme.

Manually copy the CSS file to the Scripto module.

Copy your CSS file into the appropriate directory within the Scripto module. The path from within your Omeka S installation looks like this: [$ROOT]/modules/Scripto/asset/css/site-themes. If you want to make any changes to your Scripto theme, your styles will be read from that location.

Use the command line.

This method is for more technical users. The "Papers" theme uses Gulp to manage Sass/CSS compiling, and has a specific task for exporting the Scripto theme. To use this task, navigate to the root of the theme folder via the command line and type gulp scripto. This will compile the Scripto theme and place it in the correct folder, provided the Scripto module has been installed. Note: Scripto themes are not required to use Gulp or Sass, so this method may not always be an option.

Using Sass with Scripto Themes

Like Omeka S itself and many of its themes, the "Papers" theme manages its styles with Gulp and Sass. If you plan on using these tools, here are commands you'll need to run from the root of the "Papers" theme:

  • npm install: Install the theme's Node dependencies. This is required before running any tools.
  • gulp css: This command will look at your .scss files within asset/sass and export their respective CSS files into asset/css.
  • gulp css:watch: This command performs the same function as gulp css, but watches the asset/sass folder for any ongoing changes until the command is stopped.
  • gulp scripto: This command performs the same function as gulp css, but includes Scripto theme files.
  • gulp scripto:watch: This command performs the same function as gulp css:watch, but includes Scripto theme files.

Theme Configuration and Scripto

An important note: because Scripto is totally controlled with CSS, it cannot interact with theme options in a site theme, like user-set image assets or colors. If you plan on using custom backgrounds or logos for a site theme alongside a Scripto theme, save the images to a folder within your site theme and reference them using relative paths accordingly. Theme colors and styles will have to be implemented within the papers.css file in Scripto.

You can’t perform that action at this time.