Hướng dẫn cài đặt OpenCore

# Đóng góp trang hướng dẫn này

Xin lưu ý: Đây là trang cẩm nang hướng dẫn được xây dựng và duy trì bởi cộng đồng Hackintosh, hoàn toàn không phải là tài liệu chính thức từ đội ngũ Acidanthera. Làm ơn đừng làm phiền hay gửi các câu hỏi liên quan đến bộ hướng dẫn này cho các thành viên của Acidanthera. Bản dịch tiếng Việt được thực hiện bởi tác giả Bảo Khánh (opens new window)

Bạn muốn đóng góp trang hướng dẫn này? Vậy thì tuyệt vời quá, dưới đây là những cách để bạn có thể giúp sức!

Lưu ý: Đối với những bạn muốn đóng góp, mình thực sự rất trân trọng tấm lòng của các bạn nhưng tụi mình là một tổ chức phi lợi nhuận (non-profit organization). Mình lập ra trang hướng dẫn này với mục đích là hướng dẫn và chia sẻ kiến thức mới chứ không phải để kiếm tiền. Nếu bạn có tài chính dư dả một chút, mình thực sự khuyên bạn nên quyên góp số tiền đó cho một tổ chức từ thiện. Crohn's and Colitis Canada (opens new window) là một tổ chức mình gợi ý nếu bạn chưa có lựa chọn nào trong đầu.

# Đóng góp thông qua Báo cáo vấn đề (Contributing via Issues)

Đóng góp qua Issues (Báo cáo vấn đề) khá đơn giản nhưng có một số quy tắc sau:

  • Hãy giữ cho tab Issues chỉ dành riêng để báo lỗi nội dung bài viết, không phải địa điểm để hỏi đáp lỗi hackintosh cá nhân. Đừng biến nơi này thành diễn đàn thảo luận lỗi cài đặt của riêng mình nhé.
  • Nếu thấy lỗi đánh máy (typo) hay chỗ nào diễn đạt khó hiểu, vui lòng chỉ rõ nó nằm ở trang nào. Tụi mình sẽ rất biết ơn nếu không phải đi "truy tìm kho báu" để xem những lỗi này nằm ở đâu.

Bạn có thể tìm thấy trình báo cáo lỗi tại đây: Bugtracker (opens new window)

# Đóng góp thông qua PRs (Contributing via PRs)

Một vài nguyên tắc khi đóng góp qua PRs (Pull Requests - Yêu cầu thay đổi mã nguồn):

  • Suy nghĩ cho kỹ trước khi muốn làm một điều gì đó (làm ơn đi mà).
  • Đọc kỹ lại (Proofread) những gì bạn gửi.
  • Tụi mình có quyền từ chối nếu thấy nội dung không phù hợp hoặc có thông tin không chính xác. Đương nhiên là tụi mình sẽ cho bạn biết lý do tại sao nội dung của bạn bị từ chối hoặc yêu cầu bạn sửa đổi.
    • Mình cũng đánh giá cao việc đính kèm nguồn (sources) cho bất kỳ thay đổi lớn (commits) nào để dễ dàng xác minh thông tin bạn cung cấp là hợp lệ.
  • Hình ảnh phải được lưu trữ trực tiếp trong kho lưu trữ (repo) dưới thư mục ../images/
  • PR của bạn phải được vượt qua trình kiểm tra định dạng (markdown lint) và phải sửa hết tất cả các lỗi.
  • Nói chung là, cố gắng tránh sử dụng các công cụ "không phải của Acidanthera" (non-Acidanthera tools) nếu có thể. Thông thường, mình luôn muốn tránh sử dụng các công cụ của bên thứ ba - tuy nhiên, nếu không còn cách nào khác, bạn có thể đính kèm liên kết.
    • Tuy nhiên các công cụ bị cấm (banned) hoàn toàn bao gồm:
      • UniBeast, MultiBeast và KextBeast
      • TransMac
        • Nổi tiếng là chuyên gia tạo ra các bộ cài USB phế vật (borked), lỗi tùm lum.
      • Các bộ cài từ Niresh
        • Chúng mình muốn tránh các vấn đề vi phạm bản quyền (piracy) trong các bản hướng dẫn của mình.

# Cách thức đóng góp

Cách tốt nhất để kiểm tra các thay đổi (commits) của bạn và đảm bảo chúng được định dạng chính xác là tải Node.js, sau đó chạy lệnh npm install để cài đặt các gói phụ thuộc (dependencies). Khi bạn chạy npm run dev, nó sẽ thiết lập một máy chủ web cục bộ (local webserver) mà bạn có thể kết nối để xem những thay đổi mình đã thực hiện. Lệnh npm test sẽ liệt kê bất kỳ lỗi nào về định dạng và kiểm tra chính tả (spellchecking). Nếu bạn muốn markdownlint tự động cố gắng sửa lỗi định dạng, hãy chạy lệnh npm run fix-lint.

Các bước thực hiện rất đơn giản như sau:

  • Tạo ra bản sao mới từ kho lưu trữ (Fork this repo) (opens new window)
  • Cài đặt các công cụ cần thiết:
  • Chỉnh sửa những cái bạn muốn.
  • Xây dựng trang web:
    • npm install (Để cài đặt tất cả các plugin cần thiết)
    • npm run dev (Chạy thử trang web)
      • Bạn có thể chạy thử tại địa chỉ http://localhost:8080
  • Kiểm tra định dạng (linting) và chính tả (spellcheck):
    • npm test
    • npm run lint và npm run spellcheck (để chạy các bài kiểm tra riêng lẻ)
    • npm run fix-lint (Để sửa các lỗi tiềm ẩn)
    • Đối với các từ ngữ không được hỗ trợ bởi trình kiểm tra chính tả mặc định, vui lòng thêm chúng vào file dictionary.txt và chạy lệnh npm run sort-dict.

# Mẹo (Tips)

Một số công cụ giúp việc đóng góp trở nên dễ dàng hơn:

# Đóng góp thông qua bản dịch (Contributing via Translations)

Mặc dù các hướng dẫn của Dortania chủ yếu dựa trên tiếng Anh, tụi mình biết rằng có rất nhiều ngôn ngữ khác trên thế giới và không phải ai cũng thông thạo tiếng Anh. Nếu bạn muốn giúp dịch các bản hướng dẫn của tụi mình sang các ngôn ngữ khác, tụi mình rất sẵn lòng hỗ trợ bạn.

Những điều chính cần lưu ý:

  • Bản dịch phải là một bản Fork (bản sao) riêng biệt và sẽ không được gộp (merged) vào bản hướng dẫn chính của Dortania
  • Các bản Fork phải chỉ rõ rằng chúng là bản dịch của Dortania và không phải là bản chính thức (official)
  • Các bản Fork cũng phải tuân thủ Giấy phép của tụi mình.

Nếu các điều kiện trên được đáp ứng, ạn có thể tự do lưu trữ (host) bản dịch của mình mà không gặp vấn đề gì! Các trang web của Dortania được xây dựng bằng VuePress (opens new window) sử dụng GitHub Actions (opens new window) và cuối cùng được lưu trữ trên GitHub Pages (opens new window), vì vậy bạn sẽ không mất chi phí để tự lưu trữ bản dịch của mình.

Nếu bạn có bất kỳ câu hỏi hoặc lo ngại nào về việc dịch hoặc lưu trữ, vui lòng liên hệ Bugtracker (opens new window) của chúng mình.

Các bản dịch hiện đã được biết:

Và lưu ý rằng các bản dịch này phụ thuộc vào sở thích của tác giả, các thay đổi trong bản dịch và cả những sai sót của con người. Vui lòng ghi nhớ điều này khi đọc vì chúng không còn là các bản hướng dẫn chính thức từ Dortania nữa.

⟵ Lời cảm ơn ⟶