Zero to Emacs and Org-roam: a step-by-step guide on Windows 10
- [2020-06-23] Added chapter on Org-ref and ORB
- [2020-06-27] Added chapter on exporting to MS Word with citations and bibliography
- [2020-06-28] Added chapter on getting and setting up a spell checker (Hunspell)
- [2020-07-11] Added auto-install script and a section on how to use it
- [2020-07-18] Added chapter on
org-roam-serverincluding editing the Windows registry
- [2020-09-18] Added chapter on working with PDF files in Emacs with PDF-Tools, Org-noter, and ORB
Hi all, I took the liberty of creating a step-by-step guide for people new to Emacs. I have written this with Windows users with no Linux or programming background in mind, zero about Emacs.
I am hoping this will complement the big efforts @zaeph and the project have been putting in to create quality tutorial series (I’m really looking forward to it).
It will be great if you can let me know your thoughts – constructive critique, correction, feedback for improvement, etc. – I’ll think about a better way of publishing the content for readability. Take this as the first iteration…
Audience and purpose in mind
The audience I have had in mind are:
- New to Emacs
- Windows users (Emacs part should be useful for others, I hope)
- No programming or Linux background
- Looking to use Org-roam / Emacs to help write long-form material (essays / papers about life, humanities, or some qualitative social sciences, etc.) as opposed to math and programming
The guide aims to get you going real quick, starting with downloading Emacs with vanilla configuration (no Doom, no Spacemacs).
Even if you are already down the path of using a framework like Doom, I hope stepping back a little and actually finishing configuration from scratch will help you understand how things fit together – it’s a bit like DIY making stuff; completing one thing from start to finish seems to help you leap to the next level of understanding and confidence for some reason.
What is the outcome?
At the end of Chapter 4 (available now in my repo below), you can get from zero to this:
Where is it?
What’s in it?
Let me know how you go.
- Get Emacs for Windows
- Use Emacs to write some text (including copy & paste)
- Set up Org-roam (including sqlite3)
- Improve quality-of-life with your font, theme, and minimal select packages
- Some more quality-of-life improvements for your typography – font variations and line-spacing – and other things
- Set up Org-ref and Org-roam-bibtex (ORB)
- Export to MS Word
- Set up a spell checker (Hunspell, including how to get it)
I consider the following “extra” features because they require a certain level of “hacking the system”. I suggest that you selectively decide whether or not you would like to take on the challenges, depending on your familiarity wth the technical stuff on Windows.
- Set up
org-roam-server(incl. Windows registry)
- Work with PDF files in Emacs with PDF-Tools, Org-noter, and ORB
- (maybe) How to swap CapsLock with Ctrl
- (maybe) Export to PDF