Проект "Человек. Земля. Вселенная"
 

Вики-разметка

Общие правила редактирования

Вы можете смело улучшать любую страницу сайта, руководствуясь Добрыми Намерениями и Здравым Смыслом. Улучшая страницы с помощью вики-разметки, вы вносите свой посильный вклад в Общее Дело. Даже если это простое исправление грамматических ошибок, это важно для всех пользователей сайта.

Если вы собираетесь постоянно улучшать содержимое сайта, то мы рекомендуем вам зарегистрироваться и создать свою страницу-визитку в разделе «Пользователи». Так вы быстрее найдёте единомышленников и помощников.

Для регистрации нажмите кнопку «Войти», которая расположена в правом нижнем углу страницы.

Внимание! Вики-разметка позволяет редактировать не всю страницу целиком, а лишь её часть, какой-то один раздел. Для этого воспользуйтесь кнопкой «Править» в соответствующем разделе статьи. Эта кнопка, как правило, расположена ниже самого текста. К тому же это существенно ускоряет скорость работы.

Хорошим тоном для вики-разметки также является соблюдение следующих правил:

  • Внизу редактируемого текста, справа от кнопки «Отменить» есть поле для ввода некоторых сведений - «Сводка изменений». Если вы вносите изменения на какой-либо странице, то укажите, пожалуйста, причину вносимых изменений. Например, «исправление грамматической ошибки», «исправление неверной даты», «дополнение материала» и т. п.
  • Если это небольшие изменения, то установите рядом галочку «Небольшие изменения».

Внимание! Если вы не регистрировались в системе, то для сохранения статьи вам необходимо ввести цифровой код подтверждения, расположенный ниже окна редактирования.

Создание новой страницы

Наверно, вы уже заметили, что на сайте нет кнопки «Создать страницу». Сделано это специально, чтобы не появлялись страницы-сироты, то есть страницы, на которые не ведёт ни одна ссылка.

Чтобы создать новую страницу, откройте в новом окне (вкладке) браузера главную страницу сайта http://www.verim.org для работы в Интернет или http://verim для работы на локальном компьютере. Теперь вы можете одновременно создавать страницу и «подглядывать» в данную инструкцию. Для удобства работы можете её распечатать на принтере.

Затем с главной страницы сайта перейдите в необходимый вам раздел и далее на статью, которая должна ссылаться на вашу новую страницу. Нажмите на кнопку «Править страницу». В одном из разделов этой страницы разместите ссылку на вашу страницу. Для этого введите название новой страницы.

Затем выделите название новой страницы и нажмите на функциональную кнопку Внутренняя ссылка над окном редактирования. Будет создана ссылка на новую страницу (но не сама страница).

Сохраните данную страницу (нажмите на кнопку «Сохранить»). Ссылка на новую страницу будет выделена красным цветом. Это говорит о том, что сама страница ещё не создана. Нажмите на эту ссылку (пример: Новая страница). Появится сообщение Данная страница не существует, но её можно создать. Для этого нажмите на кнопку «Создать страницу». Далее приступайте к оформлению и наполнению новой страницы. По окончанию нажмите кнопку «Сохранить».

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

Синтаксис форматирования

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

Однако если вы хотите сделать красивую статьи, то вы можете воспользоваться всеми возможностями вики-форматирования или вики-разметки.

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

Если хотите поупражняться в форматировании (вики-разметке), используйте песочницу.

Простую вики-разметку также можно легко сделать с помощью панели инструментов

Основные конструкции форматирования

Вики-форматирование (вики-разметка) поддерживает:

  • выделение текста жирным шрифтом
  • курсивом
  • подчеркнутый текст
  • вывод текста моноширинным шрифтом.

Все эти конструкции можно объединить.

Вики-форматирование (вики-разметка) поддерживает выделение текста **жирным шрифтом**, //курсивом//, 

__подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. 

Все эти конструкции можно **__//''объединить''//__**.

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

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

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

Чтобы начать текст с новой строки (новый абзац), отделите этот текст от предыдущего пустой строкой.

Чтобы принудительно вставить перенос строки, не создавая новый абзац, вставьте два обратных слэша и за ним пробел или нажмите клавишу Enter.

Внимание!Два обратных слэша действуют только в конце строки или если за ними стоит пробел.

Просто текст с разрывом строк\\ Обратите внимание,

что два обратных слэша действуют только в конце строки\\

или если за ними стоит\\ пробел. 

Внимание!Принудительные переносы следует использовать только в случае крайней необходимости.

Ссылки

Внешние

Внешние ссылки распознаются автоматически: http://www.verim.org или просто www.verim.org.

Также можно указать пояснительный текст ссылки: Это ссылка на этот сайт. Для этого после адреса ссылки поставьте вертикальную черту | и далее напишите пояснительный текст.

Адреса электронной почты тоже распознаются: admin [at] verim [dot] org.

Внешние ссылки распознаются автоматически: http://www.verim.org или просто www.verim.org 

Также можно указать пояснительный текст ссылки: [[http://www.verim.org|Это ссылка на этот сайт]]. 

Адреса электронной почты тоже распознаются: <admin@verim.org>.

Внутренние

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать имя страницы в двойных квадратных скобках, либо дополнительно прописать пояснительный текст к ссылке, который отделяется от имени страницы вертикальной чертой |. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внимание!Внутренние ссылки ведут на страницы, расположенные в одном пространстве имен родительской страницы. Другими словами, простая ссылка ведет на страницу, которая размещена в той же самой папке.

Внутренние ссылки создаются посредством двойных квадратных скобок.

Например, вот простая ссылка по имени страницы - [[Имя страницы]].

Также можно указать дополнительно пояснительный текст к ссылке - [[Имя страницы|Пояснительный текст ссылки]].

В ссылке также можно использовать пространство имен (структуру вложенных папок сайта) через двоеточие. Более подробно о пространстве имен можно прочитать в разделе «Пространство имен».

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

http://www.verim.org/hrist:vz:bytie:glava01:01.txt

Внимание!В Windows-системах двоеточие (:) может быть заменено на точку с запятой (;), но в реальной ссылке нужно указывать именно двоеточие.

Копируем в буфер обмена строку, начиная с hrist, то есть вот это:

hrist;vz;bytie;glava01;01.txt

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

[[Первый текст Библии]]

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

Таким образом будет создана ссылка на новую страницу.

Можно использовать в ссылке пространство имен (полный путь к файлу) через двоеточие. 

Например, [[hrist:vz:bytie:glava01:01.txt|Первый текст Библии]]

В примере выше через двоеточия показан иерархический путь к файлу 01.txt

Примечание:

  • Ссылки на несуществующие страницы выделяются красным цветом. Если щелкнуть по такой ссылке, вам будет предложено создать такую страницу. Если вы уверены, что страница, на которую вы ссылаетесь, всё-таки существует, то проверьте внимательно формат ссылки.

Сноски

С помощью двойных скобок можно добавить сноску1).

С помощью двойных скобок можно добавить сноску ((Это сноска)).

Расшифровка сноски будет в самом низу страницы.

Разбивка на разделы

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

Заголовок 3-го уровня

Заголовок 4-го уровня

Заголовок 5-го уровня
====Заголовок 3-го уровня====

===Заголовок 4-го уровня===

==Заголовок 5-го уровня==

Четыре и более тире преобразуются в горизонтальную черту:



----

Картинки и другие файлы

Чтобы вставить картинку на страницу вам необходимо указать ссылку на неё. Перед этим необходимо закачать картинку на сайт.

Для этого нажмите на функциональную кнопку «Добавить картинки и другие файлы» -

Далее с помощью кнопки «Обзор» необходимо найти нужный файл и нажать кнопку «Загрузить».

С помощью фигурных скобок можно вставлять в текст внешние и внутренние (то есть размещенные на этом сайте) картинки. По желанию можно указать их размер.

Картинка нормального размера:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

Картинка нормального размера:             {{dokuwiki-128.png}}

Отмасштабированная до заданной ширины:    {{dokuwiki-128.png?50}}

Отмасштабированная до заданных размеров:  {{dokuwiki-128.png?200x50}}

Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}

Поставив слева или справа пробел можно задать выравнивание картинки:

{{dokuwiki-128.png }}

{{ dokuwiki-128.png}}

{{ dokuwiki-128.png }}

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

Название картинки

{{ dokuwiki-128.png |Название картинки}}

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

Картинки-ссылки

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.verim.org|{{dokuwiki-128.png}}]]

Внимание!Картинка - это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Списки

Вики-форматирование (вики-разметка) поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, или - (дефис) в случае нумерованного. Также для этого можно использовать функциональные кнопки над окном редактирования.

  • Это список.
  • Второй элемент списка.
    • Можно сделать вложенный список.
  • Ещё один элемент.
  1. Тот же список, только нумерованный.
  2. Ещё элемент.
  3. И еще.
    1. Чем больше пробелов в начале, тем глубже вложенность. Количество пробелов кратно двум.
  4. Всё просто!
  * Это список.
  * Второй элемент списка.
    * Можно сделать вложенный список.
  * Ещё один элемент.

  - Тот же список, только нумерованный.
  - Ещё элемент.
  - И еще.
    - Чем больше пробелов в начале, тем глубже вложенность. Количество пробелов кратно двум.
  - Всё просто!

Смайлики

Используя функциональные кнопки над окном редактирования вы можете вставлять в статьи смайлики.

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME Данный смайлик можно использовать для пометки текста, требующего доработки
  • DELETEME Данный смайлик можно использовать для пометки текста, требующего удаления

Типографские символы

С помощью вики-форматирования (вики-разметки) можно переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы:

→ ← ↔⇒ ⇐⇔ » « – — '640×480' © ™ ®

«Единение указано во всех верованиях, как единственный оплот преуспеяния».

-> <- <->=> <=<=> >> << -- --- '640x480' (c) (tm) (r)

"Единение указано во всех верованиях, как единственный оплот преуспеяния".

Таблицы

Вики-форматирование (вики-разметка) поддерживает простые таблицы.

Заголовок 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  |

Примечание: Вертикальное объединение (rowspan) не поддерживается.

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру.

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

Неформатируемые блоки

Можно вывести любой текст, например цитату, в специальном блоке. Для этого необходимо начинать каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах). Также для этого можно использовать тэги <code> или <file>.

Это неформатированный текст с тэгом code, в котором сохранены все пробелы: вот             <- так.
Используя тэг file можно показать, что цитируется содержимое файла.

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

Это просто текст, в котором есть адрес http://www.splitbrain.org

и **форматирование** — но ничего не происходит.

Это просто текст, в котором есть адрес %%http://www.splitbrain.org%% 

и %%**форматирование**%% --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код страницы.

Дополнительное форматирование

С помощью перечисленных ниже средств, вы можете вставлять в свою статью цветной текст, подсвечивать сам текст, а также оформлять его в виде заметок.

Цветной шрифт

Используя тэги <wrap></wrap> вы можете изменять цвет шрифта. Например:

Красный шрифт

<wrap fgred>Красный шрифт</wrap>

Боксы

Вы также можете оформлять тексты, особенно цитаты, в виде «боксов».

Простой «бокс»:

Это пример простого «бокса»
<box>Это пример простого "бокса"</box>

Более сложный «бокс»:

Заголовок бокса

Содержимое бокса
<box 80% round red|**a title**> the box contents </box>

Все опции:

<box ширина опции | Заголовок > Содержимое бокса </box| Нижний текст >

  • ширина - размер «бокса» в процентах
  • опции: (указываются через пробел)
  • round — углы «бокса» сделать закругленными (работает не во всех браузерах)
  • blue — синий «бокс»
  • red — красный «бокс»
  • green — зеленый «бокс»
  • orange — оранжевый «бокс»
  • left — разместить «бокс» слева страницы
  • right — разместить «бокс» справа страницы

Заметки

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

обычная заметка





заметка-подсказка
важная заметка
заметка-предупреждение
<note>обычная заметка</note>

<note tip>заметка-подсказка</note>

<note important>важная заметка</note>

<note warning>заметка-предупреждение</note>

Желаем Вам удачи!

Рекомендуемые статьи:

:!: Скачать этот сайт :!:

Рекомендуем оформить подписку на новости нашего сайта. Соответствующая форма расположена внизу каждой страницы.

1) Это сноска

Обсуждение

Алексей, shuan11@mail.ru, 2017/10/17 14:59
Как перекрасить текст?
вставил код из примера <wrap fgred>Красный шрифт</wrap> в режиме "визуальное редактирование". Этот код отобразился текстом и не заработал. В чем ошибка?
Администратор, ok@verim.org, 2017/10/17 21:36
День добрый, Алексей!
Не совсем понял термин, "визуальное редактирование"...
На страничке нажимаете кнопку "Править", вставляете в нужном месте код <wrap fgred>Красный шрифт</wrap>, сохраняете страницу...
Введите ваш комментарий
SIFWV
 
 
/home/kievnet/www/site2/public_html/data/pages/wiki/syntax.txt · Последние изменения: 2016/03/09 18:04 — admin
 
Вы можете оставить свои комментарии в разделе "Обсуждение".
Рекомендуем оформить подписку на новости данного раздела. Для этого нажмите на кнопку "Подписаться", расположенную внизу каждой страницы.

Приглашаем к online-общению!
Индекс цитирования