Оформляем красиво или особенности wiki-разметки сайта

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

Итак, прежде всего хочу заметить, что сайт не использует движок mediawiki, а следовательно прежде чем что-либо добавить, проверьте как это будет выглядеть после публикации. Для просмотра используйте ссылку под окном “Предварительный просмотр”.

На странице ввода текста есть ссылка на страницу “Помощь” с описанием Wiki-разметки. Ссылка ведет сюда, больше информации можно получить здесь.

На сайте используется +wiki-язык разметки Textile.

Некоторые особенности форматирования

# Чтобы не делать увеличенный интервал отступа, после закрывающего тэга почти всегда оставляйте пустую строку. Пример:

 # uname -a
Linux atratsevskiy 2.6.36.2-calculate #1 SMP PREEMPT Thu Dec 30 08:58:30 Local time zone must be set-- i686 AMD Phenom(tm) 9850 Quad-Core Processor AuthenticAMD GNU/Linux

# В отличие от mediawiki, завершающим тэгом выделения абзацев и параграфов является перевод строки. Вместо:

=Заголовок=

следует писать:

h1. Заголовок

# Частая ошибка использования тэга фиксированного текста “@”. Если вставить этот тэг без отступов, эффекта не будет.
# Вместо , для вставки текста, часто удобней использовать один отступ в начале строки. В отличие от mediawiki, до и после такого текста используйте пустую строку, а отступ пробелом используйте только в первой строке. Пример:

 Для вставки нескольких строк текста,
достаточно поставить пробел в начале первой строки.
Используйте пустые строки до и после текста.

Работа с картинками

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

Для вставки изображений используйте тэг

!картинка.jpg!

Для вставки картинки в центре:

p=. !картинка.jpg!

Вы можете вставить картинку, добавив к ней тень. Центрирование в этом случае будет определено знаком =,< и >. Пример:

!=картинка.jpg!shadow

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

p=. !картинка_маленькая.jpg!lb:/attachments/путь/картинка.png

Тоже только с тенью:

!=картинка_маленькая.jpg!lb,shadow:/attachments/путь/картинка.png

Путь к картинке можно посмотреть после добавления её на сайт. Все картинки закрепляются за страницами, но по полным путям можно сделать ссылку на другую картинку.

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

Лучший способ быстро научиться форматировать текст - смотреть примеры. Для зарегистрированных пользователей внизу страниц с документацией доступно меню “Экспортировать в HTML | TXT”. Воспользуйтесь экспортом в TXT, чтобы посмотреть структуру wiki разметки.

Спасибо, это было написано явно для меня, что бы не забыл :slight_smile:

Спасибо, учтем.

!картинка_маленькая.jpg!lb:http://www.calculate-linux.ru/attachments/путь/картинка.png 

ИМХО - правильней было бы без имени домена, поскольку заходят иногда (я к примеру) по другому адресу. Короче как-то вот так.

!картинка_маленькая.jpg!lb:/attachments/путь/картинка.png 

Кстати, кому интересно такие и
такие ссылки имеют такой синтаксис

кому интересно "такие":http://ru.wikipedia.org/ и
"такие ссылки":/blogs/ru/211/show имеют такой синтаксис

ИМХО - правильней было бы без имени домена, поскольку заходят иногда (я к примеру) по другому адресу. Короче как-то вот так.

Картинки будут открываться, но так действительно правильней, спасибо.