Речник података / Data Dictionary

Структура података, DOI правила, Wikidata ставке, интегритет, лиценца, цитирање и статус провере
Data Structure, DOI Rules, Wikidata Items, Integrity, License, Citation and Verification Status

Ова страна описује структуру отворених података дигиталног научног корпуса Милоша Тимотијевића. Речник објашњава значење колона и поља у CSV, JSON и JSON-LD фајловима, разликовање DOI идентификатора, улогу Wikidata ставки, статусе провере, проверу интегритета, услове употребе и начин цитирања.

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

English Summary

This page describes the structure of the open data published as part of the digital scholarly corpus of Miloš Timotijević. It explains the CSV, JSON and JSON-LD exports, DOI fields, Wikidata relations, verification status, data integrity, licensing and citation practice.

The data dictionary does not replace the data files, bibliographic records, DOI registries, Wikidata, COBISS or repositories. It provides a stable reference point for reading, checking, downloading, processing and reusing the published data consistently.

Обухваћени скупови података / Covered Data Files

publications.csv

Основна табела изабраних публикација и издања. Садржи библиографске податке, DOI идентификаторе, приступне стране, репозиторијумске записе, Wikidata ставке, COBISS идентификаторе, истраживачке кластере и статус провере. CSV представља шири радни корпус и може садржати и проверене записе и записе који су још у припреми.

Преузми / Download

publications.json

Машински читљив JSON извоз проверених библиографских записа из основне публикационе табеле. Садржи метаподатке скупа, списак поља и низ records.

Преузми / Download

publications.jsonld

Семантички JSON-LD извоз проверених публикационих записа, заснован на речнику Schema.org. Публикације су представљене као повезани чворови унутар поља @graph.

Преузми / Download

wikidata-items.csv

Структурисана табела Wikidata ставки које представљају публикације и главне структурне чворове истраживачког корпуса: истраживачки оквир, тематске кластере и друге контролисане везе са Wikidata.

Преузми / Download

doi-list.csv

Контролна табела DOI идентификатора, са разликовањем главног DOI броја публикације, рада или издања од DOI броја репозиторијумске верзије.

Преузми / Download

knowledge-graph.jsonld

Машински читљив извоз основне структуре графа знања: аутора, веб-сајта, странице графа, скупа података, главног истраживачког оквира и тематских кластера.

Преузми / Download

manifest.json

Манифест интегритета машински читљивих извоза. За сваки контролисани фајл бележи путању, формат, величину, SHA-256 контролни збир и логички број записа.

Преузми / Download

Однос између публикационих извоза

publications.csv је основни табеларни извор публикационог корпуса. Он може садржати и потпуно проверене записе и записе који су још у статусу припреме или додатне провере.

publications.json и publications.jsonld представљају машински читљиве извозе проверених библиографских записа. Због тога број записа у овим фајловима може бити мањи од укупног броја редова у publications.csv.

CSV остаје основни радни табеларни слој, JSON служи за једноставну машинску обраду, док JSON-LD додаје семантичке типове и везе погодне за граф знања и повезане податке.

Општа правила за CSV фајлове

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

Унутрашње ознаке у пољима као што су id, local_id, related_publication_id и related_cluster_id представљају локалне идентификаторе који омогућавају повезивање података унутар корпуса.

Стабилни идентификатор публикације у основном корпусу налази се у пољу publications.id. Други локални кључеви користе се у помоћним табелама у складу са њиховом функцијом и не морају увек бити текстуално идентични публикационом id.

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

Празно поље означава да одређени податак није доступан, није применљив или још није унет. Празно поље не треба тумачити као негативну вредност.

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

Структура фајла publications.csv

Фајл publications.csv садржи један ред за сваку изабрану публикацију или посебно моделовано издање у оквиру дигиталног научног корпуса. Степен провере сваког записа означен је у колони status.

Колона	Значење
`id`	Стабилна унутрашња ознака публикационог записа. Користи се за повезивање исте јединице кроз различите машински читљиве слојеве корпуса.
`type`	Контролисани тип публикације. Актуелне вредности су `book`, `catalogue`, `guidebook`, `book_chapter`, `conference_paper` и `article`.
`year`	Година објављивања публикације или конкретног издања, када је утврђена.
`author_sr`	Име једног или више аутора у облику који се користи у метаподацима на српском језику. Више аутора раздваја се тачком и запетом.
`author_en`	Латинични облик имена једног или више аутора који се користи у метаподацима на енглеском језику.
`title_sr`	Наслов публикације на српском језику или нормализовани српски облик наслова који се користи у корпусу.
`title_en`	Наслов публикације на енглеском језику или енглески превод наслова, када је доступан.
`doi_work_or_edition`	Главни DOI који идентификује дело, публикацију, рад или конкретно издање, ако постоји.
`doi_landing_page`	Опционо поље за DOI који је посебно повезан са приступном страницом публикације, када се такав модел примењује.
`doi_repository`	DOI репозиторијумске или депоноване верзије публикације, на пример Zenodo записа. Више DOI вредности раздваја се тачком и запетом.
`doi_note`	Кратка напомена о односу DOI идентификатора, издања, репозиторијумских записа или другим околностима које су важне за правилно тумачење идентификатора.
`landing_page`	URL приступне странице публикације или другог релевантног мрежног извора. Када постоји посебна приступна страна публикације на овом сајту, она има предност.
`zenodo`	URL ка Zenodo запису депоноване верзије, ако постоји. Више репозиторијумских записа раздваја се тачком и запетом.
`wikidata`	Wikidata QID дела, публикације или издања које је повезано са конкретним публикационим записом, ако одговарајућа ставка постоји и ако је веза проверена.
`cobiss`	COBISS.SR-ID или други релевантан COBISS идентификатор библиографског записа.
`cluster`	Стабилна ознака једног или више истраживачких кластера којима је публикација аналитички придружена.
`status`	Ознака степена провере и обраде записа, као што су `checked`, `draft`, `needs_update`, `needs_review` или `waiting_indexing`.

Структура фајла publications.json

Фајл publications.json представља машински читљив JSON извоз проверених библиографских записа из publications.csv.

Поље	Значење
`name`	Назив скупа података на енглеском језику.
`alternateName`	Алтернативни назив скупа података на српском језику.
`description`	Кратак опис функције машински читљивог извоза.
`license`	URL лиценце под којом се објављују метаподаци.
`source`	URL основног CSV извора из кога је JSON генерисан.
`dateModified`	Датум последњег генерисања или синхронизације извоза.
`recordCount`	Број публикационих записа укључених у конкретни JSON извоз.
`fields`	Контролисани списак поља која се користе у публикационим записима.
`records`	Низ проверених публикационих записа. Поља одговарају структури `publications.csv`; празне CSV вредности могу бити представљене као `null`.

Структура фајла publications.jsonld

Фајл publications.jsonld представља семантички извоз проверених публикационих записа. Користи JSON-LD и Schema.org речник.

На почетку графа налази се чвор типа Dataset. Његово поље hasPart повезује скуп података са појединачним публикационим чворовима преко стабилних @id идентификатора.

Основни типови из publications.csv мапирају се на одговарајуће Schema.org типове. Књиге и водичи могу бити представљени типом Book, поглавља типом Chapter, а чланци и радови у зборницима типом ScholarlyArticle.

Појединачни чворови могу садржати библиографски идентификатор, DOI као PropertyValue, COBISS идентификатор, аутора, годину објављивања, приступну страницу, Wikidata везу преко sameAs, репозиторијумске записе и везе са истраживачким кластерима.

Структура фајла wikidata-items.csv

Фајл wikidata-items.csv представља синхронизовани Wikidata слој корпуса. Један ред представља једну Wikidata ставку и њену улогу у локалном моделу података.

Колона	Значење
`local_id`	Локална ознака Wikidata чвора у оквиру корпуса. За публикационе ставке по правилу се усклађује са стабилним публикационим идентификатором.
`wikidata_qid`	Wikidata QID идентификатор.
`wikidata_url`	Пун URL ка Wikidata ставки.
`item_type`	Тип локално моделованог чвора. За публикације се користе `book`, `catalogue`, `guidebook`, `book_chapter`, `conference_paper` и `article`. За структурне чворове користе се `research_framework`, `research_cluster` и, када је потребно техничко праћење Wikidata преусмерења, `redirect`.
`label_sr`	Назив ставке на српском језику, када је доступан.
`label_en`	Назив ставке на енглеском језику.
`description_sr`	Кратак опис ставке на српском језику, када је доступан.
`description_en`	Кратак опис ставке на енглеском језику, када је доступан.
`site_page`	URL странице која представља, користи или објашњава одговарајући чвор.
`related_publication_id`	Стабилни идентификатор једне или више публикација са којима је Wikidata ставка повезана. Више вредности раздваја се тачком и запетом.
`related_cluster_id`	Стабилна ознака једног или више истраживачких кластера са којима је ставка повезана.
`relation_to_corpus`	Контролисана ознака функције Wikidata ставке у корпусу. Актуелне вредности укључују `publication_item`, `cluster`, `main_framework` и `redirect_item`.
`status`	Ознака степена провере или потребе за додатном обрадом Wikidata везе.
`checked_date`	Датум последње документоване провере записа.
`notes`	Кратка напомена о ставци, њеној улози, односу дела и издања, дељеној Wikidata ставки или другом релевантном питању.

Структура фајла doi-list.csv

Фајл doi-list.csv служи као контролни регистар DOI идентификатора и репозиторијумских веза. Он допуњује, али не замењује публикациони запис у publications.csv.

Колона	Значење
`local_id`	Локални кључ DOI записа или приступне странице. Историјски настале вредности у овој табели не морају увек бити текстуално идентичне стабилном `publications.id`, па се повезивање проверава и преко приступне странице и идентификатора.
`page_type`	Тип странице или публикационе јединице у оквиру корпуса.
`title_key`	Поједностављени облик наслова погодан за претрагу, проверу и упоређивање записа. Сличност ових вредности сама по себи није доказ да су две публикације истоветне.
`landing_page`	URL приступне странице публикације или другог релевантног мрежног извора.
`doi_work_or_edition`	Главни DOI публикације, рада, књиге, каталога, поглавља или конкретног издања, ако постоји.
`doi_work_or_edition_url`	Пун DOI URL за главни DOI публикације или издања.
`doi_repository`	DOI репозиторијумске или депоноване верзије, најчешће Zenodo DOI.
`doi_repository_url`	Пун DOI URL за репозиторијумску верзију.
`repository_record_url`	URL ка репозиторијумском запису, на пример Zenodo запису, када постоји.
`status`	Ознака степена провере DOI података.
`checked_date`	Датум последње документоване провере DOI података.
`notes`	Кратка напомена о DOI идентификатору, односу више DOI бројева, репозиторијумском запису или потреби за додатном провером.

Разликовање DOI идентификатора

DOI идентификатори распоређени су према функцији коју имају у корпусу. Главни DOI публикације, рада, књиге, каталога, поглавља или конкретног издања налази се у пољу doi_work_or_edition.

DOI репозиторијумске или депоноване верзије налази се у пољу doi_repository. Zenodo DOI се третира као репозиторијумски DOI када идентификује депоновану верзију или репозиторијумски запис, а не главни DOI изворне публикације.

Сам Zenodo URL без посебног DOI идентификатора може бити наведен у пољу zenodo или repository_record_url. Постојање репозиторијумског записа зато не подразумева аутоматски да је у пољу doi_repository доступан посебан DOI.

Када однос више DOI идентификатора захтева додатно објашњење, оно се наводи у пољу doi_note или notes. Записи чији однос није довољно јасан могу бити означени статусом needs_review.

Структура фајла knowledge-graph.jsonld

Фајл knowledge-graph.jsonld користи JSON-LD и речник Schema.org. Поље @graph садржи главне структурне чворове дигиталног научног корпуса.

Основни чворови обухватају аутора (Person), веб-сајт (WebSite), улазну страницу графа знања (CollectionPage), отворени скуп података (Dataset), главни истраживачки оквир и тематске истраживачке кластере.

Стабилни @id идентификатори користе се тако да различити JSON-LD документи могу упућивати на исти ентитет без поновног стварања независних анонимних чворова.

The knowledge-graph.jsonld file uses JSON-LD and the Schema.org vocabulary. Stable @id values connect the author, website, graph entry page, open dataset, main research framework and thematic clusters across the machine-readable data layer.

Структура фајла manifest.json

manifest.json је технички манифест интегритета главних машински читљивих извоза. Он се регенерише након завршетка измена у контролисаним фајловима.

Поље	Значење
`schemaVersion`	Верзија локалног формата манифеста.
`name`	Назив и функција манифеста.
`dateModified`	Датум генерисања актуелне верзије манифеста.
`algorithm`	Алгоритам који се користи за контролни збир. У актуелном моделу користи се `SHA-256`.
`files`	Низ контролисаних датотека и њихових техничких метаподатака.
`path`	Релативна путања датотеке у репозиторијуму.
`contentUrl`	Јавни URL контролисане датотеке.
`encodingFormat`	MIME тип или машински читљива ознака формата датотеке.
`byteSize`	Тачна величина датотеке у бајтовима у тренутку генерисања манифеста.
`sha256`	SHA-256 контролни збир садржаја датотеке. Промена макар једног бајта доводи до промене ове вредности.
`recordCount`	Логички број записа или чворова у конкретном извозу. Код CSV фајлова заглавље се не рачуна као запис.

Манифест треба генерисати као последњи корак после свих измена контролисаних датотека, јер свака накнадна промена мења величину и SHA-256 вредност одговарајућег фајла.

Контролисане вредности

Статус провере

Вредност	Значење
`checked`	Запис је проверен у односу на доступне библиографске податке, приступну страну и релевантне спољне идентификаторе.
`draft`	Запис је унет у радни корпус, али још није потпуно проверен или допуњен.
`needs_update`	Запис постоји, али му је потребна исправка, допуна или нова синхронизација.
`needs_review`	Однос података или идентификатора није довољно јасан и потребна је додатна провера.
`waiting_indexing`	Подаци су припремљени, али још нису преузети или препознати у одговарајућем спољном агрегатору или индексу.

Типови публикација

У фајлу publications.csv користе се следеће контролисане вредности:

book — књига или монографија;
catalogue — изложбени, музејски или други каталог;
guidebook — самостална публикација водичког типа, укључујући музејске, споменичке и културно-историјске водиче;
book_chapter — поглавље или прилог у књизи;
conference_paper — рад објављен у зборнику са научног или стручног скупа;
article — чланак у часопису или другој периодичној публикацији.

Вредности book_chapter и conference_paper представљају различите публикационе категорије и не користе се као међусобне замене.

Типови Wikidata ставки

У актуелном wikidata-items.csv публикационе ставке задржавају одговарајући публикациони тип: book, catalogue, guidebook, book_chapter, conference_paper или article.

Структурни чворови корпуса користе вредности research_framework и research_cluster. Вредност redirect користи се за техничко евидентирање Wikidata ставке која је преусмерена и захтева проверу циљне ставке.

Стабилни идентификатори и односи дела и издања

Стабилни id у publications.csv идентификује конкретан публикациони запис у локалном корпусу. Он остаје стабилан приликом накнадног додавања DOI, Wikidata, COBISS или репозиторијумских података.

Различита издања истог дела могу бити представљена као засебни публикациони записи када имају различиту годину, COBISS запис, DOI или другу библиографски значајну идентификацију.

Wikidata ставка може, у зависности од начина моделовања на Wikidata, представљати дело у целини или конкретно издање. Зато исти Wikidata QID у изузетним случајевима може бити повезан са више локалних издања. Такав однос мора бити експлицитно документован у пољу notes.

Лиценца и услови употребе / License and Reuse

Метаподаци: могу се користити под лиценцом Creative Commons Attribution 4.0 International (CC BY 4.0) , уз навођење извора.

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

Metadata: may be reused under the Creative Commons Attribution 4.0 International License (CC BY 4.0) , with attribution. Full texts, photographs and illustrations are not covered by this license; they remain subject to the rights of authors, publishers, institutions, repositories and other rights holders.

Како цитирати речник и податке

Препоручени облик навођења речника:

Милош Тимотијевић, „Речник података дигиталног научног корпуса”, у: Miloš Timotijević — Academic Profile and Knowledge Graph , приступљено [датум приступа].

English citation form:

Miloš Timotijević, “Data Dictionary of the Digital Scholarly Corpus,” in Miloš Timotijević — Academic Profile and Knowledge Graph , accessed [access date].

Када се користи одређени CSV, JSON или JSON-LD фајл, у наводу треба назначити назив конкретног фајла, његову адресу и датум приступа.

За потпуно репродуктивно навођење одређене верзије машински читљивих података могу се додатно навести датум манифеста и SHA-256 вредност конкретног фајла из manifest.json.

Када се цитира појединачна публикација, предност треба дати самом делу, његовом главном DOI идентификатору, пуном библиографском запису или одговарајућем репозиторијумском запису, а не запису из локалног скупа података.

Ограничења

Ови подаци представљају структурисани отворени извоз из једног ауторског дигиталног научног корпуса. Они не представљају потпуну националну библиографију нити замену за COBISS, ORCID, Wikidata, DOI регистре, Crossref, Zenodo или друге библиографске и репозиторијумске системе.

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

Статус draft означава да је јединица део радног корпуса, али још није укључена у проверене JSON и JSON-LD публикационе извозе.

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

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

Верзионисање и провера интегритета

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

Git репозиторијум обезбеђује историју измена, док manifest.json омогућава проверу да ли садржај тренутно објављеног фајла одговара верзији за коју су израчунати величина и SHA-256 контролни збир.

После сваке значајније ревизије података препоручени редослед је: прво исправка основних CSV података, затим регенерисање изведених JSON и JSON-LD фајлова, потом провера међусобне усклађености, а на крају регенерисање manifest.json.

For the wider digital humanities context of this data layer, see About this Digital Humanities Project .

Метод / Method

Последње ажурирање: 31. август 2026.