Различия

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

--- ru:interwiki [2009-07-10 10:16] – 93.91.4.119
+++ ru:interwiki [2016-06-05 21:07] (текущий) – [Конфигурирование префиксов интервики] 109.110.43.14
@@ Строка 1: / Строка 1: @@
-===== InterWiki =====
+====== Интервики ======
-Это короткие ссылки на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]].
+Это короткие ссылки на другие вики-сайты. Например, вот ссылка на страницу Википедии о вики: [[wp>Wiki]].
-Изначальная идея InterWiki заключалась в том, чтобы создать один большой [[wp>Wiki]] распределенный по всей сети. На сегодняшний день, используя довольно простой синтаксис, вы можете легко сослаться из одного wiki на другой.
+Изначальная идея интервики заключалась в том, чтобы создать одну большую вики, распределённую по всему интернету. На сегодняшний день, используя довольно простой синтаксис, вы можете легко сослаться из одной вики на другую.
-В [[DokuWiki]] это делается путем добавления к ссылке [[pagenames]] короткого префикса отделенного символом **''>''**.
+В «[[dokuwiki|ДокуВики]]» это делается путём добавления к [[pagenames|имени страницы]] короткого префикса, отделённого символом правой угловой скобки: **''>''**.
 Примеры:
-  [[wp>Wiki]]               ссылается на Wikipedia,
+  [[wp>Wiki]]               ссылается на Википедию,
-  [[Meatball>TourBusStop]]  ссылается на статью TourBusStop в вики MeatBall,
+  [[meatball>TourBusStop]]  ссылается на статью TourBusStop в вики MeatBall,
-  [[google>Wiki]]           ссылается на поиск в google,
+  [[google>Wiki]]           ссылается на поиск в Гугле,
   [[doku>ru:interwiki]]     ссылается на эту статью.
-[[wp>Wiki]] ссылается на Wikipedia, [[Meatball>TourBusStop]] ссылается на статью TourBusStop в вики MeatBall, [[google>Wiki]]           ссылается на поиск в google, [[doku>ru:interwiki]] ссылается на эту статью.
+[[wp>Wiki]] ссылается на Википедию, [[meatball>TourBusStop]] ссылается на статью TourBusStop в вики MeatBall, [[google>Wiki]] ссылается на поиск в Гугле, [[doku>ru:interwiki]] ссылается на эту статью.
-Существует один специальный префикс **''this''**. Он всегда ссылается на директорию веб-сервера, в которой инсталлирован данный DokuWiki . Вы можете использовать это для того, чтобы создать относительный URL. Например, вот эта ссылка [[this>feed.php]] всегда указывает на локальный [[syndication|XML feed]]
+Существует один специальный префикс **«''this''».** Он всегда ссылается на директорию веб-сервера, в которой инсталлирована данная «ДокуВики» . Вы можете использовать это для того, чтобы создать относительный URL. Например, вот эта ссылка --- [[this>feed.php]] --- всегда указывает на локальный [[syndication|XML feed]]:
   [[this>feed.php]]
-**Дополнительная информацией по InterWiki:**
+**Дополнительная информацией по интервики:**
-  * [[wp>InterWiki]] на Wikipedia
+  * [[wp>InterWiki]] в «Википедии»
-  * [[MeatBall>InterWiki]] на MeatBall
+  * [[meatball>InterWiki]] на «MeatBall»
-  * [[Wiki>InterWiki]] на c2.com Wiki
+  * [[wiki>InterWiki]] на «c2.com Wiki»
+===== Конфигурирование префиксов интервики =====
-===== Конфигурирование префиксов InterWiki =====
+Префиксы интервики определяются в файле ''conf/interwiki.conf''. По умолчанию этот файл содержит все префиксы, предложенные на «[[http://usemod.com/intermap.txt|UseMod]]». Вы можете добавить свои собственные интервики-ссылки, создав файл ''conf/interwiki.local.conf'' и поместив в него свои ссылки (поместив их в файл, отличный от ''conf/interwiki.conf'', вы избежите их переписывания при [[ru:install:upgrade|обновлении]]).
-Префиксы InterWiki определяются в файле ''conf/interwiki.conf''. По умолчанию этот файл содержит все префиксы предложенные на [[http://usemod.com/intermap.txt]]. Вы можете добавить свои собственные interwiki-ссылки создав файл ''conf/interwiki.local.conf'' и поместив в него свои ссылки (поместив их в файл отличный от ''conf/interwiki.conf'', вы избежите их переписывания при апгрейде).
+Никто не мешает вносить правки непосредственно в ''conf/interwiki.conf'', однако это приведет к тому, что ваши изменения будут потеряны при обновлении «ДокуВики».
-Никто не мешает вносить правки непосредственно в ''conf/interwiki.conf'', однако это приведет к тому, что ваши изменения будут потеряны при апгрейде DokuWiki.
+Вместо стандартной иконки вы можете использовать другие графические файлы, положив их в директорию ''lib/images/interwiki''. Размер картинки должен быть 16x16 пикселей, название файла должно соответствовать короткому префиксу, а формат должен быть PNG или GIF.
+Вам понадобиться очистить [[caching|кэш]], если в статьях всё ещё отображается стандартная иконка.
-Вместо стандартной иконки, вы можете использовать другие графические файлы, положив их в директорию ''lib/images/interwiki''. Размер картинки должен быть 16x16 пикселей, название файла должно соответствовать короткому префиксу, а формат должен быть PNG или GIF.
-Вам понадобиться очистить [[ru:caching|кэш]], если в статьях все еще отображается стандартная иконка.
 <code>
@@ Строка 39: / Строка 38: @@
 </code>
-Короткие префиксы interwiki должны быть в нижноем регистре и соответствовать правилам [[pagename|именования статей]]
+Короткие префиксы интервики должны быть в нижнем регистре и соответствовать правилам [[pagename|именования статей]].
+Формат файла конфигураций интервики имеет следующий вид:
+<code>
+<shortcut>      <url to wiki>
+</code>
-Формат файла конфигураций interwiki имеет следующий вид:
+//<shortcut>// — короткий префикс, который вы сможете использовать в ссылках. В URL можно использовать подстановки((placeholders)) для большей гибкости. Если никаких подстановок не указано, [[phpfn>rawurlencode|URL-encoded]] имя вики будет добавлено к URL. Доступны следующие подстановки:
-  <shortcut>      <url to wiki>
+^ Подстановка ^ на что заменяется...  ^
+| {URL}       | URL-encoded имя вики |
+| {NAME}      | имя вики без какого-либо кодирования (часть, которая добавляется к URL в ''interwiki.local.conf'') |
+| {SCHEME}    | часть URL «схема»((т. е. http, ftp и т. п.)), если URL задан как имя вики |
+| {HOST}      | часть URL «имя сервера», если URL задан как имя вики |
+| {PORT}      | часть URL «номер порта», если URL задан как имя вики |
+| {PATH}      | часть URL «путь», если URL задан как имя вики |
+| {QUERY}     | часть URL «запрос», если URL задан как имя вики |
-//shortcut//
+Последние пять параметров полезны при создании интервики-ссылок на кэшируемые системы. Состав URL: %%scheme://ho.st:port/p/a/t/h?qu&er=y%%
-You should also purge the  if you have the default image instead of the one you uploaded.
+В качестве примера смотрите префикс ''coral'' в файле  ''interwiki.conf'', поставляемом в дистрибутиве.