DETAILS: REFERENCES, LANGUAGE, METADATA

6.5

ADAM and CMS: References

Thanks to hyperlinks, websites based on HTML work very well for references.

References to other pages

References to other websites, to online PDFs and to other pages within the same URL can all be entered as a normal link.


  • Place the cursor in the desired location or highlight the desired text element.
  • In the editor, click the link symbol.
  • Enter an external URL as the link destination or search the directory for an internal page.
  • Additionally, you should also enter a meaningful link title in the “Title” field, for example the name of the document you are linking. Without a link title, the screen reader will just read “link” without stating the link’s destination.
  • If you want to link to a download from your text – for example, to a PDF or an audio file – you should specify the change of format: “Read this text as an article (PDF, 4 MB)


Page-internal references

CMS and Typo3 allow you to link internally to headings on the same page.


  • Make sure your link destination is formatted as a heading.
  • Highlight the location where the link should appear and click on the link symbol above.
  • In the window that opens, in the left column, select the page where the link destination is located (i. e. the page you are already on) and click the small black arrow.
  • Click the heading you wish to link to in the drop-down list. The link will be set.


Languages

Every website has a primary language, which can be set on the back end of the CMS. This primary language applies to the entire website (all pages under a domain) or, in the case of multilingual websites, to all pages in the selected language. In Typo3 and Magnolia you can use the integrated translation options: the system will then automatically set the HTML settings correctly.

The lang attribute (<html lang="fr">) in the document header allows you to define a different language for individual pages. Consult your systems administrator if you have questions about this function. Sections of pages in other languages must be specified in the HTML code. However, on the University of Basel websites, manual code entry is disabled in Typo3 and Magnolia. On other websites, you can proceed as follows:


  • Click the HTML symbol <>.
  • Define the section language with this line of code:
    <p>The primary text is in English, <span lang="fr">mais ce passage est en français</span>.</p>.


Metadata

When setting up a new page or website, make sure to define URLs that are meaningful and not too long. And don’t forget to define a page title – it appears in the browser tab and will be read aloud by the screen reader.