47.1. Cho người soi kèo bóng đá truoctran

47.1.1. Yêu cầu

10316_10607--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ả soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran 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. (Nếu làm việc từ CVS, bạn vẫn sẽ cần nó.)GNU getText 0.10.36hoặc sau này hiện được khuyến nghị.

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ì theo sau, nhưng để biết thêm chi tiết, bạn nên xem ở đó.

47.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 soi kèo bóng đá truoctran được giữ trongDanh mục tin nhắn, một soi kèo bóng đá truoctran 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à soi kèo bóng đá truoctran mỗi ngôn ngữ mục tiêu. Có hai định dạng tệp soi kèo bóng đá truoctran tin nhắn Danh mục: Đầu tiên là"soi kèo bóng đá truoctran"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 soi kèo bóng đá truoctran 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. soi kèo bóng đá truoctran 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ặc12676_12681hoặ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 soi kèo bóng đá truoctran, 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.soi kèo bóng đá truoctran(Tệp PO soi kèo bóng đá truoctran PSQL) hoặcfr.mo(Tệp MO bằng tiếng Pháp).

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

# Nhận xét

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

MSGID "Bản gốc hơn"
MSGSTR "Một bản soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran. 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 soi kèo bóng đá truoctran. 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 soi kèo bóng đá truoctran.

#. 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 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 soi kèo bóng đá truoctran, 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 soi kèo bóng đá truoctran 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ề soi kèo bóng đá truoctran 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ờ:Fuzzy14709_14974C-Format, chỉ ra rằng tin nhắn làprintf-Style Mẫu định dạng. Điều này có nghĩa là bản soi kèo bóng đá truoctran 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.

47.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"15537_15677nls.mk,, sau đó chương trình này đã được chuẩn bị để soi kèo bóng đá truoctran.

Nếu đã có một số.soi kèo bóng đá truoctranTệp, sau đó ai đó đã thực hiện một số công việc soi kèo bóng đá truoctran. Các Tệp được đặt tênNgôn ngữ.soi kèo bóng đá truoctran, trong đóNgôn ngữlàISO 639-1 Mã ngôn ngữ hai chữ cái (trong chữ thường),, ví dụ.,fr.soi kèo bóng đá truoctranĐố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 soi kèo bóng đá truoctran 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.soi kèo bóng đá truoctranWHEREVùnglàISO 3166-1 Mã quốc gia hai chữ cái (ở Thượng trường hợp), ví dụ:pt_br.soi kèo bóng đá truoctransoi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran mới, thì trước tiên Chạy lệnh:

GMake init-soi kèo bóng đá truoctran

Đ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 soi kèo bóng đá truoctran 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ữ.soi kèo bóng đá truoctranvà chỉnh sửa nó. Để biết rằng ngôn ngữ mới có sẵn, Ngoài ra chỉnh sửa tệpnls.mkvà thêm Ngôn ngữ (hoặc ngôn ngữ và quốc gia) mã giống:

17668_17696

(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 thư viện thay đổi, 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-soi kèo bóng đá truoctran

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 soi kèo bóng đá truoctran 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. Tệp soi kèo bóng đá truoctran mới được lưu bằng.soi kèo bóng đá truoctranNewphần mở rộng.

47.1.4. Chỉnh sửa các tệp soi kèo bóng đá truoctran

18514_18790

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 soi kèo bóng đá truoctran (hoặc một bản soi kèo bóng đá truoctran trống) có sẵn. Nó là không vấn đề gửi bản soi kèo bóng đá truoctran 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ư là tài liệu tham khảo cho những gì có thể là bản soi kèo bóng đá truoctran đúng.

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

• Đả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 soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran Cũng cần phải được. Bản soi kèo bóng đá truoctran 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:

  20053_20098

  20115_20209chữ số$Cần theo dõi % Ngay lập tức, trước bất kỳ soi kèo bóng đá truoctran đ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 soi kèo bóng đá truoctran 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à soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran nó. Thay vào đó, bạn có thể đánh dấu Chuỗi có nhận xét trong tệp PO.

• duy trì kiểu 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 46.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 soi kèo bóng đá truoctran 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.