Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- uk:wiki:syntax [2012-11-20 11:34] – [Вставка HTML и PHP] 89.184.66.215
+++ uk:wiki:syntax [2024-03-04 17:27] (поточний) – [Картинки та інші файли] SKruch
@@ Рядок 96: / Рядок 96: @@
 ==== Interwiki ====
-«ДокуВікі» підтримує [[interwiki|інтервікі]]-посилання. Це короткі посилання
+«ДокуВікі» підтримує [[doku>interwiki|інтервікі]]-посилання. Це короткі посилання
 на інші вікі. Наприклад, ось посилання на статтю Вікіпедії про вікі: [[wp>Wiki]].
@@ Рядок 137: / Рядок 137: @@
 ===== Розбивка на розділи =====
-Для структурування тексту можна використовувати до п'яти рівнів заголовків. Якщо у тексті більше трьох заголовків, автоматично створюється список змісту. Його можна відключити, вставивши в документ рядок %%~~NOTOC~~%%.
+Для структурування тексту можна використовувати до п'яти рівнів заголовків. Якщо у тексті більше трьох заголовків, автоматично створюється зміст сторінки. Його можна відключити, вставивши в документ рядок %%~~NOTOC~~%%.
 ==== Заголовок 3-го рівня ====
 === Заголовок 4-го рівня ===
@@ Рядок 148: / Рядок 148: @@
 </code>
-Четыре и более тире преобразуются в горизонтальную черту:
+Чотири і більше тире перетворюються в горизонтальну риску:
 ----
@@ Рядок 156: / Рядок 156: @@
 ===== Картинки та інші файли =====
-Див. також: «[[images|Робота з зображеннями та медіафайлами]]».
+Див. також: «[[doku>images|Робота з зображеннями та медіафайлами]]».
-За допомогою фігурних дужок можна вставляти в текст зовнішні та внутрішні [[images|картинки]]. За бажанням можна вказати їх розмір.
+За допомогою фігурних дужок можна вставляти в текст зовнішні та внутрішні [[doku>images|картинки]]. За бажанням можна вказати їх розмір.
 Нормальний розмір:                        {{wiki:dokuwiki-128.png}}
@@ Рядок 166: / Рядок 166: @@
 Відмасштабована до заданих розмірів:      {{wiki:dokuwiki-128.png?200x50}}
-Відмасштабована зовнішня картинка:        {{http://de3.php.net/images/php.gif?200x50}}
+Відмасштабована зовнішня картинка:        {{https://php.net/images/php.gif?200x50}}
 <code>
@@ Рядок 198: / Рядок 198: @@
 ===== Списки =====
-«ДокуВікі» підтримує нумеровані і маркіровані списки. Щоб створити елемент списку, поставте на початку рядка два пробіли і потім зірочку (*) у разі маркірованого списку, або дефіс (-) --- у разі нумерованого.
+«ДокуВікі» підтримує нумеровані і марковані списки. Щоб створити елемент списку, поставте на початку рядка два пробіли і потім зірочку (*) у разі маркованого списку, або дефіс (-) --- у разі нумерованого.
-  * Перший елемент маркірованого списку
+  * Перший елемент маркованого списку
     * Другий елемент списку
       * Можна зробити вкладений список
@@ Рядок 211: / Рядок 211: @@
 <code>
-  * Перший елемент маркірованого списку
+  * Перший елемент маркованого списку
     * Другий елемент списку
       * Можна зробити вкладений список
@@ Рядок 317: / Рядок 317: @@
 Примітка: вертикальне вирівнювання не підтримується.
-===== Неформатируемые блоки =====
+===== Неформатовані блоки =====
-Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги ''%%<code>%%'' или ''%%<file>%%''.
+Якщо вам потрібно відобразити текст точно так, як він набраний (без будь-якого форматування), обмежте область тегами ''%%<nowiki>%%'' або навіть простіше подвійними знаками відсотків ''<nowiki>%%</nowiki>''.
-<code>Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.</code>
+<nowiki>
+Це деякий текст, який містить такі адреси: http://www.splitbrain.org і **форматування**, але з ним нічого не зроблено.
+</nowiki>
-<file>В принципе то же самое, но этим выделением можно показать,
+  <nowiki>
-что цитируется содержимое файла.</file>
+  Це деякий текст, який містить такі адреси: http://www.splitbrain.org і **форматування**, але з ним нічого не зроблено.
+  </nowiki>
+Те саме стосується %%//__цього__ тексту// зі смайликом ;-).%%
+  Те саме стосується %%//__this__ текст// зі смайликом ;-)%%.
-Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги ''nowiki'', либо ещё проще --- в двойные знаки процента ''<nowiki>%%</nowiki>''.
+===== Кодові блоки =====
-Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+Ви можете включити блоки коду до своїх документів, зробивши для них відступ принаймні на два пробіли (як у попередніх прикладах) або використовуючи теги ''<code>'' або ''<file>''.
-и %%**форматирование**%% --- но ничего не происходит.
-<code>Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
+   Це текст із відступом у два пробіли.
-и %%**форматирование**%% --- но ничего не происходит.</code>
-Чтобы увидеть, как используются эти блоки, смотрите код статьи.
+<code>Це попередньо відформатований код, усі пробіли збережено: ось                 <-так</code>
-===== Подсветка синтаксиса =====
+<file>Це майже те саме, але ви можете використовувати це виділення,
+щоб показати, що цитується вміст файлу.
+</file>
+Ці блоки були створені цим джерелом:
+  Це текст із відступом у два пробіли.
+  <code>Це попередньо відформатований код, усі пробіли збережено: ось                 <-так</code>
+  <file>Це майже те саме, але ви можете використовувати це виділення,
+  щоб показати, що цитується вміст файлу.
+  </file>
+Щоб детально побачити, як створюються ці блоки, дивіться код статті.
+===== Підсвічування синтаксису =====
-«ДокуВики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http://qbnz.com/highlighter/|GeSHi]] — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке ''code'' в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например %%<code java>%%.
+DokuWiki може виділяти вихідний код, що полегшує його читання. Він використовує GeSHi Generic Syntax Highlighter, тому підтримується будь-яка мова, яку підтримує GeSHi. Синтаксис використовує ті самі блоки ''<code>'' і ''<file>'', які описані в попередньому розділі, але для підсвічування, ім’я синтаксису мови включено в тег, //наприклад// ''<nowiki><code java></nowiki>'' або ''<nowiki><file java></nowiki>''.
 <code java>
@@ Рядок 352: / Рядок 371: @@
 </code>
-На данный момент распознаются следующие языки: 4cs;, **a**bap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, **b**ash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, **c**, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, **d**, dcs, delphi, diff, div, dos, dot, **e**cmascript, eiffel, email, erlang, **f**o, fortran, freebasic, fsharp, **g**ambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, **h**askell, hicest, hq9plus, html, **i**con, idl, ini, inno, intercal, io, **j**, java5, java, javascript, jquery, **k**ixtart, klonec, klonecpp, **l**atex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, **m**68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, **n**ewlisp, nsis, **o**beron2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, **p**ascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, **q**, qbasic, **r**ails, rebol, reg, robots, rpmspec, rsplus, ruby, **s**as, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, **t**cl, teraterm, text, thinbasic, tsql, typoscript, **u**nicon, **v**ala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, **w**hitespace, winbatch, whois, **x**basic, xml, xorg_conf, xpp, **z**80.
+Наразі розпізнаються такі мови://4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//
+==== Завантажувальні Блоки коду ====
-==== Скачиваемые блоки кода ====
+Якщо ви використовуєте синтаксис <code> або, <file> як описано вище, ви можете також зробити вказаний код доступним для завантаження. Це можна зробити, вказавши назву файлу після коду мови:
-Используя тэги ''%%<code>%%'' или ''%%<file>%%'', как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:
 <code>
@@ Рядок 368: / Рядок 386: @@
 </file>
-Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (''-'') на месте кода языка: ''%%<code - myfile.foo>%%''.
+Якщо вам не потрібне підсвічування коду, але бажаєте отримати файл для завантаження, вкажіть тире (''-'') як код мови: %%<code - myfile.foo>%%.
+**Особливість:** при написанні імені файлу українською для формування корректного імені файлу, обрамляйте назву файлу подвійними лапками наприклад "Фоо Бар.php".
-**Особенность:** при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например "Фоо Бар.php".
 <file php "Фоо Бар.php">
 <?php echo "hello world!"; ?>
 </file>
-===== Вставка HTML та PHP =====
-Чистий HTML- або PHP-код можна вставити у документ за допомогою тегів ''html'' та ''php'':
+==== Агрегація каналів RSS/ATOM ====
-Приклад застосування HTML:
+DokuWiki може інтегрувати дані із зовнішніх каналів XML. Для аналізу XML-каналів використовується [[http://simplepie.org/|SimplePie]]. Усі формати, зрозумілі SimplePie, також можна використовувати в DokuWiki. Ви можете вплинути на відтворення за допомогою кількох додаткових параметрів, розділених пробілами:
-<code>
+^Параметр	^ опис ^
-<html>
+|будь-яке число	| буде використано як максимальну кількість елементів для показу, за замовчуванням 8|
-Це є <span style="color:red;font-size:150%;">HTML-код</span>
+|reverse | спочатку відображати останні елементи в стрічці|
-</html>
+|author	показати імена авторів елементів|
+|date | показати дати елементів|
+|description | показати опис елементів. Усі теги HTML буде видалено|
+|nosort	| не сортовані елементи в стрічці|
+| //n//[dhm] | період оновлення, де d=дні, h=години, m=хвилини. (наприклад, 12h = 12 годин).|
-<html>
+//Період оновлення// за замовчуванням становить 4 години. Будь-яке значення меньше 10 хвилин розглядатиметься, як 10 хвилин. DokuWiki зазвичай намагатиметься надати кешовану версію сторінки, хоча очевидно, це й недоречно, якщо сторінка містить динамічний зовнішній вміст. Параметр повідомляє DokuWiki повторно відобразити сторінку, якщо минуло більше, ніж //період оновлення// з моменту останнього відтворення сторінки.
-<p style="border:2px dashed red;">Це також блок HTML</p>
-</html>
-</code>
-<html>
+За замовчуванням канал буде відсортовано за датою, спочатку найновіші елементи. Ви можете відсортувати його спочатку за найстарішим за допомогою //reverse// параметра або відобразити канал як є за допомогою //nosort//.
-Це є <span style="color:red;font-size:150%;">HTML-код</span>
-</html>
-<html>
+приклад:
-<p style="border:2px dashed red;">Це також блок HTML</p>
-</html>
-Приклад застосування PHP:
+  {{rss>http://slashdot.org/index.rss 5  5 author date 1h}}
-<code>
-<php>
-echo 'Логотип, згенерований PHP:';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
-echo '(generated inline HTML)';
-</php>
-<php>
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
-echo '</tr></table>';
-</php>
-</code>
-<php>
+{{rss>http://slashdot.org/index.rss 5 author date 1h}}
-echo 'Логотип, згенерований PHP:';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
-echo '(inline HTML)';
-</php>
-<PHP>
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
-echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
-echo '</tr></table>';
-</PHP>
-**Зверніть увагу**: З метою підвищення безпеки HTML- і PHP-блоки за замовчуванням відключені в конфігурації. Увімкніть їх, якщо хочете бачити результат виконання цього коду.
-===== Управляющие макросы =====
-Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:
+===== Управляючі макроси =====
-^ Макрос          ^ Описание      |
+Деякий синтаксис впливає на те, як DokuWiki відтворює сторінку, не створюючи самих виводів. Доступні наступні керуючі макроси:
-| %%~~NOTOC~~%%   | Если этот макрос присутствует в статье, оглавление не будет создано.  |
-| %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис %%<php>%%), добавление этого макроса заставит «ДокуВики» обрабатывать статью при каждом вызове.  |
-===== Синтаксические плагины =====
+^ Макрос          ^ Опис      |
+| %%~~NOTOC~~%%   | Якщо цей макрос знайдено на сторінці, зміст не буде створено.  |
+| %%~~NOCACHE~~%% | DokuWiki за замовчуванням кешує весь вихід. Іноді це може бути небажаним (наприклад, коли використовується синтаксис %%<php>%% вище), додавання цього макросу змусить DokuWiki повторно відображати сторінку під час кожного виклику |
-Синтаксис «ДокуВики» может быть расширен за счёт [[doku>plugins|плагинов]].
+===== Синтаксичні плагіни =====
-Как их устанавливать и использовать --- описывается на страницах описания. Следующие плагины доступны в инсталляции «ДокуВики» на этом сайте:
+Синтаксис DokuWiki можна розширити за допомогою [[doku>plugins|плагінів (Plugins)]]. Як використовувати ті, чи інші встановлені плагіни, описано на відповідних сторінках опису плагіну. У цій установці DokuWiki доступні наступні синтаксичні модулі:
 ~~INFO:syntaxplugins~~