Papers

By Omeka Team Theme based on the Papers of the War Department project. This theme also includes a companion Scripto theme.
Download 1.4.3

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.

Copyright

Papers is Copyright © 2019-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.

Version Released Minimum Omeka version
1.4.3August 15, 2023 [info]^4.0.0
1.4.2June 02, 2023 [info]^4.0.0
1.4.1February 03, 2023 [info]^4.0.0
1.4.0October 28, 2022 [info]^4.0.0
1.3.4August 03, 2022 [info]^3.1.0
1.3.3April 05, 2022 [info]^3.1.0
1.3.2November 16, 2021 [info]^3.0.0
1.3.1August 16, 2021 [info]^3.0.0
1.2.0October 07, 2020 [info]^3.0.0
1.1.0January 28, 2020 [info]^2.1.0
1.0September 05, 2019 [info]^2.0.0