Launch HyperCities

Archive for August, 2010

Many users compose descriptive text in another program and then copy and paste it into HyperCities. This is actually a good option, because it allows you to do multiple drafts of the text before displaying it in HyperCities. If you do this, though, it’s best to use a plain text editor like Notepad (Windows) or TextWrangler (Mac), and do your formatting using the HyperCities editor, unless you know HTML. Avoid word processing programs like Microsoft Word; Word generates HTML that looks strange in HyperCities, so HyperCities edits most of this formatting out. In other words, doing the formatting in HyperCities saves you time.
If you would like to write your own HTML, here are some guidelines:
  • Only use tags that normally appear in the <body> portion of an HTML document. Anything in the <head> portion is discarded.
  • Use inline styles. CSS blocks (<style> tags) are removed by HyperCities for appearance and security. In the past, some cut-and-paste text from Word has changed the entire appearance of HyperCities because of conflicting style names or styles applied globally to all tags, e.g. <p>.
  • Links in HyperCities always open new windows. Anchor tags do not work in HyperCities content.
  • Clicking on images in HyperCities always opens them in our special photo viewer, which allows a user to see them in a larger size.
  • The following tags will be filtered out, and everything inside of them will be removed:
    • <head>
    • <script>
    • <style>
    • <iframe>
    • <form>
    • <input>
    • <select>
    • <blink>
  • For security reasons, all Javascript is filtered out.

How to Create an Object

by | August 19, 2010 | In How To No Comments

On the upper left corner of Hypercities, click on the “Add Media” button. Clicking it shows the three types of objects that HyperCities allows: points, lines, and polygons.
<img class="alignnone size-full wp-image-360" src="” alt=”add buttons2″ width=”500″ />

A point is just a single place on a map, which can be represented by an (x,y) coordinate pair.

A line is used to trace a path. It can contain many vertices, and can be used to form shapes.

A polygon is a shape. Clicking inside a shape activates the polygon; this is the difference between a polygon and a line. Clicking inside a closed line does not activate the info bubble for that object. Clicking inside a polygon does.

Once you have chosen what kind of object you want to create and its location, you will see the “Add Media” frame on the right.


Here you can set the title of your object, timespan,  license, and description of the object.

Author name is automatically filled in from the nickname you supplied when you registered. The author name can be changed individually for any object.

To set the time, you can type the year, month and date by either clicking on the fields or tabbing between them. You can also use the arrow keys to change these numbers. Typing “-” (the minus sign) toggles between “BCE” and CE (when “BCE” is not displayed). The date on the right must always be later than the date on the left; HyperCities will prevent you from entering an end date earlier than the start date, and vice versa.

The description field allows rich formatted text. To edit the HTML source, click on the “HTML” icon.

A note: many users compose the descriptive text in another program and then copy and paste the text into HyperCities. If you do this, it’s best to use a plain text editor like Notepad (Windows) or TextEdit (Mac), and do your formatting in HyperCities itself, unless you know HTML. Avoid word processing programs like Microsoft Word; Word generates HTML that look stranges when it is displayed in HyperCities. HyperCities also edits out some formatting that Word puts in, so generally, it’s best to write the text in Notepad (or TextEdit), without formatting, and use HyperCities to do the formatting. The HyperCities text editor is WYSIWYG (what you see is what you get).

Add images by clicking the “Insert/Upload Image” icon. Videos, however, must be hosted on other video websites such as YouTube, Vimeo, etc., and they can be embedded on Hypercities by copying and pasting the embed code from the hosting service.

To display base maps with your object, click on the “Select Base Map” button. This shows a list of maps that are visible in the current viewport and timespan. To select a map, just click on it. Use the “x” near the map to remove it.


If you want other objects to show up with your object, click on the “Select Other Items” button. You can use this window just like the regular collection list. Just check the items on that you want to appear.


Once you’re done, save your object by clicking “SAVE” on the lower right corner.

Click here to see how to add your object in a collection.

This tutorial is about creating a new collection and editing an already

existing collection or a new one.


  • Creating a New Collection

Creating a new collection requires you to go to the add media interface.


At the bottom of the “add media” frame, click the “My Collection” box and click on “Create New.”


Type in the desired new collection name, and click OK.
create collection name


Once you click OK, your collection will be inside “My Collections.”


  • Editing a Collection

To add your collection into an already existing collection, edit your collection by viewing it in Narrative mode. To do this, click on the Narrative Mode Button.


In the Narrative Mode, you will see different options such as “Expanded View,” List View,

” “Edit Collection Info,” and “Delete Collection.” To edit the collection, click the “Edit Collection Info” button.


Click “My Collection” box at the bottom of the “Edit” frame. Then search for and select the name of the collection you want to put your new collection into.


Click SAVE and your new collection will be added automatically into the collection you just selected.