Cách quay video demo terminal và CLI để người xem theo kịp

Video demo trên terminal thuộc nhóm hữu ích nhất mà một lập trình viên có thể làm. Đồng thời cũng thuộc nhóm khó xem nhất. Chữ monospace bé xíu, một bức tường kết quả cuộn liên tục, câu lệnh biến mất khỏi mép trên màn hình trước khi ai kịp đọc — và người xem bỏ cuộc sau hai phút.

Cách khắc phục nằm gần như trọn vẹn ở khâu chuẩn bị. Một bản quay terminal dễ theo dõi được dựng nên trước khi bấm nút quay, chứ không phải cứu vãn sau đó. Dưới đây là toàn bộ quy trình.

Vì sao video terminal khó xem

Video quay giao diện đồ họa có điểm neo thị giác: nút bấm, biểu tượng, bố cục. Terminal thì không có gì cả. Mọi thứ cùng cỡ, cùng màu và trôi rất nhanh. Vấn đề luôn lặp lại y hệt:

• Chữ quá nhỏ: cỡ chữ dễ chịu khi ngồi trước màn hình lại không đọc nổi trong video 1080p mở ở cửa sổ nhỏ
• Giao diện tương phản thấp: xám xỉn trên nền gần đen trông sang trọng trên màn hình nhưng biến mất sau khi nén video
• Kết quả trôi mất: dòng quan trọng bay qua trong lúc bạn còn đang nói về câu lệnh
• Thao tác gõ vô hình: người xem không thấy bạn bấm phím, nên một tham số gõ nhanh trông như ảo thuật
• Thời gian chết: cài đặt, build và chạy test tạo ra ba mươi giây chẳng có gì xảy ra

Mỗi vấn đề đều có cách xử lý trong chưa đầy năm phút.

Thiết lập terminal trước khi quay

Hãy coi terminal dùng để demo là một môi trường tách biệt với terminal làm việc. Hầu hết ứng dụng terminal đều hỗ trợ profile — tạo một profile tên “Recording” và cấu hình một lần duy nhất.

• Cỡ chữ 18–24pt: khoảng gấp đôi cỡ bạn vẫn dùng. Nếu nhìn trên màn hình thấy to đến mức vô lý thì nhiều khả năng đó là cỡ chuẩn cho video
• Giao diện tương phản cao: chữ sáng trên nền tối đặc. Tuyệt đối tránh nền trong suốt và ảnh nền — chúng nén xấu và thêm nhiễu thị giác
• Chỉnh kích thước cửa sổ thay vì toàn màn hình: terminal toàn màn hình quá lớn làm chữ nhỏ đi so với khung hình. Cửa sổ rộng khoảng 90–100 cột lấp đầy khung 16:9 rất vừa vặn
• Tắt ligature nếu gây rối: những ký tự mũi tên thay cho -> và != làm người đang gõ theo bạn bối rối
• Tăng nhẹ giãn dòng: chỉ cần một chút khoảng thở là phần kết quả dày đặc đã dễ nhìn hơn hẳn

Dọn dẹp shell của bạn

Prompt và lịch sử lệnh mang nhiều thông tin hơn bạn tưởng. Trước khi quay:

• Rút gọn prompt: prompt dài với nhánh Git, phiên bản Node, dấu thời gian và đường dẫn hai dòng vừa ngốn chiều ngang vừa gây xao nhãng. Một dòng ~/project $ ngắn gọn là lý tưởng
• Ẩn tên người dùng và tên máy: cả hai đều giúp nhận diện bạn và máy của bạn trong video có thể sẽ được công khai
• Xóa bộ đệm cuộn và lịch sử lệnh: những lệnh trước đó có thể để lộ tên khách hàng, tên máy chủ nội bộ hoặc công việc không liên quan
• Kiểm tra biến môi trường: kết quả env trong video đã làm rò rỉ nhiều khóa API hơn bất kỳ đoạn mã nào
• Dùng thư mục dùng một lần: thư mục dự án sạch giúp kết quả ls không lẫn tập tin lạ
• Tắt thông báo: cả tiếng chuông terminal lẫn cửa sổ bật lên đều làm hỏng một lần quay

Nếu demo có động đến thông tin đăng nhập thật, hãy dùng giá trị giả. Che mờ ở khâu hậu kỳ tốn công hơn nhiều so với việc đặt sẵn API_KEY=demo-key-1234.

Lên kế hoạch cho chuỗi lệnh

Hãy viết trước các câu lệnh — vào một tập tin nháp, đừng dựa vào trí nhớ. Một kịch bản ngắn ghi đúng những gì bạn sẽ gõ, theo thứ tự, mang lại ba lợi ích: tránh gõ sai khi căng thẳng, giữ demo đi theo một đường thẳng, và trở thành dàn ý cho phần thuyết minh.

Sau đó chạy thử trọn vẹn một lần mà không quay. Đây là lúc lộ ra những bất ngờ: bộ nhớ đệm đã sẵn sàng từ trước, một thư viện cần cài thêm, một câu hỏi xác nhận bạn đã quên. Chạy xong thì đặt lại thư mục về trạng thái ban đầu để bản quay chính thức bắt đầu từ cùng một điểm.

Thiết lập quay cho công việc trên terminal

Nội dung terminal gần như toàn văn bản tĩnh, nên dễ tính ở mặt này nhưng khó tính ở mặt khác.

• Quay cửa sổ, đừng quay cả màn hình: quay theo cửa sổ giữ khung hình bám sát terminal và che đi mọi thứ khác trên màn hình nền
• 30fps là quá đủ: văn bản không cần 60fps. Tốc độ khung hình thấp hơn còn cho chữ sắc nét hơn ở cùng bitrate
• Quay ở độ phân giải gốc của màn hình: phóng to chữ về sau chính là nguồn gốc của hiện tượng nhòe
• Bỏ webcam, hoặc để thật nhỏ: trong demo terminal, nhân vật chính là phần kết quả. Khung hình-trong-hình lớn sẽ che góc dưới, đúng chỗ kết quả mới hiện ra

Nhịp độ: phần đa số làm sai

Nhịp của một video demo terminal hay không phải là nhịp làm việc thật của bạn.

1. Nói trước điều bạn sắp làm rồi mới gõ: “Bây giờ tôi sẽ cài CLI ở phạm vi global”
2. Gõ với tốc độ đều và dứt khoát — chậm hơn bình thường nhưng đừng chậm đến mức gượng gạo
3. Dừng một nhịp trước khi bấm Enter để câu lệnh hiện đầy đủ và kịp đọc
4. Im lặng trong lúc kết quả hiện ra, rồi hãy nói về nó
5. Chỉ ra phần quan trọng thay vì đọc to toàn bộ kết quả

Với câu lệnh dài, hãy gõ thành hai bước thấy được — lệnh gốc trước, rồi thêm tham số — đồng thời giải thích từng tham số làm gì. Cách này dễ theo dõi hơn nhiều so với một dòng bốn mươi ký tự hiện ra cùng lúc.

Xử lý những lệnh chạy lâu

Không ai muốn ngồi xem npm install chín mươi giây. Bạn có ba lựa chọn tốt:

• Tăng tốc dần: giữ câu lệnh trong khung hình nhưng cho đoạn chờ chạy ở tốc độ 4x–10x, người xem vẫn thấy nó đã diễn ra mà không phải chờ cùng
• Cắt đoạn chờ: cắt từ lúc lệnh bắt đầu đến ngay trước khi kết quả xuất hiện. Cắt ở dòng prompt thì mối nối gần như vô hình
• Làm nóng bộ nhớ đệm trước: chạy lệnh một lần trước khi quay, đến lúc quay nó sẽ tự nhiên xong trong vài giây

Dù chọn cách nào, hãy nói rõ thời gian thực tế — “bước này thường mất khoảng hai phút” — để người tự làm theo không bị bất ngờ.

Làm kết quả dễ đọc trong trình chỉnh sửa

Khâu chỉnh sửa là nơi biến một bản quay terminal tạm được thành một video thật sự tốt.

• Phóng to phần kết quả quan trọng: zoom vào ba dòng đáng chú ý hiệu quả hơn hẳn việc bắt người xem nheo mắt nhìn cả màn hình log
• Thêm lớp chữ cho các lệnh chính: đưa câu lệnh lên màn hình như phụ đề giúp người xem có thứ để đọc trong lúc nghe bạn nói
• Chú thích thông báo lỗi: khi bạn cố ý cho thấy một lần thất bại, hãy làm nổi bật dòng giải thích nguyên nhân
• Thêm chương: Cài đặt, Cấu hình, Chạy lần đầu, Xử lý sự cố — demo terminal là loại video người ta vừa xem vừa làm theo nên hay tua lại
• Loại bỏ khoảng lặng: tính năng tự động cắt khoảng lặng siết chặt các quãng nghỉ quanh câu lệnh mà không đụng đến cách bạn nói

Kết hợp terminal với các cửa sổ khác

Rất ít demo thực tế chỉ có terminal. Bạn chạy lệnh, kiểm tra trình duyệt, rồi sửa tập tin cấu hình.

• Quyết định bố cục trước khi quay: terminal và trình duyệt cạnh nhau, hoặc chuyển qua lại toàn màn hình — chọn một kiểu và giữ nguyên
• Nếu chuyển cửa sổ, hãy dừng một nhịp: cho người xem nửa giây nhận ra thay đổi rồi mới nói tiếp
• Giữ cỡ chữ đồng nhất: chữ terminal to bên cạnh chữ trình soạn thảo bé tí sẽ khiến phần soạn thảo không đọc được
• Cân nhắc quay theo vùng: nếu bố cục hai cửa sổ cố định, quay đúng vùng đó giúp khung hình ổn định suốt video

Danh sách kiểm tra trước khi quay

[ ] Đã bật profile quay: chữ to, giao diện tương phản cao, không trong suốt
[ ] Prompt đã rút gọn, đã ẩn tên người dùng và tên máy
[ ] Đã xóa bộ đệm cuộn và lịch sử lệnh
[ ] Đã thay thông tin nhạy cảm bằng giá trị giả
[ ] Đã viết sẵn chuỗi lệnh và chạy thử một lần
[ ] Đã đặt lại thư mục làm việc về trạng thái sạch
[ ] Đã tắt thông báo và tiếng chuông terminal
[ ] Đã chọn quay cửa sổ, 30fps, độ phân giải gốc
[ ] Đã quay thử mười giây để kiểm tra độ dễ đọc

Mục cuối cùng là quan trọng nhất. Quay mười giây, phát lại đúng kích thước mà khán giả thật sự sẽ xem, và tự hỏi chữ có đọc thoải mái không. Nếu không, tăng cỡ chữ rồi thử lại, trước khi bắt tay vào một bản quay mười hai phút.

Những lỗi thường gặp

• Quay toàn màn hình trên màn 4K: chữ trong video xuất ra nhỏ như hạt bụi
• Xóa màn hình liên tục: người xem mất mạch những gì vừa diễn ra
• Đổi kích thước terminal giữa chừng: văn bản dàn lại và gây khó chịu
• Đọc nguyên văn kết quả: hãy tóm tắt — “cả mười hai bài test đều qua”
• Để con trỏ nhấp nháy trên khung hình đứng yên: cắt bỏ những đoạn đuôi đó, chúng khiến video như bị treo
• Mặc định người xem biết alias của bạn: nếu bạn gõ gs, hãy nói rằng đó là git status

Kết luận

Một video demo terminal thành hay bại là ở độ dễ đọc. Để chữ to, chọn giao diện tương phản cao, dọn gọn prompt, chạy thử chuỗi lệnh, và dừng một nhịp trước mỗi lần bấm Enter. Sau đó dùng hiệu ứng zoom và tăng tốc trong trình chỉnh sửa để giữ sự chú ý ở đúng phần kết quả quan trọng. Làm được vậy, các video hướng dẫn dòng lệnh của bạn sẽ không còn là thứ người ta cố xem cho hết, mà là thứ người ta mở terminal lên làm theo.