LearnPress Publication Guide » Publishing how-to

1.5 Linking within LearnPress

LearnPress version: 1.5

Last modified: 21 December 2007

Creating in-line links

Linking to a LearnPress page

When creating an in-line link from one LearnPress page to another, it isn’t necessary to use an <a href> tag or to specify an entire URL. For one thing, that takes time. For another, if the LEARN website is redesigned or reorganized, hardcoded <a href> tags would result in countless broken links. Instead, find the LearnPress ID of the page to which you’d like to link and use the code:

<a rel="page" id="960">

This will ensure healthy links for as long as LearnPress exists, no matter what may happen to LEARN’s URLs in the future.

Linking to a page in the context of a LearnPress edition

By default, linking to a page using <a rel="page" id="960"> will take you to the standard LearnPress display of that single page. You can also link to a LearnPress page within the context of a particular edition. So:

<a rel="page" id="960">Mrs. B.F. Stayley</a> links to page 960 by itself, whereas

<a rel="page" id="960" edition="52">Mrs. B.F. Stayley</a> links to pgae 960 where it appears in the Tobacco Bag Stringing edition.

Linking to a LearnPress edition

You can also link to an entire edition, by specifying either the numeric edition id or the edition key. Use the code:

<a rel="edition" id="68">

OR

<a rel="edition" id="oralhistory2002">

Creating links using the LearnPress Links function

The Links function creates links in the sidebar of a LearnPress page, under a Links heading. LearnPress allows you to link a page to another page, a page to an edition, or an edition to an edition. Please link carefully. When too many links appear in the sidebar, they are all typically ignored.

Linking from a page

• Find the “Links” heading on the page record and click Create new link.
• Enter the page id, chapter id, media id, or edition id in the appropriate field.
• The advanced section of the form allows you to specify how the items being linked are related to one another.
  • The “rel” field specifies what the page being linked is, in relation to the page being edited. (Options include lesson plan, primary source, teacher guide, etc.) Selecting a relationship in the “rel” field will cause the relationship to appear on the page with the link. For example:
    

    Primary source: Tobacco bag stringing: Life and labor in the Depression.

    Leaving the “rel” field blank will cause the link to be displayed without a relationship specified.

  • The “rev” field specified what the page being edited is, in relation to the page being linked. Selecting a relationship in the “rev” field will cause a link to appear from the other page to the page being edited. Leaving the “rev” field blank will create a link from the page being edited, but will not create a reverse link from the page being linked.

Linking from an edition

Linking from an edition to a page or another edition works much the same as linking from a page. One important difference: Even if you specify a relationship in the “rev” field, a link will NOT display from the other edition to the one from which you’re linking. If you’d like to create a reverse link from that edition to this one, you’ll need to make a link from the record of that edition.

Notes

• Don’t go around linking willy-nilly. Consider the person using the page. Is there a related resource she would likely want to know about, such as a lesson plan that uses the resource at hand?