Đóng góp

Trang này mô tả cách yêu cầu biểu tượng, báo lỗi biểu tượng và đóng góp bản vẽ.

Yêu cầu biểu tượng

Mở một yêu cầu biểu tượng nêu rõ biểu tượng dùng để làm gì, đồ vật quen thuộc đại diện cho nó và chuyển động khi rê chuột. Các yêu cầu có đồ vật rõ ràng sẽ được vẽ trước.

Báo lỗi biểu tượng

Để báo lỗi như đường nối lộ rõ, nét bị nhòe ở kích thước nhỏ hoặc chuyển động sai, hãy mở một issue lỗi biểu tượng và đính kèm ảnh chụp màn hình.

Gửi biểu tượng

Nếu bạn đã vẽ biểu tượng bằng Skill hoặc vẽ tay mà không muốn mở pull request, hãy dùng trang gửi biểu tượng. Trang này kiểm tra tệp của bạn ngay trong trình duyệt và chuẩn bị một issue trên GitHub. Tệp chỉ nằm trong trình duyệt cho đến khi bạn đăng issue.

Xuất bản vẽ thành SVG. Với Skill, hãy chạy node scripts/export.mjs. SVG tĩnh là đủ: nếu biểu tượng được chấp nhận, chuyển động sẽ được thêm trong lúc xem xét. Nếu muốn đề xuất chuyển động riêng, hãy thêm tệp nguồn của biểu tượng.

Người bảo trì xem xét từng bài gửi bằng mắt, đối chiếu với các quy tắc thiết kế, dựa trên bản xem trước được đăng trong issue. Không thể chấp nhận logo, nhãn hiệu và những hình vẽ lại từ bộ biểu tượng khác. Biểu tượng được chấp nhận sẽ vào thư viện theo Giấy phép MIT, có ghi công của bạn.

Để Agent lập trình gửi biểu tượng, hãy dán prompt này vào đó. Agent sẽ yêu cầu bạn xác nhận các điều khoản, rồi đăng issue bằng GitHub CLI:

Submit my icon to the Kubai Icons library:
1. Export it as an SVG by running node scripts/export.mjs --only <name> in the skill folder.
2. Ask me to confirm that I made it, that it contains no logos or copied artwork, and that I agree to publish it under the MIT License. Stop if I do not confirm.
3. Run gh issue create --repo kubai087/kubai-icons --title "[Icon submission] <name>" with a body using these headings: "### Name" (kebab-case), "### What it does on hover" and "### Files" (the SVG in a code block, plus the icon's .js source if there is one).
4. Tell me the issue link.

Vẽ một biểu tượng

Biểu tượng được lưu trong icons/, mỗi biểu tượng một module ES. Hãy vẽ bằng Skill Kubai Icons hoặc vẽ tay, theo PROMPT.md và docs/authoring.md. Để kiểm tra, hãy thay my-icon bên dưới bằng tên biểu tượng của bạn:

bash
git clone https://github.com/kubai087/kubai-icons
cd kubai-icons && npm install
node tools/check.mjs --only my-icon --with folder,mail   # contact sheets in check-out/lib
npm run validate                                          # names, metadata, markup
npm run build:packages
npm test

tools/check.mjs tạo các trang xem trước, là ảnh hiển thị biểu tượng của bạn cạnh các biểu tượng có sẵn được liệt kê bằng --with. Hãy đính kèm chúng vào pull request. CI sẽ kết xuất lại các biểu tượng đã thay đổi và chạy kiểm thử, còn người bảo trì sẽ xem biểu tượng có hợp với bộ hay không.

Giấy phép

Các biểu tượng và mã gói do cộng đồng đóng góp được phát hành theo Giấy phép MIT. Các thay đổi đối với website và Skill theo điều khoản riêng, được nêu trên trang Giấy phép.

Kubai Icons miễn phí sử dụng Tài trợ dự án