50.1. Cho người kèo bóng đá pháp

50.1.1. Yêu cầu

10183_10458--Enable-NLSTùy chọn. Cái này cũng sẽ kiểm traLibintlThư viện vàMSGFMTChương trình, tất cả kèo bóng đá pháp dùng cuối sẽ cần. Để thử công việc của bạn, hãy làm theo Các phần áp dụng của các hướng dẫn cài đặt.

10761_10893xgettextvàMsgmerge, tương ứng, trong tương thích GNU thực hiện. Sau đó, chúng tôi sẽ cố gắng sắp xếp nó để nếu bạn sử dụng phân phối nguồn được đóng gói, bạn sẽ không cầnXgetText. (Nếu làm việc từ Git, bạn vẫn sẽ cần Nó.)GNU getText 0.10.36hoặc muộn hơn hiện đang được đề xuất.

Việc triển khai getText địa phương của bạn sẽ đi kèm với riêng của nó tài liệu. Một số trong đó có lẽ được nhân đôi trong những gì tiếp theo, Nhưng để biết thêm chi tiết, bạn nên xem ở đó.

50.1.2. Các khái niệm

Các cặp tin nhắn gốc (tiếng Anh) và (có thể) của chúng (có thể) Tương đương kèo bóng đá pháp được giữ trongTin nhắn Danh mục, một kèo bóng đá pháp mỗi chương trình (mặc dù các chương trình liên quan có thể Chia sẻ một danh mục tin nhắn) và kèo bóng đá pháp mỗi ngôn ngữ đích. Có Hai định dạng tệp kèo bóng đá pháp danh mục tin nhắn: Đầu tiên là"kèo bóng đá pháp"Tệp (kèo bóng đá pháp đối tượng di động), trong đó là một tệp văn bản đơn giản với cú pháp đặc biệt mà Translators chỉnh sửa. Các Thứ hai là"Mo"Tệp (cho máy Đối tượng), một tệp nhị phân được tạo từ PO tương ứng Tệp và được sử dụng trong khi chương trình quốc tế hóa được chạy. Người kèo bóng đá pháp không đối phó với các tệp MO; thực tế hầu như không có ai làm.

Phần mở rộng của tệp danh mục tin nhắn không có gì đáng ngạc nhiên hoặc.kèo bóng đá pháphoặc.mo. Tên cơ sở là tên của chương trình nó đi kèm hoặc ngôn ngữ mà tệp dành kèo bóng đá pháp về tình hình. Điều này là một chút khó hiểu. Ví dụ làpsql.kèo bóng đá pháp(Tệp PO kèo bóng đá pháp PSQL) hoặcfr.mo(Tệp MO bằng tiếng Pháp).

Định dạng tệp của các tệp kèo bóng đá pháp được minh họa ở đây:

# Nhận xét

MSGID "Chuỗi gốc"
MSGSTR "Chuỗi kèo bóng đá pháp"

MSGID "Bản gốc hơn"
MSGSTR "Một bản kèo bóng đá pháp khác"
"Chuỗi có thể bị phá vỡ như thế này"

...

12957_13313

Nhân vật # giới thiệu một bình luận. Nếu khoảng trắng ngay lập tức theo sau ký tự #, thì đây là một nhận xét được duy trì bởi kèo bóng đá pháp. Cũng có thể có những nhận xét tự động, có ký tự không phải màu trắng ngay lập tức theo #. Đây là được duy trì bởi các công cụ khác nhau hoạt động trên các tệp PO và được dự định hỗ trợ người kèo bóng đá pháp.

#. Nhận xét tự động
#: FileName.c: 1023
#, cờ, cờ

#. Nhận xét kiểu được trích xuất từ ​​tệp nguồn trong đó Thông điệp được sử dụng. Có thể lập trình viên đã chèn Thông tin cho người kèo bóng đá pháp, chẳng hạn như về căn chỉnh dự kiến. #: Nhận xét cho biết vị trí chính xác nơi tin nhắn được sử dụng trong nguồn. Người kèo bóng đá pháp không cần phải xem chương trình nguồn, nhưng anh ta có thể nếu có nghi ngờ về bản kèo bóng đá pháp chính xác. #, Bình luận chứa các cờ mô tả thông điệp trong một số đường. Hiện tại có hai lá cờ:Fuzzyđược đặt nếu tin nhắn có thể đã lỗi thời vì những thay đổi Trong nguồn chương trình. Người kèo bóng đá pháp sau đó có thể xác minh điều này và Có thể loại bỏ cờ mờ. Lưu ý rằng các tin nhắn mờ không có sẵn cho người dùng cuối. Cờ khác làC-Format, chỉ ra rằng tin nhắn làprintf-Style Mẫu định dạng. Cái này có nghĩa là bản kèo bóng đá pháp cũng phải là một chuỗi định dạng với Cùng một số và loại giữ chỗ. Có những công cụ có thể Xác minh điều này, khóa nào khỏi cờ định dạng c.

50.1.3. Tạo và duy trì danh mục tin nhắn

OK, vậy làm thế nào để tạo một"trống"Danh mục tin nhắn? Đầu tiên, đi vào thư mục có chứa chương trình có thông điệp bạn muốn kèo bóng đá pháp. Nếu có một tệpnls.mk, thì chương trình này đã được chuẩn bị cho kèo bóng đá pháp.

Nếu đã có một số.kèo bóng đá phápTệp, Sau đó, ai đó đã thực hiện một số công việc kèo bóng đá pháp thuật. Các tập tin là Được đặt tênNgôn ngữ.kèo bóng đá pháp, trong đóNgôn ngữlàISO 639-1 Mã ngôn ngữ hai chữ cái (ở mức thấp hơn trường hợp), ví dụ:fr.kèo bóng đá pháp15726_15850Ngôn ngữ_Vùng.kèo bóng đá phápWHEREVùnglàISO 3166-1 Mã quốc gia hai chữ cái (trong trường hợp trên),, ví dụ.,pt_br.kèo bóng đá phápĐối với Bồ Đào Nha ở Brazil. Nếu bạn tìm thấy ngôn ngữ bạn muốn, bạn có thể bắt đầu làm việc Tệp đó.

Nếu bạn cần bắt đầu một nỗ lực kèo bóng đá pháp mới, thì trước tiên hãy chạy Lệnh:

gmake init-kèo bóng đá pháp

Điều này sẽ tạo một tệpTiên lượng.pot. (.potĐể phân biệt nó với các tệp kèo bóng đá pháp là"Trong sản xuất". TheT"Mẫu".) Sao chép tệp này thànhNgôn ngữ.kèo bóng đá phápvà chỉnh sửa nó. Để làm kèo bóng đá pháp nó được biết rằng ngôn ngữ mới có sẵn, cũng chỉnh sửa tệpnls.mkvà thêm ngôn ngữ (hoặc ngôn ngữ và quốc gia) mã theo dòng trông giống như:

17048_17074

(tất nhiên là các ngôn ngữ khác có thể xuất hiện.)

Là chương trình cơ bản hoặc thay đổi thư viện, các tin nhắn có thể đã thay đổi hoặc thêm bởi các lập trình viên. Trong trường hợp này bạn không cần Để bắt đầu từ đầu. Thay vào đó, hãy chạy lệnh:

GMake Update-kèo bóng đá pháp

sẽ tạo tệp danh mục tin nhắn trống mới (tệp chậu Bạn đã bắt đầu với) và sẽ hợp nhất nó với các tệp kèo bóng đá pháp hiện có. Nếu như Thuật toán hợp nhất không chắc chắn về một thông báo cụ thể mà nó đánh dấu Nó"Fuzzy"Như đã giải thích ở trên. Mới Tệp kèo bóng đá pháp được lưu bằng.kèo bóng đá phápNewMở rộng.

50.1.4. Chỉnh sửa các tệp kèo bóng đá pháp

Các tệp PO có thể được chỉnh sửa với trình chỉnh sửa văn bản thông thường. Các người kèo bóng đá pháp chỉ nên thay đổi khu vực giữa các trích dẫn sau Chỉ thị MSGSTR, thêm nhận xét và thay đổi cờ mờ. Có (không có gì đáng ngạc nhiên) một chế độ PO cho Emacs, mà tôi thấy khá hữu ích.

Các tệp PO không cần được điền hoàn toàn. Phần mềm sẽ Tự động quay trở lại chuỗi gốc nếu không có bản kèo bóng đá pháp (hoặc một bản kèo bóng đá pháp trống) có sẵn. Không có vấn đề gì để gửi Các bản kèo bóng đá pháp không đầy đủ cho các vùi trong cây nguồn; cái đó Dành chỗ cho người khác để chọn công việc của bạn. Tuy nhiên, bạn là được khuyến khích ưu tiên để loại bỏ các mục mờ sau khi thực hiện Hợp nhất. Hãy nhớ rằng các mục mờ sẽ không được cài đặt; Họ chỉ phục vụ làm tài liệu tham khảo cho những gì có thể là bản kèo bóng đá pháp đúng.

Đây là một số điều cần ghi nhớ trong khi chỉnh sửa Bản kèo bóng đá pháp:

• Đảm bảo rằng nếu bản gốc kết thúc bằng một dòng mới, Bản kèo bóng đá pháp cũng vậy. Tương tự cho các tab, v.v.

• Nếu bản gốc làprintfĐịnh dạng Chuỗi, bản kèo bóng đá pháp cũng cần phải được. Bản kèo bóng đá pháp cũng Cần phải có các định dạng định dạng tương tự theo cùng một thứ tự. Đôi khi các quy tắc tự nhiên của ngôn ngữ làm cho điều này không thể hoặc Ít nhất là khó xử. Trong trường hợp đó, bạn có thể sửa đổi các nhà xác định định dạng Như thế này:

  Msgstr "Die Datei %2 $ s Hat %1 $ u Zeichen."

  Sau đó, kèo bóng đá pháp giữ chỗ đầu tiên sẽ thực sự sử dụng đối số thứ hai từ danh sách. Thechữ số$Cần theo dõi % Ngay lập tức, trước bất kỳ kèo bóng đá pháp điều khiển định dạng khác. (Tính năng này thực sự tồn tại trongprintfGia đình của chức năng. Bạn có thể chưa nghe về nó trước đây vì có ít sử dụng kèo bóng đá pháp nó ngoài quốc tế hóa thông điệp.)

• Nếu chuỗi gốc chứa một lỗi ngôn ngữ, báo cáo điều đó (hoặc tự sửa nó trong nguồn chương trình) và kèo bóng đá pháp thông thường. Chuỗi đã sửa có thể được hợp nhất khi chương trình Nguồn đã được cập nhật. Nếu chuỗi ban đầu chứa một Sai lầm thực tế, báo cáo rằng (hoặc tự sửa nó) và không kèo bóng đá pháp nó. Thay vào đó, bạn có thể đánh dấu chuỗi bằng một nhận xét trong Tệp PO.

• Duy trì phong cách và giai điệu của chuỗi gốc. Cụ thể, các tin nhắn không phải là câu (Không thể mở tệp %s) Có lẽ không nên bắt đầu với một chữ cái viết hoa (nếu ngôn ngữ của bạn phân biệt trường hợp thư) hoặc kết thúc bằng một khoảng thời gian (nếu ngôn ngữ của bạn sử dụng dấu chấm câu). Nó có thể giúp đọcPhần 49.3.

• Nếu bạn không biết tin nhắn có nghĩa là gì, hoặc nếu nó mơ hồ, Hỏi trên danh sách gửi thư của nhà phát triển. Rất có thể là tiếng Anh kèo bóng đá pháp dùng cuối nói cũng có thể không hiểu nó hoặc tìm thấy nó mơ hồ, vì vậy tốt nhất là cải thiện thông điệp.