Разница между 1.54
и текущей версией
ПравилаРазметки.
@@ -1,12 +1,12 @@
-- Правила вики-разметки
+= Правила вики-разметки
На этой странице даётся краткое описание разметки, используемой на этой вики. Она не сложна и быстро запоминается; в разметке нет ничего лишнего. Аскетичная разметка должна способствовать составлению простого и ясного текста без лишних украшательств.
--- Вики-страницы
+- Вики-страницы
Название вики-страницы (статьи) обязательно состоит как минимум из двух слов, начинающихся с большой буквы, набранных слитно без пробела. Например, НоваяСтраница или ВикиРазметка. Если имя термина или явления состоит только из одного слова, то тогда название вики-страницы рекомендуется составлять из имени с префиксом, относящимся к разделу или классификации. Например, к именам языков программирования добавляется префикс «Язык», т. о. страница, посвящённая языку AWK, именуется ЯзыкAWK. Ссылка не формируется на ''''''СтраницуВики'''''', если слово заключено в шесть одиночных кавычек.
---- Типографические соглашения
+-- Типографические соглашения
На этой вики приняты следующие типографические соглашения по оформлению статей:
1 Имена путей к файлам и каталогам, названия утилит пишутся курсивом.
@@ -18,35 +18,35 @@
1 Если даётся пример команд с выводом, то ввод пользователя выделяется жирным.
1 Примеры с вводом пользователя и выводом набираются с символами приглашения интерпретатора или среды исполнения так, чтобы было понятно где начинался и заканчивался ввод-вывод утилит, команд, примеров. Пропущенный текст вывода заменяют на ''<...>''.
---- Категорирование
+-- Категорирование
Вики-статьи помещаются в категории автоматически. Место генерации списка страниц, относящихся к категории, отмечается знаком «##». Для добавления статьи в соответствующую категорию внизу страницы после знака «#» перечисляют категории, в которые входит данная статья. Категории отделяют друг от друга знаком вертикальной черты (|), например, вот так:
# ''''''КатегорияЯзыкиПрограммирования'''''' | ''''''КатегорияОболочки''''''
--- Заголовки
+
+
+- Заголовки
Заголовки формируют структуру текста, иерархию между разделами. Заголовки в вики-разметке выделяются так:
+ = Название статьи
- Заголовок первого уровня
-- Заголовок второго уровня
--- Заголовок третьего уровня
Текст этого примера выглядит так:
-----
-
+= Название статьи
- Заголовок первого уровня
-- Заголовок второго уровня
--- Заголовок третьего уровня
------
-
--- Текстовые выделения
+- Текстовые выделения
Для выделения '''жирным''' текст заключают в тройные одиночные кавычки, для выделения ''курсивом'' текст заключают в двойные одиночные кавычки. Текст может быть набран '''''жирным курсивом''''', для этого его заключают в пять одиночных кавычек. ``Моноширинный текст`` внутри основного текста заключается в двойные обратные кавычки.
--- Специальные символы
+- Специальные символы
Специальные символы вводятся 16-ричными кодами Unicode. Так в большинстве приложений тулкита GTK+ в Unix/Linux поддерживается специальная комбинация: одновременно нажимают и удерживают клавиши Ctrl и Shift, не отпуская их нажимают «u», после чего вводят 16-ричные разряды кода символа. После окончания ввода клавиши Ctrl и Shift отпускают.
@@ -55,13 +55,13 @@
* Закрывающая кавычка-ёлочка „»“ вводится комбинацией «Ctrl+Shift+U bb».
* Тире «—» вводится комбинацией «Ctrl+Shift+U 2012».
--- Литеральный блок
+- Литеральный блок
Примеры кода, команд, исходного текста вводятся с отступом в пробел.
Моноширинный текст, команды, код.
--- Горизонтальная черта
+- Горизонтальная черта
Горизонтальная черта используется для отделения блоков текста друг от друга. Например, обсуждения на вики-страницах отделяются снизу и сверху горизонтальной чертой. А текст обсуждений формирует иерархию с использованием списков.
@@ -71,7 +71,7 @@
Текст обсуждения может быть подписан. -- АвторТекста.
----
--- Вставка изображений и гиперссылок
+- Вставка изображений и гиперссылок
Для вставки изображения достаточно поместить её URL в тексте; распознаются изображения в форматах *.jpg, *.png, *.gif и *.bmp.
@@ -118,8 +118,10 @@
[[google.ru|поисковый сайт]]
===
+Если в статье понадобится последовательность символов ``[ [`` между двумя скобками можно вставить «невидимый» символ разделения записей (record separator), он вводится кобминацией «Ctrl+Shift+U 1E».;
+
--- Списки
+- Списки
Списки используются для оформления перечислений в тексте. Не стоит ими злоупотреблять. Вики разметка позволяет формировать списки с маркерами списков (буллетами), а также автоматически нумеровать пункты. Следует отметить, что в русской типографике традиционно в качестве маркера использовался знак тире «—».
@@ -147,7 +149,7 @@
* два семьдесят семь;
1 снова два.
--- Термины и определения
+- Термины и определения
Описание терминов, специальных символов, синтаксических конструкций удобно выполнять в виде специальных параграфов. Термин набирается с отступом в один знак табуляции, а определение после двоеточия (:), перед и после двоеточия ставится один или несколько пробелов, например, вот так:
@@ -158,7 +160,7 @@
Термин : Длинное определение термина, которое может набираться в несколько строк.
----
--- Библиографический список
+- Библиографический список
Все библиографические ссылки в тексте должны быть оформлены следующим образом:
@@ -180,7 +182,7 @@
%U : Ссылка на электронный ресурс, если таковая имеется.
%s : Название сайта, если запись оформляется на электронный ресурс.
---- Пример оформления библиографического списка
+-- Пример оформления библиографического списка
%R(
@@ -222,11 +224,11 @@
%R)
----
--- Область неформатированного ввода
+- Область неформатированного ввода
Большие блоки неформатированного текста (например исходного кода) помещаются внутри блока из трёх знаков равно (===).
---- Пример оформления неформатированного блока
+-- Пример оформления неформатированного блока
===
#include <stdio.h>
@@ -251,3 +253,90 @@
return 0;
}
===
+
+Вики поддерживает подсветку синтаксиса для различных языков программирования,
+для включения подсветки название языка вписывается в начало блока в
+следующем формате "==={langname} "
+
+Пример:
+
+ ==={c}
+ #include <stdio.h>
+
+ int
+ main(int argc, const char *argv[])
+ {
+
+ return 0;
+ }
+ ===
+
+отобразится как:
+
+==={c}
+#include <stdio.h>
+
+int
+main(int argc, const char *argv[])
+{
+
+ return 0;
+}
+===
+
+Список всех поддерживаемых языков программирования можно увидеть по [[http://pygments.org/languages | ссылке]].
+
+- Таблицы
+
+-- Синтаксис
+
+Блок кода таблицы обозначается следующим образом:
+
+===
+ {| arg
+ Код таблицы
+ |}
+===
+
+''arg'' ‒ выравнивание таблицы (left, center, right).
+
+Начало ячейки обозначается вертикальной чертой «|», после чего следуют
+аргументы ячейки, восклицательный знак «!» и содержимое ячейки.
+Если аргументы отсутствуют, то «!» можно опустить.
+
+Аргументы ячейки:
+ * h ‒ выделение ячейки.
+ * l, c, r ‒ выравнивание содержимого ячейки.
+ * xy, где x и y цифра [1-9]. Объединение ячеек по горизонтали и вертикали.
+
+Строки разделяются следующим образом «|--».
+
+-- Пример оформления таблицы
+
+===
+ {| center
+ | |h! Заголовок столбца 1 |h! Заголовок столбца 2
+ |--
+ |h! Заголовок строки 1 | Содержимое ячейки | Содержимое ячейки
+ |--
+ |h! Заголовок строки 2 | Содержимое ячейки | Содержимое ячейки
+ |--
+ |h! Заголовок строки 3 |21c! Объединённая ячейка
+ |}
+===
+
+{| center
+| |h! Заголовок столбца 1 |h! Заголовок столбца 2
+|--
+|h! Заголовок строки 1 | Содержимое ячейки | Содержимое ячейки
+|--
+|h! Заголовок строки 2 | Содержимое ячейки | Содержимое ячейки
+|--
+|h! Заголовок строки 3 |21c! Объединённая ячейка
+|}
+
+- Соглашения записи математических формул
+
+ * вектор и его элементов: $$bold x = (x sub 1 , x sub 2 , ldots , x sub n ),$$
+ * элемент $$a sub ij$$ матрицы $$A$$ находится на её пересечение $$i$$-ой строки и $$j$$-го столбца, произведение матриц $$A B = C,$$ произведение матрицы на вектор $$A bold b = bold c.$$
+ * все операторы набираются прямо: $$size +1.5 int {roman d x} over {d x} = {1 over d} size +1.5 int {{roman d x} over {x} } = ln |x| + C$$ — $$roman d$$ и $$ln$$ — оператор дифференцирования (в числителе подынтегрального выражения) и натуральный логарифм, $$d$$ — числовая константа (в знаменателе подынтегрального выражения), как и $$c,$$ а $$x$$ — переменная.