mfenner / jekyll-pandoc

Jekyll Pandoc markdown converter as Ruby gem
MIT License
82 stars 10 forks source link

Footnotes and References #13

Closed Hipomenes closed 6 years ago

Hipomenes commented 6 years ago

Hello there, I wonder if this project is still maintained... I just installed jekyll-pandoc successfully, using Pandoc 2.1 and modifying the _config.yam accordingly. I then build the site all all seems fine, but footnotes nor citepro references are not rendering at all in html.

What do you think might be the problem?

Best! d

i2000s commented 6 years ago

Have you set up the bibtex source address correctly in your configure file? Like

markdown: Pandoc
pandoc:
  extensions:
    - bibliography: bibliography.bib
Hipomenes commented 6 years ago

Hi! Yes, I have the .bib path in place (not in a local folder, though). The funny thing is that the footnotes in standard Pandoc markdown are not working either.

Hipomenes commented 6 years ago

I figured out the problem. I was trying to run the jekyll-pandoc from Github Pages, and I just realized they don't support the use of plugins. I tried running a local server and it works.

i2000s commented 6 years ago

Good to hear you have figured it out! Two things I can suggest:

  1. Compile the site in your local machine and then commit the generated files to the gh-pages branch on Github.

  2. Use Travic-CI to compile the site for you with plugin supports, which is what I do for my site.

Bests,

Qi

Hipomenes commented 6 years ago

Thanks so much for the tips! That's exactly what I needed!

One last thing. I did find that citepro references are still not rendering, even though I have the right path in the _config file. Should I keep a .bib file locally? Or what could be the issue?

i2000s commented 6 years ago

Your .bib file should be in the directory you defined. The rendered static site should have the html included in your pages, and hence don't require a local file there. I don't know if this is the solution, but make sure you have both pandoc and pandoc-citeproc installed on your system. On Ubuntu, for example, you might want to try

sudo apt-get install pandoc pandoc-citeproc

Before 2014, pandoc-citeproc is not a separated package, but now it's required.

If this is no the issue, maybe others can step in and help you in solving the problem.

i2000s commented 6 years ago

@mfenner

Hipomenes commented 6 years ago

When using Pandoc locally, I've never invoked pandoc-citeproc, I just specify a .bib and csl file. Should it be different here?

i2000s commented 6 years ago

I think they should always be the same. I am not sure what's happening in your case...

Hipomenes commented 6 years ago

Issue fix. The problem was with indentation in extensions, ups!