search

hplgit / doconce

Lightweight markup language - document once, include anywhere
http://hplgit.github.io/doconce/doc/web/index.html
Other
312 stars 60 forks source link

bibliography from BibTeX #125

Closed ricopicone closed 6 years ago

ricopicone commented 7 years ago

I don't know the reason for using publish instead of BibTeX format for the bibliography, but I'm having difficulty getting even the most minimal BibTeX document to convert to publish format. I save a file doc.bib with contents

@book{Larson2013,
    Author = {Larson, M.G. and Bengzon, F.},
    Publisher = {Springer Berlin Heidelberg},
    Series = {Texts in Computational Science and Engineering},
    Title = {The Finite Element Method: Theory, Implementation, and Applications},
    Year = {2013}}

When I run publish import doc.bib I am told every attribute is missing (e.g. author, year, etc.).

I'm hoping someone can help me get this most basic example working. However, I'd also like to understand why Doconce is relying on publish, which seems to be a package in need of further development and maturity (I could be wrong?). Thanks!

ricopicone commented 7 years ago

It turns out that the capital letters that my BibTeX database manager BibDesk uses for the first letter of each key is the problem. That leaves my second question (why publish?) and generates a new one: is there a recommended BibTeX database manager for macOS that's more compatible with publish? Thanks!

ricopicone commented 7 years ago

It looks like Mendeley uses lowercase keys. I'll miss BibDesk's simplicity, but I'm willing to make the switch for now. Still, I'm curious about why Publish is integral to Doconce.

KGHustad commented 7 years ago

publish is very (perhaps too) strict about the format of the .bib file. I don't think there's any good reason to why it can't be more tolerant.

publish has the advantage of being a pure Python package, and we also have influence over the project with the abiilty to get changes incorporated fairly quickly if needed.

ricopicone commented 7 years ago

Thanks for the explanation, @KGHustad! It's not a big deal, but I think it's a bit of a barrier to getting started with Doconce. It's not surprising that a package trying to do so much has a few strict requirements.