# Workflow for working with PDFs

**URL:** <https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103>\
**Category:** Guides\
**Created:** [May 10, 2020, 7:15pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103 "2020-05-10T19:15:37Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![rgoswami](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/rgoswami/32/102_2.png) [@rgoswami](https://org-roam.discourse.group/u/rgoswami)\
**Post date:** [May 10, 2020, 7:15pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/1 "2020-05-10T19:15:37Z")

</div>

This is mostly related to ORB and org-ref. Described here:

> **[An Orgmode Note Workflow](https://rgoswami.me/posts/org-note-workflow/)**
>
> Background One of the main reasons to use orgmode is definitely to get a better note taking workflow. Closely related to blogging or writing, the ideal note workflow is one which lets you keep a bunch of throwaway ideas and also somehow have access...

---

<div class="post-metadata">

**Author:** ![zaeph](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/zaeph/32/764_2.png) [@zaeph](https://org-roam.discourse.group/u/zaeph)\
**Post date:** [May 10, 2020, 8:33pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/2 "2020-05-10T20:33:04Z")

</div>

Hi there.

Thank you for writing this. It’s a great article, and the way you present the tools is both informative and concise. I think it’d be great if we could feature it somewhere on OR/ORB.

Also, just a small thing: we’ve recently transferred the repos to an org on GitHub, and the [URL at the end of your ‘Notes’ section](https://rgoswami.me/posts/org-note-workflow/#notes) is no longer the right one. `zaeph/org-roam-bibtex` now points to my fork, and it should point to [`org-roam/org-roam-bibtex`](https://github.com/org-roam/org-roam-bibtex) instead.

---

<div class="post-metadata">

**Author:** ![rgoswami](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/rgoswami/32/102_2.png) [@rgoswami](https://org-roam.discourse.group/u/rgoswami)\
**Post date:** [May 10, 2020, 9:12pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/3 "2020-05-10T21:12:25Z")

</div>

Thanks zaeph! I just updated the post with the right links. I also realize I forgot to enable comments, so I have done that too 😄

I’d be super pleased to have it featured on the Readme or somewhere! 😊

---

<div class="post-metadata">

**Author:** ![zaeph](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/zaeph/32/764_2.png) [@zaeph](https://org-roam.discourse.group/u/zaeph)\
**Post date:** [May 10, 2020, 9:38pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/4 "2020-05-10T21:38:34Z")

</div>

> [@rgoswami](#):
>
> I’d be super pleased to have it featured on the Readme or somewhere!

I’ve created a [new section on ORB for articles](https://github.com/org-roam/org-roam-bibtex#articles), and I’ve included yours in the list. Thanks again!

---

<div class="post-metadata">

**Author:** ![jethro](https://avatars.discourse-cdn.com/v4/letter/j/b5a626/32.png) [@jethro](https://org-roam.discourse.group/u/jethro)\
**Post date:** [May 11, 2020, 4:33am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/5 "2020-05-11T04:33:52Z")

</div>

Nice write-up! Definitely covers some unfamiliar ground for me.

Quick question: what does Zotero provide over org-ref that makes you still use it?

---

<div class="post-metadata">

**Author:** ![zaeph](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/zaeph/32/764_2.png) [@zaeph](https://org-roam.discourse.group/u/zaeph)\
**Post date:** [May 11, 2020, 6:33am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/6 "2020-05-11T06:33:16Z")

</div>

Personally, I prefer using Zotero because, at the same time, it seemed to be the best way to create one-time quotes in different citing style. Since I work in both French and English, I needed to be able to switch between citing styles all the time, and having support for `.cls` files in Zotero made the difference.

I’m not sure if `org-ref` is able to do that right now, but it feels like implementing `.cls` support by working in the backend with a translator should be possible.

---

<div class="post-metadata">

**Author:** ![bruce](https://avatars.discourse-cdn.com/v4/letter/b/ccd318/32.png) [@bruce](https://org-roam.discourse.group/u/bruce)\
**Post date:** [May 11, 2020, 10:02am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/7 "2020-05-11T10:02:19Z")

</div>

> [@zaeph](#):
>
> I’m not sure if `org-ref` is able to do that right now, but it feels like implementing `.cls` support by working in the backend with a translator should be possible.

That’s CSL (Citation Style.Language). I’m actually it’s original creator 😉

Org-ref does have an csl-inspired elisp alternative, that they confusingly also call CSL.

Though I’ve not tried it yet, there’s also `citeproc-org`, which gives you a full CSL processor within org.

And the native org citation support (in the [cite-new git branch](https://code.orgmode.org/bzg/org-mode/src/wip-cite-new)) is built to allow different backends, including CSL-based ones like citeproc-org.

---

<div class="post-metadata">

**Author:** ![rgoswami](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/rgoswami/32/102_2.png) [@rgoswami](https://org-roam.discourse.group/u/rgoswami)\
**Post date:** [May 11, 2020, 11:29am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/8 "2020-05-11T11:29:15Z")

</div>

Thanks 🙂

About Zotero, well, for one thing, it does still facilitate mobile access; I get to store the pdfs on my pCloud instance, and access them on the go with [Zoo](https://play.google.com/store/apps/details?id=com.mickstarify.zooforzotero) on Android (there are other applications too). Also, the Zotero web connecter is fantastic, while browsing I get to save journal articles and even pdfs with a single click. Since I can also set it to use my University proxy, it downloads the full text in the background, and updates the bibliography file, so when I fire up emacs I have the full text and citations ready to go.

That’s much friendlier than using the `org-ref` interface IMHO, though all external bibliographic managers provide similar functionality (Mendeley or Jabref come to mind).

There’s also a SciHub auto downloader, for papers which are somehow not accessible…

---

<div class="post-metadata">

**Author:** ![zaeph](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/zaeph/32/764_2.png) [@zaeph](https://org-roam.discourse.group/u/zaeph)\
**Post date:** [May 11, 2020, 8:40pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/9 "2020-05-11T20:40:41Z")

</div>

> [@bruce](#):
>
> That’s CSL (Citation Style.Language). I’m actually it’s original creator

Hah, I didn’t know that it was you!

Sorry for the typo, I’ve always confused CSL with the `.cls` classes for LaTeX.

> [@bruce](#):
>
> And the native org citation support (in the [cite-new git branch](https://code.orgmode.org/bzg/org-mode/src/wip-cite-new)) is built to allow different backends, including CSL-based ones like citeproc-org.

I can’t wait to see this. It’d definitely be a boon for my workflow.

---

<div class="post-metadata">

**Author:** ![titaniumbones](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/titaniumbones/32/105_2.png) [@titaniumbones](https://org-roam.discourse.group/u/titaniumbones)\
**Post date:** [May 13, 2020, 2:04am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/10 "2020-05-13T02:04:17Z")

</div>

@zaeph @rgoswami, I should have searched longer before posting [about Zotero over here](https://org-roam.discourse.group/t/does-anyone-have-a-workflow-for-associating-notes-with-a-zotero-stored-pdf/112/2).

Can I ask more specifically, what it looks like when you caputre a reference to zotero and hten take notes on it/

So, e.g., for me, I have a set of tabs open in Firefox. Right now what I’m doing is:

- click on the Zotero button in the browser to save to bibliography.
- click on my bookmarklet to capture to roam. THe capture links to the web page only, not to the citekey.
- open the PDF and start taking notes. For now I am mostly copy-pasting; I miss highlighting in evince or pdf-view – I have a tiny elisp fragment that will extract highlights from a PDF, and ideally that would be part of my capture template I guess.
- get the filesystem path to the PDF
- add it as a link to the note

All of this is a bit more labourious than it should be, I think, and I’ wondering if you do something more efficient. Thanks!

---

<div class="post-metadata">

**Author:** ![rgoswami](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/rgoswami/32/102_2.png) [@rgoswami](https://org-roam.discourse.group/u/rgoswami)\
**Post date:** [May 13, 2020, 5:59am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/11 "2020-05-13T05:59:48Z")

</div>

Hi @titaniumbones. Right now my workflow is:

- Save to bibliography using the web connector (the Zotero button)
- If there is a website, I use the bookmarklet
- Otherwise I open a new note based on the general topic
- Cite using org-ref (as seen in the video in the post)
- Keep notes with org-ref (which has an ORB template to keep track of the file and integrate with org-noter).

A key aspect of this is that I use the org-noter/org-roam document to keep notes, instead of highlighting; this workflow does require working with the pdf only in emacs.

---

<div class="post-metadata">

**Author:** ![titaniumbones](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/titaniumbones/32/105_2.png) [@titaniumbones](https://org-roam.discourse.group/u/titaniumbones)\
**Post date:** [May 13, 2020, 4:10pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/12 "2020-05-13T16:10:19Z")

</div>

thanks @rgoswami that’s helpful and makes sense. I may have to look into org-noter, which up to now I have not tried to use. Would be great if the manual addition of the org-ref citation weren’t necessary, but that maybe asking a lot of this workflow.

---

<div class="post-metadata">

**Author:** ![cobblepot](https://avatars.discourse-cdn.com/v4/letter/c/dec6dc/32.png) [@cobblepot](https://org-roam.discourse.group/u/cobblepot)\
**Post date:** [May 15, 2020, 3:52am UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/13 "2020-05-15T03:52:23Z")

</div>

@titaniumbones - you should definitely check out Zotfile, which makes it very easy to highlight/annotate a pdf and extract the info into a nicely formatted Zotero note with links to the exact location of the original quotes/comments.

---

<div class="post-metadata">

**Author:** ![ianjones](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/ianjones/32/133_2.png) [@ianjones](https://org-roam.discourse.group/u/ianjones)\
**Post date:** [May 18, 2020, 2:41pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/14 "2020-05-18T14:41:32Z")

</div>

Hey Y’all,

Im trying to get this workflow going. I have the packages installed and can view pdfs inside of emacs… Im using pdf-view (not sure if this is the correct package).

When I open a pdf with helm-bibtex, It opens the pdf in a new frame and doesnt open the notes panel beside the pdf. I want the pdf to just open in a new window with my notes right beside it.

Im not sure how to link notes to a specific spot in the pdf. Is there a command Im missing?

Here are my dotfiles if that helps:

> **[theianjones/dotfiles](https://github.com/theianjones/dotfiles/tree/master/.doom.d)**
>
> Contribute to theianjones/dotfiles development by creating an account on GitHub.

@rgoswami I loved your tutorial, thanks for writing it!

Something important to note is that I’m fairly new to emacs so im not sure which package isnt doing what it should be. I think its org-noter that is what opens the pdf in a new frame?

---

<div class="post-metadata">

**Author:** ![mancub](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/mancub/32/347_2.png) [@mancub](https://org-roam.discourse.group/u/mancub)\
**Post date:** [May 18, 2020, 3:26pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/15 "2020-05-18T15:26:55Z")

</div>

Hey Ian,

so here is my workflow for pdfs.

I start with helm-bibtex to and find the pdf - instead of opening it I choose edit/add notes.

Once a capture buffer opens up for the notes - I invoke org-noter (M-x org-noter) - this opens up the PDF and the note capture buffer on the side in a separate window.

I save the note after I am done and close the window. Go back to the main window - and type C-c C-C to file the note ( the notes I have taken have been copied already to the caputure buffer).

I hope this helps!

---

<div class="post-metadata">

**Author:** ![ianjones](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/ianjones/32/133_2.png) [@ianjones](https://org-roam.discourse.group/u/ianjones)\
**Post date:** [May 18, 2020, 3:33pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/16 "2020-05-18T15:33:20Z")

</div>

The text annotations that I take dont show up in my capture buffer. I press `C-c C-a t` and a mini buffer pops up to take the note… then `C-c C-c` to capture it but after that, there is only an icon on the pdf… the note doesnt get saved to the file that helm bibtex created.

Any ideas?

Heres what Im talking about

 ![Image 2020-05-18 at 11.33.52 AM](https://global.discourse-cdn.com/free1/uploads/orgroam/original/1X/62c4675cbf6effa329b7ad36fc1d6e9e2d8234ce.jpeg)

---

<div class="post-metadata">

**Author:** ![ianjones](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/ianjones/32/133_2.png) [@ianjones](https://org-roam.discourse.group/u/ianjones)\
**Post date:** [May 18, 2020, 5:00pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/17 "2020-05-18T17:00:35Z")

</div>

@zaeph helped me out in the slack channel. Cross posting it here:

I didnt understand that adding annotations to the pdf and adding a note via org-noter were different. I was looking for M-x org-noter-insert-note.

---

<div class="post-metadata">

**Author:** ![scotto](https://avatars.discourse-cdn.com/v4/letter/s/b38774/32.png) [@scotto](https://org-roam.discourse.group/u/scotto)\
**Post date:** [May 31, 2020, 9:16pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/18 "2020-05-31T21:16:44Z")

</div>

@rgoswami, Great post.

I don’t see it here, but do you also somehow also version control your Zotero database?

In my current system, I have one gigantic org file and one gigantic .bib file, both in git – and git has actually saved me more often on the .bib file. I’ve considered using Zotero and then version controlling an exported bib file, but that has problems. If I could “git” Zotero, I’d avoid them.

---

<div class="post-metadata">

**Author:** ![bepolymathe](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/bepolymathe/32/688_2.png) [@bepolymathe](https://org-roam.discourse.group/u/bepolymathe)\
**Post date:** [June 5, 2020, 8:03pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/19 "2020-06-05T20:03:22Z")

</div>

> [@cobblepot](#):
>
> you should definitely check out Zotfile, which makes it very easy to highlight/annotate a pdf and extract the info into a nicely formatted Zotero note with links to the exact location of the original quotes/comments.

But it’s difficult to access from emacs no ?

---

<div class="post-metadata">

**Author:** ![bepolymathe](https://yyz2.discourse-cdn.com/free1/user_avatar/org-roam.discourse.group/bepolymathe/32/688_2.png) [@bepolymathe](https://org-roam.discourse.group/u/bepolymathe)\
**Post date:** [June 5, 2020, 8:10pm UTC](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103/20 "2020-06-05T20:10:39Z")

</div>

What’s your `org-noter` config ? For me

```
 (use-package org-noter
   :config
   (setq org-noter-always-create-frame t
         org-noter-separate-notes-from-heading t
         org-noter-default-heading-title "Page $p$"
         org-noter-auto-save-last-location t
         org-noter-notes-search-path '("~/Org/roam")
         org-noter-separate-notes-from-heading t
         org-noter-doc-property-in-notes t
         ))
```

[Next page](https://org-roam.discourse.group/t/workflow-for-working-with-pdfs/103.md?page=2)
