====== Если вы новичок в Limb3... ======

===== Основные идеи =====

Limb3 - это не монолитный фреймворк, как например, Symfony. Limb3 состоит из набора осносительно независимых [[limb3_2007_2:ru:packages_architecture|пакетов]], каждый из которых должен решать свою задачу.

Limb3 должен быть установлен в папку, которая доступна через get_include_path(). Вы можете или поправить свой php.ini файл или же изменять include_path прямо в базовом файле проекта:

<code php>
set_include_path('path/to/limb/installation' . PATH_SEPARATOR . get_include_path());
</code>

'path/to/limb/installation' должен указывать на папку, где лежит limb, а не на саму папку с limb, то есть /var/dev/lib/ вместо /var/dev/lib/limb/.


===== Скачивание Limb3 =====

Если вы не собираетесь участвовать в разработке Limb3, то самым простым способом можно получить Limb3 через PEAR канал. На PEAR канале выкладываются самые стабильные релизы и они появляются там наиболее рано. Однако Limb3 также можно получить с sourceforge.net и с build-сервера. см. раздел [[limb3_2007_2:ru:how_to_download|Где и как скачать Limb3]].


===== Примеры для начинающих =====

Для освоения Limb3 есть 2 пошаговых примера:
  * [[limb3_2007_2:ru:tutorials:basic|базовый пример]], где показаны только самые основы использования пакетов WEB_APP, ACTIVE_RECORD и WACT.
  * [[limb3_2007_2:ru:tutorials:shop|пример создания простого электронного магазина]], в котором объяснены почти все часто используемые компоненты Limb3.

Базовый пример можно найти в папке limb/web_app/examples/crud. Там же лежит пуская заготовка для нового Limb3-based проекта.

Другие примеры можно найти в SVN репозитории (пока они нигде более не доступны):
<code>
  svn co https://svn.limb-project.com/limb/3.x/examples
</code>

По этом адресу вы сможете найти в настоящее время:
  * реализацию основного сайта http://limb-project.com на базе Limb3
  * пример создания простого электронного магазина
  * пример реализации корпоративной визитки с каталогом

Примеры использования WACT-шаблонизатора можно найти в папке limb/wact/examples.

===== Документация =====

Документация на Limb3 достаточно актуальна. Наиболее точными являются разделы [[limb3_2007_2:ru:usage:wact|про WACT]] и [[limb3_2007_2:ru:usage:active_record|про использование ACTIVE_RECORD]]. Эти разделы мы рекомендуем прочитать после прохождения [[limb3_2007_2:ru:tutorials:basic|базового примера]].

Также есть описания на большинство [[limb3_2007_2:ru:packages|пакетов]] Limb3. В этих разделах информация частично, а кое-где и сильно, устарела. Мы постепенно исправляем ситуацию, но это требует очень много времени и поэтому прогресс идет достаточно медленно. Так что, если что-то из этих разделов будет вам неясным, то можете спрашивать на [[http://forum.limb-project.com/|форуме]] - мы стараемся отвечать на большинство вопросов оперативно и развернуто.


===== Модульные тесты =====

Для большинства классов и подсистем Limb3 существуют модульные тесты. Те разработчики, которые могу читать тесты, смогут найти множество примеров использования тех или иных классов в тестах. Подробнее о тестах и способах из запуска можно прочитать в [[limb3_2007_2:ru:how_to_run_tests|соответствующем разделе]].


===== Варианты использования Limb3 =====

Вы можете использовать Limb3 как полностью законченный фреймворк, создавая на его базе приложения или же использовать из него только отдельные пакеты, например:
  * TESTS_RUNNER - пакет для запуска тестов
  * WACT - шаблонизатор
  * TOOLKIT - инструмент для управления зависимостями
  * UTIL - набор утилитарных классов
  * и т.д.

===== Если вам нужна помощь =====

Не стесняйтесь, спрашивайте на [[http://forum.limb-project.com|форуме]]. Мы всегда постараемся ответить на ваши вопросы.