Journal Publishing Guide

This is a technical guide to help you include audio-visual material in your published content. Contact us if you have any questions about copyright and related permissions. 

First, decide whether you would like to stream the content. If your content is not streamed, readers will download the file from your OJS site before playing it on their own devices. Streamed content is uploaded to an online repository, and can be linked or embedded in published material.

Unstreamed AV content will be added to your OJS article as a galley file. If the file is a part of the primary content, upload it as “Article Text” (even if the file is not text-based). This will ensure that OJS will handle your file as primary content and give it a more prominent location.

If the file is not a part of the primary content, you can choose any other component. OJS will handle it like a supplemental file, giving it a less prominent location. The files will display as shown:

To stream content, you will need a remote URL. This can be obtained by uploading your AV content to a third-party streaming service or the University of Alberta’s platform, Aviary.

• Host it on a third-party platform
  • Upload the file to a platform of your choice (e.g. Vimeo, Youtube, Spotify).
  • The remote URL is the link to the page containing your content.
  • If you would like to embed a player directly into your publication, check that your platform provides embed code.
• Host it on Aviary
  • To host your AV content on Aviary, transfer the files to our team via Google Drive. Please provide metadata with each file. The description should be for the AV material alone, which may differ from that of the main article.
  • We will process your Aviary upload and provide you with a remote URL. Embed code will also be available.

Streamed content can be uploaded as a standalone galley, linked from a galley file, or embedded into a galley file.

Uploading Streamed AV as a Standalone Galley

Add a production galley and enter the remote URL as shown:

The relevant OJS article will have a galley button that links directly to your AV content.

Adding Streamed AV to an Existing Galley

For PDF Galleys:

You can link your AV context to text or an image.

Add links in your preferred document editor, before saving the document as a PDF. These instructions use Microsoft Word; steps may vary depending on your software.

If you are linking text, first highlight the span that you would like to link. To link text or an image, right-click and select the link option from the dropdown menu that appears.

You will then be prompted to enter the remote URL that links to your AV content.

The text/image will now link to your AV content. Test the link before and after saving the galley as a PDF to ensure that it is working.

For HTML Galleys:

You can choose to either link your AV content to text or an image, or to embed a player.

Linking

To link to AV content from article text, use the <a> tag:

<a href=”AV_url” target=”_blank”>My text.</a>

For example, this HTML:

<a href=”https://ualberta.aviaryplatform.com/collections/1759/collection_resources/74699” target=”_blank”>This text links to the "Le charme des fleurs" ballet.</a>

Produces this text:

This text links to the "Le charme des fleurs" ballet.

To link to AV content from an image, add the <img> tag into the <a> tag:

<a href="AV_url" target=”_blank”>

   <img src="image_url" alt="My AV content.">

</a>

For example, this HTML:

<a href="https://ualberta.aviaryplatform.com/collections/1759/collection_resources/74699" target=”_blank”>

   <img src="https://d1qywhc7l90rsa.cloudfront.net/accounts/154600/images/player_screencap.png" alt="A screencap of "Le charme des fleurs" ballet, which links to the video.">

</a>

Creates this linked image:

Embedding

If you would like to embed a player, we recommend choosing a streaming platform that provides embed code. This demonstration uses Aviary, the University of Alberta’s institutional repository. 

First, obtain embed code from the content page. It is often included in Share options, at the top right corner of the page. 

You will then be able to copy embed code for your content:

Paste this code into the article HTML, where you would like the player to appear. Readers will now be able to stream AV content directly from your publication, like so:

You can change the size of the player by specifying width and height attributes (in pixels). For example, height and width can be specified for embed code copied from Aviary:

<iframe title="Le charme des fleurs = The Spell of the Flowers" src="https://ualberta.aviaryplatform.com/embed/media/160613" height=“505” width=“900”></iframe>

The player now appears larger: