View source for Help:Service links/uk

{{SMW_user_TOC_(uk)}}
{{DISPLAYTITLE:Help:Службові гіперланки}}
{{Interlanguage}}
[[Semantic MediaWiki| Семантична МедіаВікі]] може надавати '''гіперланки до онлайн-служб''', коли виводить певні дані в [[Help:Browsing_interfaces#The_Factbox|зведенні даних]], спеціальній сторінці [[Help:Special:Browse|Перегляд]] та на сторінках властивостей.

Наприклад, якщо стаття містить географічні координати, корисно давати посилання на онлайн-сервіси відображення, так що користувачі можуть отримати карту місцевості з одним натиском маніпулятора. Іншим прикладом є надання гіперланки на онлайн конвертер валют. Ця сторінка пояснює, як можна додати такі функції.

== Службові гіперланки для властивостей==
Інформація для додаткових гіперланок на онлайн-послуги в зведенні даних і на спеціальній сторінці Перегляд, пов'язані з використанням
[[Help:Properties and types|вслативостей]]. Для прикладу, [[Property:Has coordinates]] показуватиме різноманітні гіперланки на онлайн-карти. В той час як інші властивості, які також використовують тип даних [[Help:Type Geographic coordinate|Geographic coordinate]] можуть не показати цього. Це дуже важливо у багатьох додатках, так як тип даних сам по собі, як правило, не містить відомостей про тип гіперланки.

Для того, щоб відображати службові гіперланки, слід додати спеціальну властивість [[Property:Provides service|provides service]] на сторінці властивості. Для прикладу, сторінка Property:Has coordinates може включати в себе розмітку:

 <nowiki>[[provides service::online maps]]</nowiki>

Тут, "онлайн карти" це ім'я набору службових гіперланок, представлених у вікі. У наступному розділі пояснюється, як визначити ці служби зв'язку.

Після вказання, що властивість надає службові гіперланки, її значення у зведенні даних, на спеціальній сторінці Перегляд і на власній сторінці з'явиться значок ([[File:Service links icon.png|link=|alt=icon for service links]]), котрий відобразить службові гіперланки, якщо натиснути на нього.

== Надання службових гіперланок ==
У двох словах, адміністратором пише текст, визначаючи появу службових гіперланок в статті.

Зазвичай тільки користувачі, у яких є адміністративні привілеї в вікі можнуть додавати або редагувати сторінки в просторі імен МедіаВікі, отже, тільки вони можуть змінити службові гіперланки.
Це розумне обмеження для більшості вікі: оскільки служба гіперланок можуть з'явитися в тисячі таблиць зведених даних, вони повинні бути перевіреними. Додавання або зміна служб зазвичай має обговорюватися серед багатьох користувачів до того, як адміністратор застосує на практиці.
Всі користувачі, однак, можуть вільно пов'язувати властивості з доступними послугами, як описано раніше.

=== Назва системного повідомлення ===
Формат системного повідомлення: <code>MediaWiki:Smw service ''service name''</code>. Частина "MediaWiki:Smw service" завжди залишається незмінною, а ім'я служби змінюється з кожним системним повідомлення.

Продовжуючи наш приклад для [[Property:Has coordinates|Has coordinates]], текст <code><nowiki>[[Provides service::online maps]]</nowiki></code> є у назві повідомлення [[MediaWiki:Smw service online maps]].

=== Зміст системного повідомлення ===
Якщо подивитись на [[MediaWiki:Smw service online maps]], то повідомлення може бути важко читати через довгі рядки, а його формат по суті полягає в наступному:

<pre>
 label text1|http://певнийсайт.com
 label text2|http://sd.org.ua
 label text2|http://ar25.org
 ...
</pre>

Кожен рядок містить службову гіперланку. Мітка ''label'' це текст, який будуть бачити користувачі в службовій гіперланці, що з'явиться. Після символу '|' написана адреса, куди веде гіперланка. Для кращого розуміння, будь ласка, натисніть "View source" у верхній частині сторінки, щоб побачити вихідний текст на цій сторінці.

==== Заповнювачі в системних повідомленнях ====
У більшості випадків, є потреба надати інформацію зі значення властивості у вигляді гіперланки. Наприклад, вказівник на сервіс онлайн-карт повинен включати в себе координати для відображення, а гіперланка на веб-сайт фільму буде включати ідентифікатор фільму. Так як точні значення даних не відомі заздалегідь, можна використовувати заповнювачі в адресі. Наприклад, текст повідомлення для служби гіперланок на IMDb можуть бути:

<pre>IMDb|http://www.imdb.com/title/tt$1/</pre>

Коли Семантична МедіаВікі відображає службову гіперланку значення властивості, вона замінює інформацію значення властивості для цих заповнювачів. На прикладі IMDB, ідентифікатор фільму типу Число замінить $1 числовим значенням і ось службова гіперланка для фільму пов'язує його з відомостями в IMDB, наприклад "tt0068646" to http://www.imdb.com/title/tt0068646/!

==== Інформація, що передається для кожного заповнювача ====
Кількість і зміст параметрів, які замінюють ''$1'', ''$2'', ''$3'', &hellip; залежить від [[Help:Properties_and_types#Datatypes|типу]] властивості.
Наприклад, проста властивість типу число замінює $ 1 з її значенням, тоді як географічні координати надають параметри для широти, довготи, напрямок, і багато іншого. У більшості випадків, $ 1 є найбільш відповідним параметром, який просто надає гіперланку на значення властивості. Типи даних, перелічені нижче підтримують службові гіперланки. Усі інші типи їх не підтримують.

<!-- Це з коментарів у вихідному коді PHP для кожного DataValue's getServiceLinkParams() -->
; [[Help:Type Page]]
: $1: URL-закодовані назви статті

; [[Help:Type Number]]
: $1: числові значення в англійські пунктуації
: $2: цілочисельна версія значеннь, в англійські пунктуації
: $3: інші

; [[Help:Type String]] (але не для [[Help:Type Text]])
: $1: URL-закодований рядок

; [[Help:Type URL]], [[Help:Type Annotation URI]]
: $1: УЛР-закодоване значення уніфікованого локатора ресурсів

; [[Help:Type Email]]
: $1: УЛР-закодоване значення уніфікованого локатора ресурсів, що включає <code>mailto:</code>

; [[Help:Type Geographic coordinate]]
: Примітка: Потрібно [[Extension:Maps|Maps (formerly Semantic Maps)]] 0.6.5 і Семантична МедіаВікі версії 1.5.1 і вище.
: $1: Місце у ненаправленій плаваючій системі позначень.
: $2: Місце у направленій DMS системі позначень.
: $3: Широта у ненаправленій плаваючій системі позначень.
: $4: Довгота у ненаправленій плаваючій системі позначень.
Оскільки географічні координати є складними, зразок вмісту для повідомлень за замовчуванням [[MediaWiki:Smw service online maps]] передбачено на цій вікі.

== Розширений приклад ==
Щоб проілюструвати весь процес створення і використання нового сервісу, ми надаємо розширений наприклад, також реалізований на
semanticweb.org. Статті про семантичний словник такий як [[semweb:FOAF]] містить відомості про словниковий простір імен і онлайн-служба [[semweb:Swoogle]] дозволяє користувачам шукати довідкову інформацію за таким іменами. Наша мета таким чином, щоб додати нову "службу" до [[semweb:Property:Namespace]], котра використовується на словникових статтях.

Спочатку, ми відредактуємо статтю [[semweb:Property:Namespace]] і додамо
<pre>
в якості додаткової служби, цювластивість, що надає
[[provides service::Swoogle lookup]] введеного простору імен.
</pre>

Після збереження зведення даних показує посилання на (поки ще неіснуючу) службу [[semweb:MediaWiki:smw_service_Swoogle_lookup|огляд]]. Натиснувши на ця гіперланку, адміністратор отримує нове поле для введення, в яке вводить

 <nowiki>Swoogle lookup|http://swoogle.umbc.edu/index.php?option=com_frontpage&service=digest&queryType=digest_ns&searchString=$1</nowiki>

Гіперланку було відновлено за допомогою Swoogle і замінити рядка пошуку (наприкінці посилання) параметром "$ 1".

Після збереження цих змін, новий сервіс є повністю функціональним, і на кожній сторінці, яка використовує
[[semweb:Property:Namespace]] буде показано відповідну гіперланку до Swoogle. Деякі статті все ж будуть відображати старі версії, якщо вони витягнуті з кеша, але після чергового редагування або чистки, всі статті будуть відображати гіперланку, як очікувалося.

{{docinfo
| master page = Help:Service links
| master rev  = 23141
| master link = internal
| status   = effective
| progress = 100
| priority = 2
| category = Посібник користувача
| author = Леонід Українець
| editor = {{REVISIONUSER}}
| minversion = 1.0
| lang = uk
| desc = An Ukrainian translation of [[Help:Service links]]
| return =
| nowarn
}}