Nicolas Goaziou <n.goaz...@gmail.com> writes: > I favor [cite:PROPERTIES] over [[cite:PROPERTIES]], because the latter > (link syntax) implies a (optional) description part. I don't think > a description is ever meaningful in citations.
I have been holding on to this for a while. Just typing it out as it comes to my mind. I favor the above syntax. I view Citations as closer to Footnotes. The syntax should parallels footnotes syntax. 1. PROPERTIES should be opaque to Org. It is a key or a list of keys possibly bibtex but Org doesn't take stand on how it looks like. 2. There will be a org-BACKEND-citation-reference. 3. There will be a org-BACKEND-bibliography. 2, 3 more likely with interface with respective citation processor (citation processor as opposed to a database) via CLI. Citation processor could be whatever org-exp-bibtex interfaces with right now. I also have some proof-of-concept - see zotcite - for zotero. 2, 3 will parallel footnote-reference and footnote-section callbacks in HTML backend. 4. Footnotes can be introduced with either fn: prefix or cite: prefix. There should be a way to put fn: and cite: in same enumeration context. There should be a way to put fn: and cite: in different enumeration context. The former case could be a degenerate mode where Org can transcode what is seen in the buffer where everything is footnotes. The latter case will result in Citations and Bibliography being generated by the above backend transcoders. 5. Citation definitions in Org buffer will be *ignored*. (It could be considered when the exporter works in a degenerate footnote only mode where plain text transcoding is resorted to because there is no suitable application available for the backend format.) Plain text citation definitions are only to help the author have a glimpse of what he is doing, it has only UI-value but no contents value. 6. There may be an advisory citation style - say APA, Chicago etc - which the backends may honor or ignore. I am not clear about: 1. How multiple keys are to be handled. 2. What prenotes or postnotes mean. 3. Chicago note style etc. I think the community should answer and articulate 1, 2, 3 clearly. With my proposal, there could be some minor changes in Footnotes normalization and some minor changes in existing transcoders. The Org syntax for citations should *at this point* in time should NOT make any assumptions about the Citation Database or the Citation Application. As far Org is concerned, there should be a way for Emacs to interact with these engines and have them return Citation Refernece and Citation Defintion contents in required backend format. --