1
2014-07-10T14:11:20-07:00
method=instancesof/path;methodNumNodes=23;
16
Embedding Third Party Material into a Scalar Page
The best way to embed a map, timeline or any other third party platform into a Scalar page is by using an iframe tag (<a href="http://www.w3schools.com/tags/tag_iframe.asp">read more about iframes here</a>). Here's how to do it.
<ol><li>Click <a href="media/edit%20button.PNG" resource="media/edit-button" rel="urn:scalar:version:205482" data-display-content-preview-box="true">edit at the bottom of the Scalar page</a> in which you wish to insert your map, timeline or other third party material.</li>
<li>Click the <a href="media/html%20Button.PNG" resource="media/html-tab" rel="urn:scalar:version:205483" data-display-content-preview-box="true">HTML tab</a> at the top of the page editor.</li>
<li>Find the url where the map, timeline or other material resides.</li>
<li>Paste the code below into the html editor, being sure to insert the url you have inside the quotation marks after src=. Also be sure to include http:// at the beginning of the url you're using. </li>
<b><iframe src="[your url]" frameborder="0" height="650" width="100%"></iframe></b>
</ol>Using your own url, your code should then look something like this:
<blockquote><b><iframe src="http://www.tiki-toki.com/timeline/embed/137152/4308693385" frameborder="0" width="100%" height="650" ></iframe></b>
</blockquote>And the page with embedded material should look like <a href="media/Tiki-Toki%20Embed.jpg" resource="media/example-of-timeline-embedded-into-a-scalar-page" rel="urn:scalar:version:205637" data-display-content-preview-box="true">this</a>.
<i><b>Frameborder</b></i> defines the width of the border around the material inside the iframe; a frameborder of 0 means there is no frame; a frameborder of N (frameborder="N") will place a border N pixels wide around the material.
<i><b>Width </b></i>sets the width of the material displayed. Width can be set to pixels or percentages. Setting the width to 100% (as in the example above) allows the iframe to expand to the maximum width allowed inside the main content area of a Scalar page.
<i><b>Height </b></i>sets the height of the material displayed. In the example above, we've set the height to 650 pixels.
Click below to see examples of Scalar pages with third party platforms embedded.
text
83788
2014-07-14T13:07:41-07:00
1
2014-07-01T12:00:54-07:00
method=instancesof/path;methodNumNodes=23;
3
Third Party Plugins and Platforms
In this section, you'll find a listing of third party plugins or platforms which we recommend for use within, or as an supplement to, Scalar projects.
plain
2014-07-05T20:12:32-07:00
1
2014-01-07T16:08:05-08:00
method=instancesof/path;methodNumNodes=23;
4
Scalar API JavaScript library reference
Information about objects, methods, and properties available in the Scalar API JavaScript library.
Note that this is not a complete list of methods and properties available in in the library; however, the items below are guaranteed to be available in the current version of the library for as long as it is supported.<div>
</div><div>If you’re looking for a simple “hello world” example, you can find it in the <a href="getting-started-with-the-scalar-api-javascript-library" rel="urn:scalar:version:103312">Getting Started</a> section.</div>
plain
2014-01-08T08:26:33-08:00
1
.code {
list-style-type: none;
margin: 0px;
padding: 0px;
}
.code li {
line-height: 0px;
white-space: pre;
tab-size: 2;
-moz-tab-size: 2;
-o-tab-size: 2;
-webkit-tab-size: 2;
text-indent: 0;
}
.code { counter-reset: li; }
.code li:before {
counter-increment: li;
content: counter(li) ". ";
background: #ececec;
border-right: 1px solid #cccccc;
color: #999;
display: inline-block;
font-family: Arial, Helvetica, sans-serif;
line-height: 24px;
margin-right: 20px;
padding-right: 5px;
text-align: right;
width: 35px;
font-size: 12px;
}
2014-01-06T15:12:12-08:00
method=instancesof/path;methodNumNodes=23;
37
Getting started with the Scalar API JavaScript library
A "hello world" example of working with the Scalar API JavaScript library.
<div>This “hello world” <a href="media/scalarapi_helloworld.js" resource="media/scalar-api-hello-world-example-code" rel="urn:scalar:version:103026">example</a> retrieves the node representing the home page of this User’s Guide and displays its title and content (view <a href="media/scalarapi_helloworld.html" resource="media/scalar-api-hello-world-demo" rel="urn:scalar:version:103113">demo</a>).</div><div>
</div><div>For a detailed explanation, follow the path below, or check out the <a href="scalar-api-javascript-library-reference" rel="urn:scalar:version:103239">API reference</a>.</div>
media
38861
2014-01-08T08:25:26-08:00
1
2013-07-24T13:31:01-07:00
method=instancesof/path;methodNumNodes=23;
6
Scalar API JavaScript library
Using Scalar's Javascript Library to access the RDF API
The Scalar API JavaScript library makes it easier to work with the Scalar API by providing an object model and a set of methods that perform most common API requests and tasks without requiring the developer to interact with raw RDF-XML or RDF-JSON. The library requires <a href="http://jquery.com">jQuery</a>.
plain
2014-01-07T18:07:11-08:00
1
2013-07-23T16:48:30-07:00
method=instancesof/path;methodNumNodes=23;
10
Custom Styling
Users who wish to change basic stylistic features of Scalar books can insert code from the sections below into the Custom Style field found in the Scalar Dashboard under the "Book Properties" tab.
plain
2013-09-02T13:30:08-07:00
1
2013-06-07T13:15:17-07:00
method=instancesof/path;methodNumNodes=23;
10
Working with the API
You can mashup your Scalar content with other data sources, build your own visualizations, or create completely new interfaces for your materials using <a href="media/feat_api_banner.jpg" resource="media/api-diagram" rel="urn:scalar:version:51266">Scalar’s built-in API</a>. All of the content from your project is available either directly via <a href="api-explorer--remote-access" rel="urn:scalar:version:51269">URL-based requests</a> which return data in <a href="rdf-syntax" rel="urn:scalar:version:51270">RDF-XML and JSON formats</a>, or through a<a href="api-helper-javascript-library" rel="urn:scalar:version:51275"> free JavaScript library</a> which creates a unified model of your downloaded Scalar data and makes it easy to access that data in a variety of ways, all while queueing requests and caching results.<p></p><p>This path will help you understand how to use the various capabilities of Scalar's robust API.</p>
media
12710
2013-09-13T13:32:12-07:00
1
2013-03-28T14:04:06-07:00
method=instancesof/path;methodNumNodes=23;
4
QuickStarts
A path of all QuickStart content in this user's guide.
This path gathers all of the QuickStart material from the entire user's guide in one place.
plain
2014-09-15T10:40:53-07:00
1
2013-03-27T17:47:31-07:00
method=instancesof/path;methodNumNodes=23;
1
Themes
A gallery of Scalar's built-in book themes.
This is a path of screenshots featuring Scalar's various book themes.
plain
2013-03-27T17:47:31-07:00
1
2013-03-27T15:59:58-07:00
method=instancesof/path;methodNumNodes=23;
4
Editing Pages
Explores the page editor in detail.
Creating a new page and editing an existing page (by clicking the "Edit" button at its bottom) both take you to the same place: the page editor. This path explains the page editor in detail.
plain
12696
2013-03-27T16:55:15-07:00
1
2013-03-27T10:45:43-07:00
method=instancesof/path;methodNumNodes=23;
8
Dashboard
Scalar's interface for accessing account- and book-level settings.
<p>The Dashboard provides access to account- and book-level settings and allows you to make quick changes to the status of any content in a book. Its functionality is spread across several tabs. To access the Dashboard, click the "Dashboard" link in the top-right corner.</p><p>If you have multiple books, you can select the book you want to work with from the drop-down menu at the top.</p>
plain
12801
2014-09-29T17:47:50-07:00
1
2013-03-27T10:41:27-07:00
method=instancesof/path;methodNumNodes=23;
3
Visualizations
Exploring the contents of a book visually.
<p>Scalar's visualizations enable you to see the contents of your book rendered in a variety of ways. Because each visualization can also be made the default view for a page, it's possible to integrate visualizations directly into your book. If you're working with structure in a way that's not immediately apparent at the page level, a visualization may be a good way to help readers conceptualize the "shape" of your content.</p><p>All visualizations have been created using the <a href="http://d3js.org/">D3.js</a> library.</p>
plain
12710
2013-03-27T17:12:18-07:00
1
2013-03-27T10:40:16-07:00
method=instancesof/path;methodNumNodes=23;
5
Advanced Topics
Exploring Scalar's more advanced features.
<p>In this section we'll cover some of Scalar's more advanced features.</p>
plain
2015-07-30T17:47:22-07:00
1
2013-03-27T10:30:01-07:00
method=instancesof/path;methodNumNodes=23;
2
Working with Structure
How to use Scalar's many options for structuring publications.
<p>A Scalar book is much more than a collection of discrete pages; it's the relationships between those pages and their media that ultimately give the book its shape. Scalar is flexible in the way it enables you to organize your content, taking the building blocks of online publishing (sequenced posts, tags, and more) and applying them in new ways.</p>
plain
2013-03-27T10:39:08-07:00
1
2013-03-26T12:54:31-07:00
method=instancesof/path;methodNumNodes=23;
3
Working with Content
Creating and editing content in Scalar.
plain
2013-03-27T16:00:44-07:00
1
2013-03-26T12:31:54-07:00
method=instancesof/path;methodNumNodes=23;
2
Annotating Media
Adding annotations to various media types in Scalar.
<p>Scalar enables you to add annotations to the following media types:</p><ul> <li>Images</li> <li>Audio</li> <li>Video</li> <li>Plain Text</li></ul><p>Scalar annotations are quite flexible, due to the fact that each annotation you create is also its own page, and like any Scalar page, can be tagged, added to paths, or even become a path or tag itself. Annotations can refer to multiple media files simultaneously, no matter what types they may be.</p>
plain
2013-03-26T12:45:31-07:00
1
2013-03-26T12:25:22-07:00
method=instancesof/path;methodNumNodes=23;
6
Importing Media from Non-Affiliated Archives
Bringing media into your book from services Scalar accesses via public API.
<p>Non-affiliated or "other" archives are web services with which Scalar has no official relationship, but uses public APIs to access. These include:</p><ul> <li>Prezi</li> <li>SoundCloud</li> <li>Vimeo</li> <li>YouTube</li><li>Metropolitan Museum of Art</li><li>The Getty Museum Collection
</li></ul><div>Let's explore how media can be imported from each of these sources.
</div>
plain
12690
2014-09-30T16:43:40-07:00
1
2013-03-26T11:33:02-07:00
method=instancesof/path;methodNumNodes=23;
7
Importing Media from Affiliated Archives
Bringing media into your book from archives with which Scalar has an official relationship.
<p>Affiliated archives are ones with which Scalar has an official relationship. They include:</p><ul> <li>Critical Commons</li><li>Cuban Theater Digital Archive</li> <li>Hemispheric Institute Digital Video Library</li> <li>HyperCities
</li><li>Internet Archive</li> <li>PLAY!</li> <li>Shoah Foundation VHA Online</li> <li>Shoah Foundation VHA (partner site)</li></ul><div>Let's explore how media can be imported from each of these sources.</div>
plain
12684
2015-11-25T18:42:32-08:00
1
2013-03-26T11:30:50-07:00
method=instancesof/path;methodNumNodes=23;
6
Importing Media from Online Archives
How to go about importing media from existing archives.
<p>Scalar has direct links with a number of scholarly and popular media archives, making importing media easy. To get started, make sure you're logged in to a book for which you have Author privileges, and thenclick the menu at the top of the navigation on the left side of the window and select "Import". Four options will be displayed:</p><ul> <li>Affiliated archives</li> <li>Other archives</li> <li>Local media files</li> <li>Internet media files</li></ul><p>Let's look at the first two of these options in turn.</p>
plain
12668
2013-03-27T13:17:58-07:00
1
2013-03-26T10:16:54-07:00
method=instancesof/path;methodNumNodes=23;
6
Developing a Media Strategy
Answering the four key questions about how you'll use media in your book.
<p>Scalar makes it easy to quickly start bringing media into your book and working with it. You can import from a variety of sources, reference, embed, and annotate to your heart's content, and we've spent a lot of effort in making all of Scalar's supported media types compatible with as many of the supported platforms as possible. There are exceptions and caveats, however, and if you're working with a large collection of media, media in a variety of formats, or need to ensure that your book will be accessible on specific platforms, then developing a <em>strategy</em> for the media in your book is essential. Writing a Scalar book makes you a publisher, and as such the responsibility for making sure the work you publish is as accessible as possible falls on you.</p><p>Every book has its own unique media requirements, but a solid media strategy will answer the same four questions no matter what the book. In this path, we'll tackle each of these questions in turn.</p>
plain
12668
2013-07-30T16:54:25-07:00
1
2013-03-26T10:14:28-07:00
method=instancesof/path;methodNumNodes=23;
8
Working with Media
How to get the most out of your use of media in Scalar.
<p>Scalar is designed to allow you to bring media seamlessly into your books for the purpose of presentation, discussion, and analysis. This path includes information that will help you get the most of your use of media in Scalar.</p>
plain
2014-08-19T15:46:30-07:00
1
2013-03-26T09:35:33-07:00
method=instancesof/path;methodNumNodes=23;
5
Getting Started
Explains account and book creation, and some interface basics.
<p>Welcome to Scalar! This path will help get you up to speed with creating a Scalar account, creating your first book, and learning the basics of the Scalar interface.
</p>
plain
2014-09-25T20:22:55-07:00
1
2013-03-26T09:32:14-07:00
method=instancesof/path;methodNumNodes=23;
25
Welcome
Introduction to the User's Guide
<p>Scalar is a free, open source publishing platform that’s designed to make it easy for authors to write long-form, born-digital scholarship online. Scalar enables users to assemble media from multiple sources and juxtapose them with their own writing in a variety of ways, with minimal technical expertise required. Scalar also gives authors tools to structure essay- and book-length works in ways that take advantage of the unique capabilities of digital writing, including nested, recursive, and non-linear formats. The platform also supports collaborative authoring and reader commentary.</p><p>This user's guide includes introductions to Scalar's features as well as more in-depth material to explore as your get to know the tools. If you're familiar with blogging platforms like WordPress you'll find yourself at home with many of Scalar's editing features, though you can also do things with Scalar that would be next to impossible in a typical blog.</p><p>If this is your first time using Scalar, head down the <a href="getting-started" rel="urn:scalar:version:36820">Getting Started</a> path to acquaint yourself with the basics. If you're in a hurry, you can explore a special path that gathers all of Scalar's <a href="quickstarts" rel="urn:scalar:version:37127">QuickStart</a> documentation in one place. If you're embarking on a large project, we highly recommend you read through the sections on <a href="working-with-media" rel="urn:scalar:version:36835">Working with Media</a>, <a href="working-with-content" rel="urn:scalar:version:36909">Working with Content</a>, and <a href="working-with-structure" rel="urn:scalar:version:36917">Working with Structure</a> to familiarize yourself with all of Scalar's capabilities as well as some important considerations for using media in your book. The <a href="advanced-topics" rel="urn:scalar:version:36940">Advanced Topics</a> section dives into some useful features for those who want to dive a bit deeper into the platform. Finally, the <a href="http://scalar.usc.edu/works/guide/custom-styling">Custom Styling</a> section shows you how to tailor basic stylistic features of Scalar projects, like font size and background color. </p><p>Welcome to Scalar!</p>
plain
2015-02-03T05:06:44-08:00