Adding Media and Annotations [DRAFT]
This section describes functionality in Scalar's page editor, which is accessed by clicking the 
icon (if creating new content) or the 
icon (if editing existing content) in your Scalar header bar.
Adding media to your page is done through links in the page editor.
Adding Media Links
You can add media links to your content by selecting the text you'd like to link and clicking on the first blue media button
seen at the top of the text editor. This will insert a link to a media file that's already been imported into Scalar. This kind of link allows maximum flexibility in the layout of your text and media--Scalar can rearrange them as needed depending on the current view.Adding Inline Media
If, however, you want to embed your media in the page at a specific location in the more traditional style, you can use the second blue media button
. This will insert an inline reference to a Scalar media file that will be embedded in the page at the selected location.Formatting Media
Once you've selected the media you'd like to insert, whether as a media link or as inline media, you'll be prompted to choose your formatting options. Using the media reference options select the following display preferences:- Size. Choices include “Small” (206px wide), “Medium” (412px wide), “Large” (620px wide), “Full” (maximum wide of the page), and “Native” (the original size of the media up to the maximum width of the page).
- Alignment. Choices include "Left" (aligned left), "Center" (aligned center) [for inline media only], and "Right" (aligned right).
- Caption. Choices include "Description" (the description for the media object will be displayed), "Title" (the title of the media object will be displayed), "Title and description" (the title and description for the media object will be displayed), and "None" (neither title nor description will be displayed).
Adding Media Annotations
If the media you're adding has been annotated, the media reference options described above will also include options for displaying those annotations. Just below options for displaying the size, alignment and caption of the media object, you can select which annotations will display and which will be featured. Under “Annotations” click to select which annotations will appear when the media object loads on the page. Clicking the eye icon next to “Annotation Title” at the top will select and de-select all annotations in the list. Once, you’ve selected at least one annotation, you’ll also have the option, under “Featured annotation,” to choose which, of the annotations you selected above will be highlighted in blue below the media object.Let's take an example. You have an image for which you've created four separate annotations--that is, you've previously annotated the image by drawing out four separate areas to which you'd like to call your readers' attention. You'd like to discuss two of those annotations in one paragraph and the other two in a following paragraph. Simply add the media object to the first paragraph by selecting the relevant text and clicking the first media button; choose the size, alignment and caption for the media; select the two annotations you'd like to discuss; decide whether you'd also like either one of those annotations to be featured, to be highlighted in blue below the media object. Then do the same on the next paragraph, this time choosing the other two annotations.
One can also, by selecting no annotations, use the annotation display options to display a "clean" version of a piece of media that has been heavily annotated.
Reformatting Media
To change the size, alignment, caption, and annotation display options for media already added to a page, follow the steps below:For linked media: Click on the hyperlink for the linked media in the text editor and select the gear icon that pops up. Then change the setting in the media reference options.
For inline media: Click on the grey box for the media object and then select the gear icon that pops up. Then change the setting in the media reference options.
