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 want to link and then using the first blue media button
seen at the top of the text editor in its Visual mode. 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 promted 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), 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. For example, if the image you're adding has ten annotations (ten bounded areas with commentary) you can choose to have none of those annotations display, all of them display or any combination of those ten annotations display.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.
