Đây là dự án [Ezygrapes](https://github.com/youngmonkeys/ezygrapes) Mở terminal (Command Prompt, PowerShell, hoặc Terminal trên Linux/Mac). Dưới đây là hướng dẫn cho Windowns PowerShell. ## 1. Chuẩn bị môi trường - `nvm install 16`: Cài đặt Node.js phiên bản 16 bằng nvm (Node Version Manager) để đảm bảo dự án sử dụng đúng phiên bản Node.js cần thiết. - `nvm use 16`: Chuyển sang sử dụng Node.js phiên bản 16 cho terminal hiện tại. - `npm install -g yarn`: Cài đặt Yarn toàn cục (globally) để quản lý các gói phụ thuộc thay vì sử dụng npm mặc định. ![4.png](/api/v1/media/0675e3c75657418410a1b06b80a250f5e83ae529a7cab38243b254a0ffa409ca.png) ## 2. Clone kho lưu trữ - `git clone git@github.com:youngmonkeys/ezygrapes.git`: Sao chép kho lưu trữ ezygrapes từ GitHub về máy tính cục bộ thông qua giao thức SSH. - `cd ezygrapes`: Di chuyển vào thư mục vừa được sao chép để làm việc với dự án. ## 3. Xây dựng Ezygrapes - `yarn`: Cài đặt tất cả các phụ thuộc của dự án được liệt kê trong tệp `package.json`. ![5.png](/api/v1/media/87936bb0f890bf464ebc1e5c218a0ec44e8929a39928d964749c7fc8c9515a6f.png) - `yarn add --dev grapesjs-cli`: Cài đặt công cụ dòng lệnh grapesjs-cli dưới dạng phụ thuộc phát triển (--dev). ![6.png](/api/v1/media/a67dbd6df8177e5cb41b4827c3074bc611557377fe50ce86f828118f45ef09ec.png) - `$env:BUILD_MODULE="true"; yarn grapesjs-cli build --dts="skip" --patch=0 --targets="> 1%, ie 11, safari 8, not dead"` -- `$env:BUILD_MODULE="true"`: Thiết lập biến môi trường BUILD_MODULE là true (cú pháp này dành cho PowerShell trên Windows). -- `yarn grapesjs-cli build`: Chạy lệnh xây dựng dự án bằng grapesjs-cli. -- `--dts="skip"`: Bỏ qua việc tạo tệp khai báo TypeScript (.d.ts). -- `--patch=0`: Không áp dụng bản vá (patch) tự động. -- `--targets="> 1%, ie 11, safari 8, not dead"`: Xác định các trình duyệt mục tiêu để tối ưu hóa mã, bao gồm: các trình duyệt chiếm hơn 1% thị phần, IE 11, Safari 8, và các trình duyệt chưa bị "chết" (not dead). ![7.png](/api/v1/media/73f496f29c41735e7e9e003877cf1fe75325332ffb036bc90814bc323517ea04.png) ## 4. Xây dựng plugin - `cd plugins/preset-webpage`: Di chuyển vào thư mục chứa plugin preset-webpage. - `yarn`: Cài đặt các phụ thuộc của plugin được liệt kê trong tệp package.json của thư mục này. ![8.png](/api/v1/media/a373c9daed16e6b9511dbf81294c83edb01d8350a2adf02d1bb2c7296b4303e8.png) - `yarn add node-sass --dev`: Cài đặt node-sass (một thư viện để biên dịch SCSS thành CSS) dưới dạng phụ thuộc phát triển. ![9.png](/api/v1/media/bc7dc33159d21d5989686928e3543dc7140ca1ecd5f9aa03760f627440a1a267.png) - `yarn build`: Biên dịch và xây dựng plugin preset-webpage. ![10.png](/api/v1/media/f35d4274f72d0a3a90efd53f10c32b5390d3321333490c411297934e252b064f.png) ## 5. Khởi động server - `yarn start`:Khởi động máy chủ phát triển (development server) để chạy dự án. Thông thường, lệnh này sẽ mở một giao diện web (thường tại localhost:8080 hoặc cổng khác tùy cấu hình) để bạn có thể xem và chỉnh sửa dự án trong trình duyệt. ![11.png](/api/v1/media/790d0263c2622c0243341045bffc21035538d3edb9ed8a5596c581552c89b907.png) - Mở trình duyệt và truy cập địa chỉ được hiển thị trong terminal (http://localhost:8080). ![12.png](/api/v1/media/bb4b8780a8e0265d717d35031f15836b3d25692ff8b6d5cb127835d98b4fd7b4.png) - Bạn có thể nhấn tổ hợp nút "CTRL C" để dừng tiến trình đang chạy. ## 6. Tóm lại Trên đây là cách để bạn có thể chạy dự án Ezygrapes cùng với plugin preset-webpage. Hy vọng với những chia sẻ trên đây giúp bạn nắm được đặc điểm và ứng dụng.