Eisvogel là một mẫu LaTeX mạnh mẽ cho pandoc, giúp bạn dễ dàng chuyển đổi tệp Markdown thành tài liệu PDF hoặc LaTeX chuyên nghiệp. Hướng dẫn này sẽ dẫn dắt bạn qua quy trình hoàn chỉnh từ cài đặt đến tạo PDF đầu tiên, ngay cả người mới bắt đầu cũng có thể hoàn thành mọi thao tác trong vòng 10 phút.

Chuẩn bị: Cài đặt các công cụ cần thiết

Trước khi sử dụng mẫu Eisvogel, hãy đảm bảo hệ thống đã cài đặt các công cụ sau:

• pandoc: Công cụ cốt lõi để chuyển đổi tài liệu
• Bản phát hành LaTeX: Đề xuất sử dụng TeX Live hoặc MiKTeX
• Git: Dùng để lấy mã nguồn mẫu

Câu lệnh cài đặt mẫu (hệ thống Linux)

# Cài đặt pandoc
sudo apt-get install pandoc

# Cài đặt gói cơ bản TeX Live
sudo apt-get install texlive-latex-base texlive-fonts-recommended texlive-fonts-extra texlive-latex-extra

Lấy mẫu Eisvogel

Sử dụng Git để sao chép kho lưu trữ dự án về máy cục bộ:

git clone https://gitcode.com/gh_mirrors/pa/pandoc-latex-template
cd pandoc-latex-template

Các tệp cốt lõi của mẫu nằm trong thư mục template-multi-file/, bao gồm nhiều tệp mô-đun LaTeX như:

• eisvogel.latex: Tệp mẫu chính
• font-settings.latex: Cấu hình phông chữ
• hypersetup.latex: Cài đặt liên kết siêu kết nối

Tạo tài liệu PDF đầu tiên nhanh chóng

1. Chuẩn bị tệp Markdown

Dự án cung cấp nhiều ví dụ, chúng ta sẽ sử dụng ví dụ cơ bản:

cd examples/basic-example

Tệp document.md trong thư mục này là ví dụ về tệp Markdown chứa văn bản, khối mã công thức và danh sách.

2. Thực thi lệnh chuyển đổi

Sử dụng lệnh sau để chuyển đổi Markdown thành PDF:

pandoc document.md -o ketqua.pdf --template ../template-multi-file/eisvogel.latex --pdf-engine=xelatex

3. Xem kết quả đã tạo

Sau khi chuyển đổi, tệp ketqua.pdf sẽ được tạo trong thư mục hiện tại. Mở tệp để xem hiệu quả trình bày chuyên nghiệp, bao gồm tiêu đề, nội dung chính, mã được tô sáng và công thức toán học:

Tùy chỉnh trang tiêu đề

Eisvogel cung cấp nhiều kiểu trang tiêu đề, mặc định trang tiêu đề đơn giản nhưng tinh tế, chứa tiêu đề, phụ đề, tác giả và ngày tháng:

Để tùy chỉnh trang tiêu đề, bạn có thể thêm cấu hình trong phần YAML metadata của tệp Markdown:

---
tieude: "Tiêu đề tài liệu của tôi"
phude: "Đây là phần phụ đề"
tacgia: "Tên tác giả"
ngay: "2023-10-01"
trangbia: true
maubia: "3498db"
mauchu: "ffffff"
---

Hỗ trợ tài liệu đa ngôn ngữ

Mẫu Eisvogel hỗ trợ tốt nhiều ngôn ngữ, bao gồm tiếng Trung, tiếng Nhật, tiếng Đức, v.v. Dưới đây là hiệu quả hiển thị tài liệu tiếng Trung:

Khi tạo PDF tiếng Trung, hãy đảm bảo bản phát hành LaTeX đã cài đặt gói phông chữ tương ứng và chỉ định phông chữ Trung Quốc trong lệnh chuyển đổi:

pandoc document.md -o ketqua.pdf --template ../template-multi-file/eisvogel.latex --pdf-engine=xelatex -V CJKmainfont="SimSun"

Khám phá thêm ví dụ

Thư mục examples/ trong dự án cung cấp nhiều ví dụ về các tình huống sử dụng, bao gồm:

• code-blocks-listings/: Trình bày khối mã được tô sáng
• images-and-tables/: Bố cục hình ảnh và bảng biểu
• columns/: Bố cục nhiều cột
• watermark/: Thêm hiệu ứng dấu nước

Bằng cách nghiên cứu các ví dụ này, bạn có thể nhanh chóng nắm vững các tính năng nâng cao của Eisvogel.

Kết luận

Qua hướng dẫn này, bạn đã tìm hiểu về phương pháp sử dụng cơ bản của mẫu Eisvogel. Từ cài đặt công cụ đến tạo PDF đầu tiên, toàn bộ quy trình chỉ mất 10 phút. Điểm mạnh của Eisvogel nằm ở khả năng tùy chỉnh cao và hiệu quả trình bày chuyên nghiệp, dù là tài liệu học thuật, tài liệu kỹ thuật hay bài thuyết trình, đều có thể đáp ứng nhu cầu của bạn.

Bắt đầu ngay và thử nghiệm tạo tài liệu PDF đầu tiên của bạn bằng Eisvogel!