Quy tắc biến đổi văn bản đã lưu
Phép biến đổi là nhóm nhỏ các quy tắc tìm và thay thế được lưu để chủ động áp dụng: làm sạch văn bản dán vào, sắp xếp danh sách, bỏ khoảng trắng cuối dòng hoặc bọc nội dung trong khối mã. Bạn chọn từ menu Format, xem trước thay đổi rồi quyết định áp dụng.
Cài đặt cho biết chính xác chúng là gì: "Các quy tắc tìm/thay thế đã lưu và một vài thao tác văn bản tích hợp sẵn. Chúng không phải là tập lệnh: Varlig không bao giờ chạy các lệnh shell, plugin hoặc yêu cầu mạng cho chúng và không bao giờ tự áp dụng chúng - không phải khi nhập, dán hoặc mở ghi chú. Bạn chọn một cái từ Định dạng ▸ Chuyển đổi và xem những thay đổi của nó trước khi áp dụng bất cứ thứ gì."
Nơi lưu trữ
Settings › Editor › Text Transformations giữ danh sách và nó trống để bắt đầu: cho đến khi bạn thêm một, Format › Transformations hiển thị No Transformations và không có gì chạy ở bất cứ đâu.
Add Transformation tạo mục mới tên Transformation, chứa một quy tắc Find and Replace. Mỗi phép biến đổi có:
| Trường | Tác dụng | Giá trị ban đầu |
|---|---|---|
| Name | Menu Format gọi nó là gì. | Transformation |
| Applies to | Selection hoặc Whole Note. | Selection |
| Show in Format menu | Format › Transformations liệt kê nó hay không. | Bật |
| Các quy tắc | Add Rule thêm một; Remove Last Rule loại bỏ quy tắc cuối cùng. | Một Find and Replace |
Mỗi hàng trong danh sách cũng có một nút để sao chép nó và một nút để xóa nó.
Phép biến đổi chưa hoàn chỉnh — thiếu tên, thiếu quy tắc hoặc mẫu không biên dịch được — sẽ được đánh dấu kèm lý do trong Settings, và không xuất hiện trong Format › Transformations cho đến khi sửa xong.
Phép biến đổi văn bản đã lưu đồng bộ giữa Mac, iPhone và iPad qua iCloud. Trên Mac, bật Sync notes with iCloud. Mỗi thiết bị giữ một bản sao trong tùy chọn cục bộ, nên các phép biến đổi vẫn dùng được khi ngoại tuyến; chúng không nằm trong bản xuất ghi chú hay bản sao lưu thư viện.
Các quy tắc
Quy tắc chạy theo thứ tự, mỗi quy tắc nhận kết quả của quy tắc ngay trước. Không có điều kiện hay phân nhánh.
| Quy tắc | Tác dụng |
|---|---|
| Find and Replace | Văn bản theo nghĩa đen, với Match Case và Whole Words (cả hai đều tắt để bắt đầu). |
| Regular Expression | Mẫu biểu thức chính quy ICU; dùng $1 và ${name} trong nội dung thay thế để tham chiếu nhóm bắt. |
| UPPERCASE | Chuyển văn bản thành chữ hoa. |
| lowercase | Chuyển văn bản thành chữ thường. |
| Title Case | Viết hoa từng từ. |
| Sort Lines | Sắp xếp các dòng. |
| Unique Lines | Giữ dòng đầu tiên của mỗi dòng lặp lại. |
| Trim Trailing Spaces | Loại bỏ khoảng trắng ở cuối mỗi dòng. |
| Join Lines | Nối các dòng với Separator mà bạn đưa ra. |
| Split Lines | Tách tại chuỗi ghi trong Split at, mỗi phần thành một dòng. |
| Wrap in Code Fence | Đặt văn bản trong khối mã có dấu mở và đóng, dùng ngôn ngữ bạn chọn ở Language. |
Quy tắc chỉ là danh sách giá trị, không phải mã thực thi. Biểu thức chính quy được biên dịch và kiểm tra bằng cùng bộ xử lý của Edit › Find and Replace (Advanced)…. Mẫu không biên dịch được sẽ được đánh dấu trong Settings trước khi bạn áp dụng.
Áp dụng phép biến đổi
Trên Mac, chạy phép biến đổi từ Format › Transformations › name. Trên iPhone và iPad, dùng menu Transformations trong trình soạn thảo. Các phép biến đổi không có phím tắt và không bao giờ tự chạy khi bạn mở ghi chú, nhập dữ liệu, dán hoặc đưa ứng dụng xuống nền.
Với Applies to đặt thành Selection, hãy chọn văn bản trước. Với Whole Note, toàn bộ ghi chú là phạm vi.
Varlig chạy các quy tắc trên một bản sao và hiển thị danh sách bảng xem trước Removes 4 lines và Inserts 4 lines. Các danh sách được cắt theo phần thực sự khác nhau và thành 40 dòng ở mỗi bên, với một ghi chú khi có nhiều hơn. Phần chân trang cho biết "Áp dụng là một bước hoàn tác. Không có gì thay đổi cho đến khi bạn nhấn Áp dụng." Cancel để lại ghi chú một mình; Apply thực hiện thay đổi, như một chỉnh sửa duy nhất mà Edit › Undo (⌘Z) đảo ngược trong một bước.
Nếu ghi chú đã thay đổi kể từ khi bản xem trước được thực hiện, Apply sẽ từ chối và yêu cầu chạy mới thay vì viết lên văn bản mới hơn.
Khi phép biến đổi không chạy
Nếu có lỗi, ghi chú được giữ nguyên hoàn toàn, không có trường hợp áp dụng dở dang. Varlig giải thích lỗi thay vì thay đổi nội dung:
- "Các chuyển đổi không chạy trên các ghi chú được bảo vệ, chỉ đọc hoặc trong thùng rác." Thư viện chỉ đọc cũng vậy.
- “More than 10,000 matches in one rule. Narrow the transformation.” — Một quy tắc có hơn 10.000 kết quả khớp; hãy thu hẹp phép biến đổi.
- "Quá trình chuyển đổi mất quá nhiều thời gian. Đơn giản hóa các quy tắc của nó hoặc sử dụng phạm vi nhỏ hơn."
- "Sự biến đổi này không thay đổi gì ở đây."
- Thông báo nêu rõ từng lỗi: mẫu không hợp lệ, thiếu nhóm bắt, không có văn bản cần tìm, phép biến đổi thiếu tên hoặc quy tắc, hay dùng phạm vi Selection mà chưa chọn văn bản.
Giới hạn
| Gì | Giới hạn |
|---|---|
| Phép biến đổi đã lưu | 50 |
| Số quy tắc trong một phép biến đổi | 20 |
| Số kết quả khớp trong một quy tắc | 10,000 |
| Thời gian cho toàn bộ phép biến đổi | 1,5 giây |
Không có chế độ chạy thử cho nhiều ghi chú. Để thay đổi nhiều ghi chú cùng lúc, dùng Edit › Replace in Notes…, có bản xem trước riêng cho từng ghi chú.
Một chuyển đổi chỉ tạo ra Markdown thông thường, vì vậy không có gì nó viết là đặc biệt đối với Varlig và một biên tập viên khác nhìn thấy chính xác những gì Varlig đã lưu.