¿Necesito generar un archivo css de Pygments para mi blog jekyll, para habilitar el colorido fragmento de código?

Question

Esta es la primera vez que uso Jekyll y Pygments. Pero no sé cómo insertar un fragmento de código colorido.

He instalado con éxito Pygments, siguiendo los pasos oficiales, con la reducción del precio de esta manera:

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

que ver el código fuente HTML que incluye las clases, sin embargo no hay color para el este fragmento.

¿Necesito generar algunos archivos CSS de Pygments e incluirlos? ¿Y cómo?

Answer 1

Es necesario incluir syntax.css

Usted puede tomar la muestra de mi repo https://github.com/madhur/madhur.github.com/blob/master/files/css/syntax.css

y luego personalizarlo de acuerdo a su tema. El mío está personalizado para fondos oscuros.

Answer 2

Sí, necesita instalar o crear clases de CSS para hacer que el código resalte el trabajo Pygments sea visible. Después de instalar Pygments, esto se puede hacer mediante la ejecución del siguiente desde la línea de comandos:

pygmentize -S default -f html > pygments.css 

Esto creará un archivo pygments.css con el valor por defecto en el directorio actual; pygments -L style listará todos los estilos disponibles.

Usted puede mover esto en su árbol de HTML y llamarlo con un correspondiente:

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

O, copiar el contenido de pygments.css y colocarlo en una hoja de estilos existente. Eso le ayudará a empezar. Puede editar el CSS desde allí para personalizarlo según corresponda.

---

Dos notas:

1. Probablemente ya has hecho esto, pero en beneficio de las personas que son nuevos en Jekyll y Pygments, es probable que también hay que añadir pygments: true en su archivo _config.yml para que Pygments funcione. (O, Jekyll correr con jekyll --pygments que tiene el mismo efecto.)

2. Jekyll installation documentation El original no era muy clara sobre cómo llegar Pygments de funcionar cuando se hizo esta pregunta. Agregué la sección 'Uso de Pygments' desde entonces para ayudar a aclarar las cosas allí también.