Наръчник по дигитална епиграфика

Следният документ съдържа материали в помощ на участниците да се подготвят за работилницата по дигитална епиграфика, организиран от проекта PROMETHEUS – Популяризиране на универсални ценности чрез дигитална епиграфика и културно наследство в рамките на 5 работни дни, между 15 и 19 април 2024 г. в платформите Ζoom и YouTube.

Работилницата е предназначена за членове на проекта и външни участници, GLAM професионалисти, изследователи и студенти, участващи в управлението и курирането на епиграфското наследство в страните партньори. Обучителни сесии и лекции ще бъдат изнесени от членове на екипа на проекта и гост-лектори.

Необходими са познания по старогръцки и латински за участие в EpiDoc частта на семинара.

Изисквания

От участниците не се изисква да имат предишни познания по TEI-XML или други технологии, които ще бъдат преподавани по време на курса на семинара. Изисква се обаче те да подготвят необходимото оборудване и софтуер, за да могат ефективно да участват в епиграфско обучение, който включва практически занятия.

1.1 Оборудване

Необходима екипировка:

Компютър със стабилна интернет връзка.

Допълнително оборудване:

Ако имате възможност, може да е полезно да имате два екрана, един за следене на програмата и друг за практически упражнения.

1.2 Софтуер и акаунти

Изисква се участниците да инсталират предварително софтуер и да отворят акаунти, които ще се използват за практическа практика по време на семинара.

1.2.1 Софтуер

Oxygen XML Editor

Oxygen XML Editor е софтуерен инструмент, който ви помага да работите с XML файлове. XML е вид маркиращ език, използван за структуриране на данни. Участниците ще имат нужда от този софтуер, за да се научат как да кодират надписи в EpiDoc XML.

❗❗❗ Участниците трябва да инсталират Oxygen XML Editor преди работилницата. ❗❗❗

Инсталация:

Отидете на oxygenxml.com

●Изтеглете и инсталирайте версията на Oxygen XML Editor, подходяща за вашата операционна система (Windows, MacOS и др.)

Стартиране

●За да стартирате приложението, отворете Oxygen 26.1.exe или oxygen.bat от директорията за инсталиране на продукта.

Лицензи:

●Изберете безплатен 30-дневен демо лиценз ТУК
●Изберете академичен лиценз.
●Копирайте в клипборда лицензния ключ, който сте получили по имейл, и го поставете в диалоговия прозорец за регистрация на лиценз от приложението.

Ако имате затруднения с инструкцията, гледайте видеоклипове за това как да инсталирате Oxygen на Windows 10 и MacOS

EFES (EpiDoc Front End Services)

EFES е безплатна, лесна за използване фронт-енд платформа с възможности за персонализация за онлайн публикуването на антични текстове в EpiDoc XML. Разработен е през 2017-2018 г. от екип от експерти (Габриел Бодар, Джейми Нориш, Полина Йорданова, Симона Стоянова). EFES позволява създаването на множество индекси, интерфейс за търсене и преглеждане, географска визуализация и интеграция със свързани отворени данни. По време на работилницата участниците ще бъдат обучени как да използват EFES.

❗❗❗ Участниците трябва да инсталират EFES преди работилницата и да се опитат да стартират програмата, следвайки инструкциите ❗❗❗

https://github.com/EpiDoc/EFES/wiki/Installation

https://github.com/EpiDoc/EFES/wiki/User-Guide#quickstart

Проверете дали имате инсталиран Java 8 (поне).
Вземете софтуера EFES: можете или да изтеглите ZIP от https://github.com/EpiDoc/EFES/archive/master.zip или клонирайте от Github, ако вече имате акаунт.
Когато ZIP файлът бъде изтеглен,разархивирайте го в директория (напр. на вашия работен плот), като промените името на папката от „EFES-master“ на „EFES“.
Отворете вашия команден промпт/терминал:
1. a.Windows: в полето за търсене в менюто "Старт" въведете: cmd
2. b.GNU/Linux или Mac OS X: в полето за търсене в лентата с менюта отгоре напишете: terminal
Стартирайте процеса на изграждане на EFES, като отидете до вашата папка EFES (a) и след това стартирате скрипт, който ще стартира Jetty, лек уеб сървър, предварително конфигуриран да изпълнява всички компоненти на EFES (b):
1. a.Windows:
  1. i.отидете във вашата папка EFES, като въведете следната команда и след това натиснете Enter: cd Desktop\EFES
  2. ii.въведете следната команда и след това натиснете Enter: build.bat
2. b.GNU/Linux или Mac OS X:
  1. i.отидете до вашата папка EFES, като въведете следната команда и след това натиснете Enter: cd Desktop/EFES
  2. ii.въведете следната команда и след това натиснете Enter: sh build.sh
  3. iii.
Отворете браузър и отидете на http://127.0.0.1:9999/. Трябва да показва страница за добре дошли заедно с елементарна навигация.
Съхранявайте XML съдържанието на проекта (EpiDoc файлове) в папката /webapps/ROOT/content/xml/epidoc/.
Индексирайте новодобавените файлове през Административния панел на сайта.
Вижте HTML версиите на вашите XML файлове наhttp://127.0.0.1:9999/en/inscriptions /.

Това ръководство за инсталиране заедно с някои възможни проблеми за отстраняване на неизправности можете да намерите на:

https://github.com/EpiDoc/EFES/wiki/Installation

AIAX PORTABLE

AIAX е фронт-енд платформа, изработена за целите на проекта Telamon. По своите функции за визуализация и индексиране е аналогична на EFES. Техническата ѝ реализация обаче е различна, тъй като се осъществява с помощта на SQL база данни, съхраняваща елементите, атрибутите и стойностите на XML кода на отделните файлове и обработваща ги с помощта на PHP.

По време на работилницата участниците ще имат възможност да бъдат обучени да използват AIAX.

❗❗❗Моля те,отворете и стартирайте приложението поне веднъж преди семинара ❗❗❗

За да изтеглите локалната версия на софтуера AIAX, моля, следвайте тези инструкции:

1. Отворете вашия уеб браузър и отидете на следния URL адрес:

https://telamon.uni-sofia.bg/bg/page/project

2. На уеб страницата намерете връзката за изтегляне на софтуера AIAX. Показва се на видно място в секцията „Тествайте“ (Τest it). Кликнете върху връзката за изтегляне, за да започнете процеса на изтегляне.

3. След като изтеглянето приключи, отидете до папката, където е записан изтегленият файл.

4. Намерете изтегления файл, който е компресиран (напр. ZIP файл). Щракнете с десния бутон върху файла и

изберете „Разархивиране“, за да разархивирате съдържанието на файла.

5. След като извлечете съдържанието, отворете папката с име “AiaxTelamonPortable”.

6. В папката трябва да намерите изпълним (.exe) файл с име “Telamon”;. Това е основният изпълним файл за софтуера AIAX.

7. Щракнете двукратно върху изпълнимия файл “Telamon”, за да стартирате софтуера AIAX.

8. Щракнете върху „Разрешаване“ в диалоговия прозорец на сървъра на Apache, след което щракнете върху „Разрешаване“ в диалоговия прозорец на mysql.

9. Вече имате работеща локална версия на софтуера AIAX, можете да започнете да използвате софтуера за желаните от вас задачи.

Ако срещнете някакви проблеми по време на процеса на инсталиране или стартиране, моля, уверете се, че на вашият компютър портовете не са заети и затворете всички ненужни програми, които работят във фонов режим. Можете да се обърнете към това ръководство по въпроса как ефективно да затворите работеща програма:https://www.thewindowsclub.com/how-to-close-running-apps-on-windows-11-10

Това може да помогне за разрешаване на потенциални конфликти и да осигури гладка работа на софтуера.

Следвайки тези стъпки, трябва да можете да изтеглите и инсталирате локалната версия на софтуера AIAX на вашия компютър. Ако срещнете допълнителни проблеми, моля, вижте Кратко ръководство за USBWebserver в папката “AiaxTelamonPortable” или се свържете с организаторите за съдействие.

1.2.2 Създаване на акаунти

Участниците трябва да създадат акаунти в следните платформи:

GitHub

Участниците трябва да създадат хранилище в GitHub преди следобедната сесия във вторник, 16 април.

GitHub е платформа за съвместна работа, използвана за хостване и сътрудничество по проекти за разработка на софтуер. GitHub позволява на разработчиците да споделят, преглеждат и управляват промените в кода ефективно, което го прави популярен за проекти с отворен код.

Zenodo

GitHub акаунт може да се използва и за Зенодо, благодарение на интеграцията между две платформи. Можете също да създадете отделен акаунт в Zenodo.

Zenodo е хранилище с отворен достъп, разработено от CERN (Европейска организация за ядрени изследвания), за да улесни споделянето и архивирането на изследователски данни. Той предоставя на изследователи, проекти и институции платформа за съхраняване и споделяне на различни видове изследователски резултати.

Zotero

Zotero е безплатен софтуер за управление на библиографски препратки с отворен код, който помага на изследователите да събират, организират, цитират и споделят изследователски материали като статии, книги, уеб страници и др. Използва се широко за академично писане и изследвания. В този семинар участниците ще научат как тази платформа може да се използва за дигитални проекти.

2. Обучителни материали

Онлайн документи, които често ще правите справки по време и след семинара:

EpiDoc Guidelines 9.6

Leiden и EpiDoc (по-кратка)
Structure of an EpiDoc edition

3. Надписи за упражнение

Тъй като това е обучителен семинар, който включва практически тренинг по кодиране в EpiDoc XML, ще ви трябват надписи, които да използвате за практиката. За предпочитане е да използвате собствен материал за упражнение.

Ако обаче нямате собствен материал, можете да изберете надписи от онлайн бази данни:

Можете също така да използвате и приспособите материал от една от базите данни на EpiDoc, напр.

Telamon, IGCyr, IOSPE, CGRN, Inscriptions of Roman Cyrenaica 2020.

Ако не разполагате със собствен материал и не ви се сърфира в базите данни, можете да използвате един от примерите, приложени по-долу:

Latin: Funerary inscription for Cassius Felix from Ratiaria

Honorary inscription for Gaius Valerius Valentianus

Dedication to the Gods of Egiridava

Dedication to Casebonus

Greek: Statue base for Emperor Trajan

Dedication to Pluto by Longinus

Funerary inscription for the veteran Aurelius Posidonius

Milestone for Emperor Gordian III

Statue base for Caesar Maximus

Greek 1
Greek 2
Greek 3
Greek 4

4. Допълнително четене

В Prometheus Zotero Library - Списък за четене на първата работилница има колекция, съдържаща полезни заглавия за допълнително четене, които са свързани с източника. Повечето от публикациите в списъка се публикуват под отворени лицензи и са свободно достъпни.

Проект Prometheus Zotero Library:

Първа работилница - Списък за четене

Важни връзки

Ето някои полезни и важни връзки към обучителни материали и референтни сайтове, които участниците в семинара ще искат да посетят по време и след обучението си по дигитална епиграфика.

Документация на EFES

https://github.com/EpiDoc/EFES

Markup List