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

Структура и правила употребе отворених података

Колоне, DOI правила, Wikidata ставке, лиценца, цитирање и статус провере
Columns, DOI Rules, Wikidata Items, License, Citation and Verification Status

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

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

English Summary

This page describes the structure of the open data used in the digital scholarly corpus of Miloš Timotijević. It explains the CSV columns, the JSON-LD knowledge graph export, DOI rules, verification status, licensing and citation practice.

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

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

publications.csv

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

Преузми / Download

wikidata-items.csv

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

Преузми / Download

doi-list.csv

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

Преузми / Download

knowledge-graph.jsonld

Машински читљив извоз главних ентитета и односа графа знања.

Преузми / Download

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

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

Унутрашње ознаке у пољима као што су id, local_id и related_cluster_id треба да буду стабилне. Оне се не мењају када се накнадно додају DOI бројеви, Wikidata ставке, репозиторијумски записи или исправке у опису.

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

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

Фајл publications.csv садржи један ред за сваку изабрану публикацију или издање у оквиру дигиталног научног корпуса. Актуелна радна верзија обухвата проверене записе са приступним странама, DOI бројевима, Zenodo записима и Wikidata ставкама, као и радне записе који се постепено допуњују и проверавају.

Колона	Значење
`id`	Унутрашња стабилна ознака јединице. Пише се малим словима, без размака, са цртицама или доњим цртама, у складу са постојећим моделом.
`type`	Тип публикације: `book`, `article`, `chapter`, `catalogue`, `review` или други контролисани тип.
`year`	Година објављивања публикације или издања.
`author_sr`	Име аутора или аутора у српском облику.
`author_en`	Име аутора или аутора у латиничном или енглеском облику.
`title_sr`	Наслов публикације на српском језику.
`title_en`	Енглески наслов публикације, ако постоји.
`doi_work_or_edition`	DOI који се односи на дело, публикацију, рад или конкретно издање, ако постоји.
`doi_landing_page`	DOI који резолвује на приступну страну публикације на овом сајту, ако је такав модел примењен.
`doi_repository`	DOI репозиторијумске или депоноване верзије публикације, на пример Zenodo записа, ако постоји.
`doi_note`	Кратка напомена о односу DOI бројева, нарочито када постоји више верзија, више записа или могућа недоумица.
`landing_page`	Приступна страна публикације на овом сајту.
`zenodo`	Zenodo запис или DOI линк ка депонованој верзији, ако постоји.
`wikidata`	Wikidata ставка за дело или публикацију, ако постоји.
`cobiss`	COBISS.SR-ID или други релевантан COBISS запис.
`cluster`	Истраживачки кластер или више кластера којима публикација припада.
`status`	Статус провере података: `checked`, `draft`, `needs_update`, `needs_review`, `waiting_indexing`.

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

Фајл wikidata-items.csv садржи контролни списак Wikidata ставки повезаних са дигиталним научним корпусом. Један ред представља једну Wikidata ставку: аутора, публикацију, истраживачки оквир, кластер, тему, институцију или друго повезано чвориште.

Колона	Значење
`local_id`	Унутрашња стабилна ознака ставке у оквиру овог сајта.
`wikidata_qid`	Wikidata QID идентификатор.
`wikidata_url`	Пун линк ка Wikidata ставки.
`item_type`	Тип ставке: аутор, публикација, истраживачки оквир, кластер, тема, установа или друго.
`label_sr`	Назив ставке на српском језику, када је доступан.
`label_en`	Назив ставке на енглеском језику или у латиничном облику.
`description_sr`	Кратак опис на српском језику, када је доступан.
`description_en`	Кратак опис на енглеском језику.
`site_page`	Страница овог сајта на којој се ставка користи или објашњава.
`related_publication_id`	Унутрашња ознака повезане публикације, ако се ставка односи на публикацију.
`related_cluster_id`	Истраживачки кластер или више кластера са којима је ставка повезана.
`relation_to_corpus`	Улога ставке у корпусу: аутор, кластер, публикација, главни оквир, повезана тема и слично.
`status`	Статус провере података.
`checked_date`	Датум последње провере.
`notes`	Кратка напомена о ставци.

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

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

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

Правила за DOI бројеве

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

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

Ако на приступној страни није јасно да ли се DOI односи на публикацију, приступну страну или репозиторијумску верзију, запис добија статус needs_review.

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

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

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

Типови ставки и страница

Типови као што су book, article, chapter, catalogue, conference_paper, publication, research_cluster, research_framework, person, institution, place и topic користе се као контролисане вредности. Нове вредности треба додавати само када постоји стварна потреба.

Лиценца и услови употребе / 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 фајл, треба навести конкретан фајл, верзију ако је назначена, адресу фајла и датум приступа. Када се цитира појединачна публикација, предност треба дати самом делу, DOI броју, репозиторијумском запису или библиографском запису.

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

Фајл knowledge-graph.jsonld користи JSON-LD и речник Schema.org. Поље @graph садржи главне чворове корпуса, док стабилни @id идентификатори омогућавају повезивање аутора, сајта, улазне странице, кровног оквира и тематских кластера.

The knowledge-graph.jsonld file uses JSON-LD and the Schema.org vocabulary. Its @graph array contains the main corpus nodes, while stable @id values connect the author, website, graph entry page, main framework and thematic clusters.

Ограничења

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

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

Одржавање

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

Препоручени редослед одржавања је: најпре ажурирати CSV фајл, затим ажурирати овај речник података, а потом проверити страницу Подаци / Data и sitemap.

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