Справка:Справка

Материал из База_Знаний
(Различия между версиями)
Перейти к: навигация, поиск
Строка 89: Строка 89:
-
==== Ссылки на изображениях ====
+
==== Ссылки с изображений ====
Вы можете использовать изображение как ссылку на другую внутреннюю или внешнюю страницу комбинируя синтаксис ссылки и изображения (смотри ниже), например так:
Вы можете использовать изображение как ссылку на другую внутреннюю или внешнюю страницу комбинируя синтаксис ссылки и изображения (смотри ниже), например так:
Строка 97: Строка 97:
[[http://www.php.net|{{wiki:php-powered.png}}]]
[[http://www.php.net|{{wiki:php-powered.png}}]]
-
Пожалуйста, учтите: Форматирование изображений - единственный синтаксис форматирования, разрешённый в ссылках.
 

Версия 12:13, 28 октября 2008

Содержание

Основы

Редактировать статью в Википедии просто. Следуйте ссылке «править». Откроется страница правки; на ней есть текстовая форма с исходным текстом статьи, который содержит особые символы — разметку «вики», описанную ниже.

Редактирование

Затем:

  1. внесите желаемые изменения в исходный текст;
  2. кратко опишите смысл своей правки в строке «Описание изменений»;
  3. для проверки правильного отображения страницы нажмите кнопку «Предварительный просмотр»;
  4. если со страницей всё в порядке, опубликуйте свою новую версию нажатием кнопки «Записать страницу».


Дополнительные возможности

  • Выше текстовой формы редактирования находятся кнопки для форматирования текста, ниже — панель быстрой вставки специальных символов, элементов вики-разметки и шаблонов.
  • Кнопка «Внесённые изменения» позволяет сравнить исходный код с тем, что у вас в окне редактирования.


Зарегистрированным участникам также доступны:

  • флажок «Малое изменение», позволяющий отметить ваши изменения как незначительные;
  • флажок «Включить эту страницу в список наблюдения» для наблюдения за дальнейшими изменениями этой статьи.


Часто бывает удобно предварительно скопировать текст в текстовый редактор (через буфер обмена), отредактировать, а затем перенести обратно в форму редактирования в браузере. Для этих целей следует использовать текстовый редактор, поддерживающий юникод.


Базовое форматирование текста

Wiki поддерживает жирный, курсив, подчёркнутый и моноширинный текст. Конечно, вы можете это комбинировать.

  Wiki поддерживает '''жирный''', ''курсив'', <u>подчёркнутый</u> и <tt>моноширинный</tt> текст.
  Конечно, вы можете это '''<u>комбинировать</u>'''.

Вы можете также использовать подстрочный и надстрочный текст.

  Вы можете также использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> текст.

Ещё вы можете пометить что-то как зачёркнутое.

  Ещё вы можете пометить что-то как <del>зачёркнутое</del>.

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

Это текст написан в несколько строк. Помните, что только два бэкслеша стоящих в конце строки или с имеющимся после них пробелом опознаются как начало новой строки

  Это текст написан в несколько строк. Помните, что 
  только два бэкслеша стоящих в конце строки или с 
  имеющимся после них пробелом опознаются как начало новой строки

Вы должны использовать новые строки только там, где это действительно необходимо.

Ссылки

Wiki поддерживает несколько способов создания ссылок.

Внешние

Внешние ссылки определяются автоматически: http://www.google.com - Вы можете также делать из текста ссылки: Эта ссылка ведёт на google. Адреса электронной почты определяются следующим образом: name@example.com.

  Внешние ссылки определяются автоматически: http://www.google.com  - 
  Вы можете также делать из текста ссылки: [http://www.google.com Эта ссылка ведёт на google]. 
  Адреса электронной почты определяются следующим образом: [mailto:name@example.com name@example.com].

Внутренние

Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто просто использовать Заглавная страница или использовать дополнительный Ссылка на заглавную страницу.

  Внутренние ссылки создаются с помощью квадратных скобок. Вы можете просто просто
  использовать [[Заглавная страница]] или использовать дополнительный [[Заглавная страница|Ссылка на заглавную страницу]].

Окончания сливаются со ссылкой: тестирование.
Автоматически скрывается заключённое в круглых скобках: царство.
Автоматически скрывается пространство имён: Портал сообщества.

  Окончания сливаются со ссылкой: [[тест]]ирование. 
  Автоматически скрывается заключённое в круглых скобках: [[царство (биология)|царство]].
  Автоматически скрывается пространство имён: [[Википедия:Портал сообщества|Портал сообщества]].

Ссылки на отдельную секцию страницы также возможны. Всего лишь добавьте название секции после символа # известного из HTML. Это ссылка на эту секцию.

  Это ссылка на [[Справка:Справка#Внутренние|эту секцию]].


Примечания:

  • Ссылки на существующие страницы отображаются в стиле отличном от несуществующих.
  • Когда название секции меняется, ссылка на неё тоже меняется. Так что не злоупотребляйте ссылками на секции.


Ссылки с изображений

Вы можете использовать изображение как ссылку на другую внутреннюю или внешнюю страницу комбинируя синтаксис ссылки и изображения (смотри ниже), например так:

 [[1]]

[[2]]



Сноски

Вы можете добавлять сноски ((Это сноска)) используя двойные круглые скобки.

 Вы можете добавлять сноски ((Это сноска)) используя двойные круглые скобки.
Структурирование

Вы можете использовать пять разных типов заголовков для структурирования документа. Если вам требуется более трёх заголовков, таблица содержимого генерируется автоматически -- это можно отключить, включив строку ~~NOTOC~~ в документ.

Заголовок 3

Заголовок 4

Заголовок 5

 ==== Заголовок 3 ====
 === Заголовок 4 ===
 == Заголовок 5 ==

Используя четыре или более дефиса, вы можете создать горизонтальную линию:


Изображения и другие файлы

Вы можете включить внешние и внутренние изображения с помощью фигурных скобок. Дополнительно вы можете задать их размер.


Вы можете задать заголовок к изображению (отображается большинством браузеров как всплывающая подсазка).

{{ wiki:php-powered.png |Это заголовок}}

 {{ wiki:php-powered.png |Это заголовок}}

Если вы укажете имя файла, который не является изображением (gif,jpeg,png), он отобразится как ссылка.

Списки

Dokuwiki поддерживает упорядоченные и неупорядоченные списки. Чтобы создать список, предварите свой текст двумя пробелами и используйте * для неупорядоченного или - для упорядоченного.

 * Это список
 * Это второй пункт
   * Список может быть многоуровневым
 * Ещё пункт
 - Такой же список, но упорядоченный
 - Ещё пункт
   - Используйте отступ для более глубоких уровней
 - Вот так

 * Это список
 * Это второй пункт
   * Список может быть многоуровневым
 * Ещё пункт
 - Такой же список, но упорядоченный
 - Ещё пункт
   - Используйте отступ для более глубоких уровней
 - Вот так

Эмотиконы

DokuWiki конвертирует часто используемые [[wp>emoticon]]ы в графическую форму. Дополнительные смайлики могут быть помещены в директорию smiley и настроены в файле conf/smileys.conf. Вот обзор смайликов включённых в DokuWiki.

 * :) %%  :)  %%
 * =) %%  =)  %%
 * :| %%  :|  %%
 * =| %%  =|  %%
 * :( %%  :(  %%
 * =( %%  =(  %%
 * :D %%  :D  %%
 * =D %%  =D  %%
 * :o %%  :o  %%
 * :O %%  :O  %%
 * ;) %%  ;)  %%
 * :/ %%  :/  %%
 * :P %%  :P  %%
 * :lol: %%  :lol:  %%
 * :mad: %%  :mad:  %%
 * :rolleyes: %%  :rolleyes:  %%
 * :cool: %%  :cool:  %%
Типография

DokuWiki может конвертировать простые текстовые символы в их типографически корректные сущности. Это примеры опознаваемых символов.

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Он подумал 'Это мужской мир'..."

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Он подумал 'Это мужской мир'..."

Пожалуйста, учтите: Эта замена может быть отключена в файле конфигурации.

Таблицы

DokuWiki поддерживает синтаксис для создания таблиц.

^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | Строка 1 Столбец 1 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | | Строка 2 Столбец 1 | двойной столбец || | Строка 3 Столбец 1 | Строка 2 Столбец 2 | Строка 2 Столбец 3 |

Строки таблицы должны начинаться и заканчиваться символом | для обычных строк и ^ для заголовков.

 ^ Заголовок 1       ^ Заголовок 2       ^ Заголовок 3       ^
 | Строка 1 Столбец 1| Строка 1 Столбец 2| Строка 1 Столбец 3|
 | Строка 2 Столбец 1| Объединение столбцов                 ||
 | Строка 3 Столбец 1| Строка 2 Столбец 2| Строка 2 Столбец 3|

Чтобы объединить горизонтальные ячейки, просто оставьте следующую ячейку пустой как показано выше. Убедитесь, что везде используете равное количество разделителей ячеек!

Вертикальные заголовки тоже возможны.

| ^ Заголовок 1 ^ Заголовок 2 ^ ^ Заголовок 3 | Строка 1 Столбец 2 | Строка 1 Столбец 3 | ^ Заголовок 4 | Нет объединения столбцов | | ^ Заголовок 5 | Строка 2 Столбец 2 | Строка 2 Столбец 3 |

Как вы видите, здесь есть разделитель ячеек перед ячейкой, что определяется форматированием:

 |              ^ Заголовок 1              ^ Заголовок 2        ^
 ^ Заголовок 3  | Строка 1 Столбец 2       | Строка 1 Столбец 3 |
 ^ Заголовок 4  | Нет объединения столбцов |                    |
 ^ Заголовок 5  | Строка 2 Столбец 2       | Строка 2 Столбец 3 |

Примечание: Объединение вертикальных ячеек невозможно.

Вы можете выровнять содержимое таблицы. Добавьте как минимум два пробела на противоположном конце текста: Добавьте минимум два пробела слева для выравнивания по правому краю, минимум два пробела справа для выравнивания по левому краю и минимум по два пробела с обеих сторон для центрирования текста.

^ Таблица с выравниванием ^^^ | справа| по центр |слева | |слева | справа| по центру | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Вот как это выглядит в исходнике:

 ^           Таблица с выравниванием             ^^^
 |          справа|     по центру     |слева            |
 |слева           |             справа|    по центру    |
 | xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxx |
Неформатированые блоки

Вы можете включить неформатированые блоки в ваш документ предваряя их как минимум двумя пробелами (как в предыдущих примерах) или используя тэги code и file.

Это преформатированый код, все пробелы сохранены <-здесь

<file> Это почти то же самое, но вы можете показать, что цитируете файл. </file>

Чтобы указать Wiki игнорировать всю область полностью (т.е. не форматировать её), окружите область тэгами nowiki или даже проще, двойными знаками процента %%.

Это текст, в котором есть адрес: http://www.splitbrain.org и **форматирование**, но с ним ничего не произошло.

Смотрите исходный код страницы, чтобы увидеть, как использовать эти блоки

Подсветка синтаксиса

DokuWiki может "подсвечивать" исходные коды, что делает их более удобными для чтения. DokuWiki использует для этого [[3]] Generic Syntax Highlighter -- то есть, поддерживается подсветка любого языка, поддерживаемого GeSHi. Для подсветки синтаксиса используется тег code с указанием строки, идентифицирующей язык. Например: <code java>.

/**

* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/

class HelloWorldApp {

   public static void main(String[] args) {
       System.out.println("Hello World!"); //Display the string.
   }

}

В настоящее время поддерживаются следующие строки, идентифицирующие языки: //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, objc, oobas, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml//

Внедрение HTML и PHP

Вы можете внедрять код HTML или PHP в Ваши документы, используя теги html или php примерно так: This is some HTML

This is some HTML

<php> echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; </php>

<php> echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; </php>

    • Обратите внимание**: Внедрение HTML и PHP запрещено конфигурацией по умолчанию. Если внедрение кода HTML и PHP запрещено, код просто отображается вместо выполнения.
Личные инструменты