Водич за дигиталну епиграфику

Следећи документ садржи материјале који би требало да помогну учесницима да се припреме за радионицу о дигиталној епиграфици коју организује пројекат PROMETHEUS – Промовисање универзалних вредности кроз дигиталну епиграфику и културно наслеђе која ће бити организована током 5 дана, од 15. до 19. априла 2024 преко Zoom и 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 пре радионице. ❗❗❗

Инсталација:

Иди на http://oxygenxml.com

●Преузмите и инсталирајте Oxygen XML Editor који је погодан за ваш ОС (Windows, MacOS, итд.)

Покретање

●Да бисте покренули апликацију, покрените Oxygen 26.1.exe или oxygen.bat из инсталационог директоријума производа.

Лиценца:

●Захтев за бесплатну 30-дневну демо лиценцу ОВДЕ
●Изабери Врста академске лиценце.
●Копирајте у клипборд лиценцни кључ који сте добили е-поштом и налепите га у дијалог за регистрацију лиценце из апликације.

Ако имате потешкоћа са упутствима, погледајте видео записе о томе како да инсталирате, погледајте туторијале 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'.
Отворите Command prompt/Terminal:

Windows: у претраживачу у Старт менију укуцајте: cmd

GNU/Linux

Mac OS X: у претраживачу у Менију на врху укуцајте: terminal

Покрените процес уградње EFES-а, навигирајући до вашег EFES фолдера (a), а затим покрените скрипт која ће покренути Jetty, лаки веб сервер који је пред-конфигурисан за покретање свих компоненти EFES-а (b):

Windows:

Идите до вашег EFES фолдера куцајући следећу команду и затим притисните Enter: cd Desktop\EFES

укуцајте следећу команду и затим притисните Enter: build.bat

навигирајте до вашег EFES фолдера куцајући следећу команду и затим притисните Enter: cd Desktop\EFES

укуцајте следећу команду и затим притисните Enter: build.bat

GNU/Linux или Mac OS X:

1. 1. i.идите до фасцикле EFES куцајући следећу команду, а затим притисните Enter: cd Desktop/EFES
  2. ii.откуцајте следећу команду, а затим притисните Enter: sh

build.sh

1. 1. iii.
Отворите претраживач и идите на http://127.0.0.1:9999/. Требало би да прикаже страницу добродошлице заједно са основном навигацијом.
Сместите XML садржај пројекта (EpiDoc фајлове) у фолдер /webapps/ROOT/content/xml/epidoc/.
Индексирајте датотеке преко Admin панела на сајту.
Погледајте HTML верзије својих HTML датотека на 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/en/page/project

2. На веб страници пронађите везу за преузимање за AIAX софтверa. Уочљиво је приказано у одељку „Тестирај“. Кликните на везу за преузимање да бисте започели процес преузимања.

Када се преузимање заврши, идите до фолдера где је сачуван преузети фајл.
Лоцирајте преузети фајл, компримовани фајл (на пример, ZIP фајл). Десни клик на фајл и изаберите "Извуци" да бисте распаковали садржај фајла.
Након распакивања садржаја, отворите фолдер под називом "AiaxTelamon Portable".
Унутар фолдера треба да пронађете извршни фајл под називом "Telamon". Ово је главни извршни фајл за AIAX софтвер.
Двапут кликните на извршни фајл "Telamon" да бисте покренули AIAX софтвер.

8. Кликните на "Allow" у прозору за дијалог за Apache сервер, а затим кликните на "Allow" у дијалог прозору за MySQL.

Сада имате покренуту локалну верзију AIAX софтвера и можете почети да користите софтвер за жељене задатке.

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

Ово може помоћи у решавању потенцијалних проблема и обезбедити несметан рад софтвера.

Пратећи ове кораке, требало би да будете у могућности да преузмете и инсталирате локалну верзију AIAX софтвера на свој рачунар. Ако наиђете на било какве додатне проблеме, погледајте Водич за брзи почетак за USB Веб сервер у фасцикли „AIAX Telamon Portable“ или контактирајте организаторе за помоћ.

1.2.2 Креирање налога

Учесници треба да креирају налоге на следећим платформама:

GitHub

Учесници би требало да направе репозиторијум на GitHub-у пре поподневне сесије у уторак, 16. априла.

GitHub је платформа која се користи за хостовање и сарадњу на пројектима развоја софтвера, што омогућава колаборативни рад. GitHub омогућава програмерима да деле, прегледају и управљају изменама кода ефикасно, што га чини популарним за пројекте отвореног кода.

Зенодо

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

Zenodo је репозиторијум са отвореним приступом који је развио CERN (Европска организација за нуклеарна истраживања) како би олакшао дељење и архивирање истраживачких података. Он пружа истраживачима, пројектима и институцијама платформу за складиштење, чување и дељење различитих типова резултата из истраживања.

Zotero

Зотеро је бесплатан софтвер за управљање референцама отвореног кода који помаже истраживачима да прикупљају, организују, цитирају и деле истраживачке материјале као што су чланци, књиге, веб странице и још много тога. Широко се користи за академско писање и истраживање. На овој радионици учесници ће научити како се ова платформа може користити за дигиталне пројекте.

2. Материјали за обуку

Онлајн документи које ћете често консултовати током и након радионице:

EpiDoc Guidelines 9.6

Leiden and EpiDoc Quick Reference
Структура EpiDoc странице

3. Натписи за вежбање

Пошто је ово радионица за обуку која укључује практичну обуку где ћете научити како да кодирате у EpiDoc XML-у биће вам потребни натписи које ћете користити за вежбање. Пожељно је да за вежбу користите сопствени материјал.

Међутим, ако немате свој материјал, можете одабрати натписе из онлајн база података:

Такође можете користити и комбиновати и материјал из једне од EpiDoc база података, нпр.

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

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

Латински: Funerary inscription for Cassius Felix from Ratiaria

Honorary inscription for Gaius Valerius Valentianus

Dedication to the Gods of Egiridava

Dedication to Casebonus

Грчки: 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. Даље читање

Библиотека Прометеј Зотеро - Листа за читање прве радионице садржи збирку са корисним насловима за даље читање, који су повезани са извором. Већина публикација на листи објављена је под отвореним лиценцама и слободно је доступна.

Прометеј пројекат Зотеро библиотека:

Прва радионица - Листа за лектиру

Важни линкови

Ево неколико корисних и важних линкова који воде до важних материјала за обуку и референтних сајтова које ће учесници радионице желети да посете током и након обуке из дигиталне епиграфике.

EFES документација

https://github.com/EpiDoc/EFES

Markup List