Giới thiệu

Sau gần một năm phát triển, HeyTeX đã có những bước "lột xác" vượt bậc, từ một công cụ biên soạn LaTeX trực tuyến đơn giản trở thành một hệ sinh thái hoàn chỉnh cho việc tạo tài liệu khoa học chuyên nghiệp. Phiên bản mới không chỉ hỗ trợ LaTeX mà còn tích hợp Typst - hệ thống sắp chữ hiện đại, mang đến trải nghiệm biên tập giống Visual Studio Code ngay trên trình duyệt.

HeyTeX 2.0 là sự kết hợp ăn ý của:

- 🚀 Dual-Engine: LaTeX (server-side) & Typst (client-side WebAssembly)

- 🎨 Giao diện hiện đại: Dark/Light theme, VS Code-like experience

- 📋 Template Gallery: 14+ mẫu tài liệu chuyên nghiệp

- 🤝 Real-time Collaboration: Làm việc nhóm đồng thời

- 👤 User Management: Profile, statistics, admin panel

1. Những thay đổi lớn so với phiên bản cũ

1.1. Từ LaTeX-only đến Dual-Engine

Phiên bản đầu tiên của HeyTeX chỉ hỗ trợ LaTeX, biên dịch trên server, có giao diện đơn giản, chức năng cơ bản, bao gồm biên dịch và hợp tác, chủ yếu là các văn bản ngắn, bài viết ngắn, thường chỉ gói gọn trong một file tex. Lúc đó HeyTeX cũng cho phép chèn hình ảnh, tuy vậy cách làm khá khó khăn cho người dùng mới. HeyTeX 2.0 giờ đây hỗ trợ cả LaTeX và Typst, trong đó LaTeX được biên dịch ngay trên server với TeXLive đầy đủ, giúp biên tập và biên dịch được các văn bản dài, sách, tài liệu, dự án một cách nhanh chóng. Đối với Typst có đặc điểm gọn nhẹ, nhanh, HeyTeX cho phép biên dịch ngay tại máy tính của bạn với WebAssembly, chạy cực nhanh, biên dịch nhanh như chớp (chỉ có lần đầu biên dịch là chậm hơn, do tải bộ biên dịch từ server tới máy của người dùng). Hiển nhiên, người dùng tự do chọn engine phù hợp với nhu cầu. Chúng tôi đề xuất bạn chọn LaTeX trước, rồi Typst sau.

HeyTeX hỗ trợ LaTeX và Typst

1.2. Giao diện lột xác hoàn toàn

Monaco Editor - một giao diện biên tập hiện đại, đã được tích hợp hoàn chỉnh:

- ✨ Syntax highlighting (nhấn mạnh cú pháp lệnh) cho cả LaTeX và Typst, giao diện biên tập đa màu sắc, dễ nhận ra cấu trúc lệnh, cấu trúc văn bản.

- 🔍 IntelliSense và auto-completion thông minh, cho phép người dùng có gợi ý khi biên soạn mã.

- 🎨 Dark/Light theme có thể chuyển đổi dễ dàng giữa hai chủ đề tối - sáng.

- 📏 Split view với PDF preview tích hợp, có thể thu nhỏ, phục hồi dễ dàng các khung để tập trung vào duyệt danh sách file, biên tập mã hay xem PDF.

- ⚡ SyncTeX: Click đúp PDF để nhảy đến code tương ứng.

1.3. Hệ thống Template chuyên nghiệp

Một trong những cải tiến lớn nhất là Template Gallery giống giao diện Finder (của macOS):

LaTeX Templates (7 mẫu):

- 📄 Blank Document: Tài liệu trống để bắt đầu

- 👔 CV/Resume: CV (Curriculum Vitate - Lý lịch khoa học) hiện đại với modernCV

- 🎓 Academic CV: CV khoa học với danh sách công bố, grants, awards

- ✉️ Formal Letter: Thư chính thức / trang trọng

- 📝 Article: Bài báo với references.bib

- 📰 Research Paper: Bài báo khoa học định dạng IEEE

- 🖼️ Poster: Poster hội nghị với tikzposter

- 📚 Report: Báo cáo kỹ thuật với table of contents

Typst Templates (7 mẫu): Tương tự LaTeX nhưng với cú pháp Typst hiện đại. Đặc trưng của Typst là biên dịch nhanh như chớp (hơn 10-50 lần so với biên dịch LaTeX). Typst cũng có cú pháp dễ học, dễ đọc hơn LaTeX.
Cách sử dụng Template: Click “Tạo dự án mới” → Chọn Engine (Typst hoặc LaTeX) ở cột trái → Chọn Template phù hợp ở cột phải → Nhập tên dự án và bắt đầu.

Người dùng không còn phải bắt đầu từ trang trắng! Mọi template đều có cấu trúc hoàn chỉnh, bạn chỉ cần điền, chỉnh sửa nội dung cho phù hợp rồi biên dịch.

2. Tính năng mới nổi bật

2.1. Profile & Statistics

Mỗi người dùng giờ có trang Profile đầy đủ với hai tab Profile và Password, khi bạn click vào Avatar của bạn (ở góc trên bên phải), một hộp thoại thông tin cá nhân sẽ xuất hiện, gồm có 2 tab có thể chuyển qua lại dễ dàng: Profile (Thông tin) và Password (Đổi mật khẩu).

Tab "Profile":

- 📊 Thống kê dự án: Số dự án LaTeX/Typst mà bạn đang có

- 📅 Thông tin tài khoản: Ngày đăng ký, lần đăng nhập cuối vào HeyTeX

- 🖼️ Avatar: Upload ảnh đại diện, khuyến khích ảnh cận mặt.

- ✏️ Chỉnh sửa: Tên, email

Tab "Password":

- 🔐 Đổi mật khẩu an toàn

- Yêu cầu xác thực mật khẩu cũ

- Validation (xác minh) mật khẩu mới (tối thiểu 6 ký tự)

2.2. Quản trị các dự án của bạn

Với mỗi user, HeyTeX 2.0 có Dashboard chuyên nghiệp:

Dashboard View: Cho phép hiển thị các dự án TeX và Typst của bạn ở dạng Card và dạng List, và bạn dễ dàng chuyển đổi qua lại giữa hai dạng này.

Project Management: Với mỗi dự án, bạn có thể xem thông tin, tải về máy, tải về pdf, chia sẻ dự án. Hãy rê nhẹ chuột tới dự án đó và các công cụ đó sẽ hiện lên.

Thông tin một dự án

2.3. Real-time Collaboration nâng cao

Tính năng cộng tác biên tập đã được có từ HeyTeX 1.0, nhưng giờ đây đã được cải tiến đáng kể:

CRDT với Yjs:

- Đồng bộ thời gian thực không xung đột

- Hiển thị con trỏ của người khác

- Tự động merge changes (trộn các thay đổi)

WebSocket:

- Kết nối ổn định với auto-reconnect

- Độ trễ thấp (<100ms trong cùng mạng)

Project Collaborators:

- Bạn có thể thêm thành viên cho dự án với 1 trong 2 vai trò: Viewer (chỉ xem) hoặc Editor (biên tập).

3. File Management

Cấu trúc thư mục:

- 📁 Tạo folders và subfolders

- 📄 Cho phép nhiều files trong một project

- 🖼️ Upload images (PNG, JPG, SVG)

- 📚 Upload .bib files cho references

- 🔗 Link files với relative paths

HeyTeX cho phép quản lý files/folders

Upload:

Cho phép tải lên một lúc hàng loạt files, folders rất tiện lợi. Khi bạn bấm vào nút upload, một hộp thoại Upload hiện ra và cho phép bạn kéo thả files / folder vào trong hộp thoại để tải lên.

Tính năng upload của HeyTeX

4. Hướng dẫn sử dụng nhanh HeyTeX

4.1. Đăng ký và đăng nhập

1. Truy cập HeyTeX tại: https://heytex.truyenthong.edu.vn

2. Click “Đăng ký” và điền thông tin:

   - Email (dùng email thật để reset password)

   - Tên đầy đủ

   - Mật khẩu (tối thiểu 6 ký tự)

3. Đăng nhập và bắt đầu

4.2. Tạo dự án đầu tiên

Cách 1: Dùng Template (Khuyên dùng): Click “+ Tạo dự án mới” → Chọn Engine: Typst (dễ học) hoặc LaTeX (mạnh mẽ) → Chọn Template: CV, Letter, Article, v.v. → Nhập tên dự án → Click “Tạo dự án”.

Cách 2: Blank Document: Chọn template “Blank Document” → Bắt đầu viết từ đầu.

4.3. Biên tập và biên dịch

Bước 1: Viết nội dung

- Gõ code LaTeX hoặc Typst vào editor

- Sử dụng IntelliSense để gợi ý lệnh

- Thêm images bằng cách upload vào file tree

Bước 2: Biên dịch

- Click nút “Compile” (hoặc `Ctrl/Cmd + B`)

- Typst: Biên dịch ngay lập tức (< 1 giây)

- LaTeX: Biên dịch trên server (3-10 giây)

Bước 3: Xem kết quả

- PDF hiển thị ngay bên cạnh

- Sử dụng SyncTeX để navigate (chỉ LaTeX)

Bước 4: Download

- Click "Download PDF" để lưu về máy

4.4. Làm việc nhóm

Thêm Collaborators: Mở project muốn chia sẻ → Click “Share” hoặc “Collaborators” → Nhập email người muốn mời → Chọn role: VIEWER (chỉ xem) hoặc EDITOR (chỉnh sửa) → Click “Invite”.

5. So sánh LaTeX vs Typst

5.1. Khi nào dùng LaTeX?

Ưu điểm:

- ✅ Hệ sinh thái packages cực lớn (CTAN)

- ✅ Templates đã tồn tại cho mọi thứ

- ✅ Tương thích với journals, conferences

- ✅ SyncTeX hỗ trợ tốt

- ✅ BibTeX/BibLaTeX cho references

Nhược điểm:

- ❌ Cú pháp phức tạp, khó học

- ❌ Error messages khó hiểu

- ❌ Biên dịch chậm (đặc biệt tài liệu lớn)

Dùng cho: Papers submit lên conferences/journals; Thesis, dissertation; Sách chuyên ngành; Tài liệu cần packages đặc biệt.

5.2. Khi nào dùng Typst?

Ưu điểm:

- ✅ Cú pháp đơn giản, dễ học

- ✅ Error messages rõ ràng

- ✅ Biên dịch cực nhanh (WebAssembly)

- ✅ Live preview không lag

- ✅ Scripting với native syntax

Nhược điểm:

- ❌ Ecosystem còn nhỏ

- ❌ Chưa nhiều templates có sẵn

- ❌ Một số journals chưa chấp nhận

Dùng cho: Báo cáo cá nhân, bài tập; Notes, slides; CV, letter cá nhân; Documents cần compile nhanh; Người mới học muốn dễ tiếp cận.

6. Tips & Tricks

6.1. Keyboard Shortcuts hữu ích

Editor:

- `Ctrl/Cmd + S`: Save

- `Ctrl/Cmd + B`: Compile

- `Ctrl/Cmd + F`: Find

- `Ctrl/Cmd + H`: Replace

- `Ctrl/Cmd + /`: Comment/Uncomment

- `Alt + Up/Down`: Move line

- `Ctrl/Cmd + D`: Select next occurrence

Dashboard:

- `Ctrl/Cmd + K`: Focus search box

- `Enter`: Open selected project

6.2. Tối ưu workflow

1. Dùng Templates:

- Không bắt đầu từ blank

- Sửa template có sẵn nhanh hơn nhiều

2. Organize Files:

- Tạo folders cho images, chapters

- Dùng relative paths: `./images/fig1.png`

3. Save thường xuyên:

- `Ctrl/Cmd + S` mỗi vài phút

- HeyTeX có auto-save nhưng vẫn nên chủ động

4. Check errors:

- Đọc compile log khi có lỗi

- Lỗi thường ở dòng gần nhất vừa sửa

5. Collaborate smart:

- Chia nhỏ sections cho từng người

- Comment code để người khác hiểu

- Commit message rõ ràng (nếu dùng Git sau này)

6.3. Khắc phục lỗi thường gặp

LaTeX không compile:

- Kiểm tra `\usepackage{lmodern}` ở đầu file

- Đảm bảo `\begin{document}` có `\end{document}`

- Xem compile log để biết dòng lỗi

- Thử comment out từng phần để tìm lỗi

Typst không compile:

- Kiểm tra cú pháp: `#` cho functions, `*` cho bold

- Đảm bảo brackets `[]` và `()` đóng đúng

- Error message của Typst rất rõ, đọc kỹ

Image không hiển thị:

- Đảm bảo image đã upload

- Path phải đúng: `./images/fig1.png`

- LaTeX: không cần extension trong `\includegraphics{fig1}`

- Typst: cần full path: `image("./images/fig1.png")`

Collaborator không thấy changes:

- Refresh trang (F5)

- Kiểm tra kết nối internet

- Logout → Login lại

7. Kết luận

HeyTeX 2.0 đã thực sự "lột xác" từ một công cụ LaTeX đơn giản thành một hệ sinh thái biên tập tài liệu khoa học hoàn chỉnh. Với sự kết hợp của LaTeX truyền thống và Typst hiện đại, cùng với hàng loạt tính năng như Template Gallery, Real-time Collaboration, và Admin Panel, HeyTeX giờ đây là lựa chọn phù hợp cho:

- 🎓 Sinh viên: Viết báo cáo, luận văn

- 👨‍🏫 Giảng viên: Soạn tài liệu giảng, slides

- 🔬 Nhà nghiên cứu: Viết papers, posters

- 👔 Chuyên gia: Tạo CV, letters chuyên nghiệp

- 👥 Teams: Cộng tác viết tài liệu

Điều đặc biệt là HeyTeX hoàn toàn miễn phí, hỗ trợ tiếng Việt đầy đủ, và được phát triển bởi cộng đồng HeyTeX.

Hãy trải nghiệm HeyTeX 2.0 tại: https://heytex.truyenthong.edu.vn

Hỗ trợ và liên hệ

- Website: https://heytex.truyenthong.edu.vn

- GitHub: https://github.com/phucdhh/HeyTeX

- Nhóm HeyTeX: Tham gia

- Liên hệ developer: Nguyễn Đăng Minh Phúc

---------

© 2025-2026 HeyTeX. All rights reserved.  

Phát triển bởi Nguyễn Đăng Minh Phúc và cộng đồng HeyTeX.  

Licensed under AGPL-3.0.

#collaboration#heytex#latex#onlineeditor#typst