Skip to content
This repository has been archived by the owner on Mar 17, 2020. It is now read-only.

Allow reStructuredText configuration from _config.py #33

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

zsoldosp
Copy link
Contributor

@zsoldosp zsoldosp commented Feb 6, 2014

When writing posts with code snippets in rst format, e.g.:


---
title: Hello (Java) World

---

My first post, a sample Java program!

.. include::  ./snippets/HelloWorld.java
   :code: java

By default, docutils generates long pygment css class names [1], which are incompatible with the generated pygments css files [2], which use the short version.

This pull request demonstrates how to fix the concrete problem I'm having, but I think a generic approach to configure these settings from _config.py (blog.rst.syntax_highlight="short") would be a better solution.

So it's a pull request/pull request draft/feature suggestion - decide how do you want to handle it!

[1] http://docutils.sourceforge.net/docs/user/config.html#syntax-highlight
[2] http://pygments.org/docs/cmdline/#generating-styles

When writing posts with code snippets in rst format (e.g.:
**Java**

.. include::  ./snippets/HelloWorld.java
   :code: java
)

By default, docutils generates long css class names [1], which are incompatible with the generated pygments css files [2], which use the short version.

This pull request demonstrates how to fix the concrete problem I'm having, but I think a generic approach to configure these settings from _config (`blog.rst.syntax_highlight="short"`) would be a better solution.

So it's a pull request/pull request draft/feature suggestion - decide how do you want to handle it!


[1] http://docutils.sourceforge.net/docs/user/config.html#syntax-highlight
[2] http://pygments.org/docs/cmdline/#generating-styles
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant