Установка

Системные Требования

Чтобы использовать Jigsaw, на Вашем компьютере должны быть установлены PHP (минимальная версия 7.3) и Composer. Вам также необязательно потребуется установить Node.js и NPM, если Вы хотите использовать Laravel Mix для компиляции CSS и Javascript.

1. Создать каталог проекта

Сначала создайте новый каталог для своего сайта:

$ mkdir my-site

2. Установите Jigsaw через Composer

Затем перейдите в каталог Вашего нового проекта и установите Jigsaw с помощью Composer:

$ cd my-site
$ composer require tightenco/jigsaw

3. Инициализируйте свой проект

Наконец, из каталога Вашего проекта запустите команду Jigsaw init, чтобы сформировать структуру каталогов по умолчанию:

$ ./vendor/bin/jigsaw init

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

$ ./vendor/bin/jigsaw init blog

или

$ ./vendor/bin/jigsaw init docs

Структура каталогов

По умолчанию Jigsaw предоставляет следующую структуру каталогов:

source
_assets
js
main.js
sass
main.scss
_layouts
master.blade.php
assets
build
js
main.js
sass
main.css
mix-manifest.json
images
jigsaw.png
index.blade.php
tasks
vendor
bootstrap.php
composer.json
composer.lock
config.php
package.json
webpack.mix.js

Каталог /source содержит фактическое содержимое Вашего сайта. Здесь будут храниться все страницы Вашего сайта, CSS, Javascript, изображения и т. д.

В корне каталога Jigsaw предоставляет файл config.php, в котором Вы можете указать параметры конфигурации для своего сайта, а также webpack.mix.js для настроек, связанных с компиляцией Ваших ресурсов.

Затем узнайте о создании и предварительном просмотре Вашего сайта.

Почему в /source есть два каталога assets, один с префиксом подчеркивания? Узнайте в разделе Компиляция ресурсов section.