barrysteyn / pelican_plugin-render_math

A plugin for the pelican blog to allow it render mathematics in Latex.
67 stars 25 forks source link

Unable to get the plugin working. #4

Closed devinberg closed 10 years ago

devinberg commented 10 years ago

I have been trying to get this plugin working. Is the install process really just copying the directory and adding 'render_math' to the plugins list?

My site Site code < Probably not helpful.

In my conf file:

# Plugins and their settings.
PLUGIN_PATH = 'pelican-plugins'
PLUGINS = ('sitemap', 'render_math', )
barrysteyn commented 10 years ago

Hi There

I am going to need a bit more than the above to determine what the problem. Perhaps give me a page that is not rendering and I can then look into it.

One quick thing: This plugin requires the latest version of Typogrify. I needed to change Typogrify in order to get it to play nicely, but I don't think the author adjusted the version number up correctly. No matter, just upgrade to the latest version and try again.

If that solves the problem, please can you report back to me (I will try put a message that warns the users). If not, then as I said in the beginning, I am going to need an example of a page that is not rendering correctly.

To answer your question that you posed in the beginning: Yes, the install process really is just ensuring that render_math is available to pelican as a plugin. No template alteration is needed.

As an aside: I just saw your site. When I was younger, I was torn between engineering and computer science. Comp sci won because I love pure Math, but I always felt that my engineering general knowledge really suffered. Oh well, that's just a rant.

devinberg commented 10 years ago

Ok, I see now. The instructions don't really make it seem like you need to have Typogrify installed. The way it is currently worded makes it sound like you are suggesting that there could be a problem if Typogrify is also installed. Not that Typogrify is a necessary requirement for this plugin to work. I might suggest making that more clear in the README.

It does work now that I have installed Typogrify 2.0.4. Thank you for your help.

barrysteyn commented 10 years ago

Hi

Awesome. Thanks for the feedback. Just to be sure - the plugin will work fine (or at least it should work fine) without Typogrify if you are not using it (i.e. if you have not set it to True in the settings). In this case, it will just ignore Typogrify and happily go on its way.

I can see in your config file that you do not have it set, so it should have been ignored. Please can you do me a favour then:

  1. Can you make sure that you are not using another config file where it is set to true?
  2. Can you maybe email me (barry.steyn@gmail.com) a screen shot of the problem before you installed Typogrfiy. By screenshot, I mean the error (if one was presented) during the compilation process.

With your feedback, I am going to use reflection to determine if I can use the version of Typogrify that is present.

devinberg commented 10 years ago

Ok, I do not have any other config files. Prior to installing Typogrify it was not giving me any errors. It just wasn't rendering the Latex in my document. I'm sorry that I don't have more information.

barrysteyn commented 10 years ago

Okay, I think this may be enough to go on. I will try removing Typogrify from my virtualenv and see the result.

Thanks, and if you have any feedback regarding the library in general, then please shout.

Also, needing Typogrify installed is definitely bug, so if I can reproduce this, I will make another issue and fix. Then perhaps you should get the latest version.

BTW: Enabling Typogrify is not a bad thing, it makes your site look nicer. In the past, my latex plugin (now renamed to Math) needed to have Typogrify set to False. This has been solved, so maybe try enable it for the whole site and see if you like it.

barrysteyn commented 10 years ago

Hi @devinberg

I am struggling to reproduce your issue - I have totally removed Typogrify, and removed any mention of it in my config (just like your config), and things work as expected.

Can I ask you to tell me what version of Python you are running, and in what environment (e.g. virtualenv). If you are not comfortable communicating on this public forum, please can you email me directly (barry.steyn@gmail.com), you will be helping the community out greatly by helping me to reproduce your issue.

I would also like you to give me any advice for improvement or features you would like to see.

devinberg commented 10 years ago

Versions

I don't actually run it in a virtualenv. It is entirely possible that I had done something wrong to screw it up somewhere else.