Writing and Naming the Content

Writing a Content Snippet

By snippet we mean a content page or slide explaining the grammar of a particular section. Grammar textbooks used:

• Hansen&Quinn's "Greek: An Intensive Course" for the English explanations.
• the Italian "Il nuovo Lingua Greca: Teoria" by Bottin&Quaglia&Marchiori for the tables (not available online).

The challenging part is condensing all relevant info into one digestable snippet, while keeping the tone informal and upbeat. If you wish to add a new content snippet:

• Log into Ancient Geek Admin.
• Click on Contents in the sidebar.
• Click on Add Content (top right).
• Fill in the box with your content in a Markdown format.

In addition, you will have to:

• Select a target and source language (for example: Target -->Ancient Greek, Source -->English).
• Pick a Grammar Topic from the list (if you can't find the topic you want, read below about how to add a new Grammar Topic).
• Pick Related Content. These are snippets that will appear in the UI below the page that you are creating.
• Give the slide a Title that is coherent with all the others. See format below.

IMPORTANT: Make sure there is ONLY ONE content snippet pointing to ONE grammar topic.

Naming a Content Snippet

Some examples below of the method chosen to name the snippets. Notice how they all start with the Category (Verbs, Nouns, Adjectives, Adverbs, Diacritics, etc), then they have the specific Grammar Topic (First and Second Declension, Third Declension, Future Indicative Active, etc) and sometimes, in brackets, any necessary subdivisions. Remember that the order should be coherent throughout:

• Nouns: First Declension.
• Adjectives: First and Second Declension or Adjectives: First and Second Declension (Two-ending).
• Verbs: Present Indicative Active.
• etc...

Creating a new Grammar Topic

The Grammar Topics are the most important part. They connect the Content with the Exercises. A mistake here would mean that the user is looking at the wrong grammar explanations for the questions he/she is being asked. It's important that the grammar reference (Smyth) and the API query are correct.

• Log into Ancient Geek Admin.
• Click on Grammar Topics in the sidebar.
• Click on Grammar Topic (top right).
• Insert a grammar reference (e.g. s123) (For more info go back to the main menu and select "How to make a Grammar Reference and why?").
• Insert the matching grammar reference URL (e.g. here) (also explained in "How to make a Grammar Reference and why?").
• Add a query string (e.g. pos=adj&posAdd__contains=os_h_on) (For more info go back to the main menu and select "How to write an API query?").
• Write a Title. An example of the format: Adjectives - Three-termination or Nouns in Ancient Greek - Case.
• Select a Category from the dropbdown menu. If you can't find the category you want, create a new one.

Creating a new Category

Categories are connected to Grammar Topics, which in turn are connected to Content. The Category determines what the unit will look like. To add a new category:

• Log into Ancient Geek Admin.
• Click on Categories in the sidebar.
• Click on Add Category (top right).
• Add the Category name.
• Add the path of the image file you wish to have on your unit.

How will it all appear in the UI?

What you will see in the LEARN section of the UI is:

• a series of boxes named with the titles of grammar topics
• when you click on the box, you will see exercises for the user and on the left the related grammar content in a vertical sidebar. The top title will be the main content for that topic.
• the titles following the main grammar topic are the Related Content

Making changes to the Content or Grammar Topic directly from the UI

It is possible to make changes to the Content and Grammar Topic directly from the UI. In each sidebar there are two clickable options at the top: "Content" and "Grammar Topic", which are hot links that redirect you to the right place in the admin panel.