Интернет, компьютеры, софт и прочий Hi-Tech

Показать HTML | Показать BBCode

PHP-библиотека xBB 0.29 для работы с BBCode

Общие сведения

1. Названия тегов и атрибутов не зависят от регистра. Например, [font=Arial size=+1], [FONT=Arial SIZE=+1] и [FoNt=Arial SiZe=+1] - равнозначно.
    
   
2. Значения атрибутов могут быть закавычены "так" и 'так', либо никак не закавычены. Следующие конструкции равнозначны: [google="BBCode"], [google='BBCode'], [google=BBCode]. Следующие конструкции НЕ равнозначны: [google="Поддержка BBCode"], [google=Поддержка BBCode]. Последний вариант будет интерпретирован скриптом как [google="Поддержка" bbcode=""].
    
   
3. Теги могут быть вложенными. Но те из них, которые создают элементы блочного типа (такие как [h1] или [table]), не могут быть вложены в строчные теги (такие как [i] или [color]). Строчные элементы закрываются, если начинается блочный. Эти ограничения обусловлены требованиями W3C.
    
   
4. Теги должны быть правильно вложены. Неправильный код "[b][i]текст[/b][/i]" будет интерпретирован скриптом как "[b][i]текст[/i][/b][/i]". Это ограничение также обусловлено требованием W3C.
    
   
5. В данной реализации BBCode поддерживаются закрывающие теги вида [/]. Такой тег закрывает последний незакрытый тег. Например, [b]текст[/b] равнозначно [b]текст[/]. Тем не менее рекомендую пользоваться именно первой формой написания. Тогда, в случае нагромождения вложенных тегов, вам будет легче ориентроваться в коде. Кроме того, первая форма написания позволяет скрипту более корректно обрабатывать пользовательские ошибки.
    
   
6. Поддерживается закрытие тега способом [тег /]. Например, конструкции [url name=top][/url] и [url name=top /] равнозначны.
    
   
7. В некоторых случаях можно не писать закрывающий тег. Например, тег [tr] (строка таблицы), будет автоматически закрыт, как только встретится очередной [tr] или закрывающий тег [/table]. Тег [hr] вообще не имеет закрывающего, интерпретируется скриптом как [hr/]. О поведении конкретных тегов смотрите их описания.
    
   
8. При конвертации ББКода в HTML сохраняется форматирование пробелами. Т.е. все двойные пробелы переводятся в '&nbsp;&nbsp;', все переводы строк заменяются на '<br />'. Однако вокруг некоторых элементов (таких как [h1]) игнорируются 1-2 перевода строк, так как эти элементы сами по себе создают дополнительные отступы. Это сделано для того, чтобы по возможности приблизить визуальное представление HTML к исходному ББкоду.
   

1. Открывающая квадратная скобка '[' может быть мнемонизирована как '@l;'.
    
   
2. Закрывающая квадратная скобка ']' может быть мнемонизирована как '@r;'.
    
   
3. Двойная кавычка '"' может быть мнемонизирована как '@q;'.
    
   
4. Одинарная кавычка "'" (апостроф) может быть мнемонизирована как '@a;'.
    
   
5. Знак собачки '@' может быть мнемонизирован как '@at;'.
   

Благодарности

• Большое спасибо разработчикам редактора TinyMCE из Moxiecode Systems AB. Я использовал их идеи для переделки тулбара в xBBEditor-е для xBB версии 0.29. А также заимствовал несколько кнопок.
   
  
• Дмитрий Котеров (http://dklab.ru) - разработчик библиотеки JsHttpRequest, которую я использовал в xBBEditor-е для xBB версии 0.28.
   
  
• Александр Пальчиков (ZigFreeD) - специально для xBB написал код JavaScript для редактирования BBCode в textarea. Этот код был использован в xBBEditor-е. Отдельное спасибо за активное тестирование и исправление найденных багов.
   
  
• Nigel McNie (http://qbnz.com/highlighter) - разработчик библиотеки GeSHi, которую я использовал для создания тегов подсветки синтаксиса. Кроме того, я использовал дизайн документации GeSHi для оформления документации xBB. Благо Nigel McNie разрешает это делать.
   
  
• Дмитрий Золотарев (Whirlwind - http://www.prolib.ru) - спасибо за идеи, помощь в продвижении и SVN-репозитарий.
   
  
• Виталий Фиоктистов (VITUS - http://www.pc.uz) - придумал название "xBB" и нарисовал соответствующий логотип. Также спасибо за идеи и помощь в продвижении.
   
  
• Алесандр Михайлов - подготовил коллекцию смайликов для phpBB (2005), которой я воспользовался включив в пакет xBB.
  

Последнее редактирование: 2011-02-20 03:26:51

Метки материала: xbb, bbcode, теги, php, html, парсер, xhtml, bb-code

68 комментариев

13.08.2007 18:59:32

#

 Гость Dmi3x

Блин, всё отлично работает... но эта красиваф форма на JS рабоает только в IE
В опере эта форма вообще даже нормально не отображается
Видать придётся кнопки самому делать

13.08.2007 19:19:05

#

 dima

У меня в Опере 9.20 все нормально отбражается и кнопки работают. Какая у вас версия? В 8-ой однозначно не будет работать.

14.08.2007 13:56:22

#

 Гость Dmi3x

Г, ну у меня как раз 8.5 )
Я конечно не силён в JS, но брал вот отсюда: ( http://forum.vingrad.ru/forum/topic-35775.html)  - скрипт для вставки текста в textarea и он у меня работал и в 8й Опере... хотя и не полностью, но работал
Блин, жалко что такая фигня с этими браузерами...
 
А вобщем, огромное спасибо за либу! абалденная штука!

14.08.2007 14:52:34

#

 dima

Спасибо на добром слове.
 
xBB может работать с любым редактором. Если у вас есть свой, лучше использовать именно его.
 
xBBEditor - вещь экспериментальная. Я попытался реализовать в нем подсветку синтаксиса BBCode. А это требует
 

Javascript

document.designMode = 'on';

который поддерживается в Опере только с 9-й версии.

18.08.2007 21:02:39

#

 dima

Тоже думал об этом. Причем в более универсальном ключе. Так, чтобы в <p> заключались все куски текста, которые должны заключаться в него по смыслу.
 
Но это оказалось несколько сложнее, чем сначало представлялось. Проблема в том, что нельзя просто взять в <p> куски текста, разделенные пустыми строками, это может привести к невалидному (с точки зрения W3C) коду. Например, в таком случае:
 
text 1
[center]text 2[/center]
text 3
 
Можно, конечно, пытаться учесть все такие случаи. Но это требует громоздкого кода. Хотелось бы чего покрасивше Идеи уже есть. Думаю, что в следующей версии это будет сделано.

30.09.2007 23:32:25

#

 dima

1 секунда - тоже чересчур много. На xBB.uz большие и сложные тексты BBCode отдаются посетителю практически мгновенно (уж незнаю, как принимаются )
 
Все дело - в кэшировании. Нет смысла генерировать один и тот же текст каждый раз, как его запросят.
 
Но даже и без кэширования 12 сек. - это чересчур. Приведите, пожалуйста, характеристики вашего сервера и код, который выводит посты.

Оставьте, пожалуйста, свой комментарий к публикации

Представиться как

Антибот:

Просьба не постить мусор. Если вы хотите потестить xBB, воспользуйтесь кнопкой предварительного просмотра на панели инструментов xBBEditor-а.