Guide to the Ad fontes Editorial Environment

Thank you for your interest in Ad fontes. On the following pages, you can learn how to use the editorial environment for the site, so that you can make your own interactive exercises. The environment permits faculty, institutions, and other interested parties to create their own content for Ad fontes.

The Ad fontes backend can be used to edit all pages on the site, and access is therefore partially limited for authors of exercises. If you would like to contribute content, please get in touch with the Ad fontes staff beforehand:  //'; l[1] = 'a'; l[2] = '/'; l[3] = '<'; l[4] = '|104'; l[5] = '|99'; l[6] = '|46'; l[7] = '|104'; l[8] = '|122'; l[9] = '|117'; l[10] = '|46'; l[11] = '|116'; l[12] = '|115'; l[13] = '|105'; l[14] = '|104'; l[15] = '|64'; l[16] = '|115'; l[17] = '|101'; l[18] = '|116'; l[19] = '|110'; l[20] = '|111'; l[21] = '|102'; l[22] = '|100'; l[23] = '|97'; l[24] = '>'; l[25] = '"'; l[26] = '|104'; l[27] = '|99'; l[28] = '|46'; l[29] = '|104'; l[30] = '|122'; l[31] = '|117'; l[32] = '|46'; l[33] = '|116'; l[34] = '|115'; l[35] = '|105'; l[36] = '|104'; l[37] = '|64'; l[38] = '|115'; l[39] = '|101'; l[40] = '|116'; l[41] = '|110'; l[42] = '|111'; l[43] = '|102'; l[44] = '|100'; l[45] = '|97'; l[46] = ':'; l[47] = 'o'; l[48] = 't'; l[49] = 'l'; l[50] = 'i'; l[51] = 'a'; l[52] = 'm'; l[53] = '"'; l[54] = '='; l[55] = 'f'; l[56] = 'e'; l[57] = 'r'; l[58] = 'h'; l[59] = ' '; l[60] = 'a'; l[61] = '<'; for (var i = l.length-1; i >= 0; i=i-1) { if (l[i].substring(0, 1) === '|') document.write("&#"+unescape(l[i].substring(1))+";"); else document.write(unescape(l[i])); } //]]> ">.

All newly created content will be marked as being by the person or institution responsible for its creation (designated in the "suggested citation" field). It will be kept under a free licence, either CC-BY or CC-BY-NC (always the newest version, currently 4.0).

Ad fontes content will be associated with a stable link that you can use and share. Ad fontes administrators determine how content will be incorporated with the rest of the project. If there is a disagreement, the "Digital Teaching and Research" ( //'; l[1] = 'a'; l[2] = '/'; l[3] = '<'; l[4] = '|104'; l[5] = '|99'; l[6] = '|46'; l[7] = '|104'; l[8] = '|122'; l[9] = '|117'; l[10] = '|46'; l[11] = '|108'; l[12] = '|105'; l[13] = '|104'; l[14] = '|112'; l[15] = '|64'; l[16] = '|102'; l[17] = '|108'; l[18] = '|100'; l[19] = '>'; l[20] = '"'; l[21] = '|104'; l[22] = '|99'; l[23] = '|46'; l[24] = '|104'; l[25] = '|122'; l[26] = '|117'; l[27] = '|46'; l[28] = '|108'; l[29] = '|105'; l[30] = '|104'; l[31] = '|112'; l[32] = '|64'; l[33] = '|102'; l[34] = '|108'; l[35] = '|100'; l[36] = ':'; l[37] = 'o'; l[38] = 't'; l[39] = 'l'; l[40] = 'i'; l[41] = 'a'; l[42] = 'm'; l[43] = '"'; l[44] = '='; l[45] = 'f'; l[46] = 'e'; l[47] = 'r'; l[48] = 'h'; l[49] = ' '; l[50] = 'a'; l[51] = '<'; for (var i = l.length-1; i >= 0; i=i-1) { if (l[i].substring(0, 1) === '|') document.write("&#"+unescape(l[i].substring(1))+";"); else document.write(unescape(l[i])); } //]]> ">) section of the University of Zürich Philosophy Department can serve as mediator.

If your project cannot be fit to one of the existing exercise types, it is possible to create an "open exercise." Doing so requires experience working with JavaScript, so please contact the Ad fontes staff.

In the WYSIWYG editor, you can create content for standard pages, such as introductions or solution pages. 

The corresponding pages will be uploaded by the Ad fontes team to the site map, where they can be filled with images, texts, and links. You can also add bullets and numbered lists to improve the visual layout.

You may also translate already existing pages in Ad fontes or create versions of your own content in other languages (DE, EN, FR). You can select the language from the drop down menu at the top of the page.

Please note: Translations of the same page do not have to match exactly. National preferences for style or use can be taken into account.

In the page tree, select the relevant page and click on the tap labeled "Seiteninhalt." You should now be able to enter content into the WYSIWYG editor.

Translations of interactive exercise (such as transcription exercises) are also possible, and these can be accessed through the "Exercises" section.

You can create your own Ad fontes content (except for interactive exercises). To do so, please contact the Ad fontes team with the following information:

• A description of the content
• Where you think the new page or pages should be placed (for example, "in Tutorials - Describing Manuscript Sources, after Seals")
• The number of anticipated pages
• Suggested images
• When the pages should be published

The team will respond as soon as the pages are prepared and can be filled out.

Creating a Multiple-Choice Exercise

Please contact Ad fontes with as much of the following information as possible:

• A description of the exercise and type of source
• What skill or proficiency is being tested
• Number of planned sections or questions
• Possible illustrations for the exercise
• When the page(s) should be published

The team will upload the exercise as a shell with filler text that you can complete. You will also receive dedicated page numbers for the different parts.

When the page is uploaded and you're ready to fill in the content, click on the “exercises” (“Übung”) page from menu in the backend and select “multiple-choice exercise” (“Multiplechoice-Übung”). Look for your exercise in the list and click on the pencil on the right side. Enter instructions for the exercise, and you can also add an introduction and an image. The document must then be saved. After you save, there will be a “+” button under the field for the exercise instructions. Click on it to add questions to your exercise. Using the “+” button under the questions field, you can add the multiple-choice answers for each question. It’s also possible to add feedback text when wrong answers are selected. Mark which fields contain the correct answers, then select “save and close” (“speichern und schliessen”).

Making a Text-Entry Exercise

Please contact Ad fontes with as much of the following information as possible:

• A description of the exercise and type of source
• What skill or proficiency is being tested
• Number of planned sections or questions
• Possible illustrations for the exercise
• When the page(s) should be published

When it’s ready, click on the “exercises” (“Übung”) page from menu in the backend and select “text-entry exercise” (“Texteingabe-Übung”). Look for the template we created for your exercise in the list and click on the pencil on the right side. In the given fields, enter instructions for the exercise, and you can also add an introduction and an image. Then, click on the “+” button next to “question/task block” (“Frage-/Aufgaben- Blöcke”). In the text field “label,” you can define the questions or topics that you’re looking for responses to. In the “answer” (“Antwort”) field under “label,” you can enter the various answer options. The number of “question/task blocks” and the number of “labels” is up to you.

Finally, click “save and close” (“speichern und schliessen”).

Making a Drag & Drop Exercise

In the site backend menu, click on “Exercises” ("Übungen") and select “Drag & Drop” ("Drag & Drop"). Look for the template created for your exercise by the Ad fontes team and open it by clicking on the pencil to the right.

Fill out the relevant text fields (“introduction,” etc.), and you can also upload an image of your choice for the introductory page if you wish.

When you’ve filled out the text fields, save the exercise by clicking the save button (“Speichern”), then select “Drag & Drop Elements” (“Drag & Drop Elemente”) in the menu list.

Click on the “+” button to create a field with the title “Drop Area” (“Drop-Bereich”). Here, you can enter a title for the drop area and/or upload an image caption. Then, select the “+” button within the “Drop Area” (“Drop-Bereich”). This will create a corresponding enty field into which you can put a “Drag Text” entry and/or and image. It is possible to associate several “drag elements” with a single “drop field.”

You can make additional “drop fields” by clicking the “+” button under the menu list.

Creating a Mixed Exercise

Please contact Ad fontes with as much of the following information as possible:

• A description of the exercise and type of source
• What skill or proficiency is being tested
• Number of planned sections or questions
• Possible illustrations for the exercise
• When the page(s) should be published

The team will upload the exercise as a template with filler text that you can fill out. You will also receive dedicated page numbers for the different parts.

When it’s ready, click on the “Exercises” (“Übung”) page from menu in the backend and select “Mixed Exercise” (“gemischte Übung”). Look for your exercise in the list and click on the pencil on the right side. Provide instructions for the exercise, and you can also add an introduction and an image. The document must then be saved. After you save, there will be two fields under the text field for the exercises instructions. You can use them to create multiple-choice questions or text-entry questions. Select which you want to make by clicking on the “+” button. The subsequent steps will depend on the exercise type (see the instructions for the relevant exercise type).

Finally, select “Save and Close” (“Speichern und Schliessen”).

The site map shows all the pages that make up the content of Ad fontes. The content of a single site can be brought up in the site map as well. To get to the site map, click on “Pages” (“Seiten”) in the main navigation list.

After clicking on the pencil, select your stage in the working process. There are three tabs you can use:

• Basic settings: The Ad fontes team will maintain this content
• Page Content: Here content can be added, edited, or translated. For translations, see the instructions below.
• Page Display: Here you can change the appearance of the page. It will open a new tab in the browser with the page as it appears from the frontend.

Translations

Translations can be entered directly under the “Site Content” tab. The correct language must be selected (from the menu on the top right) before the translated text can be entered.

WYSIWYG-Editor

Im WYSIWIG-Editor können die Inhalte von normalen Seiten wie Einführungs- oder Erklärungsseiten erfasst werden.

Die entsprechende Seite wird durch das Ad fontes Team im Seitenbaum bereitgestellt und kann mit Bildern, Textinhalten und Verlinkungen befüllt werden. Zur besseren Übersicht können Sie Aufzählungszeichen und Zwischentitel markieren.

Edit Help Pages

Other script types, license types, institutions, languages, and levels can be accounted for in the Help Pages. The help page can be found in the site map under “Training.” After the kind of entry (script type, license type, etc.) is selected, it can be linked to the main page using the plus on the right. The entry should thus be linked directly to the relevant table.

You can insert images through transcription exercises or in the WYSIWIG Editor. Select in the menu list upload template (“Vorlage einfügen”). Add then an image caption below and any following running text, if necessary. Click on the example image and select “upload/edit image” (“Bild einfügen/bearbeiten”).

Upload Image

You can then return to the file manager via “source” (“Quelle”). Select the section of the site in which your entry can be found, click on the menu list on “upload” (“Hochladen”) and “add file” (“Datei hinzufügen”). Then you can find the uploaded image in the file explorer.

Editing Image Info

If you hover your cursor over the image, a pencil should appear in the lower half. Click on it to edit the image data. The name should begin with the dedicated page number that we gave you followed by a short name in lower case letters with words separated by underscores.

Inserting Images

Select the picture and confirm your choice by clicking “ok.”