Adding / Editing Content Form—The Detailed Explanation

There are a variety of types of content that can be added to the MMI site, including References, Opportunities, Events, and Pages. Each of these includes common elements, combined with elements unique to each type of content. To find explanation of the unique elements for each content type, see the Details links below.

Form elements that are flagged with a * in the form are required. You will not be able to submit the content until these elements are completed.

Header Fields

Title

The Title (which may have a more specific name, like "Metadata Reference Title") is the text that appears at the top of the page. Spaces, and a limited set of "special characters" (including & / ? - :) are allowed.

For example, the Title of this page is "Adding / Editing Content Form - The Detailed Explanation."

Short Name

The Short Name is used as the final part of the URL for the document. It should be all lower case alphanumeric (a-z, 0-9) characters, and not include spaces. Hyphens (-) are allowed but discouraged.

For example, the Short Name of this page is details. The complete URL for the page is http://mmiweb.mbari.org/help/content/details.

Short Description

The Short Description is the subtitle for the page. It is displayed in a bold font (slightly larger than body text) at the top of the page, and is often used for a 'hover tip' when the user's mouse is over a link to the page. This is a free-text field. It should be kept short, ideally within the space of the field, and should not simply repeat the Title. It may be blank if no further explanation of needed.

Categories Section

The Categories Section allows you to classify the content, according to a number of taxonomies. Two of these are required for MMI References; most of the others are recommended for most content.

Group Content Filing System

Use the Group Content Filing System to put a piece of content in the "Team Content" area of a specific Group. For more information about the Group Content Filing System, see see "Working in Committees and Groups."

References: Reference Type and Reference Topic

The MMI References require classification according to their major type (1 category only) and major topic (at least one category). These are used to drive most of the principal search categories on the site, so their selection is required.

Keywords

Use the keywords to describe the content that being submitted. Content on the MMI site is organized by descriptive metadata, which determines where a page will appear based on the assigned keywords. In many cases, keywords drive what is displayed in the menu items to the left.

Multiple keyword selections are allowed, and even encouraged. Please select all keywords that are appropriate to your content. For example, the Proposed Workshop Ideas is tagged with the following: Tutorial, Metadata Topics, MMI Hosted, MMI Led, Workshop.

Body (also called "Description" or "Metadata Resource Description")

The Body contains the actual content that is being submitted. By default, visitors to the MMI site will see a rich-text box in which the body is entered. The toolbar at the bottom of the Body box allows text formatting, alignment, bullet/numbering, and more.

To view and/or edit the HTML version of the content, click the "disable rich-text" link, or use the HTML button in the toolbar. If content has been generated using an HTML editor, such as Dreamweaver or PageBreeze, the code can be pasted into one of the HTML views of the Body section of the Add/Edit page form. The link directly below the body section toggles the rich-text editor on and off.

If formatted content was created in any other type of program, we recommend that the content be converted to "plain-text" or HTML prior to copying and pasting into the body section. Once plain text is pasted, apply the necessary formatting using the rich-text toolbar, or HTML codes.

What is the difference between the "disable rich-text" link and the HTML button?

Both options will open a HTML code editor. The "disable rich-text" link transforms the editing box in the Body section to an HTML code entry box. The "HTML" button opens the editable content, in HTML form, in a new window.

Note: In many browsers, the Body section is resizable. To make the window larger, click and drag the lower right corner (Resize ) to the desired size.

Reference URLs

Reference URLs are the primary location(s) where the referenced content, or information about it can be found. The first field (Title) is a short phrase describing the URL; the second field is the URL itself. It is important to distinguish in the Title the exact nature of the URL, in particular whether it is the home of the referenced item, or merely information about or related to the item.

Source URLs

The Source URLs describe where information was obtained to create this reference description. This is important to allow later verification of the information on the page.

MMI Doc Workflow Section

The workflow is the way documents are managed as they are created, reviewed, and published. Workflow settings are often assigned by default, but these settings can (and will) be modified during the editorial process.

Workflow Setting

The workfow setting establishes the visibility and characterization of the publication state. Depending on the user role, the type and publication state of content, not all settings will be available.

For more information on the MMI Workflow, see "Workflow: The MMI Editorial Process."

Comment

The comment section is an opportunity to provide more information for the reviewer or trashman. Comments are always encouraged, but they are particularly necessary in the following cases:

  • Request Deletion: In all cases where you are requesting content be removed from the site, please provide the trashman with a reason. For example, if the content includes questionable information, please point the trashman to the specific piece of questionable content.
  • Incorrect or Outdated Information: If you discover information that is incorrect or outdated, and you do not have the knowledge necessary to correct the information, please mark the content as "Visible to Members, Request Review", and point the reviewer to the flagged information.

Log Message

If a group of authors is collaborating on a particular piece of content, the Log Message is particularly useful. This section provides each author with an opportunity to communicate with the collaborative group.

Each log message will appear with the appropriate version of the content on the "Revisions" tab.

URL Path Settings

URLs are generally assigned automatically according to site-wide specifications, or manually using the URL Path dropdown options in the categories section of the page. There are some cases where these options do not provide the necessary URLs. In these cases, URLs can be assigned using the URL Path Settings text box, according to the URL Conventions in use on the site.

File Attachments

To add an image, or a non-webpage document to the content, use the File Attachments section.

To attach a file,

  1. Click the "File Attachments" link to expand the section
  2. Once expanded, click "Browse" to identiy the file to attach
  3. Click "Attach" to submit the file
  4. The File Attachments section presents three options for attached files:
    • Delete: This can be used to remove an attachment from the page. The removal will take place only after you click "Submit" to save the page.
    • List: By default, the system will list all attached files near the bottom of the page. Each file name will be an active link to the attached document.
    • Private: In rare cases, the attachments can be tagged as "Private," which means they are available only to those individuals with access to the node.
      Note: If widely available content links to a "private" attachment, the attachment is no longer private.
  5. Once the desired file is attached, the system displays the URL of the attachment. This URL can be used to insert a link, or an image into the body of the content.

Related Links

In each type of content, the Add / Edit Content page includes a placeholder for authors to include links to related content. These links can point visitors to content within the MMI site, or to content available on the web. The related links appear in a separate box at the bottom of the content once it has been published.

The Related Link section appears as a rich-text editor. Two elements are included in a related link:

  • Destination: can begin with http:// (external links), or it can begin with a / (content available on the MMI site).
  • Label: the text that appears as a link in the Related Links box.

To add a related link, insert the destination {space} label. For example, the OOSTethys project is included as a Related Link to this page. The syntax is
http://oostethys.org/ Sample Related Link: OOSTethys Project

Note: The Related Links section can be created or edited in rich-text, or HTML code.

Attachment: