Macro giữ ký hiệu nhất quán

newcommand, NewDocumentCommand, một tệp macro dùng chung.

Macro giữ ký hiệu nhất quán

Bài báo nào cũng có những ký hiệu lặp lại: tập số thực, toán tử kỳ vọng, giá trị tuyệt đối với cặp gạch đứng có kích thước đúng. Nếu bạn gõ \mathbb{R} ở bốn mươi chỗ và sau đó người hướng dẫn thích \mathbf{R} hơn, bạn phải sửa bốn mươi lần và chắc chắn sẽ sót một chỗ. Một macro biến ký hiệu đó thành một lệnh có tên, chỉ định nghĩa một lần. Đổi định nghĩa là cả tài liệu theo. Đó là cách giữ ký hiệu nhất quán: mã nguồn không thể tự lệch pha với chính nó.

Định nghĩa lệnh bằng newcommand

\newcommand{\R}{\mathbb{R}}
\newcommand{\E}[1]{\mathbb{E}\left[#1\right]}
\newcommand{\abs}[1]{\left\lvert #1 \right\rvert}

Định nghĩa đầu tiên thuộc loại đơn giản nhất: \R giờ chỉ là cách viết tắt thuần túy, và gõ \R ở bất cứ đâu sẽ ra \mathbb{R}.

Dạng thứ hai nhận một đối số. [1] sau tên khai báo rằng \E nhận một đối số, và #1 đánh dấu chỗ đối số đó được đặt vào trong phần khai triển. Vì vậy \E{X} trở thành \mathbb{E}\left[X\right]. Định nghĩa này mang lại nhiều hơn sự ngắn gọn: cặp \left[ và \right] làm cho dấu ngoặc co giãn vừa với bất cứ thứ gì nằm bên trong, nên \E{\frac{X}{n}} tự động có ngoặc cao. Macro \abs làm điều tương tự với \lvert và \rvert, cặp gạch đứng đúng cho giá trị tuyệt đối. Bạn có thể khai báo tối đa chín đối số và gọi chúng bằng #1 đến #9.

Nếu một lệnh đã tồn tại, \newcommand từ chối định nghĩa lại và dừng với một lỗi, điều này bảo vệ bạn khỏi việc vô tình phá hỏng thứ gì đó. Để cố ý thay thế một lệnh có sẵn, hãy dùng \renewcommand.

Giao diện hiện đại

LaTeX hiện nay còn đi kèm một lệnh định nghĩa phong phú hơn:

\NewDocumentCommand{\citepair}{mm}{\cite{#1}, \cite{#2}}

\NewDocumentCommand dùng một chuỗi đặc tả đối số thay vì một con số đếm. Ở đây mm nghĩa là hai đối số bắt buộc, nên \citepair{knuth84}{lamport94} trích dẫn cả hai khóa. Ngôn ngữ đặc tả đi xa hơn những gì \newcommand làm được: o khai báo một đối số tùy chọn trong ngoặc vuông, s nhận biết biến thể có dấu sao, và O{default} cho đối số tùy chọn một giá trị mặc định. Với bất cứ việc gì vượt quá phép thay thế đơn giản, hãy dùng giao diện này.

Chia sẻ các định nghĩa

Hãy giữ một tệp macros.sty dùng chung cho các chương. Đặt các định nghĩa của bạn trong một tệp đó, nạp nó bằng \usepackage{macros} từ mỗi tài liệu, và mọi chương của luận văn, cùng với slide và bản bài báo, đều thống nhất về ký hiệu. Khi có cộng sự tham gia, họ chỉ đọc một tệp ngắn để nắm các quy ước của bạn thay vì phải suy ngược ra từ văn bản. Điều này kết hợp tự nhiên với thiết lập nhiều tệp.

Một mẹo về cách đặt tên: hãy đặt cho macro những cái tên có nghĩa như \abs hoặc \norm, thay vì tên dựa vào hình thức như \bigbars. Tên nên nói lên ký hiệu có nghĩa gì, để định nghĩa được tự do thay đổi cách nó hiển thị. Và đừng định nghĩa macro cho thứ bạn chỉ dùng hai lần; lợi ích bắt đầu ở khoảng lần dùng thứ ba.

Quay lại Thời gian chạy