search

asciidoctor / asciidoctor-bibtex

Add bibtex citation support for asciidoc documents
Other
69 stars 27 forks source link

Support for biblatex-like citation commands #90

Open languitar opened 2 years ago

languitar commented 2 years ago

I was looking for more lightweight alternatives for scientific writing than LaTeX and asciidoc sounds like a viable option. However, what is currently missing for me in asciidoctor-bibtex is something like the content citations commands known from biblatex like \citefullauthor or \citetitle. Would it be possible to add something like these to this package here?

jimisola commented 2 years ago

+1 I'm was just looking for the same thing. For comparison Natbib citation styles has: cite:, citep, citet, citep, citeauthor and citeyear.

Seems to be support for accessing these fields in bibtex-ruby. Therefore, guessing that it's a matter change to citation_macro.rb or? (not very familiar with Ruby - yet)

mojavelinux commented 2 years ago

The functionality could be matched, but it would still have to adhere to AsciiDoc syntax, meaning inline macros. AsciiDoc is not LaTeX and I don't want it to start morphing into it.

jimisola commented 2 years ago

Inline macros of course.

Not really following though with morphing. How do you mean? By using the same naming with exception for asterix () as in citet?

mojavelinux commented 2 years ago

All I'm pointing out is that the primary syntax element must be a macro (not \citetitle and the like). Beyond that, it can be enhanced to match 1-to-1 the features from its counterpart in LaTeX.

jimisola commented 1 year ago

@mojavelinux Writing my thesis now and it would be very useful to be able to cite titles as well. Is it a lot of work to implement? What about for someone that has not coded for AsciiDoctor and barely Ruby before?

mojavelinux commented 1 year ago

What about for someone that has not coded for AsciiDoctor and barely Ruby before?

There was a time when I had not written in Ruby. I picked up Asciidoctor and was maintaining it a few weeks later. I think Ruby is one of those programming languages that just makes sense and is easy to step into. But on top of that, there are hundreds of people in the chat, some of who would be willing to help you work through the code.

There are lots of examples of custom macros in the extensions lab to get you started. We tried to make writing a macro extension as simple as possible, at least the part of defining the macro. As for what it takes to implement the logic, well, that depends on how difficult the feature itself is to implement.

I would recommend creating a topic in the chat and talk through what you are doing. People will follow along and jump in when they have something to say.