Giới thiệu

GitHub Readme Stats là một dự án GitHub rất phổ biến, cho phép người dùng lấy thông tin thống kê của tài khoản GitHub của họ một cách động. Những thông tin này bao gồm số lượng stars, tổng số commits, và các ngôn ngữ lập trình chính được sử dụng, từ đó tạo ra các thẻ động đẹp mắt. Việc thêm những thẻ này vào GitHub readme của bạn sẽ giúp trang cá nhân của bạn trở nên hấp dẫn hơn.

Cách Sử Dụng GitHub Readme Stats

Sử dụng GitHub Readme Stats rất đơn giản. Phương pháp dễ nhất là bạn chỉ cần chèn liên kết công khai của dự án vào readme của bạn và thêm một số tham số, như đã mô tả trong tài liệu chính thức. Bạn có thể xem các loại thẻ cụ thể trong DEMO chính thức.

Nguyên lý hoạt động

Khi readme của bạn được truy cập, liên kết này sẽ nhận một yêu cầu. Nó sẽ gọi API của GitHub để lấy dữ liệu cụ thể và tạo ra một hình ảnh SVG theo thời gian thực dựa trên dữ liệu đó.

Hạn chế của phương pháp này

Mặc dù rất dễ sử dụng, nhưng phương pháp này không khai thác hết tiềm năng của GitHub Readme Stats:

GitHub Readme Stats không thể đọc dữ liệu thống kê của các repo riêng tư của bạn.
Liên kết công khai sử dụng cùng một token API của GitHub để lấy dữ liệu, do đó sẽ bị giới hạn tốc độ khi khối lượng yêu cầu lớn, dẫn đến không thể hiển thị thẻ.
Theo thời gian, liên kết công khai có thể trở nên không hợp lệ, dẫn đến việc thẻ không được tải.

Thực hành tốt nhất

Do đó, thực hành tốt nhất là triển khai GitHub Readme Stats của riêng bạn và sử dụng token API của riêng bạn để tránh những vấn đề đã nêu.

Cách triển khai GitHub Readme Stats của riêng bạn

Bạn có thể sử dụng Leapcell để triển khai. Leapcell là một nền tảng hosting ứng dụng web mạnh mẽ, hỗ trợ nhiều ngôn ngữ và framework như Node.js, Python và Go. Nó cung cấp một mức quota miễn phí cao, và việc sử dụng cá nhân sẽ khó chạm đến mức phải trả tiền. Vì vậy, nó rất phù hợp cho việc triển khai GitHub Readme Stats của riêng bạn.

Các bước triển khai

Fork dự án GitHub Readme Stats. Leapcell sẽ kéo mã từ repository của bạn sau này.
Truy cập trang web Leapcell và đăng ký tài khoản. Sau khi đăng ký, nhấp vào "Create Service" trên trang.
Chọn nguồn mã trên trang tạo dịch vụ. Chọn GitHub Readme Stats mà bạn vừa fork.
Cấu hình thông tin triển khai: Leapcell sẽ tự động nhận diện đây là một dự án Node.js và điền sẵn một số thông số cơ bản. Bạn cần điều chỉnh chúng theo tình hình thực tế của dự án:

Trường Giá trị

Start Command npm install express

Build Command node express.js

Port 9000
Tạo token truy cập trong GitHub nếu bạn muốn dự án có thể truy cập repo riêng tư của bạn. Nhớ cấp quyền cho token với repo và user.
Điền token truy cập vào biến môi trường PAT_1.
Nhấp vào Submit ở dưới cùng để triển khai. Quá trình triển khai sẽ hoàn thành nhanh chóng và bạn sẽ được đưa trở lại trang chính của triển khai. Tại đây, bạn sẽ thấy Leapcell cung cấp một miền. Đây là địa chỉ GitHub Readme Stats độc quyền của bạn.

Trường	Giá trị
`Start Command`	`npm install express`
`Build Command`	`node express.js`
`Port`	9000

Cách sử dụng địa chỉ mới

Bây giờ, bạn có thể sử dụng địa chỉ mới này để tạo các thẻ thống kê. Cần lưu ý rằng đường dẫn API của phiên bản mà chúng ta triển khai là khác với liên kết công khai. Bạn cần xóa /api/ khỏi địa chỉ.

Ví dụ:

Copy

Liên kết công khai: https://github-readme-stats.vercel.app/api?username=[tên của bạn]
Tự lưu trữ: https://xxxxx.leapcell.dev/?username=[tên của bạn]

Kiểm tra bằng cách truy cập vào liên kết: https://xxxxx.leapcell.dev/?username=anuraghazra&repo=github-readme-stats và bạn sẽ thấy thẻ hiển thị thành công.

Kết luận

Chúc mừng bạn, bây giờ bạn đã có GitHub Readme Stats với tất cả các tiềm năng được khai thác! Hãy theo dõi chúng tôi trên X: @LeapcellHQ để cập nhật thêm thông tin.

Các bài viết liên quan

Câu hỏi thường gặp (FAQ)

1. Tôi có cần kiến thức lập trình để sử dụng GitHub Readme Stats không?
Có, nhưng bạn không cần phải là một lập trình viên chuyên nghiệp. Kiến thức cơ bản về Git và GitHub sẽ giúp ích rất nhiều.

2. Có cách nào để hiển thị các dữ liệu từ repo riêng tư không?
Có, bạn cần sử dụng token truy cập với quyền phù hợp để có thể truy cập dữ liệu từ các repo riêng tư.

3. Tôi có thể tùy chỉnh kiểu thẻ không?
Có, bạn có thể tùy chỉnh các tham số trong liên kết để thay đổi cách hiển thị của thẻ.

Mẹo và Lưu ý

Hãy chắc chắn rằng bạn đã cấp quyền đúng cho token API để tránh gặp phải các lỗi không cần thiết.
Thường xuyên kiểm tra và cập nhật mã nguồn của bạn để đảm bảo rằng mọi thứ hoạt động trơn tru.

Chúc bạn thành công trong việc triển khai GitHub Readme Stats của riêng bạn!

Khai Thác Tối Đa Thống Kê GitHub Readme Stats