An Omeka S theme based on the Papers of the War Department. It comes packaged with a 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.

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.

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.

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.

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.