Tôi có cần tạo một tệp css từ Pygments cho blog jekyll của mình, để cho phép đoạn mã đầy màu sắc không?

Question

Đây là lần đầu tiên tôi sử dụng Jekyll và Pygments. Nhưng tôi không biết cách chèn đoạn mã đầy màu sắc.

Tôi đã cài đặt thành công Pygments, làm theo các bước chính thức, với markdown như thế này:

{% highlight ruby %} 
def foo 
    puts 'foo' 
end 
{% endhighlight %} 

tôi xem mã nguồn html bao gồm các lớp học, tuy nhiên không có màu cho đoạn này.

Tôi có cần tạo một số tệp css từ Pygments và bao gồm chúng không? Và làm thế nào?

Answer 1

Bạn cần phải bao gồm syntax.css

Bạn có thể lấy mẫu từ repo của tôi https://github.com/madhur/madhur.github.com/blob/master/files/css/syntax.css

và sau đó tùy chỉnh nó theo chủ đề của bạn. Mỏ được tùy chỉnh cho nền tối.

Answer 2

Có, bạn cần phải cài đặt hoặc tạo lớp CSS để làm cho mã làm nổi bật Pygments hiển thị. Sau khi cài đặt Pygments, điều này có thể được thực hiện bằng cách chạy sau từ dòng lệnh:

pygmentize -S default -f html > pygments.css 

Điều này sẽ tạo ra một file pygments.css với mặc định trong thư mục hiện tại của bạn; pygments -L style sẽ liệt kê tất cả các kiểu có sẵn.

Bạn có thể di chuyển này vào cây HTML của bạn và gọi nó với một tương ứng:

<link rel="stylesheet" type="text/css" href="/path/to/pygments.css"> 

Hoặc, sao chép nội dung của pygments.css và đặt nó trong một style sheet hiện hành. Điều đó sẽ giúp bạn bắt đầu. Bạn có thể chỉnh sửa CSS từ đó để tùy chỉnh khi thích hợp.

---

Hai lưu ý:

1. Có thể bạn đã làm điều này, nhưng vì lợi ích của những người mới đến Jekyll và Pygments, bạn sẽ có lẽ cũng cần phải thêm pygments: true vào tệp _config.yml của bạn để giúp Pygments hoạt động. (Hoặc, chạy Jekyll với jekyll --pygments trong đó có tác dụng tương tự.)

2. Bản gốc Jekyll installation documentation là không phải là rất rõ ràng về cách để có được Pygments làm việc khi câu hỏi này được hỏi. Tôi đã thêm phần 'Sử dụng Pygments' kể từ đó để hy vọng giúp mọi thứ rõ ràng ở đó.