Начало работы
После того, как все необходимые инструменты были подготовлены, можно начинать.
Создание удаленного репозитария
Надежнее всего хранить проекты не только на компьютере, но и где-нибудь еще. Так как мы используем Git для контроля версий, проекты мы будем хранить на Гитхабе. Если вам нужен приватный репозитарий, если вы используете корпоративное хранилище или просто не любите Гитхаб, подойдет любое другое хранилище Git-репозитариев.
Создадим удаленный репозитарий.
После создания, клонируем только созданный репозитарий себе:
Лучше клонировать через SSH: если при создании ключа возникла ошибка, на данном этапе она проявит себя.
Скопированный адрес репозитария понадобится нам далее. Лучше всего будет создать на компьютере отдельную папку для репозитариев и клонировать все репозитарии в нее. У меня это C:\repos. Перейдем в нашу папку в терминале:
Клонируем репозитарий:
Все прошло удачно, значит, SSH-ключ был создан правильно. Можно переходить в папку репозитария и создавать проект.
Появившаяся надпись (master) обозначает активную ветку Git-репозитария. Для нас это означает, что созданная при клонировании папка действительно содержит наш репозитарий, и мы готовы начинать.
Создание нового проекта Baumeister
Создадим новый проект в нашей папке: введем в терминал следующую команду:
yo baumeister
Выданное приветствие означает, что все работает как надо. Текст в скобках всегда указывает на значение по умолчанию: например, чтобы имя проекта осталось Test, нужно просто нажать Enter.
Описание диалога
What’s the name of your project? — имя проекта. По умолчанию совпадает с именем репозитария, только начинается с большой буквы и содержит пробелы.
A short description of your project: — краткое описание проекта (опционально).
What to you want to build? — тип создаваемого проекта. Нас интересует первый вариант: A static website (Static site generator using Handlebars and Frontmatters). Второй вариант создаст проект без Handlebars.
How should your Bootstrap theme be named in the Sass files? — имя нашей темы для Bootstrap. Лучше писать сюда что-то имеющее смысл, потому что именно так будет называться папка с нашей темой и некоторые файлы в проекте. Можно вписать сюда имя проекта.
With how many boilerplate code you like to get started with? — сколько шаблонных файлов нам нужно. Поначалу лучше выбирать первый пункт: Just a little – Get started with a few example files.
Do you like change the default output paths? — нужно ли изменить пути выходных файлов. Нажимаем n.
Choose a license for you project — выбор лицензии для проекта. Доступно четыре варианта:
- MIT
- Apache License, Version 2.0
- GNU GPLv3
- All rights reserved
Более подробно о выборе лицензии можно почитать на Хабре.
What’s your Name? — ваше имя.
What’s the the URL of your website? — адрес вашего личного сайта (не сайта проекта!) (опционально)
Which initial version should we put in the package.json? — начальная версия проекта.
Do you like to add additional info to package.json? — хотим ли мы указать дополнительную информацию о проекте. Ее можно указать позднее в файле package.json (опционально).
Do you like to add comment headers containing meta information to your production files? — хотим ли мы, чтобы конечные файлы содержали информацию о нашем проекте.
Do you like to add your production ready files (`dist` directory) to version control? — хотим ли мы, чтобы конечные файлы попали в репозитарий. Более подробно про игнорирование файлов можно почитать в документации к Git.
Процесс создания проекта происходит достаточно долго. В конце вы увидите сообщение об успешном завершении создания проекта:
Вот и все! Можно начинать работу. Осталось ознакомиться со структурой проекта и основными командами.
Типичные неисправности
Ошибка с apply возникает, если у вас установлен gulp старой версии. Нужно удалить gulp, установленный глобально, и установить вместо него gulp-cli. Ошибка может возникнуть, если вы ранее использовали gulp.
Ошибка с Git возникает, если у вас в системе нет валидного SSH-ключа. Если у вас получилось клонировать репозитарий через SSH, этой ошибки возникнуть не должно.