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

46.1.1. Yêu cầu

Chúng tôi sẽ không đánh giá các kỹ năng ngôn ngữ của bạn - Phần này là về Công cụ phần mềm. Về mặt lý thuyết, bạn chỉ cần một trình soạn thảo văn bản. Nhưng Đây chỉ là trong trường hợp không thể mà bạn không muốn thử ra các tin nhắn được kèo bóng đá pháp của bạn. Khi bạn định cấu hình nguồn của mình cây, hãy chắc chắn sử dụng--Enable-NLSTùy chọn. Điều này cũng sẽ kiểm tralibintlThư viện vàMSGFMTChương trình, mà tất cả kèo bóng đá pháp dùng cuối sẽ cần Dẫu sao thì. Để thử công việc của bạn, hãy làm theo các phần áp dụng của hướng dẫn cài đặt.

Nếu bạn muốn bắt đầu một nỗ lực kèo bóng đá pháp thuật mới hoặc muốn làm Một danh mục tin nhắn hợp nhất (được mô tả sau), bạn sẽ cần Chương trìnhXgetTextvàMSGMERGE, tương ứng, trong tương thích GNU thực hiện. Sau này, 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 đóng gói, bạn sẽ không cầnXgetText. (Từ CVS, bạn vẫn sẽ cần nó.)GNU getText 0.10.36hoặc muộn hơn hiện đang được đề xuất.

11497_11683

46.1.2. Các khái niệm

các cặp tin nhắn gốc (tiếng Anh) và chúng (có thể) Các tương đương được kèo bóng đá pháp được giữ trongDanh mục tin nhắn, 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ữ mục tiêu. Có hai định dạng tệp kèo bóng đá pháp tin nhắn Danh mục: Đầu tiên là"kèo bóng đá pháp"Tệp (đối với đối tượng di động), đây là một tệp văn bản đơn giản với đặc biệt Cú pháp mà người kèo bóng đá pháp chỉnh sửa. Thứ hai là"Mo"Tệp (cho đối tượng máy), đó là một Tệp nhị phân được tạo từ tệp PO tương ứng và được sử dụng Trong khi chương trình quốc tế hóa được chạy. kèo bóng đá pháp giả không đối phó với các tập tin MO; trong thực tế hầu như không 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, tùy thuộc vào tình huống. Đ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.mo12979_13002

Đị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"

...

MSGID được trích xuất từ ​​nguồn chương trình. (Họ không cần phải, nhưng đây là cách phổ biến nhất.) Các dòng MSGSTR ban đầu trống rỗng và được điền vào các chuỗi hữu ích bởi người kèo bóng đá pháp. Các chuỗi có thể chứa lối thoát theo kiểu C ký tự và có thể được tiếp tục trên các dòng như minh họa. (Dòng tiếp theo phải bắt đầu ở đầu dòng.)

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 dõi ký tự #, thì đây là một bình luận duy trì bởi người kèo bóng đá pháp. Cũng có thể có tự động Nhận xét, có một ký tự không phải trắng ngay lập tức theo số #. Chúng đượ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.

14077_14136

#. Nhận xét kiểu được trích xuất từ ​​tệp nguồn nơi tin nhắn đượ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ề dự kiến liên kết. #: Bình luận cho biết vị trí chính xác Thông điệp được sử dụng trong nguồn. Người kèo bóng đá pháp không cần phải nhìn tại nguồn chương trình, nhưng anh ấy có thể nếu có nghi ngờ về kèo bóng đá pháp chính xác. #, Bình luận chứa cờ Mô tả thông điệp theo một cách nào đó. Hiện tại có hai cờ:Fuzzyđược đặt nếu tin nhắn có có thể đã lỗi thời vì những thay đổi trong chương trình nguồn. Người kèo bóng đá pháp sau đó có thể xác minh điều này và có thể xóa Cờ mờ. Lưu ý rằng các tin nhắn mờ không được cung cấp cho người dùng cuối. Cờ khác làC-Format, chỉ ra rằng thông báo làprintf-Style Mẫu định dạng. Điều 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ó các công cụ có thể xác minh điều này, khóa nào khỏi cờ định dạng c.

46.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 chứa chương trình có tin nhắn bạn muốn kèo bóng đá pháp. Nếu có một tệpnls.mk,, sau đó chương trình này đã được chuẩn bị để 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. Các Tệp đượ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 (trong trường hợp thường), ví dụ.,fr.kèo bóng đá phápĐối với tiếng Pháp. Nếu có Thực sự cần phải có nhiều hơn một nỗ lực kèo bóng đá pháp thuật cho mỗi ngôn ngữ sau đó các tệp cũng có thể được đặt tênNgôn ngữ_Vùng.kèo bóng đá phápWHEREVùnglàISO 3166-1 Mã quốc gia hai chữ cái (ở Thượng trường hợp), ví dụ:pt_br.kèo bóng đá phápkèo bóng đá pháp Bồ Đào Nha ở Brazil. Nếu bạn tìm thấy ngôn ngữ bạn muốn bạn chỉ có thể bắt đầu hoạt động trên 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 Chạy lệnh

16977_16994

Đ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". TheTlà viết tắt của"Mẫu".) Sao chép tệp này thànhNgôn ngữ.kèo bóng đá pháp17418_17514nls.mkvà thêm Ngôn ngữ (hoặc ngôn ngữ và quốc gia) mã giống:

17670_17698

(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, tin nhắn có thể được 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 (nồi Tệp bạn đã bắt đầu với) và sẽ hợp nhất nó với kèo bóng đá pháp hiện có Tệp. Nếu thuật toán hợp nhất không chắc chắn về một cụ thể thông báo nó đánh dấu nó"Fuzzy"như giải thích ở trên. kèo bóng đá pháp trường hợp một cái gì đó đã thực sự sai, tệp PO cũ được lưu bằng.kèo bóng đá phápoldMở rộng.

46.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, có thể thêm nhận xét và thay đổi mờ lá cờ. Có (không có gì đáng ngạc nhiên) một chế độ PO cho Emacs, mà tôi tìm 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 ban đầu nếu không kèo bóng đá pháp (hoặc một bản kèo bóng đá pháp trống) có sẵn. Nó là không vấn đề gửi bản kèo bóng đá pháp không đầy đủ cho các vùi trong cây nguồn; tạo chỗ cho người khác nhặt công việc. Tuy nhiên, bạn được khuyến khích ưu tiên loại bỏ Mục nhập 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ụ như tham khảo 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àprintfChuỗi định dạng, 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ùng một định dạng xác định 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ại ít khó xử nhất. Trong trường hợp đó, bạn có thể sửa đổi định dạng Các trình xác định 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 lần thứ hai Đối số 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. (Cái này tính năng thực sự tồn tại trongprintfGia đình chức năng. Bạn có thể không đã nghe nói 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 rằng (hoặc tự sửa nó trong nguồn chương trình) và kèo bóng đá pháp bình thường. Chuỗi đã sửa có thể được hợp nhất trong Khi các nguồn chương trình đã được cập nhật. Nếu bản gốc Chuỗi chứa một lỗi thực tế, báo cáo rằng (hoặc sửa nó chính bạn) và không kèo bóng đá pháp nó. Thay vào đó, bạn có thể đánh dấu Chuỗi có nhận xét trong tệp PO.

• Duy trì phong cách và giai điệu của chuỗi ban đầu. 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 chữ cái) 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 45.3.

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