AVIM cho Firefox
Phiên bản 20080728.210 (thứ ba, ngày 26 tháng 8 năm 2008) do Nguyễn Xuân Minh
AVIM là một phần mở rộng cung cấp bộ gõ tiếng Việt trong Firefox, dựa trên script cùng tên của Đặng Trần Hiếu. Hiếu là người đầu tiên phát triển phần mở rộng này.Các tính năng
Phần mở rộng AVIM cho phép bạn đánh máy trong tiếng Việt một cách hiện đại do một trong những bộ gõ tiếng Việt đầy đủ nhất:
- AVIM hỗ trợ bốn kiểu gõ chuẩn (Telex, VNI, và hai kiểu VIQR), cũng như kiểu gõ “Tự động” mặc định, tức là tổng hợp Telex và VNI.
- Không giống các bảng gõ thường, AVIM để bạn nhập dấu phụ bất cứ chỗ nào sau chữ gốc của nó, và có thể nhập các dấu phụ theo thứ tự nào. AVIM tự động chỉnh lại văn bản để tuân theo các quy tắc chính tả tiếng Việt. Chẳng hạn khi sử dụng kiểu gõ VIQR, ddu+o+`ng, dduo+`ng, dduo+ng`, ddu+`ong+, duon`g+d, và ngay cả dduong+'?~.` đều cho ra đường.
- AVIM không kiểm tra chính tả đầy đủ – cần phần mở rộng Từ điển tiếng Việt – nhưng tính năng kiểm tra theo quy tắc chính tả vẫn giúp bạn tránh lỗi khi viết. Khi nào AVIM gặp một từ không theo quy tắc chính tả, nó xử lý các phím sau theo ý nghĩa đầu tiên, nên thay vì thêm dấu vào từ thì phím sẽ cho ra ký tự thường của nó. Cách này có ích khi cần pha trộn những từ ngoại ngữ vào văn bản tiếng Việt.
- AVIM hiểu cả hai kiểu bỏ dấu – kiểu cũ (thí dụ “xóa”) và kiểu mới (“xoá”) – và tự động chỉnh lại văn bản theo một kiểu, tùy lựa chọn của bạn.
- Ít khi gặp lỗi trong tính năng tự động bỏ dấu, tại vì AVIM đã được sử dụng rộng rãi trong nhiều trường hợp. Nó được thử dùng ngay cả toàn bộ danh sách từ của dự án từ điển Free Vietnamese Dictionary Project. Phiên bản script được phát triển từ khoảng năm 2005, Phần mở rộng này rất vững vì phiên bản script được phát triển từ khoảng năm 2005, trong thời gian này nó được sử dụng tại nhiều website ở khắp Internet.
Phần mở rộng có giao diện đầy đủ, để cho bạn điều khiển được sự đánh máy hơn các bộ gõ ở trong trang Web:
- Một panel gọn gàng trên thanh trạng thái của Firefox, rất giống các panel trên thanh trạng thái của Microsoft Word, hiển thị kiểu gõ hiện đang bật lên. Khi nhấn chuột trái vào panel, có trình đơn để tắt hoặc chuyên biệt AVIM. Có thể giấu panel này.
- Một trình đơn rất giống dưới trình đơn Chỉnh sửa làm dễ chuyên biệt AVIM ngay cả khi bạn giấu panel hoặc cả thanh trạng thái.
- Nếu bạn quen với các nút bấm có trong nhiều bộ gỡ tại trang Web, phần mở rộng cung cấp bộ nút cho thanh công cụ mà bạn có thể thêm từng nút một (Hiển thị ▸ Thanh công cụ ▸ Tùy biến…). Nếu không cần cả năm kiểu gõ, chỉ việc cần thêm các nút cần.
- Hộp thoại tùy chỉnh có sẵn từ cửa sổ Tiện ích (Công cụ ▸ Các Tiện ích), ở đấy bạn có thể thiết lập các chi tiết của AVIM.
- Vài phím tắt để bạn khỏi cần với tay tới chuột. Có thể bật hay tắt AVIM dễ dàng dùng khoản Bật trong trình đơn, hoặc bằng cách bấm Ctrl+Alt+V (⌥⌘V trên Mac). Phím tắt này rất tiện khi cần nhập những từ ngoại ngữ hay mã nguồn vào trang Web.
- AVIM có sẵn trong bốn thứ tiếng – Anh, Pháp, Tây Ban Nha, Việt – cả ba được cài đặt cùng lúc. Phần mở rộng tự động nhận ra ngôn ngữ giao diện để hợp với bản dịch Firefox đang được sử dụng; nếu AVIM không có sẵn trong ngôn ngữ của Firefox, nó sử dụng tiếng Anh mặc định.
Không giống những bộ gõ khác có sẵn để cài đặt trong Firefox, AVIM hoạt động ở bất cứ chỗ nào:
- AVIM nhận ra mỗi hộp văn bản trong mỗi trang Web mà bạn mở lên. (Tuy nhiên, AVIM bỏ qua các hộp mật khẩu.)
- AVIM cũng nhận ra gần như tất cả mọi hộp văn bản trong Firefox, bao gồm các hộp trong hộp thoại Đặc tính Đánh dấu, Thư viện (trước đây gọi là Trình Quản lý Đánh dấu), và hộp thoại này mà trang Web hiển thị dùng JavaScript.
- Đã thử biết rằng phần mở rộng này tương thích với hàng chục phần mở rộng, bao gồm: ChatZilla, iMacros, Pencil, ScrapBook, ScribeFire, StumbleUpon, Từ điển tiếng Việt, Vietnamese Language Pack, vnDict, và Zotero.
- AVIM hỗ trợ đầy đủ bất cứ trang Web nào được viết bằng HTML, bao gồm Gmail và Google Docs. Nó nhận ra được các hộp soạn thảo có định dạng như FCKeditor và TinyMCE.
- Phần mở rộng hỗ trợ chương trình chơi nhạc Songbird, cũng như các phiên bản đang thử (chưa được phát hành) của trình duyệt Flock và Mozilla Thunderbird, chương trình thư điện tử cùng đôi với Firefox. Nó cũng hỗ trợ các chương trình Internet mà bạn xây dựng dùng Mozilla Prism.
AVIM cố gắng hoạt động một cách dễ hiểu, không làm bạn trật bước:
- Khi nào thay đổi tùy chỉnh của AVIM, thay đổi đó được áp dụng ngay ở các cửa sổ Firefox đã mở lên, và được tự động áp dụng vào cửa sổ Firefox nào mà bạn mở lên từ lúc đó.
- Các phím tắt của AVIM’s không những không có xung đột với các phím tắt mặc định của Firefox, mà còn tránh khỏi các phím tắt của nhiều phần mở rộng.
- Các hộp văn bản không cuộn lên trên hay nhảy lại đầu dòng mỗi lần thêm dấu.
- Hộp thoại tùy chỉnh của phiên bản mới nhận ra khi phần mở rộng Mudim cũng được cài đặt và bật lên và có nút để dễ tắt nó, để tránh sự xung đột. AVIM không vô hiệu hóa cả phần mở rộng Mudim mà chỉ chuyển nó qua chế độ Tắt.
- Tương tự, bộ giám sát script của phần mở rộng tự động tắt các script bộ gõ được nhúng vào trang mà có thể xung đột với AVIM.
- AVIM có giao diện chuẩn hoàn toàn, nên nó có vẻ như một phần có sẵn trong Firefox, bất chấp bạn chuyển qua giao diện (theme) nào trong Firefox.
So sánh với Mudim, CHIM, và Vietnamese Portable thì rõ ràng là AVIM là công cụ gõ tiếng Việt đầy đủ nhất trong dạng phần mở rộng.
Ảnh chụp màn
Cần thiết trong hệ thống
Phần mở rộng cần một trong những chương trình sau:
- Mozilla Firefox, phiên bản 3.0 trở lên
- Mozilla Thunderbird, phiên bản 3.0 (alpha)
- Mozilla Prism, phiên bản 0.9 trở lên
- Flock, phiên bản 2.0 (beta)
- Songbird, phiên bản 0.3 trở lên
- Komodo IDE hoặc Komodo Edit, phiên bản 5.0 (alpha)
- Instantbird, phiên bản 0.1.2 trở lên (alpha)
- Pencil (chương trình hoặc phần mở rộng)
- ChatZilla (chương trình hoặc phần mở rộng)
Bạn cũng cần một bàn phím thích hợp. Các kiểu gõ trong AVIM được thiết kế cho các bàn phím theo tiêu chuẩn Mỹ, nhưng bàn phím nào mà có các phím cần thiết thì được. Các phím cần thiết tùy kiểu gõ mà bạn muốn sử dụng, nhưng mọi kiểu gõ cần các phím chữ (A–Z) và dấu chéo ngược (\), và các phím tắt của phần mở rộng cũng cần dấu hai chấm (:) và dấu chấm phẩy (;).
Kiểu gõ VNI thì cũng cần các phím số (0–9), còn kiểu gõ VIQR cần các phím dấu sau: ngoặc đơn trái ((), cộng (+), huyền (`), lược ('), chéo (/), hỏi (?), ngã (~), chấm (.), và gạch ngang (-). Loại VIQR* thay dấu sao (*) cho dấu cộng (+).
Sau hết, cần các phong chữ hỗ trợ các chữ tiếng Việt. Phần nhiều hệ điều hành ngày nay có phong chữ tiếng Việt đầy đủ.
Cài đặt
(gói XPInstall, 45,5 kB)
Nếu dự định sử dụng AVIM trong Firefox, hãy nhấn chuột trái vào liên kết ở trên. Bạn sẽ gặp cờ ngang (thường màu vàng) cho biết rằng Firefox đã chặn sự cài đặt. Hãy nhấn Cho phép, rồi nhấn Cài đặt trong hộp thoại sau đó. Hãy khởi động lại Firefox.
Còn nếu bạn muốn tải xuống AVIM cho một chương trình khác, như là Thunderbird, hãy nhấn chuột phải vào liên kết ở trên và chọn Lưu Liên kết Thành. Sau khi lưu gói cài đặt, hãy mở cửa sổ Các Tiện ích của chương trình mục (thường từ Công cụ ▸ Các Tiện ích). Hãy kéo gói cài đặt vào cửa sổ đó, nhấn Cài đặt trong hộp mà hiện lên, và khởi động lại chương trình đó.
Gói cài đặt phần mở rộng cũng có sẵn tại website Firefox Add-ons chính thức.
Sử dụng
Gõ tiếng Việt
Sau khi bạn cài đặt phần mở rộng và khởi động lại Firefox, kiểu gõ Tự động được tự động bật lên. Để đổi thành kiểu gõ khác, hãy vào trình đơn Chỉnh sửa ▸ Gõ Tiếng Việt hoặc nhấn vào panel đề “Tự động” trên thanh trạng thái. Cũng có thể bấm Ctrl+: và Ctrl+; (⌘: và ⌘; trong Mac) để chuyển qua lại các kiểu gõ. Các kiểu gõ dùng các phím sau:
| Dấu | Thí dụ | Phím bấm | ||||
|---|---|---|---|---|---|---|
| Tự động¹ | Telex | VNI | VIQR | VIQR* | ||
| Các dấu thanh điệu | ||||||
| Sắc | á | as hoặc a1 | as | a1 | a' | |
| Huyền | à | af hoặc a2 | af | a2 | a` | |
| Hỏi | ả | ar hoặc a3 | ar | a3 | a? | |
| Ngã | ã | ax hoặc a4 | ax | a4 | a~ | |
| Nặng | ạ | aj hoặc a5 | aj | a5 | a. | |
| Các dấu khác | ||||||
| Mũ | â | aa hoặc a6 | aa | a6 | a^ | |
| ê | ee hoặc e6 | ee | e6 | e^ | ||
| Móc | ơ | ow hoặc o7 | ow | o7 | o+ | o* |
| Trăng | ă | aw hoặc a8 | aw | a8 | a( | |
| Gạch ngang | đ | dd | dd | d9 | dd | |
| Các phím tiện | ||||||
| Thoát phím chết | a. | a\.² | ||||
| Xóa dấu | z hoặc 0 | z | 0 | - | ||
|
||||||
Thí dụ sau đây có các dòng mở đầu tiểu thuyết Việt Nam Truyện Kiều:
Trăm năm trong cõi người ta,
Chữ tài chữ mệnh khéo là ghét nhau
Trải qua một cuộc bể dâu,
Những điều trông thấy mà đau đớn lòng.
Lạ gì bỉ sắc tư phong
Trời xanh quen thói má hồng đánh ghen.
Và sau đây có những cách gõ đoạn này dùng các kiểu gõ trong AVIM (có nhiều cách khác, vì AVIM để bạn bỏ dấu nhiều chỗ):
- Telex
-
Trawm nawm trong coxi nguwowfi ta,
Chuux tafi chuwx meejnh kheso laf ghest nhau
Trari qua moojt cuoojc beer daau,
Nhuwxng ddieefu troong thaasy maaf ddau ddowsn lofng.
Laj gif bir sawsc tuw phong
Trowfi xanh quen thosi mas hoofng ddasnh ghen. - VNI
-
Tra8m na8m trong co4i ngu7o72i ta,
Chu74 ta2i chu72 me65nh khe1o la2 ghe1t nhau
Tra3i qua mo65t cuo65c be63 da6u,
Nhu74ng d9ie62u tro6ng tha61y ma2 d9au d9o71n lo2ng.
La5 gi2 bi3 sa81c tu7 phong
Tro71i xanh quen tho1i ma1 ho62ng d9a1nh ghen. - VIQR
-
Tra(m na(m trong co~i ngu+o+`i ta,
Chu+~ ta`i chu+~ me^.nh khe'o la` ghe't nhau
Tra?i qua mo^.t cuo^.c be^? da^u,
Nhu+~ng ddie^`u tro^ng tha^'y ma` ddau ddo+'n lo`ng\.
La. gi` bi? sa('c tu+ phong
Tro+`i xanh quen tho'i ma' ho^`ng dda'nh ghen\. - VIQR*
-
Tra(m na(m trong co~i ngu*o*`i ta,
Chu*~ ta`i chu*~ me^.nh khe'o la` ghe't nhau
Tra?i qua mo^.t cuo^.c be^? da^u,
Nhu*~ng ddie^`u tro^ng tha^'y ma` ddau ddo*'n lo`ng\.
La. gi` bi? sa('c tu* phong
Tro*`i xanh quen tho'i ma' ho^`ng dda'nh ghen\.
Hãy thử gõ dùng AVIM tại trang thử.
Tùy biến AVIM
Theo mặc định, kiểu gõ Tự động nhận các kiểu gõ Telex và VNI. Có thể thiết lập kiểu gõ Tự động, cũng như một số tùy chỉnh khác, dùng cửa sổ tùy chọn của AVIM.
Các tùy chọn có sẵn:
- Bật lên AVIM để gõ tiếng Việt
- Nếu được chọn, AVIM được bật lên. Nếu không, nó được tắt, tức là có thể gõ như thể là phần mở rộng chưa được cài. Theo mặc định, nó được đánh dấu (bật). Tùy chọn này có ID là extensions.avim.enabled.
- Kiểu gõ
-
Chọn kiểu gõ để áp dụng vào các phím được bấm. Theo mặc định, nó là Tự động. Tùy chọn này có ID là extensions.avim.method, và giá trị trong công cụ about:config có thể là:
- Tự động
- Telex
- VNI
- VIQR
- VIQR*
- Bắt buộc các quy tắc chính tả tiếng Việt
- Nếu được chọn, AVIM đại khái là bộ kiểm tra chính tả. Hãy dùng làm thí dụ một từ không tuân theo các quy tắc chính tả tiếng Việt – thường có nghĩa là nó là một từ hay tên ngoại ngữ. Nếu bạn sử dụng kiểu gõ Telex, as thường cho ra á, nhưng nếu tùy chọn này được chọn và bạn nhập vào Washington, bạn sẽ thấy Washington; nếu tùy chọn này không được chọn, bạn sẽ thấy Wáhington. Theo mặc định, tùy chọn này được chọn (bắt buộc). Tùy chọn này có ID là extensions.avim.ignoreMalformed.
- Cho phép dz và f ở đầu từ
- Nếu được chọn, AVIM cho phép bỏ dấu trên các từ bắt đầu với dz (đồng âm với d) hoặc f (đồng âm với ph), ngay cả khi bắt buộc các quy tắc chính tả. Những cách đánh vần này thường không được chấp nhận, nhưng thường gặp nó tại những diễn đàn trực tuyến. Theo mặc định, tùy chọn này không được chọn (không cho phép). Nó có ID là extensions.avim.informal.
- Bỏ dấu trên nguyên âm đầu tiên trong nguyên âm đôi ở cuối từ (bỏ dấu kiểu cũ)
- Nếu được chọn, AVIM chắc chắn bỏ dấu kiểu cũ, tức là xo'a và xoa' đều cho ra xóa (khi sử dụng kiểu gõ VIQR). Nếu nó không được chọn, AVIM bỏ dấu kiểu mới, tức là cả hai đều cho ra xoá. Theo mặc định, nó được chọn (kiểu cũ). Tùy chọn này có ID là extensions.avim.oldAccents.
- Nhận tổ hợp gõ từ các kiểu gõ sau khi Tự động được chọn
- Nếu tùy chọn nào dưới đề mục này được chọn, các phím của kiểu gõ đó được nhận bởi kiểu gõ Tự động. Theo mặc định, Telex và VNI đóng góp vào kiểu gõ Tự động. Các tùy chọn này có ID bắt đầu với extensions.avim.auto.
- Tắt các script bộ gõ ở trong trang Web
- Nếu được chọn, bộ giám sát script được bật lên. Ngay khi bạn gõ vào trang Web, phần mở rộng tự động tắt script bộ gõ nào được nhúng vào trang đó mà có thể xung đột với AVIM. Theo mặc định, tùy chọn này được chọn, nên các script AVIM/HIM, MViet, VietTyping, và VietUni bị tắt. Tùy chọn này có ID là extensions.avim.scriptMonitor.enabled. Bạn có thể chọn các script để tắt dùng các tùy chọn còn lại mà có ID bắt đầu với extensions.avim.scriptMonitor. Bộ giám sát script có khả năng tắt các script sau: AVIM/HIM, CHIM/Mudim, MViet, VietIMEW, VietTyping, VietUni, và Vinova.
- Hiển thị trên thanh trạng thái
- Nếu được chọn, thanh trạng thái hiển thị; nếu không, nó ẩn. Theo mặc định, tùy chọn này được chọn (hiển thị). Tùy chọn này có ID là extensions.avim.statusBarPanel.
- Tab Bỏ qua
-
Danh sách các ID hộp văn bản (không phân biệt chữ hoa chữ thường). Các hộp văn bản có ID trong danh sách này bị AVIM bỏ qua. Theo mặc định, danh sách có các ID sau:
colorzilla-textbox-hex– hộp mã màu hệ thập lục phân, phần mở rộng ColorZillaemailvàe-mail– vì rất ít khi địa chỉ thư điện tử có ký tự không thuộc ASCIITextboxEval– thanh Mã nguồn, Bảng kiểm soát Lỗitx_tagName– hộp Tên Thẻ, hộp thoại Chèn Nốt, Trình Kiểm tra DOM, vì rất ít khi tên thẻ có ký tự không thuộc ASCII
urlbar– Thanh Địa chỉ, cửa sổ trình duyệt Firefox – không khuyên sử dụng cái này, tại vì AVIM có ích thí dụ khi nhập các địa chỉ của bài tại Wikipedia tiếng Việt.searchbar– Thanh Tìm kiếm WebFindToolbar– Thanh Tìm kiếm trong Trang
Sử dụng AVIM trong tiếng Việt
Theo mặc định, AVIM có giao giện cùng ngôn ngữ với Firefox trên máy. Tuy nhiên, gói địa hóa tiếng Việt chỉ có tương tích với Firefox 2. (Đang thử phiên bản alpha cho Firefox 3.) May là bạn có thể đổi qua tiếng Việt mỗi phần mở rộng hỗ trợ tiếng Việt (bao gồm AVIM và Từ điển tiếng Việt):
- Dùng Thanh Địa chỉ của Firefox, hãy đi tới about:config.
- Hãy nhấn nút “I’ll be careful, I promise!” (Tôi sẽ cẩn thận, hứa đấy!) để đi tiếp. (Bạn sẽ bảo đảm miễn là theo các bước này.)
- Hãy nhập general.useragent.locale vào thanh Lọc và chờ một giây.
- Hãy nhấn đúp vào tùy chỉnh có ID là general.useragent.locale.
- Hãy nhập vi (tức là tiếng Việt) vào hộp thoại mà hiển thị và nhấn OK.
- Hãy khởi động lại Firefox.
Để hoàn tác sự thay đổi địa phương, hãy theo các bước ở trên, nhưng thay vì nhấn đúp vào tùy chỉnh, hãy nhấn chuột phải vào nó và chọn Reset (Đặt lại), rồi khởi động lại Firefox.
Cám ơn Trần Xuân Huy về mẹo này.
Các lỗi
- Trong phần nhiều hộp soạn thảo văn bản có định dạng, các dấu bị mất sau khi văn bản được nhập vào, hoàn tác, rồi làm lại.
- Trong Xinha, khi phần bổ trợ SmartReplace và VIQR được bật lên, dấu lược (') cho ra dấu lược cong đằng sau dấu sắc.
- Khi AVIM bị tắt, các nút trên thanh công cụ nhìn giống vẫn có hiệu lực, trong khi nó vô hiệu.
- AVIM không hoạt động ở trong hộp soạn thảo Scintilla của Komodo.
Những gì mới
- Phiên bản 20080728.210 (thứ ba, ngày 26 tháng 8 năm 2008)
- Hỗ trợ sơ sơ các phiên bản alpha của Komodo IDE 5.0 và Komodo Edit 5.0.
- Hỗ trợ các phần mở rộng Deepest Sender, iMacros, ReminderFox, và Zotero.
- Sửa tính năng dời dấu bằng cách lặp lại, lần này cho VNI và VIQR.
- Giải quyết vấn đề trong VIQR và VIQR* mà cho vào o``` thì dấu lại bị gắn vào nguyên âm.
- Có thể bỏ qua các hộp soạn thảo có định dạng theo ID của khung chung quanh.
- Hỗ trợ thanh tìm kiếm trong Trình Quản lý các Tiện ích.
- Hỗ trợ Firebug và ScribeFire trong cửa sổ riêng.
- Hỗ trợ các hộp thoại tìm kiếm trong Thunderbird.
- Hỗ trợ các loại hộp văn bản ít gặp, như là thẻ
<isindex>của HTML.
Giúp đỡ
- AVIM cố gắng nhận ra mọi hộp văn bản trong mọi trang Web mà Firefox tải xuống. Tuy nhiên, một số trang Web làm việc này rất khó. Nếu bạn gặp đến một website công khai mà AVIM không hỗ trợ, xin cho Minh biết. (Lưu ý rằng, vì các lý do công nghệ, không có thể hỗ trợ các hộp văn bản ở trang Flash hay trình Java.)
- Nếu bạn nói tiếng Việt giỏi, xin giúp Minh và Hiếu tìm kiếm những từ mà AVIM chưa xử lý đúng.
- Nếu bạn thạo một ngôn ngữ mà AVIM chưa có, xin giúp dịch AVIM ra ngôn ngữ đó. Không cần phải dịch nhiều, và bạn có thể dịch trực tuyến tại BabelZilla.
Giấy phép
Phần mở rộng này chạy trên script AVIM của Đặng Trần Hiếu, có sẵn theo giấy phép dễ dãi sau:
AVIM JavaScript Vietnamese Input Method Source File
Copyright © 2004–2008 Hieu Tran Dang <lt2hieu2004 (at) users (dot) sf (dot) net>
Website: http://noname00.com/hieu
You are allowed to use this software in any way you want providing:
- You must retain this copyright notice at all time
- You must not claim that you or any other third party is the author of this software in any way.
Tập tin script được sửa đổi theo giấy phép này và do Hiếu cho phép trong văn bản trước tiên. Các tập tin hình ảnh thuộc về phạm vi công cộng. Các tập tin khác được phân phối với phần mở rộng này có sẵn theo giấy phép MIT:
Copyright © 2007–2008 Minh Nguyen.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
The Software is provided “AS IS”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
Nói tóm lại, hãy sử dụng phần mềm này cách nào không sao, miễn là bạn giữ nguyên các thông báo bản quyền trong AVIM và không kiện Minh hay Hiếu hễ có sao.
Xây dựng
Nếu bạn muốn theo dõi mã nguồn phát triển gần đây nhất, bạn có thể sử dụng lệnh sau (cần Subversion) trong cửa sổ dòng lệnh, để tải xuống mã nguồn hiện hành của phần mở rộng:
svn co http://version.1ec5.org/avim/trunk/ avim
Để gói mã nguồn thành phần mở rộng một mình, bạn có thể sử dụng script xây dựng, cần Python 2.5 trở lên. Trong cửa sổ dòng lệnh, hãy duyệt tới thư mục avim/ và chạy lệnh sau:
python build.py
Hai gói cài đặt, avim.xpi và avim-phiên_bản.xpi, sẽ nằm trong thư mục đó. Script xây dựng có vài tùy chọn, chẳng hạn để sản xuất một phiên bản soát lỗi có bộ phận đo thử.
Tùy chọn khi xây dựng
Để cho quá trình phát hành tiện hơn, script xây dựng hỗ trợ vài tùy chọn:
- --babelzilla
- Sản xuất một gói tích hợp với BabelZilla, để làm tiện việc dịch phần mở rộng này. Xóa các thẻ
<em:localized>khỏi bản liệt kê cài đặt (install manifest) của phần mở rộng, và đổi tên các bản dịch theo các mã địa phương mà BabelZilla hiểu. - -d
--debug - Sản xuất một gói thử, bao gồm trình đo thử, dùng để tìm kiếm các lỗi trở lại (regression).
- -h
--help - In thông báo trợ giúp này ra dòng lệnh.
- --use-name name
- Định rõ tên của gói. Mặc định là avim.
- --use-version version
- Định rõ chuỗi phiên bản. Mặc định tùy phiên bản mã nguồn mà bạn lấy từ kho Subversion gần đây nhất.
- -v
--version - In thông báo đề phiên bản của script xây dựng ra dòng lệnh.
Sử dụng trình đo thử
Kho nào bạn xây dựng một gói không phải loại phát hành (tức là để thử hoặc dịch), phần mở rộng sẽ bao gồm trình đo thử tự động. Tuy nó vẫn chỉ thử sơ sơ, trình đo thử làm rất dễ việc kiếm thấy các lỗi trở lại những hàm chính của AVIM.
Để sử dụng trình đo thử:
- Hãy cài đặt gói thử trong một chương trình được hỗ trợ.
- Hãy mở Trình Tiện ích (Công cụ ▸ Các Tiện ích) và chọn AVIM trong danh sách phần mở rộng.
- Hãy bấm nút Tùy chỉnh để mở cửa sổ tùy chọn của AVIM và bấm nút Mở Trình Đo thử.
- Hãy bấm nút Duyệt để chọn tập tin để cho vào. Tập tin này cần tuân theo dạng văn bản thuần và chứa một danh sách các từ tuân theo những quy tắc chính tả tiếng Việt, chỉ chia nhau bằng khoảng cách.
- Hãy bấm nút Run Tests.
AVIM nhập vào các từ trong tập tin dùng kiểu gõ đang chọn. Cùng lúc chạy, trình đo thử cập nhật một danh sách có vài cột với từ đầu tiên, các phím dùng để gõ từ này, và kết quả, tức là văn bản cho ra. Cột cuối cùng đề văn bản cho ra có đúng như từ đầu tiên hay không. Mỗi hàng được tô đậm màu xanh màu đỏ, để cho dễ đọc nhanh danh sách này để kiếm lỗi trở lại nào đó.
Trình đo thử hiện thử các từ dùng kiểu gõ được chọn, sau khi chuyển các phím chết đến cuối từ. Nó biết về tính năng tự động sao chép dấu móc. Vào tương lai, trình đo thử sẽ được mở rộng thêm để cho phép bạn kiểm tra rằng AVIM không bỏ dấu vào các từ không tuân theo quy tắc.