Школа Даля
 

Привет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ссылки

Внешние

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

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

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

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

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

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

Внутренние

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

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

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

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

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

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

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

http://www.olegdal.ru/project:bioloc:start.txt

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

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

project:bioloc:start.txt

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

[[Биолокация]]

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

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

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

Например, [[project:bioloc:start.txt|Биолокация]]

В примере выше через двоеточия показан иерархический путь к файлу start.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.olegdal.ru|{{dokuwiki-128.png}}]]

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

Списки

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

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

    * Второй элемент списка

      * Можно сделать вложенный список

    * Ещё один элемент

  - Тот же список, только нумерованный

  - Ещё элемент

    - Чем больше пробелов в начале, тем глубже вложенность

  - Всё просто

Смайлики

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

  • 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) Это сноска
 
/home/h006361565/olegdal.ru/docs/data/pages/wiki/syntax.txt · Последние изменения: 2023/09/03 17:13 (внешнее изменение)
 

Школа Даля - это некоммерческий проект, электронные материалы и версии книг распространяются бесплатно.
Наши материалы можно свободно копировать, желательно с указанием ссылки на источник. Спасибо!

Select language:

Индекс цитирования