{"id":23041229,"url":"https://github.com/mvandrew/bx-gulp-scripts","last_synced_at":"2025-04-03T00:40:34.105Z","repository":{"id":98730223,"uuid":"143758698","full_name":"mvandrew/bx-gulp-scripts","owner":"mvandrew","description":"Gulp скрипты для сборки шаблонов 1С-Битрикс","archived":false,"fork":false,"pushed_at":"2018-11-21T18:19:58.000Z","size":11,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-08T14:45:10.761Z","etag":null,"topics":["bitrix","bitrix-cms","gulp","gulp-tasks","javascript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mvandrew.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-06T17:05:31.000Z","updated_at":"2022-08-07T13:10:55.000Z","dependencies_parsed_at":"2023-05-31T13:16:29.708Z","dependency_job_id":null,"html_url":"https://github.com/mvandrew/bx-gulp-scripts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvandrew%2Fbx-gulp-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvandrew%2Fbx-gulp-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvandrew%2Fbx-gulp-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvandrew%2Fbx-gulp-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mvandrew","download_url":"https://codeload.github.com/mvandrew/bx-gulp-scripts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246916739,"owners_count":20854511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitrix","bitrix-cms","gulp","gulp-tasks","javascript"],"created_at":"2024-12-15T19:31:10.190Z","updated_at":"2025-04-03T00:40:34.055Z","avatar_url":"https://github.com/mvandrew.png","language":"JavaScript","readme":"# Gulp скрипты для сборки шаблонов 1С-Битрикс\n\n## Установка\nУстановка зависит от того, как используется Git в проекте Битрикс\n\n### Используется корневой репозиторий на весь проект\nСкрипты добавляются, как модуль к основному репозиторию:\n\n    git submodule add https://github.com/mvandrew/bx-gulp-scripts.git src/scripts\n\n### Git не успользуется в проекте\nСкрипты могут быть установлены путём клонирования репозитория в каталог (каталог проекта)/src/scripts:\n\n    git clone https://github.com/mvandrew/bx-gulp-scripts.git src/scripts\n    \nИли просто скопированы файлы скриптов в каталог (каталог проекта)/src/scripts.\n\n## Конфигурационный файл\nПример файла конфигурации config.default.js нужно переименовать в index.js и разместить в каталоге (каталог проекта)/src/config/.\n\nТаким образом, полный путь будет выглядеть:\n\n    (каталог проекта)/src/config/index.js\n    \nВ конфигурационном файле следует задать значение константы ```templateName```. В качестве значения указать идентификатор вашей темы оформления.\n\nЕсли расположение файлов отличается от предлагаемого, то следует изменить значения констант путей расположения ресурсных файлов и файлов с результатами сборки.\n\n## Рекомендации по расположению файлов\n### Ресурсные файлы темы\nВсе исходники ресурсов темы рекомендуется распологать в каталоге:\n\n    src/assets/templates/(Имя Темы)\n    \nЭтот каталог своей структурой преимущественно повторяет структуру каталога с темой оформления. В нём размещаются файлы:\n\nПодкаталог  | Назначение\n----------- | -----------\ncomponents  | Оформление компонент. Структура каталога полностью повторяет структуру соответствующего каталога темы оформления. В каталоге содержаться файлы: **js** (JavaScript в формате ECMAScript 6), **scss** (Стили компонент) и изображения (Пропускаются через компрессор Gulp).\nimages      | Изображения, которые будут помещены в результирующий каталог темы после компрессора.\nsprites     | Каталог для исходных наборов, из которых будут формироваться спрайты.\njs          | JavaScript файлы в нотации ECMAScript 6.\nscss        | Общие для темы оформления **SCSS** файлы.\n\n### Каталог оформления темы\nКаталог темы оформления сайта рекомендуется размещать по пути:\n\n    local/templates/(Имя Темы)\n    \nНесмотря на то, что рекомендуется все модификации помещать в каталог ```local```, можно встретить сайты, где модифицированная тема находится в каталоге ```bitrix/templates/(Имя Темы)```. Компиляцию ресурсных файлов можно настроить и на этот каталог, путём изменения путей в константах конфигурационного файла: ```src/config/index.js```.\n\n## Зависимости Node.js\nДля нормальной работы всех функций **Gulp** предусмотренных пакетом в файл ```package.json``` следует добавить секцию зависимостей:\n\n    \"devDependencies\": {\n        \"@babel/core\": \"^7.1.2\",\n        \"@babel/preset-env\": \"^7.1.0\",\n        \"browser-sync\": \"^2.24.7\",\n        \"del\": \"^3.0.0\",\n        \"fs\": \"0.0.1-security\",\n        \"gulp\": \"^3.9.1\",\n        \"gulp-autoprefixer\": \"^6.0.0\",\n        \"gulp-babel\": \"^8.0.0\",\n        \"gulp-cache\": \"^1.0.2\",\n        \"gulp-concat\": \"^2.6.1\",\n        \"gulp-cssnano\": \"^2.1.3\",\n        \"gulp-group-css-media-queries\": \"^1.2.2\",\n        \"gulp-if\": \"^2.0.2\",\n        \"gulp-image-resize\": \"^0.13.0\",\n        \"gulp-imagemin\": \"^4.1.0\",\n        \"gulp-notify\": \"^3.2.0\",\n        \"gulp-plumber\": \"^1.2.0\",\n        \"gulp-rename\": \"^1.4.0\",\n        \"gulp-sass\": \"^4.0.1\",\n        \"gulp-sourcemaps\": \"^2.6.4\",\n        \"gulp-string-replace\": \"^1.1.1\",\n        \"gulp-strip-comments\": \"^2.5.2\",\n        \"gulp-strip-css-comments\": \"^2.0.0\",\n        \"gulp-uglify\": \"^3.0.1\",\n        \"gulp-zip\": \"^4.2.0\",\n        \"gulp.spritesmith\": \"^6.9.0\",\n        \"imagemin-pngquant\": \"^6.0.0\",\n        \"jquery\": \"^3.3.1\",\n        \"jquery-match-height\": \"^0.7.2\",\n        \"merge-stream\": \"^1.0.1\",\n        \"path\": \"^0.12.7\",\n        \"vinyl-buffer\": \"^1.0.1\"\n      } \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvandrew%2Fbx-gulp-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvandrew%2Fbx-gulp-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvandrew%2Fbx-gulp-scripts/lists"}