Open Manuscript Initiative Терминология и определения

Метаданни на документа

Поле	Стойност
Вид документ	Политика за терминологията в областта на управлението и централен речник
Статус	Чернова
Версия	0.1.0
Нормативен език	Английски
Приложимо за	Спецификации, схеми, профили, регистри, примери, реализации и официални преводи на OMI

1. Цел

Настоящият документ определя общата терминология на проекта „Open Manuscript Initiative“ (OMI).

Целта му е да се гарантира, че един и същ термин има едно и също значение в целия набор от спецификации на „OMI“. Освен това той разграничава понятия, които често се третират като синоними в текстообработващите програми, издателските системи, хранилищата, програмите за управление на цитати и редакционните платформи.

Определенията в настоящия документ имат за цел:

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

2. Правомощия и употреба

Термините, чието значение се определя в други спецификации, ТРЯБВА да използват определенията, съдържащи се в настоящия документ.

Една спецификация от типа „OMI“ МОЖЕ да дефинира по-тесно специализирано значение за собствения си обхват, но ТРЯБВА:

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

Когато даден термин не е дефиниран тук, се прилага съответната спецификация на „OMI“. Когато нито настоящият документ, нито спецификация на „OMI“ дефинира даден термин, се използва обичайното му техническо значение.

Английските термини в този документ са канонични за набора от нормативни спецификации на английски език. Официалните преводи ТРЯБВА да запазват концептуалните разграничения, дори когато в друг език обикновено се използва една дума за няколко английски термина.

3. Нормативен език

Ключовите думи ТРЯБВА, НЕ ТРЯБВА, СЛЕДВА, НЕ СЛЕДВА и МОЖЕ изразяват нива на нормативни изисквания, когато са изписани с главни букви.

Използването с малки букви на думи като „трябва“, „следва“ или „може“ е част от обикновения прозаичен стил и не създава самостоятелни изисквания за съответствие.

4. Принципи на терминологията

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

Терминът обозначава понятие. Понятието остава непроменено дори когато:

• потребителският интерфейс използва преведен или съкратен етикет;
• името на файла се променя;
• визуалното представяне използва различна формулировка;
• външният стандарт използва друг термин;
• в дадена дисциплина се използва местен синоним.

4.2 Семантична идентичност преди представянето

OMI разграничава един обект от неговото визуално представяне.

Примери:

• появата на цитата не е самият форматиран текст на цитата;
• един обект „заглавие“ не е конкретен размер на шрифта;
• бележката не е оцветено подчертаване;
• библиографският запис не е низ от данни за библиографска единица;
• ръкописът не е файл от типа DOCX или PDF.

4.3 Местна идентичност и външна идентичност

Един обект от типа „OMI“ може да има стабилен локален идентификатор и един или повече външни идентификатори.

Локалният идентификатор установява идентичността в рамките на документ, пакет или системен контекст на „OMI“. Външният идентификатор свързва обекта с система за идентификация извън този контекст.

Нито един от двата типа не замества автоматично другия.

4.4 Ролите и хората са две различни неща

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

Ролята НЕ ТРЯБВА да се разглежда като постоянно свойство на агента.

4.5 Съдържанието и работният процес са отделни

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

4.6 Нормативни и информативни значения

Определението в речника може да дефинира дадена концепция, без да определя всички машинно четими свойства, необходими за нейната сериализация. Съответната спецификация „OMI“ определя пълния ѝ нормативен модел на данните и правилата за обработка.

5. Основни концептуални връзки

Основните концепции на „OMI“ са свързани по следния начин:

Scholarly work
    ↓ represented during its lifecycle as
Manuscript
    ↓ expressed through one or more
Document instances or versions
    ↓ composed of identifiable
Scholarly objects
    ↓ serialized into
OMI documents and packages
    ↓ processed by
Implementations
    ↓ rendered or exported as
Publications and exchange formats

Основните референтни понятия са свързани по следния начин:

Citable resource
    ↓ described by
Bibliographic record
    ↓ selected into
Manuscript reference library
    ↓ referenced by
Citation occurrence
    ↓ formatted through
Citation style and publication profile
    ↓ displayed as
Rendered citation or bibliography entry

Основните понятия за анотиране са свързани по следния начин:

Scholarly object or content range
    ↓ addressed by
Anchor
    ↓ used as target by
Annotation
    ↓ may participate in
Review, editorial, translation, or discussion workflow

6. Ръкопис, документ, файл и публикация

Тези термини НЕ ТРЯБВА да се използват като взаимозаменяеми синоними в нормативния текст на OMI.

6.1 Научна дейност

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

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

6.2 Ръкопис

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

Един ръкопис може да включва:

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

Един ръкопис не се определя от една конкретна сериализация или един софтуерен продукт.

6.3 Документ

Конкретно структурирано представяне на съдържанието на ръкописа и свързаните с него данни в определен контекст на обработка.

Един ръкопис може да съдържа няколко екземпляра на документа, като например:

• текущ документ, който може да се редактира;
• представен документ;
• прегледана редакция;
• приет документ;
• публикувана снимка;
• преведен документ.

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

6.4 Инстанция на документ

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

Един екземпляр на документ може да бъде променлив или непроменлив в зависимост от състоянието му в жизнения цикъл.

6.5 Изходен документ

Документът, избран като основен източник за определена операция, като например превод, визуализация, валидиране, сравнение или експортиране.

Изходният документ е контекстуален. Терминът не означава непременно най-ранната историческа версия.

6.6 Каноничен документ

Екземплярът от документа, определен като авторитетен за конкретна цел.

Примери за това са:

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

Каноничният статус ТРЯБВА да определя обхвата и правомощията му. Стандартът „OMI“ не предполага, че един и същ документ е каноничен за всички цели.

6.7 Файл

Поредица от съхранени или предадени байтове, идентифицирана като един обект от файловата система или транспортен обект.

Един файл може да съдържа:

• един документ от типа „OMI“ със сериен номер;
• пакет или контейнер от типа „OMI“;
• публикационна дейност;
• внесен външен документ;
• свързан ресурс.

Файлът е единица за съхранение или пренос, но не е задължително да е семантична единица.

6.8 Формат на файла

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

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

6.9 Сериализация

Процесът на кодиране на модел на данни във файл, поток от байтове или представяне на съобщение.

Десериализацията е обратната операция: възстановяване на обектите с данни от сериализирано представяне.

6.10 Пакет

Прехвърлима единица, съдържаща документ от типа „OMI“, заедно с нула или повече свързани ресурси, манифести, схеми, мултимедийни файлове, записи за произход или подписи.

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

6.11 Контейнер

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

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

6.12 Публикуване

Публикувано научно произведение, предназначено за разпространение, цитиране, достъп или съхранение.

Дадена публикация може да бъде представена като HTML, PDF, EPUB, JATS, XML, печатен вариант, структурирани метаданни или друг формат.

Публикацията обикновено се създава въз основа на определена версия на ръкописа или документа, но не замества семантичния източник.

6.13 Официална версия

Версията на публикацията, официално определена от отговорния издател или издателския орган като окончателната публикувана версия.

„Официалната версия“ е понятие, свързано със статуса на публикацията. Това не означава, че по-ранните или по-късните версии на ръкописа престават да съществуват.

6.14 Публикации

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

Примери за това са:

• достъпно на HTML;
• PDF, готов за печат;
• EPUB;
• JATS XML;
• Метаданни за депозита в Crossref;
• Метаданни на DataCite;
• архивни пакети.

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

7. Обекти и структура на документа

7.1 Предмет

Идентифицируема единица, представена в модела на данните на „OMI“.

Един обект може да има:

• тип;
• стабилен идентификатор;
• свойства;
• взаимоотношения;
• информация за жизнения цикъл;
• произход;
• разширения.

Трябва да се избягва използването на думата обект без уточнение, когато е налице по-конкретен термин.

7.2 Научен обект

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

Един научен обект се определя по-скоро от научното му значение и връзките му, отколкото от външния му вид.

Примери за това са:

• ръкопис;
• раздел;
• параграф;
• заглавие;
• цитат;
• фигура;
• таблица;
• уравнение;
• бележка;
• поява на цитат;
• библиографска записка;
• бележка;
• решение за преразглеждане;
• твърдение на участник.

7.3 Структурен обект

Научен обект, чиято основна цел е да структурира съдържанието на документите.

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

7.4 Обект със съдържание

Научен обект, чиято основна цел е да предава интелектуално съдържание.

Примери за това са параграф, цитат, блок с код, формула, фигура, таблица, бележка и запис в библиографията.

Един и същ тип обект може да има както структурни, така и съдържателни функции.

7.5 Блоков обект

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

Типичните блокови обекти включват:

• параграф;
• заглавие;
• списък;
• блок с цитат;
• фигура;
• таблица;
• блок с уравнение;
• блок с код;
• блок за бележки.

Статусът на блока се отнася до структурата на документа, а не до визуалното оформление CSS.

7.6 Вграден обект

Обект, вграден в потока от съдържание на блок-обект.

Примери за това са:

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

7.7 Раздел

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

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

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

7.8 Заглавие

Етикет, свързан с раздел или друго определено структурно подразделение.

Нивото на заглавието изразява йерархията. То НЕ ТРЯБВА да се определя единствено въз основа на размера на шрифта или визуалното оформление.

7.9 Параграф

Единица проза или подобно текстово съдържание на ниво блок.

Един параграф може да съдържа вградени обекти и текстови отрязъци.

7.10 Забележка

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

Примери за това са бележки под линия, бележки в края на текста, бележки на автора, редакционни бележки и бележки на преводача.

Бележката не е същото като анотацията. Бележката е част от съдържанието на ръкописа; анотацията е обект, отнасящ се към съдържание или към друг обект.

7.11 Ресурс

Цифров или физически обект, свързан с ръкопис, библиографска записка, пакет или публикация.

Примери за това са изображения, набори от данни, аудиофайлове, видеофайлове, допълнителни файлове, схеми и външни уеб ресурси.

Терминът ТРЯБВА да посочва дали ресурсът е вграден, пакетиран, цитиран или се разрешава външно, когато това разграничение оказва влияние върху обработката.

8. Идентичност и идентификатори

8.1 Идентичност

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

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

8.2 Идентификатор

Стойност, използвана за разграничаване или обозначаване на обект в рамките на определена система за идентификатори или обхват.

Спецификацията, използваща идентификатор, ТРЯБВА да дефинира или да посочи:

• обхватът му;
• синтаксиса му;
• очакванията за неговата уникалност;
• правилата за сравнение;
• очакванията си за устойчивост;
• поведението му при разрешаване, ако има такова.

8.3 Местен идентификатор

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

Местният идентификатор може да остане непроменен при експортиране и импортиране, но неговата валидност се определя от контекста, в който се намира.

8.4 Глобален идентификатор

Идентификатор, който трябва да бъде уникален в рамките на независими системи или административни домейни.

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

8.5 Постоянен идентификатор

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

Примери за това са DOI, Handle, ARK, ORCID, ROR, URN и други управлявани схеми.

Постоянен идентификатор НЕ ТРЯБВА да се описва като постоянно разрешим, освен ако съответната система за идентификатори не предоставя такава гаранция.

8.6 Външен идентификатор

Идентификатор, присвоен от система, регистър, орган, хранилище, издател или каталог извън настоящия обхват на идентичността на „OMI“.

Примери за това са:

• DOI за публикация;
• ORCID за човек;
• ROR идентификатор на организация;
• ISBN за конкретно издание;
• регистрационен номер в хранилището;
• архивен референтен код.

8.7 Каноничен идентификатор

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

Каноничният статус не прави псевдонимите или другите идентификатори невалидни. Правилото за избор ТРЯБВА да бъде документирано.

8.8 Псевдоним

Алтернативен идентификатор, име, етикет или маршрут, който се отнася до същия обект в определен контекст.

Псевдонимите НЕ ТРЯБВА да се разглеждат като отделни обекти само защото техните символни низове се различават.

8.9 Резолвер

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

Неуспешното разрешаване не води задължително до невалидност на идентификатора.

9. Агенти, идентичност и принос

9.1 Агент

Субект, способен да заема дадена роля, да прави твърдение, да извършва действие или да бъде обект на приписване.

Основните видове агенти включват:

• лице;
• организация;
• консорциум;
• проект;
• услуга;
• неидентифициран или исторически агент.

9.2 Лице

Човешки агент.

Обектът „лице“ може да съдържа имена, идентификатори, принадлежности, контактна информация и произход. НЕ СЕ ДОПУСКА да се приема, че един неизменен именен низ изчерпателно представя лицето.

9.3 Организация

Колективен или институционален субект, чиято идентичност е независима от която и да е от отделните му членове.

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

9.4 Съавтор

Агент, свързан с научен обект, ръкопис, публикация, събитие от работния процес или друг обект от „OMI“ чрез една или повече роли на съавторство.

„Contributor“ е контекстуална връзка, а не отделен тип агент.

9.5 Автор

Съавтор, чиято роля включва интелектуално авторство на научната работа или на определена част от нея.

OMI не определя дали дадена статия отговаря на изискванията на списанието, дисциплината, законовите или етичните правила за авторство. Профилите и редакционните политики могат да налагат допълнителни критерии.

9.6 Редактор

Лице, което изпълнява редакционна функция по отношение на ръкопис, публикация, библиографско произведение или работен процес.

Ролята ТРЯБВА да бъде уточнена, когато има вероятност от двусмислие, например:

• редактор на ръкописи;
• редактор на списание;
• редактор на томове;
• редактор;
• технически редактор;
• редактор на спецификации.

9.7 Рецензент

Лице, на което е възложено да оцени ръкопис, обект, претенция, метод, превод или публикация в рамките на процес на рецензиране.

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

9.8 Преводач

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

„Преводач“ е роля. Преведеният документ ТРЯБВА да запази връзката със съответния изходен документ и изходната версия.

9.9 Издател

Лице, отговорно за пускането в обращение или официалното разпространение на дадена публикация.

Ролята на издателя се различава от тази на софтуера, който извършва визуализация или хостинг.

9.10 Ролята на приноса

Контролирана или разширяема стойност, която описва как даден агент е допринесъл в определен контекст.

Примери за това са автор, редактор, преводач, рецензент, куратор на данни, сътрудник по софтуера и илюстратор.

Ролята на приноса ТРЯБВА да се представя независимо от реда на приносителите и независимо от самоличността на субекта.

9.11 Принадлежност

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

Една организация може да има:

• роля или длъжност;
• начална и крайна дата;
• източник;
• твърдение, отнасящо се конкретно до даден ръкопис;
• идентификатор на външна организация.

НЕ СЕ ДОПУСКА да се приема, че дадена принадлежност е вечна.

9.12 Ред на авторите

Изричното подреждане на участниците според определена роля или резултат.

Редът на участниците не винаги съвпада с размера на приноса, азбучния ред или реда на показване. Приложимата спецификация или профил ТРЯБВА да посочва съответното тълкуване.

9.13 Съавтор

Съавтор, определен като лице за връзка по отношение на конкретен ръкопис, подадена статия, публикация или работен процес.

Съответният статус не представлява ранг на авторство и МОЖЕ да се отнася за повече от един съавтор.

10. Метаданни и произход

10.1 Метаданни

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

Метаданните могат да бъдат:

• описателен;
• административни;
• технически;
• структурен;
• свързани с правата;
• свързани с произхода;
• свързани със съхранението.

Метаданните не са непременно по-малко важни или по-малко авторитетни от самото съдържание.

10.2 Стойност на метаданните

Едно структурирано твърдение, свързано със свойство на метаданните.

Стойността на метаданните може да включва език, произход, степен на достоверност, срок на валидност или информация за източника, в допълнение към основната ѝ стойност.

10.3 Произход

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

Произходът може да посочи:

• отговорен агент;
• изходна система;
• идентификатор на източника;
• моментът на създаване или извличане;
• операция по трансформация;
• софтуер и версия;
• състояние на увереност или проверка;
• връзка с по-ранни версии.

10.4 Твърдение

Изявление, представено в данните на „OMI“, което изразява стойност, връзка, статус или факт относно даден обект.

Всяко твърдение може да има своя собствена проследимост и степен на достоверност. Представянето на твърдението в „OMI“ само по себе си не гарантира, че твърдението е вярно.

10.5 Авторитетна стойност

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

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

Авторитетният статут НЕ ТРЯБВА да се извежда единствено въз основа на актуалността.

10.6 Източник

Единицата, системата, документът, агентът или процесът, от които са получени данните или съдържанието.

Терминът ТРЯБВА да бъде уточнен, когато е възможно да възникне двусмислие, например източник на метаданни, източник на превод, източник на цитат или източник на импорт.

10.7 Увереност

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

Увереността не замества достоверността и НЕ ТРЯБВА да се представя като обективна вероятност, освен ако методът не я дефинира като такава.

11. Анкори и препратки в документите

11.1 Котва

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

Една връзка може да сочи към:

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

Анкорът е механизъм за адресиране. Не е самата бележка или цитатът, който го използва.

11.2 Целева точка за закрепване

Обектът, обхватът на съдържанието, местоположението или състоянието, обозначени от препратка.

11.3 Разделителна способност на Anchor

Процесът на определяне на текущата цел, представлявана от котва.

Резолюцията може да доведе до:

• една цел;
• няколко цели;
• неточно определена цел;
• нерешен резултат;
• невалиден резултат.

11.4 Стабилна котва

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

„Стабилен“ не означава „непроменим“. Моделът „Anchor“ определя какви промени се очаква да издържи даден „Anchor“.

11.5 Позиция

Място между или в рамките на единици съдържание в определено състояние на документа.

Суровите отмествания на символите представляват позиции, но не са непременно стабилни ориентири.

11.6 Обхват

Подреден интервал между начална и крайна граница в определено пространство със съдържание.

Един диапазон МОЖЕ да бъде празен, когато съответната спецификация допуска семантика на точката на вмъкване.

11.7 Препратка

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

Препратката се различава от библиографското цитиране, въпреки че и двете могат да използват маркери и идентификатори.

11.8 Неразрешена препратка

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

Нерешената препратка може да бъде възстановена и НЕ ТРЯБВА автоматично да се разглежда като неизвестна препратка или неправилно оформен идентификатор.

12. Анотиране и преглед

12.1 Бележка

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

Една анотация обикновено съдържа:

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

12.2 Цел на анотацията

Обектът, към който се отнася дадена анотация.

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

12.3 Текст на бележката

Съдържанието или структурираното твърдение, което анотацията свързва със своя обект.

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

12.4 Мотивация за добавяне на бележки

Стойност, изразяваща целта на дадена анотация.

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

Мотивацията сама по себе си не определя правомощията по отношение на работния процес.

12.5 Коментар

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

Не всяка анотация е коментар; анотациите могат да съдържат и структурирани решения, класификации или заключения, генерирани от машина.

12.6 Преглед

Структуриран процес на оценяване или обект на оценяване, отнасящ се до ръкопис, научен обект, публикация или техническа спецификация.

Терминът ТРЯБВА да бъде уточнен, когато се отнася до процеса, а не до крайния обект на прегледа.

12.7 Преглед на обекта

Научен обект, който съдържа или представя обзорно съдържание, заключения, препоръки, въпроси, решения или свързани с тях бележки.

12.8 Кръг за преглед

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

12.9 Редакционно решение

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

Редакционното решение е различно от препоръката на рецензента.

12.10 Предложена промяна

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

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

13. Терминология, свързана с библиографията и цитирането

13.1 Източник, подходящ за цитиране

Единица, която може да бъде обект на научно цитиране.

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

13.2 Библиографска записка

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

Един библиографски запис може да съдържа:

• местни и външни идентификатори;
• заглавия;
• автори;
• тип на ресурса;
• информация за публикуването или създаването;
• връзки между контейнерите;
• език;
• места за достъп;
• произход;
• връзки между версиите и статусите.

13.3 Библиографска идентичност

Определяне на това, кое произведение, израз, проява, версия или екземпляр описва даден библиографски запис.

Библиографската идентичност НЕ ТРЯБВА да се извежда единствено въз основа на цитати със сходен формат.

13.4 Библиотека с ръкописни източници

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

Даден запис може да съществува, без в момента да е цитиран.

13.5 Запис в справочната библиотека

Включването или представянето на даден библиографски запис в библиотеката с препратки към ръкописа, в зависимост от конкретния ръкопис.

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

13.6 Позоваване

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

В описанията на нормативните модели за обекта „ръкопис“ ТРЯБВА да се използва по-точният термин поява на цитат, а за неговото представяне – визуализиран цитат.

13.7 Честота на цитиране

Препратка от конкретно място в ръкописа или обект към запис в справочната библиотека или библиографска записка.

Едно цитиране може да включва:

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

Няколко цитирания могат да сочат към един и същ библиографски запис.

13.8 Цел за цитиране

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

13.9 Локатор

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

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

Локаторът не е част от общото библиографско описание, освен ако не описва ресурса като цяло.

13.10 Група за цитиране

Подредена колекция от цитати, представени или обработени заедно на едно място в ръкописа.

Всеки член запазва своя собствена цел и локатор.

13.11 Режим на цитиране

Стойност, която описва как дадено цитиране се вписва в дискурса или презентацията.

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

Начинът на цитиране се различава от стила на цитиране.

13.12 Цел на цитирането

Структурирано посочване на научната връзка или причината за цитирането на даден източник.

Примерите могат да включват подкрепяне, опровергаване, разширяване, обсъждане, сравняване, възпроизвеждане, предоставяне на данни или представяне на метод.

Посочването на източника е по избор, освен ако профилът не го изисква.

13.13 Стил на цитиране

Набор от правила за форматиране на цитати и библиографии.

Примери за това са стиловете APA, Chicago, MLA, Vancouver, OSCOLA, както и стиловете, специфични за отделни списания.

Стилът на цитиране не определя идентичността или семантичната структура на цитирания източник.

13.14 Цитиране в превод

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

Извежда се визуализирана библиографска справка, а не самият авторитетен библиографски обект.

13.15 Библиография

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

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

13.16 Запис в библиографията

Едно визуализирано или сериализирано представяне на библиографски запис в рамките на дадена библиография.

13.17 Източник

Пренатоварен общ термин, който МОЖЕ да означава връзка, цитат, библиографска записка, препратка или източник.

В нормативните документи на OMI СЛЕДВА да се избягва употребата на термина референция без уточнение, когато се има предвид едно от следните:

• поява на цитат;
• библиографска записка;
• запис в справочната библиотека;
• препратка;
• позоваване на идентификатор;
• външна нормативна препратка.

13.18 Работа

В библиографското моделиране – абстрактно интелектуално или творческо творение, независимо от конкретен език, издание или форма на разпространение.

13.19 Израз

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

13.20 Проявление

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

13.21 Позиция

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

OMI профилите МОГАТ да използват опростен библиографски модел, когато тези разграничения не са необходими.

13.22 Сравняване

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

13.23 Премахване на дублираните данни

Процесът на идентифициране и управление на дублиращи се представяния на един и същ обект.

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

13.24 Оттегляне

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

Оттеглен обект не се изтрива от библиографската история. Неговият статус и връзките му ТРЯБВА да останат представяеми.

13.25 Поправка

Публикувана или документирана промяна, имаща за цел да поправи грешка в по-ранен научен обект или публикация.

Връзките за корекция ТРЯБВА да разграничават коригиращия обект от коригирания обект.

14. Език и превод

14.1 Език

Естественият или формалният език, свързан със съдържанието или метаданните.

При идентифицирането на езици чрез машинно четене СЛЕДВА да се използват езиковите маркери по BCP 47, когато това е приложимо.

14.2 Език на документа

Основният език, деклариран за конкретен екземпляр на документ.

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

14.3 Оригинален език

Езикът, на който е бил написан първоначално даден научен обект, произведение или документ във връзка с описаната връзка.

Статусът на оригиналния език зависи от контекста и ТРЯБВА да посочва съответния изходен обект или версия.

14.4 Превод

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

Преводът не е същото като локализацията.

14.5 Изходен език

Езикът на изходното съдържание, използвано за превода.

14.6 Целеви език

Езикът, на който се превежда съдържанието.

14.7 Единица за превод

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

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

14.8 Съвпадение на преводите

Структурирана връзка между един или повече изходни обекти и един или повече обекти на целевия език.

Съответствието може да бъде „един към един“, „един към много“, „много към един“ или „неустановено“.

14.9 Статус на превода

Работен процес или състояние на синхронизация, свързани с преведеното съдържание.

Примери за това могат да бъдат: непреведени, чернови, прегледани, одобрени, остарели и заменени.

14.10 Остарял превод

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

„Остаряло“ не означава непременно „неправилно“.

14.11 Локализация

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

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

14.12 Транслитерация

Предаване на текст от една писмена система в друга съгласно определен метод.

Транслитерацията не е превод.

15. Версии, промени и състояния

Версия 15.1

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

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

15.2 Преразглеждане

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

Някои спецификации могат да правят разграничение между незначителни промени и официално пуснатите версии.

15.3 Промяна

Записана операция или промяна, която променя съдържанието, метаданните, структурата, взаимоотношенията, правата за достъп или състоянието.

15.4 Набор от промени

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

15.5 Моментална снимка

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

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

15.6 Освобождаване от отговорност

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

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

15.7 Проект

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

По отношение на зрелостта на спецификацията се прилага формалната дефиниция, съдържаща се в политиката за жизнения цикъл на спецификациите.

15.8 Представена версия

Моментна снимка на документ, официално предоставена в рамките на редакционен, рецензионен, архивен или издателски работен процес.

15.9 Одобрена версия

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

15.10 Публикувана версия

Версия на документ или публикация, издадена с цел разпространение.

Когато има няколко публикувани версии, терминът ТРЯБВА да бъде уточнен.

15.11 Непроменима

Не се разрешава промяна при запазване на същата идентичност и обозначение на версията.

Една неизменна единица може да бъде заменена от нова версия.

15.12 Променлив

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

15.13 Клон

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

15.14 Обединяване

Операция, която обединява промените или историята на няколко клона или версии.

При всяко обединяване ТРЯБВА да се определи начинът за разрешаване на конфликтите и произходът, когато има вероятност да бъде засегната семантичната цялост.

16. Сътрудничество и достъп

16.1 Работно пространство

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

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

16.2 Член на работната група

Агент, на когото са предоставени роля или права в работната среда.

Членството зависи от контекста и може да включва статус, срок на валидност, източник на поканата и обхват на достъпа.

16.3 Роля

Определен набор от отговорности или очаквани дейности, които даден агент изпълнява в конкретен контекст.

Ролята не е автоматично набор от разрешения, въпреки че дадена политика може да съпоставя роли с разрешения.

16.4 Разрешение

Разрешение за извършване на определена операция върху определен ресурс или в определена област.

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

16.5 Контрол на достъпа

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

16.6 Собственик

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

Правото на собственост НЕ ТРЯБВА да се тълкува като право на интелектуална собственост, освен ако това не е изрично посочено в отделна правна политика.

16.7 Съавтор

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

Съавторството е роля, свързана със съвместна работа; само по себе си то не определя реда на авторите или политиката за авторство.

16.8 Програма за преглед

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

16.9 Покана

Структурирано искане, с което на агент се предлага членство или роля в работна среда или работен процес.

16.10 Събитие, свързано с одит

Записано събитие, свързано с отчетността, произхода, сигурността или историята на работния процес.

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

17. Технически характеристики, профили и съответствие

17.1 Спецификация на „OMI“

Регистриран технически документ, който определя нормативни структури, поведения, ограничения, речници или изисквания за оперативна съвместимост под постоянен идентификатор от типа „OMI-SPEC-NNN“.

17.2 Набор от спецификации

Координиран набор от спецификации, схеми, регистри, профили, примери и ресурси за съответствие на „OMI“, публикуван като едно издание на „OMI“.

17.3 Документ за управление

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

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

17.4 Нормативен

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

Нормативното съдържание установява задължения или авторитетни определения.

17.5 Информативно

Предоставя се с цел обяснение, контекст, насоки, обосновка или илюстрация, без да създава самостоятелни изисквания за съответствие.

17.6 Изискване

Проверяемо нормативно задължение или разрешение, изразено чрез спецификация.

17.7 Съответствие

Спазване на приложимите нормативни изисквания за декларираната версия на спецификацията, клас на съответствие и профил.

Съответствието винаги е ограничено по обхват. Неуточнено твърдение като „съвместимо сOMI“ е недостатъчно за официална употреба.

17.8 Клас на съответствие

Именована категория на роля при внедряването с дефиниран набор от приложими изисквания.

Примери за това са: производител, потребител, валидатор, рендериращ модул, редактор, импортер, експортер и модул за съхранение.

17.9 Декларация за съответствие

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

17.10 Профил

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

Един профил НЕ ТРЯБВА да противоречи без предупреждение на основната спецификация, която профилира.

17.11 Профил на публикациите

Профил, който определя изискванията и определя поведението за една или повече цели на публикуване.

Тя може да дефинира:

• задължителни метаданни;
• разрешени съоръжения;
• ред на секциите;
• стил на цитиране;
• отбележка за визуализация;
• формати на изхода;
• изисквания за достъпност;
• правила за валидиране.

17.12 Профил за валидиране

Профил, който определя кои правила за валидиране, нива на сериозност, речници и ограничения се прилагат в даден контекст.

17.13 Разширение

Декларирано допълнение към основния модел или поведение на „OMI“ чрез оторизиран механизъм за разширение.

Разширението НЕ ТРЯБВА да предефинира основната семантика без предупреждение.

17.14 Точка за разширение

Място или механизъм, изрично проектиран да позволява съвместимо разширение.

17.15 Пространство на имена за разширения

Стабилен обхват на идентификаторите, използван за разграничаване на имена, свойства, типове или стойности, дефинирани от разширението, от основните имена на OMI и други разширения.

17.16 Регистър

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

17.17 Запис в регистъра

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

17.18 Възможности

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

Възможността не е същото като разрешението. Възможността описва какво може да направи една система; разрешението описва какво има право да прави даден субект.

17.19 Ядро

Минималният общ нормативен модел или набор от възможности, изискван съгласно приложимото определение за съответствие на „OMI“.

Думата core ТРЯБВА да посочва версията си или контекста на спецификацията, когато съществува възможност за двусмислие.

18. Схеми, валидиране и обработка

18.1 Схема

Машинно-четима формализация на структурните ограничения за част от модела на данни „OMI“.

Схемата може да проверява валидността на типовете, задължителните свойства, кардиналността, синтаксиса и избраните взаимоотношения. Тя не определя автоматично цялата семантика или поведението при обработката.

18.2 Схема на „JSON“

Езикът за схеми, използван за изразяване на ограничения, които могат да бъдат проверени от машина, за представяния от типа „JSON“, беше приет в спецификацията „OMI“.

18.3 Валидиране

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

Проверката може да включва:

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

18.4 Валидатор

Имплементация или компонент, който извършва валидиране и отчита резултатите.

18.5 Правило за валидиране

Идентифицирано правило, оценено по време на валидирането.

Правилото за валидиране ТРЯБВА да определя обхвата, условието, степента на сериозност, съобщението и приложимата спецификация или профил.

18.6 Резултат от валидирането

Един от отчетените резултати от оценката на правило за валидиране спрямо целева стойност.

18.7 Доклад за валидиране

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

18.8 Валидно

Спазване на приложимите правила за валидиране за декларирана схема, спецификация и профил.

Командата „Valid“ НЕ ТРЯБВА да се използва, без да се посочи конкретният набор от правила, когато са възможни няколко такива.

18.9 Невалидно

Нарушаване на едно или повече приложими нормативни правила за валидиране.

18.10 Грешка

Състояние, което нарушава нормативна изискване или пречи на правилното изпълнение на дадена операция.

18.11 Предупреждение

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

18.12 Информационен резултат

Резултат от валидиране или обработка, който предоставя контекст, без да посочва невалидност или препоръчана корекция.

18.13 Процесор

Реализация или компонент, който използва данни от OMI и изпълнява определена операция.

Примери за това са парсерът, валидаторът, рендерерът, импортерът, експортерът, резолверът, конверторът и процесорът за съхранение.

18.14 Анализатор

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

Успешното синтаксично анализиране не означава семантична валидност.

18.15 Производител

Реализация, която създава или генерира данни, съответстващи на стандарта „OMI“.

18.16 Потребител

Реализация, която чете или обработва данни от OMI.

18.17 Рендериращ модул

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

18.18 Рендериране

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

Рендерирането НЕ ТРЯБВА да променя без предупреждение авторитетния семантичен източник.

19. Импорт, износ и оперативна съвместимост

19.1 Внос

Процесът на преобразуване или включване на данни от външно представяне в представяне от типа „OMI“.

19.2 Износ

Процесът на преобразуване на данни от „OMI“ във външно представяне или пакет с резултати.

19.3 Преобразуване

Преобразуване между представяния, формати, схеми или модели.

Импортът и експортът са еднопосочни форми на преобразуване по отношение на контекста на обработка на OMI.

19.4 Картографиране

Документирана връзка между понятия, свойства, стойности, структури или операции в изходния модел и целевия модел.

19.5 Картографиране без загуба на информация

Преобразуване, което запазва цялата информация, изисквана от обявения обхват на преобразуването, и позволява еквивалентно възстановяване.

19.6 Картографиране с условно беззагубно преобразуване

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

19.7 Картографиране със загуба на информация

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

Загубата ТРЯБВА да бъде документирана и СЛЕДВА да бъде отчитана от инструментите за конвертиране.

19.8 Отиване и връщане

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

В заявката за двупосочна операция ЗАДЪЛЖИТЕЛНО трябва да се посочи коя информация и семантика трябва да бъдат запазени.

19.9 Оперативна съвместимост

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

Оперативната съвместимост може да бъде структурна, семантична, поведенческа, оперативна или насочена към съхранение. СЛЕДВА да се посочи съответното измерение.

19.10 Съвместимост

Способността на версии, реализации, формати или профили да функционират съвместно в съответствие с определени изисквания.

Терминът съвместим, използван без уточнение, СЛЕДВА да се избягва. Спецификациите СЛЕДВА да посочват съвместимост „назад“, „напред“, „в двете посоки“, „поведение“, „схема“, „API“ или „профил“.

19.11 Съхранение

Управляваната дейност по поддържане на достъпността, целостта, идентичността, интерпретируемостта и произхода на научното съдържание във времето.

19.12 Процесор за съхранение

Решение, което проверява, групира, прехвърля, удостоверява или поддържа съдържание от типа „OMI“ с цел дългосрочно съхранение.

20. Терминология, свързана с внедряването

20.1 Прилагане

Софтуер, услуга, компонент, библиотека или система, които реализират една или повече спецификации или профили на „OMI“.

Реализацията не е самият стандарт.

20.2 Референтна реализация

Реализация, поддържана от „OMI“, предназначена за демонстриране, тестване и предоставяне на обратна връзка относно спецификациите.

Open Manuscript Studio е еталонна реализация. Поведението ѝ не е нормативно, освен ако не бъде включено в публикувана спецификация.

20.3 Независимо изпълнение

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

20.4 Open Manuscript Studio

Основното приложение за създаване на справочни материали и съвместна работа в OMI.

Официалното съкратено наименование е Studio, когато контекстът е еднозначен.

20.5 Документ „OMI“

Сериализиран документ, който декларира и съответства на спецификацията за документ или файлов формат „OMI“.

Изразът НЕ ТРЯБВА да се използва за всеки документ, който е просто редактиран с приложение, поддържащо формат „OMI“.

20.6 Поддръжка

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

Поддръжката ТРЯБВА да бъде определена като подходяща, например чете, записва, проверява, визуализира, импортира, експортира или съхранява.

20.7 Неизвестна функция

Характеристика, тип, свойство, разширение или стойност, които дадена реализация не разпознава.

20.8 Неподдържана функция

Призната функция, която дадена реализация не предоставя или не обработва.

„Неизвестно“ и „неподдържано“ са две различни състояния.

20.9 Определено от реализацията

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

Поведението, определено от конкретната реализация, ТРЯБВА да бъде документирано от реализацията, когато то засяга оперативната съвместимост или очакванията на потребителите.

20.10 Потребителски агент

Приложение, което действа от името на човешки потребител с цел създаване, показване, редактиране, преглед, потвърждаване или обработка на съдържание от OMI.

Терминът не означава научен субект, като например автор или организация.

21. Разграничения, при които лесно се допускат грешки

21.1 Ръкопис срещу файл

Ръкописът е научен интелектуален обект. Файлът е една от формите за съхранение или пренос на този обект.

Неправилно:

Ръкописът е ZIP файл.

Предпочитано:

Пакетът с ръкописа е сериализиран в контейнер на базата на ZIP.

21.2 Документ срещу публикация

Документът е структурирано представяне в контекста на обработката. Публикацията е публикуван резултат.

21.3 Библиографска записка срещу честота на цитиране

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

21.4 Сравнение между справочната библиотека и библиографията

Референтната библиотека е структурирана колекция, достъпна за ръкописа. Библиографията е подбрана и оформена колекция.

21.5 Анкер срещу анотация

Анкерът определя дадена цел. Анотацията свързва даден обект с тази цел.

21.6 „Бележка“ срещу „анотация“

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

21.7 Роля срещу право на достъп

Ролята описва отговорността или функцията. Разрешението дава право за извършване на дадена операция.

21.8 Спецификация срещу схема

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

21.9 Профил срещу разширение

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

21.10 Превод срещу локализация

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

21.11 Версия срещу ревизия

„Версия“ е общото наименование за дадено състояние. „Ревизия“ обикновено обозначава версия, създадена в резултат на промяна спрямо по-ранно състояние.

21.12 Възможност срещу разрешение

Възможността се отнася до техническата поддръжка. Разрешението се отнася до оторизацията.

21.13 „Валидно“ срещу „съответстващо“

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

21.14 Постоянни срещу неизменни

„Постоянен“ означава, че е предназначен да остане идентифицируем във времето. „Непроменлив“ означава, че не се допуска промяна при същата идентичност на версията.

22. Термини, които трябва да се уточнят или да се избягват

Нормативните документи от типа „OMI“ ТРЯБВА да дадат точно определение на следните двусмислени термини:

Да се избягва или да се уточнява	Да се предпочита
препратка	поява на цитат, библиографска записка, препратка към друг източник или нормативна препратка
източник	източник на метаданни, източник на превод, източник на импортирани данни или цитиран източник
версия	версия на ръкописа, версия на схемата, версия на реализацията или версия на публикацията
запис	библиографски запис, запис за валидиране, събитие от одит или вписване в регистъра
обект	научен обект, структурен обект, съдържателен обект или агент
редактор	редактор на ръкописи, редактор на списание, редактор на том, коректор или редактор по спецификации
формат	формат на файла, формат на публикацията, формат на представяне или модел на данни
съвместимост	съвместимост с по-стари версии, съвместимост с по-нови версии, двупосочна съвместимост или съвместимост по профил
валиден	валиден спрямо посочена схема, спецификация или профил
връзка	идентификатор, URL, анкор, цитат, препратка или връзка
потребител	автор, редактор, рецензент, преводач, администратор, читател или клиент на API
публикувано	публикувано като коя версия или резултат
каноничен	каноничен за какъв обхват и авторитет

Следните изрази НЕ ТРЯБВА да се появяват в нормативните изисквания без измеримо определение:

• подходящи метаданни;
• стандартен формат;
• стандартно цитиране;
• правилно представяне;
• удобен за ползване;
• високо качество;
• постоянна връзка;
• безопасно съхранение;
• пълна подкрепа.

23. Изписване с главни букви и форматиране

Общите понятия се изписват с малки букви:

ръкопис, котва, поява на цитат, профил

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

Open Manuscript Initiative, Open Manuscript Studio, Модел за цитиране, Регистър на спецификациите

Имената, свойствата, литералните стойности и идентификаторите, които могат да бъдат прочетени от машина, използват форматиране на кода:

Свойството „documentLanguage“ съдържа езиков таг.

Постоянните идентификатори на документи от типа „OMI“ използват префикси с главни букви:

OMI-SPEC-005
OMI-PROFILE-001
OMI-REG-001
OMI-SCHEMA-001
OMI-EXAMPLE-001

24. Съкращения

Съкращението ТРЯБВА да се изпише с пълното му наименование при първото му употребяване в документа, освен ако може разумно да се очаква, че целевата аудитория го познава.

Препоръчителните форми включват:

Съкращение	Значение
OMI	Open Manuscript Initiative
CSL	Език за стилове на цитиране
DOI	Идентификатор на цифров обект
ORCID	Идентификационен номер на изследовател и сътрудник
ROR	Регистър на изследователските организации
JATS	Набор от етикети за научни статии
API	Интерфейс за програмиране на приложения
URI	Унифициран идентификатор на ресурс
URL	Унифициран локатор на ресурси
UUID	Универсален уникален идентификатор
JSON	JavaScript Нотация на обектите
XML	Език за разширяема маркировка
PDF	Формат за преносими документи
EPUB	Електронно издание

При съкращенията в множествено число не се използва апостроф:

APIs, DOIs, URL адреси

25. Изисквания за превод

Официалните преводи на спецификациите на OMI ТРЯБВА да използват одобрен списък с терминология, специфичен за съответния език, извлечен от настоящия документ.

При превода ЗАДЪЛЖИТЕЛНО трябва да се запазят различията, включително:

• ръкопис срещу документ;
• разлика между цитиране и библиографски запис;
• сравнение между справочна библиотека и библиография;
• анкор срещу анотация;
• бележка срещу анотация;
• роля срещу разрешение;
• спецификация срещу схема;
• превод срещу локализация;
• възможност срещу разрешение;
• „валиден“ срещу „съответстващ“.

Когато една дума от целевия език обединява две понятия от „OMI“, в превода СЛЕДВА да се използва:

• квалифициран съставен термин;
• стабилен технически заем;
• разяснение в скоби;
• бележка към речника, отнасяща се до конкретен език.

Имената на свойствата, стойностите на изброенията, идентификаторите, типовете медии, идентификаторите на пространствата от имена и идентификаторите на изискванията НЕ ТРЯБВА да се превеждат.

26. Добавяне или промяна на терминология

Предложението за добавяне на централен термин ТРЯБВА да включва:

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

Всяка промяна в дефиницията ТРЯБВА да бъде оценена съгласно Политиката за версии на „OMI“.

Една промяна може да доведе до срив, когато променя:

• същността на понятието;
• обхванатите субекти;
• нормативно тълкуване;
• схема или значението на „API“;
• резултати от проверката за съответствие;
• установени съответствия с външни стандарти.

Остарелите термини ТРЯБВА да останат документирани заедно с техните заместители и НЕ ТРЯБВА да бъдат преопределяни без предупреждение.

27. Външни съответствия на терминологията

OMI може да съпостави термините си с външни стандарти, но НЕ СЛЕДВА да се приема, че има еквивалентност само защото наименованията са сходни.

В описанието ТРЯБВА да се посочи дали то е:

• точно;
• по-тесен;
• по-широк;
• припокриване;
• зависи от контекста;
• не са равностойни.

Примери за подходящи външни източници на терминология включват:

• JATS;
• Език за стилове на цитиране;
• Метаданни на Crossref;
• Метаданни на DataCite;
• ORCID;
• ROR;
• Dublin Core;
• schema.org;
• библиотечни и архивни модели;
• модели за уеб-анотации;
• стандарти за съхранение.

Външните съответствия имат информативен характер, освен ако не са включени като нормативни изисквания в спецификация на OMI.

28. Очаквания за съответствие

OMI В спецификациите и официалните профили ТРЯБВА да се използват основните термини последователно.

Една съответстваща реализация МОЖЕ да използва различни етикети в потребителския интерфейс, но експортираните от нея данни, API, документацията и декларациите за съответствие ТРЯБВА да запазват определените концептуални разграничения.

Една реализация НЕ ТРЯБВА да твърди, че две основни концепции от OMI са еквивалентни, когато спецификациите ги разграничават.

Свойство на схемата или поле от типа „API“, което използва централен термин, ТРЯБВА да съдържа препратка към съответната дефиниция в генерираната документация или да я възпроизвежда.

29. Поддръжка

Настоящият документ се поддържа в съответствие с цикъла на разработка на спецификациите, политиката за версиониране и ръководството за стил на спецификациите на „OMI“.

Прегледът на терминологията СЛЕДВА да се извършва, когато:

• се изготвя нова спецификация;
• една схема въвежда нов основен тип или свойство;
• в двете спецификации една и съща дума се използва с различно значение;
• външното съпоставяне разкрива концептуално несъответствие;
• официалният превод не може да запази ясно това разграничение;
• Опитът от внедряването показва, че има неясноти.

Редакционните корекции могат да се публикуват като версии на кръпки. Съвместимите допълнения могат да се публикуват като второстепенни версии. Промените, които променят установеното нормативно значение, изискват основна версия или документирана промяна, нарушаваща съвместимостта, преди версия 1.0.

30. Обобщение

OMI зависи от различия, които обичайните програми за работа с документи често скриват.

Ръкописът не е файл. Появата на цитат не е форматиран цитат. Библиографският запис не е вписване в библиографията. Анкерът не е анотация. Ролята не е разрешение. Спецификацията не е схема. Референтната реализация не е стандартът.

Поддържането на тези разграничения позволява на независимите системи да обменят научно съдържание, без да се налага многократно преосмисляне на неговия смисъл. Поради това настоящият терминологичен документ представлява част от архитектурната основа на мрежата „Open Manuscript Initiative“.