Вікісховище:Підписи файлів

Підписи файлів

Підписи файлів є складовою частиною Структуровані дані (перша частина, яку можна увімкнути). Вони призначені для зберігання коротких багатомовних описів файлів. Дивіться Довідка:Підписи файлів для отримання додаткової інформації. Вони були увімкнені на Вікісховищі в січні 2019 року.

Що робить підпис гарним?

Точні рекомендації щодо підписів до файлів ще мають бути розроблені.

Існують технічні вимоги (обмежені довжиною 255 символів і не можуть містити розмітку), які обов'язково роблять підписи короткими.

ПОШИРЕНІ ЗАПИТАННЯ

Чим це відрізняється від описів?

• Підписи повинні бути простими і короткими. У той час як описи можуть бути дуже розлогими, підписи обмежені довжиною 255 символів, не можуть містити розмітку (як посилання у Вікітексті або HTML) та не підтримують зовнішні посилання.
• Підписи доступні як частина наших структурованих даних, тоді як описи - ні. З технічної точки зору, опис - це звичайний вікітекст, загорнутий у мовний шаблон, знову загорнутий у шаблон інформації; тоді як підписи - це Вікібаза label. Як такі, вони будуть доступні для пошуку через API, що дозволить легко знаходити/фільтрувати/витягувати підписи з файлів як метадані.

У багатьох випадках підпис буде подібним або ж ідентичним опису (або навіть назві файлу!). Наприклад, File:Fire station Hallstatt - October 2017 - 02.jpg має підпис англійською "Hallstatt fire station in October 2017".

Та навпаки, на Pluto-01 Stern 03 Pluto Color TXT.jpg дуже великий опис (858 символів, і посилання), а підпис значно коротший (більш-менш такий самий підпис, що використовується у статтях Вікіпедії, які використовують це зображення).

Чи не можу я (або бот) просто скопіювати описи в підписи?

По-перше, підписи коротші, ніж багато описів, вони не можуть містити посилань та вікі-розмітки.

Хоча може бути можливим скопіювати короткі фрагменти тексту з опису до підпису, це потребує людської інтерпретації.

У титри слід копіювати лише той текст, який є настільки коротким, що не є об'єктом авторського права, оскільки титри публікуються з відмовою від авторських прав за ліцензією CC0 ("суспільне надбання").

Які переваги підписів?

Однією з основних переваг є покращена можливість пошуку з урахуванням мови. Класичні описи файлів знаходяться у вікітексті, і їх можна шукати лише за допомогою повнотекстового пошуку, який обов'язково переглядає весь вміст сторінки, включаючи категорії та шаблони ліцензій; при цьому неможливо здійснити пошук за мовою. Оскільки вони доступні для пошуку через API, стороннім користувачам легше знаходити та повторно використовувати медіа та самі підписи.

Іншими можливими варіантами використання можуть бути:

• заповнення інфобоксів
• запитувати файли на предмет відсутності підписів певною мовою
• створення списків для перекладу важливих файлів, які потребують локалізації субтитрів для проекту або кампанії
• …

Де зберігаються підписи?

Підписи зберігаються на Вікісховищі, як частина Wikibase (а отже, не як частина вікітексту). Вони не зберігаються у Вікіданих. Хоча Вікібаза дійсно забезпечує роботу Вікіданих, вона також розгорнута тут, на Вікісховищі.

Як здійснювати пошук за підписом?

Користувачі можуть шукати файли за їхніми підписами MediaInfo так само, як вони шукали б будь-що інше. Наприклад, якщо користувач завантажує зображення Ейфелевої вежі і вводить ‘Tour Eiffel’ (французькою) та ‘Eiffel Tower’ (англійською) як багатомовні підписи до файлу, зображення може бути знайдене іншим користувачем, який шукає або ‘Eiffel Tower’, або ‘Tour Eiffel’.

Чому у мене відображаються мови X Y та Z?

Якщо ви зареєстрований користувач, то відображатимуться мови, перелічені у Babel boxes на Ваша сторінка користувача.

Як змінити зовнішній вигляд підписів?

Ви можете увімкнути наступні гаджети у ваших налаштуваннях (у розділі "Інтерфейс: Файли та категорії"):

• Згорнути блок підписів і додати посилання для його розгортання при необхідності: Згорнути підписи (main script code, additional style code)
• Зробити блок підписів компактнішим: Компактні підписи (код)
• Щоб повністю приховати підписи: Приховати підписи (код)

"Згорнути підписи" та "Компактні підписи" можна комбінувати за бажанням.

Див. додатково розділ Стилістика нижче.

Як запросити підписи за допомогою API?

Підтримка API поки що обмежена, але незабаром буде покращена.

Отримати підписи можна за допомогою wbgetentities модуля з ID. Для кожного файлу існує ID Вікісховища MXXXX, XXXX як page_id. Так, наприклад, File:Pluto-01 Stern 03 Pluto Color TXT.jpg має ідентифікатор сторінки 41837276, тому ідентифікатором сутності є M41837276, і ви можете запитати wbgetentities&ids=M41837276. Простий спосіб отримати Mid - скористатися API action=query&prop=info&titles=File:Pluto-01_Stern_03_Pluto_Color_TXT.jpg (ідентифікатор сторінки надається полем pageid).

Як зробити запит до підписів за допомогою Lua/шаблонів

З Lua до них можна отримати доступ за допомогою функції _SDC_Description в Інформація, які мають шаблонний інтерфейс {{File caption}}.

Як встановити підписи під час завантаження?

Додавання підписів у Майстрі завантаження Upload Wizard.

Ви вже можете заповнювати підписи під час завантаження за допомогою Upload Wizard. Ви можете pre-fill (поля попереднього заповнення) підпис з URL-параметрами caption та captionlang при виклику Майстра завантаження за посиланням, наприклад, в контексті кампанія завантаження.

Підтримка інших способів завантаження буде додана в майбутньому - ви можете стежити за роботою на різних баг-трекерах, for Pywikibot, for the Commons Android app або for Pattypan.

Як редагувати підписи за допомогою API?

Ви можете використовувати API модуль wbsetlabel з ID MXXXX (ідентифікатором) об'єкта (більш детально див. розділ про подання запитів).

Стилізація

Поле форми підписів можна стилізувати за допомогою CSS Cascading Style Sheets. Додайте правила в your common.css file або аддон для браузера, наприклад Stylus Userstyles Manager або xStyle. В останньому випадку слід скористатися наданим обмеженням для домену Вікісховища commons.wikimedia.org.

Показати підпис у згорнутому вигляді

За допомогою гаджета Collapse Captions (Згорнути підписи) у згорнутому режимі за замовчуванням, окрім рядка Expand (Розгорнути), ви будете бачити лише порожнє поле. Наступне зробить підпис видимим у цьому стані (тобто Captions вашою мовою):

.mw-collapsible-content { display: initial !important; }
.mw-slot-header,
.wbmi-entityview-captionsPanel.mw-collapsed .mw-collapsible-content *:not(.wbmi-entityview-captions-header)
	{ display: none; }
.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header	{
	display: block;
	border-bottom: none;
	margin-bottom: 0;
	padding-top: 0;
	font-style: italic;
	font-weight: normal;
}
.ltr .mw-collapsible-content .wbmi-entityview-captions-header { text-align: right; }
.rtl .mw-collapsible-content .wbmi-entityview-captions-header { text-align: left; }
.rtl .mw-collapsible-toggle { float: left; }

Примітки:

• Через метод, яким номери рядків вставлені тут, у презентації, у копії правил ви побачите, що кожен другий рядок буде порожнім. Ви можете сміливо видалити ці порожні рядки, якщо хочете. Насправді є ще деякий відступ з символом табуляції, який тут також не показаний.
  Це стосується і наступних правил, номери рядків яких вказані нижче.
• Line 1: У тестах була необхідна частина !important. Це викличе попередження тут на Вікісховищі в редакторі коду common.css. Можливо, при використанні цього файлу його можна було б навіть не вказувати (протестовано лише з браузерним аддоном).
• Line 2: Це призведе до видалення заголовку (Structured data вашою мовою). Якщо ви хочете, щоб він відображався, видаліть цей рядок разом з комою.

• Lines 10–12 are for formatting of the visible caption. If you want to have the default upright, bold string, delete these lines.
• Lines 13–14: You probably need in most cases only either of these two rules, though it doesn’t matter if you copy them both. To decide which one you usually will need look at their beginning:
  • .ltr: left-to-right writing systems like Latin script (e.g. English).
  • .rtl: right-to-left writing systems like Arabian script.

If you want to have the default string at beginning (left for ltr, right for rtl systems), delete these lines.

• Line 15 is only needed for rtl systems. It sends the toggle for collapsing and decollapsing to the left of the page. This rule will be active also for every toggle on all other Commons pages.

Further styling just for appearance, add this below the rules from above:

.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header::after { content: " …"; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header {
	border-bottom: none;
	text-decoration: underline;
}

Notes:

• Line 1: If the ellipsis inside of content: " …"; is not in the usual style of your language then replace it according to your taste, but do not omit the quote signs! If the added content is on the wrong side in your writing system then replace after with before.
• Lines 2–5 are for the caption in uncollapsed mode. If you don’t want it to be underlined then delete line 4.

Більш компактний згорнутий режим

… but not that compact like with the gadget Compact Captions

При меншій роздільній здатності це заважатиме попередньому перегляду та інформації про розмір для всіх файлів, де MediaViewer не присутній (тобто для всіх файлів, що не мають типу image). Дивіться першу примітку нижче.

.mw-slot-header { display: none; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header
	{ border-bottom: none; }
.wbmi-entityview-captionsPanel {
	border: none;
	margin-top: -1.5em;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-captions-header {
	margin-bottom: 0;
	padding-top: 0;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-entitycontent {
	padding: 0.3em 0;
}

Notes:

• If the block interferes with the preceding text block, then delete line 6 or at least reduce the amount of the value. margin-top: -0.5em; seems to be usable.
• Lines 1–3 can be left out if you use the unchanged rules from above, but it does not cause harm if you add them twice, as long as you remember this in future edits.

Further styling just for appearance:

.wbmi-entityview-captions-header .wbmi-entityview-editButton { font-size: smaller; }
.ltr .wbmi-entityview-editButton { margin-left: 0.25em !important; }
.rtl .wbmi-entityview-editButton { margin-right: 0.25em !important; }
.wbmi-entityview-editButton::before { content: "("; }
.wbmi-entityview-editButton::after { content: ")"; }

Notes:

• Lines 2–3: Read notes above for .ltr and .rtl.
• Lines 4–5: If you do not want to have parentheses around the edit string (Edit in your language) either delete both rules or replace them with your preferred characters inside of content: "…";, but do not omit the quote signs!