Помощь по BBCode

Вступление

Что такое BBCode?
BBCode — это специальный вариант HTML. Сможете ли вы использовать BBCode в ваших сообщениях или нет, определяется администратором форума. Кроме того, вы сможете отключить использование BBCode в конкретном сообщении при его размещении. Сам BBCode по стилю похож на HTML, теги заключены в квадратные скобки [ и ], а не в < и >; он даёт больше возможностей управления тем, как выводятся данные. При использовании некоторых шаблонов вы сможете добавлять BBCode в ваши сообщения, пользуясь простым интерфейсом, расположенным над полем для ввода текста. Но даже в этом случае данное руководство может оказаться полезным.

Форматирование текста

Как сделать текст жирным, наклонным или подчёркнутым
BBCode включает теги для быстрого изменения стиля шрифта, сделать это можно следующими способами:
  • Чтобы сделать текст жирным, заключите его в [b][/b], например:

    [b]Привет[/b]

    станет Привет
  • Для подчёркивания используйте [u][/u], например:

    [u]Доброе утро[/u]

    станет Доброе утро
  • Курсив делается тегами [i][/i], например:

    Это [i]здорово![/i]

    выдаст Это здорово!

Как изменить цвет или размер текста
Для изменения цвета или размера шрифта могут быть использованы следующие теги (окончательный вид будет зависеть от системы и браузера пользователя):
  • Цвет текста можно изменить, окружив его [color=][/color]. Вы можете указать либо известное имя цвета (red, blue, yellow и т. п.), или шестнадцатеричное представление, например #FFFFFF, #000000. Таким образом, для создания красного текста вы можете использовать:

    [color=red]Привет![/color]

    или

    [color=#FF0000]Привет![/color]

    оба способа дадут в результате Привет!
  • Изменение размера достигается аналогичным образом при использовании [size=][/size]. Этот тег зависит от используемых шаблонов, рекомендуемый формат — число, показывающее размер текста в процентах, от 20% (очень маленький) до 200% (очень большой) от размера по умолчанию. Например:

    [size=30]МАЛЕНЬКИЙ[/size]

    скорее всего будет МАЛЕНЬКИЙ

    в то время как:

    [size=200]ОГРОМНЫЙ![/size]

    будет ОГРОМНЫЙ!

Могу ли я комбинировать теги?
Да, конечно, можете. Например, для привлечения чьего-то внимания вы сможете написать:

[size=200][color=red][b]ПОСМОТРИТЕ НА МЕНЯ![/b][/color][/size]

что выдаст ПОСМОТРИТЕ НА МЕНЯ!

Мы не рекомендуем выводить таким образом длинные тексты! Учтите, что вы, автор сообщения, должны позаботиться о том, чтобы теги были правильно вложены. Вот этот BBCode, например, неправилен:

[b][u]Это неверно[/b][/u]

Создание ссылок

Ссылки на другой сайт
В BBCode поддерживается несколько способов создания URL'ов.
  • Первый из них использует тег [url=][/url], после знака = должен идти нужный URL. Например, для ссылки на phpbbex.com вы могли бы использовать:

    [url=http://phpbbex.com/]Посетите форум phpBBex![/url]

    Это создаст следующую ссылку: Посетите форум phpBBex! Учтите, что ссылка будет открываться в том же или в новом окне, в зависимости от настроек браузера пользователя.
  • Если вы хотите, чтобы в качестве текста ссылки показывался сам URL, вы можете просто сделать следующее:

    [url]http://phpbbex.com/[/url]

    Это выдаст следующую ссылку: http://phpbbex.com/
  • Кроме того, phpBBex поддерживает возможность, называемую Автоматические ссылки, это переведёт любой синтаксически правильный URL в ссылку без необходимости указания тегов и даже префикса http://. Например, ввод www.phpbbex.com в ваше сообщение приведёт к автоматической выдаче www.phpbbex.com при просмотре сообщения.
  • То же самое относится и к адресам email, вы можете либо указать адрес в явном виде:

    [email]example@mail.com[/email]

    что выдаст example@mail.com, или просто ввести example@mail.com в ваше сообщение, и он будет автоматически преобразован при просмотре.
Как и со всеми прочими тегами BBCode, вы можете заключать в URL'ы любые другие теги, например [img][/img] (см. следующий пункт), [b][/b] и т. д. Как и с тегами форматирования, правильная вложенность тегов зависит от вас, например:

[url=http://phpbbex.com/][img]http://phpbbex.com/logo.png[/url][/img]

неверно, что может привести к последующему удалению вашего сообщения, так что будьте аккуратнее.

Показ изображений, видео, аудио, карт и прочих медиа элементов в сообщениях

Добавление изображения в сообщение
BBCode включает тег для добавления картинки в ваше сообщение. При этом следует помнить две очень важные вещи: во-первых, многих пользователей раздражает большое количество изображений, во-вторых, ваше изображение уже должно быть размещено в интернете(Для загрузки изображения с компьютера используте систему вложений.). Для вывода изображения вы должны окружить его BBCode тегами [img][/img]. Например:

[img]http://phpbbex.com/logo.png[/img]

выдаст:

phpBBex logo

Добавление вложений в сообщение
Теперь вложения могут быть помещены в любой части сообщения при помощи нового тега BBCode [attachment=][/attachment], если вложения разрешены администратором форума и если вы имеете необходимые права доступа. На странице размещения сообщения находится выпадающий список (соответственно кнопка) для размещения вложений в сообщении.

Добавление видео, аудио и прочих медиа элементов [media]
Для вставки видео пользователь должен вставить его адрес между [media][/media]:

Поддерживаемые видеосервисы:
  • youtube.com (youtu.be) — плейлисты также поддерживаются
  • vimeo.com
  • rutube.ru — только адрес из кода встраивания
  • vk.com (vkontakte.ru) — только адрес из кода встраивания
  • facebook.com
  • video.mail.ru
  • smotri.com
  • dailymotion.com
  • ustream.tv — поддерживаются и записи, и трансляции
  • twitch.tv — поддерживаются и записи, и трансляции
  • video.qip.ru
  • video.yandex.ru — только адрес из кода встраивания
  • video.bigmir.net
  • tvigle.ru — только адрес из кода встраивания
  • video.online.ua
  • video.sibnet.ru
  • yapfiles.ru — только адрес из кода встраивания BBCode (для видео и музыки)
  • megogo.net
  • intv.ru
  • lovi.tv
  • metacafe.com
  • veevr.com
  • myvideo.de
  • clipfish.de
  • hulu.com — только адрес из кода встраивания
  • own3d.tv
  • ign.com
  • ted.com
  • vine.co
  • coub.com
  • pinkbike.com
  • mpora.com
  • archive.org
  • файлы WebM, OGV и MP4 через HTML5
Поддерживаемые аудиосервисы:
  • soundcloud.com — ссылка на страницу трека и ссылка из кода встраивания
  • promodj.com — ссылка на страницу трека, ссылка на скачивание и ссылка из кода встраивания
  • pleer.com (prostopleer.com) — ссылка на трек или плейлист и ссылки из кода встраивания (новый и старый вариант)
  • music.yandex.ru — ссылка на страницу с треком (только для тех треков, что поддерживают это)
  • video.yandex.ru — только ссылка из кода встраивания на аудио
  • yapfiles.ru — только ссылка из кода встраивания на аудио
  • файлы WAV, MP3, OGG, OGA, AAC и M4A через HTML5
Прочие медиа:
  • docs.google.com (документы, таблицы и формы; берите ссылку из File » Publish to the web)
  • maps.google.com (карты, панорамы)
  • openstreetmap.org (карты)
  • 360cities.net (панорамы)
  • picasaweb.google.com (слайдшоу из галерей)
  • dermandar.com (панорамы)
  • share.mapbbcode.org (карты с вашими метками на ней)
  • connect.garmin.com (GPS-треки)
  • endomondo.com (маршруты и тренировки)
  • gpsies.com (GPS-треки)
  • bikemap.net (GPS-треки)
  • livegpstracks.com (GPS-треки, поддерживаются только ссылки из кода встраивания)

Цитирование и вывод форматированных текстов

Цитирование при ответах
Есть два способа процитировать текст, со ссылкой и без.
  • Когда вы используете кнопку «Цитата» для ответа на сообщение, то его текст добавляется в поле ввода окружённым блоком [quote=""][/quote]. Этот метод позволит вам цитировать со ссылкой на автора либо на что-то ещё, что вы туда впишете. Например, для цитирования отрывка текста, написанного Mr. Blobby, вы напишете:

    [quote="Mr. Blobby"]Текст Mr. Blobby будет здесь[/quote]

    В результате перед текстом будут вставлены слова «Mr. Blobby писал(а):». Помните, вы должны заключить имя в кавычки "", они не могут быть опущены.
  • Второй метод просто позволяет вам что-то процитировать. Для этого вам надо заключить текст в теги [quote][/quote]. При просмотре сообщения будет просто показан текст в блоке цитирования.

Вывод кода или форматированного текста
Если вам необходимо вывести программный код или что-то, что должно быть выведено моноширным шрифтом, вы должны заключить текст в теги [code][/code] (для больших текстов, оформляется в виде отдельного блока) или [tt][/tt] (для коротких однострочных текстов, без отдельного блока), например:

[code]echo "This is some code";[/code]

Всё форматирование, используемое внутри тегов [code][/code] и [tt][/tt], будет сохранено. Подсветка синтаксиса языка PHP может быть включена с помощью [code=php][/code] и рекомендуется при отправке сообщений с PHP-кодом для улучшения его удобочитаемости.

Создание списков

Создание маркированного списка
BBCode поддерживает два вида списков: маркированные и нумерованные. Они практически идентичны своим эквивалентам из HTML. В маркированном списке все элементы выводятся последовательно, каждый отмечается символом-маркером. Для создания маркированного списка используйте [list][/list] и определите каждый элемент при помощи [*]. Например, чтобы вывести свои любимые цвета, вы можете использовать:

[list]
[*]Красный
[*]Синий
[*]Жёлтый
[/list]

Это выдаст такой список:
  • Красный
  • Синий
  • Жёлтый

Создание нумерованного списка
Второй тип списка, нумерованный, позволяет выбрать, что именно будет выводиться перед каждым элементом. Для создания нумерованного списка используйте [list=1][/list] или [list=a][/list] для создания алфавитного списка. Как и в случае маркированного списка, элементы определяются с помощью [*]. Например:

[list=1]
[*]Пойти в магазин
[*]Купить новый компьютер
[*]Обругать компьютер, когда случится ошибка
[/list]

выдаст следующее:
  1. Пойти в магазин
  2. Купить новый компьютер
  3. Обругать компьютер, когда случится ошибка
Для алфавитного списка используйте:

[list=a]
[*]Первый возможный ответ
[*]Второй возможный ответ
[*]Третий возможный ответ
[/list]

что выдаст
  1. Первый возможный ответ
  2. Второй возможный ответ
  3. Третий возможный ответ