top | item 28048880

Emacs' org-mode gets citation support

234 points| NeutralForest | 4 years ago |blog.tecosaur.com | reply

64 comments

order
[+] ljm|4 years ago|reply
The stuff you can do with emacs, which is around 50 years old now, is still phenomenal, and it's still under active development to provide all manners of features that make emacs an immensely powerful and expressive lisp machine.

The only reason I haven't got into org-mode is because of the context switch and the fact that I'll spend more time figuring how to organise my thoughts.

But emacs is still my daily driver for everything I work with but typescript, so far. It's the most seductive technology I've ever had the pleasure of working with.

[+] macintux|4 years ago|reply
I’ve recently switched to org-mode, and the nice thing is you really don’t have to dive into the deep end. The full scope is enormous, but all you really need to use is basic markup, at least for typically notetaking. You can add more features over time if/when you need them.
[+] hankmander|4 years ago|reply
I use tide-mode for TS. It's great together with LSP!
[+] Scarblac|4 years ago|reply
Why not Typescript? I use it for that every day.
[+] westurner|4 years ago|reply
FWIW, Jupyter-book handles Citations and bibliographies with sphinxcontrib-bibtex: https://jupyterbook.org/content/citations.html

Some notes about Zotero and Schema.org RDFa for publishing [CSL with citeproc] citations: references of Linked Data resources in a graph, with URIs all: https://wrdrd.github.io/docs/tools/index#zotero-and-schema-o...

Compared to trying to parse beautifully typeset bibliographies in PDFs built from LaTeX with a Computer Modern font, search engines can more easily index e.g. https://schema.org/ScholarlyArticle linked data as RDFa, Microdata, or JSON-LD.

Scholarly search engines: Google Scholar, Semantic Scholar, Meta.org,

[+] reificator|4 years ago|reply
I keep everything in my life in plaintext, so I've been looking longingly at Org for several years now. There are three things standing in my way, from least to most important:

* I sometimes view on or want to share documents over sites like Github/Gitlab. If I share Markdown or even usually AsciiDoc, then the document is formatted appropriately even for people who are used to Word and rendered HTML. EDIT: Apparently this has changed since I last looked. Good news!

* I often edit from mobile devices, which almost certainly have no support for Org features. EDIT: There are apparently good org-specific editors.

* My desktop editor of choice is not and likely never will be emacs, so even with plugins that support Org it's always a hampered experience relative to what the format claims to offer.

It looks like it does everything I want and more, with all the little helpers you need overtop a plaintext format that's decent enough to read on its own. But I'm not changing my text editor just to use a single different format.

So instead I opt for the worst of all worlds and just use Markdown for everything because it's supported everywhere. It gets me headers, lists, code blocks, and sometimes checkboxes, and the rest I can handle ad-hoc.

EDIT: 5 responses in ~10 minutes, but 0 or neutral upvotes. I knew mentioning an editor preference was a mistake. Yes I have tried emacs for an extended period, yes I respect it, no I am not likely to use it myself.

[+] talentedcoin|4 years ago|reply
Yeesh. Please don’t complain about your poorly-researched laundry list of preferences not being upvoted. Come on, nobody cares what editor you yourself do or don’t use.
[+] mewfree|4 years ago|reply
* GitHub does render .org files just like Markdown!

* I've heard people of people being really happy with Orgzly on Android. I personally run Emacs on my Android phone through Termux. It works really well for me. Other solutions include using a SSH client to connect to a server running Emacs, or simply using GitHub directly on mobile web or their app if your notes are on GitHub.

* I've made the switch from Vim to Emacs (+ evil-mode) because of org-mode and have been extremely happy with it. It truly changed my life.

[+] simick|4 years ago|reply
It's unlikely I would ever move away from (Neo)Vim as my 'main' (i.e., programming) editor, as I find it much more intuitive and comfortable.

Instead, I think of Emacs + org-mode as a single, separate entity solely for to-do tracking and plain text hierarchical note taking. I find that the conveniences of org-mode for these specific tasks outweighs the otherwise unintuitive (from the perspective of my muscle memory) interface.

[+] cmiles74|4 years ago|reply
Aside from editing on mobile devices, I think Emacs isn't as hard to pick up as it once was. It's certainly not easy but tools like Spacemacs or Doom make it much simpler to get started and really limit the need to create and edit a complicated little library of your Elisp code.

http://spacemacs.org

https://github.com/hlissner/doom-emacs

[+] singingfish|4 years ago|reply
So I discovered recently that if you set up git-auto-commit mode with an org directory tree, then configure it to auto-push to gitlab on add/change, I get nicely formatted documents for free.

Later on I can convert them via pandoc to docx or markdown so they can end up in sharepoint/confluence and I only minimally have to touch either of those horror shows.

I was writing some docs yesterday, and my colleague who's always bagging me about my use of nothing but emacs and terminals complimented how nice it looked rendered in gitlab.

[+] jcpst|4 years ago|reply
Mobile: “Organice” is by far my favorite org mode editor on a mobile device. And it’s not even a native app, it’s a PWA. https://github.com/200ok-ch/organice

Like others have mentioned, you don’t have to switch to Emacs. 99% of what I do in Emacs is in org mode. You don’t have to stick to one editor. I use NeoVim when in a shell, Jetbrains when I’m at work, VS Code when trying out other languages…

[+] dannyobrien|4 years ago|reply
Not really for OP, but I've found a couple of really great iOS apps that work well with Emacs org-mode, Beorg[1] and FlatHabits[2]. They're actually both good apps in their own right, that use org-mode files as a backend for their features.

[1]: https://beorgapp.com/ [2]: https://flathabits.com/

[+] anschwa|4 years ago|reply
It sounds like you are looking for an excuse to give org-mode a chance.

Github will render org-mode documents now, so there's that.

Don't be afraid to give emacs a test drive, it's very possible to avoid getting sucked into the ecosystem and configuration if you aren't interested.

Either you'll decide it's what you've been looking for, or you prefer your current approach. Win-Win.

[+] joeman1000|4 years ago|reply
I’ve been a plain-text fiend for about the past 3 years: there is no other experience which can come near org-mode in emacs. Absolutely none. Markdown feels like a toy compared to org.
[+] alpaca128|4 years ago|reply
> I sometimes view on or want to share documents over sites like Github/Gitlab.

If nobody else edits the documents you could first export them to Markdown or HTML. Pandoc handles that reasonably well.

> My desktop editor of choice is not and likely never will be emacs

That only matters if you want to use the more interactive features of Emacs' org-mode. I only use Vim and still write everything in .org files. I just like how it's got a simple syntax and also enough flexibility to handle everything. I set up a keybinding that lets me convert the file to a PDF by calling Emacs in batch mode (unfortunately there's no other correct and complete parser).

In the end Markdown isn't bad, but I don't like how basically every platform and tool adds their own special flavor.

[+] BeetleB|4 years ago|reply
I think you'll always get a subpar experience if you try to use the org format without Emacs. I would not recommend org if Emacs is a deal breaker.
[+] kehrin|4 years ago|reply
I'd love to see Org to be picked up as a universal format. The overlap with LaTeX is probably too big though.
[+] sidpatil|4 years ago|reply
GitHub does render Org-mode documents to an extent. I haven't done a comparison with its Markdown rendering though.

There do exist mobile apps for Org-mode, but it's been a while since I've used them.

I agree with your third point and wish that Org-mode support was better in non-Emacs editors.

[+] mbrumlow|4 years ago|reply
> My desktop editor of choice is not and likely never will be emacs

That is a shame. Why?

[+] jpeloquin|4 years ago|reply
I remember reading posts on the emacs-orgmode mailing list back in 2014 about what citations should look like, and what backend should be used. At the time I was picking software to organize notes for my PhD thesis. There was some discussion of adding link handlers and packing citation metadata into regular links, like [[cite:key][citation metadata which would normally be display text]]. That sort of worked, although citations with multiple citation keys didn't fit easily into that approach. The final outcome looks great: (1) terse syntax that's easy to type and read but very flexible, (2) clear delimiters, and (3) option to use CSL styles, which are numerous and very easy to modify.
[+] da39a3ee|4 years ago|reply
Org-mode is amazing and has a lovely community. But I'm really not sure it's a good idea to use it for authoring LaTeX documents because that makes it impossible to work with others: however amazing org is, the fact is that it's Emacs and therefore only a small number of people use it. But if these citations are for personal blog posts etc I guess that's great, although personally I think I'd want to use the same tools for all my writing.
[+] aaronchall|4 years ago|reply
I found Orgmode was amazing for writing LaTeX documents - but I wasn't working with other people.

For a few classes I took recently, I used R-markdown. For one class's group paper we all collaborated with the same source file, I set up continuous integration on my server and hosted the result paper - which the other group members seemed to ignore, just looking at their local results, and at one point we had the numbers for numbered headings showing up twice in the document because one member didn't realize we were automatically adding them in.

For the other class, we had some group exams each over a weekend, and I found I had to organize everyone else's work, which was a lot of extra work. Some of them didn't understand they needed to give me a plain-text file with their contribution, and instead handed me MS Word with math, which caused some frustration for me. I emailed out the compiled document over and over, and we did essentially one-on-ones where they explained their work and I verified it, cleaned it up, and (re?)wrote most of it anyways.

If orgmode was my choice, I'd probably wind up doing the same, but you have to really behave like a type-A personality to lead the group, and stay type-A to get it done.

The takeaway I had is that if you take the lead and are willing to do most of the work you can use the tech you want to use and still be rather successful with a group.

But if you have to rely on them to do the work, they need to use technology they understand how to use.

[+] tmalsburg2|4 years ago|reply
I love org mode and use it for almost everything (note taking, agenda, to-do list, contacts, teaching materials, protocols, documentation, ...). The boost in productivity that it gives me is amazing and I do not expect to switch to another system in this life. However, I agree that org is not a great tool for writing serious documents intended for publication. First, the issue about collaboration that you mentioned. Just about 10% of my collaborators use Emacs, and even those people aren't serious users of org mode. But even when I'm writing alone, I really do need the power of LaTeX in the vast majority of cases. Org allows embedding LaTeX (behind the scenes LaTeX is a stepping stone on the path to PDF), but if I end up littering my org document with LaTeX macros anyway, I can just as well use straight LaTeX and org doesn't really buy me anything. It just adds another level of complexity to common authoring workflows. I also often use literate programming techniques in my articles, and Knitr (LaTeX' solution) is considerably more powerful and reliable than org's Babel system.
[+] solaceb|4 years ago|reply
I'm currently researching ways to integrate org-mode based citation structures with more commonly used tools such as Zotero, and apparently it's possible to make them talk nicely? The linked article states:

> Zotero is a good option, and if you’re using it it’s quite easy to use it with Org Cite. Out of the box, you can tell it to export your library, or parts of it, to a .bib file and automatically keep it in sync. I’d recommend installing the Better BibTeX extension though.

A non-technical friend and myself are looking into creating a blog for discussing issues related to health care, hence my interest on this front. Hopefully it's straightforward (famous last words)!

[+] AlanYx|4 years ago|reply
Does anyone know what software the author uses to prepare Figures 1 and 2 (the figures showing the syntax, with colored labels)?
[+] jpeloquin|4 years ago|reply
Not 100% sure, but: (1) the arrow caps look like some that are available in Inkscape and (2) the SVG's XML has a bunch of inkscape-namespaced tags, so it was probably drawn in Inkscape.

Edit: Cross-posted with uallo. Leaving it up anyway.

[+] moonox235|4 years ago|reply
Org Mode is able to spawn a separate Emacs process to do the job. I'm not smart enough to make that work. If the developers can lower the barrier to entry to that feature it would mean for me to not have to wait for the end of the export to pdf/html/etc run and keep on editing.