Commons:Machine-readable data/ru

Shortcut: COM:MRD

На Викискладе многие метаданные (включая лицензию и автора) не доступны в машиночитаемой форме. Существует API-модуль iiprop=extmetadata, который может быть использован для получения некоторых значений (пример), но так как информация введена в свободной текстовой форме на самой странице описания файла, это не идеальный вариант. Проводимый проект Структурированные данные на Викискладе направлен на перемещение метаданных в виде полностью структурированных данных и в конечном итоге заменит машиночитаемые данные, представленные на этой странице.

Тем временем, чтобы облегчить переход к более структурированным данным в будущем, Викисклад использует набор стандартных шаблонов, которые были сделаны машиночитаемыми определённым образом, через HTML-элементы. Некоторые скрипты уже используют это. Стоит отметить, что эти данные доступны для любой вики, использующей Викисклад, где они могут быть прочитаны из HTML страницы «File:», как и другие локальные данные.

Машиночитаемые данные

Машиночитаемые данные, задаваемые информационными шаблонами-карточками

Есть несколько стандартных шаблонов-инфобоксов, помечающих различные элементы шаблона различными тегами, что позволяет парсинг информации. Используются несколько различных стилей тегов:

  • Метки микроформатов следуют индустриальным стандартам и могут быть разобраны уже существующими инструментами.
  • Атрибуты id (идентификаторы) тега <td> являются пользовательской разметкой, которая позволяет задавать более полные теги, которые могут быть прочитаны пользовательскими инструментами. Наиболее универсальные инфобоксы имеют двухстолбцовую структуру: столбец № 1 содержит имя поля, а столбец № 2 значение
    • Традиционно атрибуты id (идентификаторы) тега <td> использовались для отметки имени, данного ячейке в первом столбце строки. Для получения данных вам нужно будет получить содержимое следующей ячейки <td> во втором столбце.
    • Шаблоны {{Creator}} и {{Institution}} имеют более сложную структуру, поэтому ячейки с фактическими данными помечены атрибутами пурпурного цвета.
Шаблон Название параметра шаблона Описание Атрибут id у <td> Микроформат Комментарий
{{Information}}descriptionописание файлаfileinfotpl_deschProduct.description.Часто содержит несколько языков, оформленных шаблоном {{Lang}}.
{{Information}}dateдата создания оригинальной работыfileinfotpl_datehCalendar vevent.dtstartИногда дополнительно содержит дату публикации или содержит только ее. Эти две даты имеют разное значение для защиты прав. Если используется {{Date context}}, может показать разницу. Микроформат, добавленный шаблоном {{Date}}
{{Information}}sourceисточник файлаfileinfotpl_srcЧасто содержит целые таблицы. Пока что у нас нет хороших способов обращения с этими шаблонами источников. Шаблоны источников часто содержат идентификаторы каталогов, но и они не машиночитаемы.
{{Information}}authorавтор файлаfileinfotpl_autЭто может быть автор, создатель и/или обладатель авторских прав и используется по-разному. Часто содержит шаблон {{Creator}}, описание которого приведено ниже.
{{Information}}permissionразрешение/лицензия для файлаfileinfotpl_perm
{{Information}}other versionsдругие версии файлаfileinfotpl_ver
{{Artwork}}descriptionописание художественного произведенияfileinfotpl_deschProduct.description
{{Artwork}}dateдата создания оригинала художественного произведенияfileinfotpl_datehCalendar vevent.dtstartмикроформат, добавленный шаблоном {{Date}}
{{Artwork}}sourceисточник файлаfileinfotpl_src
{{Artwork}}artistсоздатель художественного произведенияfileinfotpl_aut"hProduct.fn value"
{{Artwork}}authorавтор произведенияfileinfotpl_aut"hProduct.fn value"
{{Artwork}}permissionразрешение/лицензия для файла и художественного произведенияfileinfotpl_perm
{{Artwork}}other versionsдругие версии файлаfileinfotpl_ver
{{Artwork}}titleзаголовок художественного произведенияfileinfotpl_art_titlehProduct.fn
{{Artwork}}object typeтип объекта художественного произведенияfileinfotpl_art_object_type
{{Artwork}}mediumтехника или способ создания художественного произведенияfileinfotpl_art_medium
{{Artwork}}dimensionsразмеры художественного произведенияfileinfotpl_art_dimensions
{{Artwork}}galleryучреждение, в котором хранится художественное произведениеfileinfotpl_art_gallery
{{Artwork}}locationместоположение художественного произведения внутри учрежденияfileinfotpl_art_locationhProduct.locality
{{Artwork}}accession numberИнвентарный номер художественного произведенияfileinfotpl_art_idhProduct.identifier
{{Artwork}}object historyистория объекта художественного произведенияfileinfotpl_art_object_history
{{Artwork}}exhibition historyистория выставок художественного произведенияfileinfotpl_art_exhibition_history
{{Artwork}}credit lineсоздатель художественного произведенияfileinfotpl_art_credit_line
{{Artwork}}inscriptionsкраткое посвящение художественного произведенияfileinfotpl_art_inscriptions
{{Artwork}}notesзаметки о художественном произведенииfileinfotpl_art_notes
{{Artwork}}referencesссылки, связанные с художественным произведениемfileinfotpl_art_references
{{Book}}Authorавтор книгиfileinfotpl_author
{{Book}}Editorредактор книгиfileinfotpl_book_editor
{{Book}}Translatorпереводчик книгиfileinfotpl_book_translator
{{Book}}Illustratorиллюстратор книгиfileinfotpl_book_illustrator
{{Book}}Titleзаголовок книгиfileinfotpl_book_title
{{Book}}Subtitleподзаголовок книгиfileinfotpl_book_subtitle
{{Book}}Series titleназвание серии книгfileinfotpl_book_series-title
{{Book}}Authority fileданные нормативного контроляfileinfotpl_book_authority
{{Book}}Publisherиздатель книгиfileinfotpl_book_publisher
{{Book}}Printerпечатник книгиfileinfotpl_book_printer
{{Book}}Year of publicationдата или год публикации книгиfileinfotpl_date
{{Book}}Place of publicationместо или город публикации книгиfileinfotpl_book_place-of-publication
{{Book}}Languageязык книгиfileinfotpl_book_language
{{Book}}Descriptionописание книгиfileinfotpl_desc
{{Creator}}Nameимя создателяcreatorvCard.fn
{{Creator}}Alternative namesдругие имена создателяfileinfotpl_creator_alt-name_valuevCard.nickname
{{Creator}}Descriptionнациональность и профессия(и) создателяfileinfotpl_creator_desc_valuevCard.note
{{Creator}}Date of deathдата смерти создателяfileinfotpl_creator_deathdate_value
{{Creator}}Date of birthдата рождения создателяfileinfotpl_creator_birthdate_valuevCard.bday
{{Creator}}Location of birth/deathместо смерти создателяfileinfotpl_creator_deathloc_value
{{Creator}}Location of birthместо рождения создателяfileinfotpl_creator_birthloc_value
{{Creator}}Work periodпериод активности создателяfileinfotpl_creator_work-period_value
{{Creator}}Work locationместо работы создателяfileinfotpl_creator_work-location_valuev
{{Creator}}Imageпортрет или фото, изображающие создателяfileinfotpl_creator_image
{{Creator}}Authority fileавторитетный контроль, связанный с создателемfileinfotpl_creator_authority_value


{{FileContentsByBot}}(различные)по-разному, пожалуйста, обсуждайте шаблон {{FileContentsByBot}}(various)hproduct-by-botбольшой набор данных, который продолжает расти, обсуждайте шаблон {{FileContentsByBot}}
{{Photograph}}titleназвание фотографииfileinfotpl_art_titlehProduct.fn
{{Photograph}}descriptionописание фотографииfileinfotpl_deschProduct.description
{{Photograph}}original descriptionпервоначальное описание фотографии в архивеfileinfotpl_deschProduct.description
{{Photograph}}dateдата создания оригинала произведенияfileinfotpl_datehCalendar vevent.dtstartмикроформат, добавленный шаблоном {{Date}}
{{Photograph}}mediumтехника или материал фотографииfileinfotpl_art_medium
{{Photograph}}dimensionsразмеры фотографииfileinfotpl_art_dimensions
{{Photograph}}artistсоздатель фотографииfileinfotpl_aut"hProduct.fn value"
{{Photograph}}institutionучреждение, в котором хранится художественное произведениеfileinfotpl_art_gallery
{{Photograph}}locationместонахождение художественного произведения внутри учрежденияfileinfotpl_art_locationhProduct.locality
{{Photograph}}sourceисточник файлаfileinfotpl_src
{{Photograph}}permissionразрешение/лицензия для файла и художественного произведенияfileinfotpl_perm
{{Photograph}}other versionsдругие версии файлаfileinfotpl_ver
{{Photograph}}accession numberномер, по которому доступна фотографияhProduct.identifier

Другой возможный формат метаданных Commons

Из-за того, что формат таблица+идентификатор очень сложно добавлять в шаблоны, отличающиеся по формату от шаблона Информация в Commons, в качестве другого возможного формата можно использовать CommonsMetadata, похожий на шаблоны лицензий: весь информационный шаблон должен заключаться в класс fileinfotpl, а тег, содержащий конкретную информацию, должен иметь класс fileinfotpl_* (с такими же именами, как и выше, но для классов, а не для идентификаторов).

Машиночитаемые данные, задаваемые шаблонами лицензий

Появилось в октябре 2010 года с использованием классов <span class="licensetpl_XXX">

licensetpl
Элемент, идентифицирующий лицензию. Служит «обёрткой» для всего кода лицензии, должен быть ЕДИНСТВЕННОЙ лицензией, а не мульти-лицензией.
licensetpl_short
Короткое название лицензии: «Public domain», «CC BY-SA 3.0», «CC by 2.0 fr» и т. п.
licensetpl_long
Длинное название лицензии: «Public domain», «Creative Commons Attribution-Share Alike 3.0».
licensetpl_attr_req
Требуется ли атрибуция: «true» (истина) или «false» (ложь).
licensetpl_attr
Требуемая атрибуция: текст в свободной форме.
licensetpl_link_req
Требуется ли для этой лицензии ссылка на лицензию: «true» или «false».
licensetpl_link
Ссылка на документ лицензии: «www.creativecommons.org/licenses/by-sa/XXX/YYY»
licensetpl_nonfree
«true», если это несвободная лицензия (не используется на Викискладе, только для вики-проектов с ПДИ)

Несколько блоков licensetpl для одного произведения могут быть заключены в общий блок, имеющий класс licensetpl_wrapper.

Шаблоны, задающие эту информацию

Машиночитаемые данные, задаваемые шаблонами форматирования

Шаблоны форматирования стилей, созданные для единого оформления различных семейств шаблонов, не связанных с лицензией, содержат машиночитаемые данные, позволяющие идентифицировать эти данные.

Шаблон Назначение название класса
{{Restriction-Layout}} используется в сообщениях с предупреждениями restrictiontemplate
{{FoP-Layout}} используется шаблонами, касающимися свободы панорамы foptemplate
{{Partnership-Layout}} используется шаблонами об организациях-партнёрах partnershiptemplate
{{Source-Layout}} используется общими шаблонами источников sourcetemplate
{{Created with}} используется шаблонами «Создано с помощью…» createdwithtemplate

Машиночитаемые данные, задаваемые шаблонами, не касающимися охраны авторских прав

Шаблоны, описывающие правовые ограничения, не связанные с авторскими правами, содержат эти классы, чтобы идентифицировать специфичные шаблоны ограничений.

Шаблон(ы) Цель название класса
{{Trademarked}} Изображения с торговой маркой restriction-trademarked
{{Copydesign}} Дизайн, на который действуют авторские права. restriction-design
{{Communist symbol}} Коммунистические символы restriction-communist
{{Italy-MiBAC-disclaimer}} {{Soprintendenza}} Репродукции итальянских произведений restriction-ita-mibac
{{Australian Commonwealth reserve}} Заповедники Австралии restriction-aus-reserve
{{Personality rights}} {{Romania personality rights}} Права личности restriction-personality
{{2257}} Сообщение, связанное с Актом по защите детей и борьбе с непристойностью (США) restriction-2257
{{Costume}} Костюмы restriction-costume
{{Fan art}} Фан-арт restriction-fan-art
{{Currency}} Валюта restriction-currency
{{IHL Symbol}} Cимволы, использование которых регулируется Международным гуманитарным правом. restriction-ihl
{{Nazi symbol}} Нацистские и фашистские символы restriction-nazi
{{Insignia}} Официальные знаки отличия restriction-insignia

Машиночитаемые данные, задаваемые особыми шаблонами

Задаются и другие машиночитаемые данные. Некоторые из них приведены ниже:

{{Personality rights}}
<span class="commons-template-name" style="display:none" id="commons-template-personality-rights">Personality rights</span>
{{Credit line}}
<td id="fileinfotpl_credit" class="fileinfo-paramfield fileinfotpl_credit" style=""></td>

Машиночитаемые данные, задаваемые шаблонами местоположения

{{Location}} и подобные шаблоны добавляют машиночитаемые данные георасположения в следующем формате: <span class="geo">12.34;24.68</span> (широта и долгота как числа с плавающей запятой, разделённые точкой с запятой). Координаты используют систему WGS 84 (ту же, которую использует GPS и большинство онлайн-карт). Более подробную информацию смотрите на странице Викисклад:Geocoding.

Использование

MediaWiki API

Сейчас MediaWiki API обслуживает ограниченное количество метаданных. Рассмотрим следующий запрос:

(Открыть в API-песочнице) который возвращает некоторые полезные параметры, такие как Credit, Artist, LicenseUrl и Copyrighted и используется, например, виджетом Media Viewer.

Скрипты, использующие машиночитаемые данные

Внешние инструменты

Смотрите также

Определение новых машиночитаемых данных

  • НЕ используйте HTML-идентификаторы, используйте классы. Идентификатор можно использовать только один раз на странице, и большинство этих полей могут встречаться несколько раз на странице. Рассмотрим, например, описания производных работ, которые могут включать информацию об оригинале и производной.
  • Когда это возможно, оберните фактические данные, а не какой-то заголовок поля. Этот последний метод исторически используется для всех наших информационных шаблонов, но его гораздо сложнее поддерживать в долгосрочной перспективе.
  • Оберните данные, а не то, как они отформатированы.
  • Ожидайте, что форматирование потеряется при преобразовании данных. Визуальное оформление не является частью информации.
  • Не заключйте много единиц информации в одно поле. Есть разница между датой публикации и датой создания. И та, и другая являются датой, но обе являются 'полями данных'. Аналогично CC-by-SA-4.0-3.0-2.5 — название не одной лицензии, а три лицензии с названиями CC-by-SA-##.
  • Убедитесь, что значения данных имеют одинаковые единицы измерения или дают одну постоянную единицу измерения.

Проблемы

Есть несколько вещей, которые пока НЕ учитываются или плохо учитываются. К ним относятся:

  • Производные работы
  • Произведения, вошедшие в другие произведения. См. также Category:FoP_templates
  • Производные лицензии или произведения, включенные в произведения, ведут к неразберихе.
  • Автор / правообладатель
  • Имена пользователей / 'настоящие имена'
  • Идентификаторы каталогов и т. д.
  • Разрешения VRTS
  • Дата публикации / дата создания
  • Учреждения, предоставившие материалы
  • Все описания, НЕ указанные выше, не могут быть распознаны вообще и рано или поздно потребуют ручной обработки
  • Наследники: {{Heirs license}}
  • Работы, имеющие несколько лицензий CC, которые используют {{Cc-by-3.0,2.5,2.0,1.0}}, {{Cc-by-sa-2.5,2.0,1.0}}, {{Cc-by-sa-4.0,3.0,2.5,2.0,1.0}} или {{Cc-by-all}}.
  • Нелицензируемые работы: {{Copyrighted free use}}, {{Attribution}} (Вопрос, как описать, что удалось получить это право на использование?)
  • Нестандартные шаблоны для описания файлов, например User:Tevaprapas/Information
  • Шаблоны, указывающие на охрану прав части произведений: {{Copyright information}}
Category:Commons help/ru
Category:Commons help/ru