An Org Template for Meeting Minutes

When I was a Unix n00b, one of the things that really impressed me was the format of the Bell Labs technical memoranda. I especially liked the cover sheet, which captured all the vital information. It was, of course, generated by a set of Troff macros,

These days, most companies that have a standardized format for such things probably implement it as a Word style sheet. If you share Irreal’s sensibilities, that’s horrifying but, as usual, Emacs comes to the rescue.

Matthias David has an excellent package that uses Org mode to do the same thing for meeting notes. If you’re tasked with taking notes during meetings or if you’re, say, the secretary of some club or organization, this package produces excellent looking reports from Org source. You specify some headings that have the required information, write the report, and Org exports it as a beautifully formatted report.

Follow the link to see an example of the final result and the header options that control it. You can even include a PNG of a logo. It is, except for the subject matter, an exact analog to the Bell Lab’s technical memo. An interesting, if easy, project would be to adopt it to technical memoranda. If you don’t already have a company standard for technical memoranda, you should implement this immediately before you end up stuck with a Word style sheet.

Posted in General | Tagged , | Leave a comment

The Org Agenda

Derek Taylor over at DistroTube has another useful video. This time it’s on Org agenda. Taylor is a Doom Emacs user so the keybindings will be unfamiliar to vanilla Emacs users but a couple of minutes with the manual can overcome that if you don’t worship at the Church of Doom.

Many newcomers to Emacs come specifically for Org but Taylor is not one of them. He’s been using Emacs for a while and is just now discovering the full power of Org. It is, he says, much more than another markup language like Markdown, LaTeX, or Troff. This video focuses on its scheduling capabilities and Org agenda.

If you like scheduling your day or recording your day’s events as in a memobook, org can make that easy. Taylor’s video serves as an introduction into some of the basic operations but is by no means a complete exegesis. Still, it’s ideal for the n00b who wants to get a feeling for Org’s scheduling abilities.

The video is about 34 and a quarter minutes—a little less if you skip the shoutouts at the end—so you’ll need to schedule some time. As I said, this video will probably be useful mostly to Org n00bs but others may find some useful information in it too.

Posted in General | Tagged , | Leave a comment

The Law of Unintended Consequences

I find this hilarious:

There’s actually a lesson here: Whatever precautions you take, someone will find a way to game the system.

Posted in General | Tagged | Leave a comment

Document Preparation with Org, LaTeX, and Docker

Marco Ieni was tired of working with Microsoft Word so he he built a workflow that uses Org mode for document preparation. Irreal readers know he won’t be getting any arguments here. Even putting aside the brain-dead Word UI there are compelling reasons to prefer plain text: you can use effective version control; write with any editor; make use of grep, diff, and similar utilities; and even generate some text programmatically. And, of course, your data is not held captive in some proprietary format.

There’s nothing new about any of that, of course, but Ieni took it a step further and considered the problem of collaborators. He accepts that convincing colleagues to adopt Emacs is basically impossible so he came up with a command line utility, doc-org, to enable non-Emacsers to have a sensible writing environment. Of course, they still have use some sort text editor, which many academics would no doubt consider an intolerable burden but Ieni says that the system is mainly aimed at people who are already using LaTeX and would like to move to the easier Org markup. It’s a good fit for people like that. As Ieni puts it, “The main goal of doc-org is to bring the conciseness of org mode to latex users.”

Ieni concludes his post by saying that he hopes that people will come to realize that “the best way to write documents together is the same of writing code together: plain text + version control systems like git.” Realistically that’s probably not going to happen but the most efficient and successful will probably adopt some sort of notion similar to this.

Posted in General | Tagged | Leave a comment

Blocking Melpa

Here’s a mystery to entertain you as you segue into the weekend. Jerror was complaining on the Emacs subredit that their university had blocked MELPA. What?!? Why in the world would anyone block MELPA? It doesn’t appear to be one of those “let’s block everything we don’t use ourselves” that you sometimes see from less than competent IT departments. According to Jerror, the only other site he could determine that was being blocked was Libgen. Even if you think blocking libgen makes sense, why block MELPA?

The last time I checked, there was no answer. There were plenty of comments but most of those were ironic, usually accusing the IT department of being Vim users. One commenter suggested that this is the result of subscribing to some prepackaged blacklist but that seems to be malfeasance and, really, only pushes the mystery back one step.

Many of the comments offered ways of getting around the block, which in a way makes the problem go away but it still doesn’t answer the question of why the site was blocked in the first place. Jerror says he hasn’t yet pinged the IT department so maybe that will provide an answer. In the mean time, if you’ve got a possible explanation, let us all know. Of course, it doesn’t really matter much but it’s one of those things you come across and think, “What’s this all about?”

Posted in General | Tagged | Leave a comment

Doom for N00bs

Derek Taylor has an interesting take on learning Doom Emacs. Most immigrants to Doom are coming from Vim or are Emacs users who need the more ergonomic evil keybindings because of RSI problems. But, says Taylor, some people coming to Doom are total n00bs arriving from outside of either Vim or Emacs. He’s done several videos on switching to Doom but some of his viewers told him he was neglecting users coming to Doom tabula rasa.

He’s posted a video to remedy this. It’s intended to be an introduction to Doom Emacs for the n00b. He doesn’t assume the viewer has any particular background. He shows how to get Doom installed and do some elementary configuration. I think his video is perfect for beginners because he’s not an Emacs power user and is well positioned to understand the neophytes’ concerns and problems.

If you’re new to the Emacs/Vim world and would like to try out Doom, take a look at Taylor’s video; It gives you enough to get started. I still like the idea of starting with vanilla Emacs and building a configuration that’s customized explicitly to suit you but I recognize that some folks are in a hurry an would rather have a reasonably usable configuration out of the box. And, of course, Doom allows you to control which packages and features get loaded so it can still be tweaked to suit the individual user.

Posted in General | Tagged | Leave a comment

Zamansky 75: Bufler

Mike Zamansky has added another video to his Using Emacs Series. This time it’s about bufler, a replacement for ibuffer. Mostly when I call up ibuffer, I just want to see a list of my buffers and I don’t care that much about grouping. Somewhere along the line, I installed ibuffer-vc that groups the buffers by their vc root but I don’t really care about the grouping. I should probably uninstall ibuffer-vc but I don’t mind the grouping and it’s there so inertia has ruled.

Zamansky is different. He really likes having his buffers grouped by project. After his last video, someone suggested he try bufler. He did that and liked the results except that it split the current window and opened the results in the new window when it was called. He didn’t like that and couldn’t find a way to change the behavior so he wrote a bit of Elisp to give him his preferred behavior.

The video is just over 10 minutes so it will be easy to find time for it. If, like me, you just want a list of buffers, bufler may not interest you. If you’d like to have a more organized listing, bufler may be for you. Either way, take a look a Zamansky’s video and see what you think.

Posted in General | Tagged | Leave a comment

Taking Notes By Hand

Longtime readers know that Irreal is, um, skeptical of most studies put out by the psychology community. They are, largely, not reproducible and often just silly. One finding that is popular among psychologists that that note-taking is more effective when they are taken by hand than when they are taken with a keyboard.

They offer up the usual psychobabble in support of the idea that may or may not be correct but they also suggest that note takers behave differently when typing than when using longhand. When typing, we are more efficient so we tend to produce transcripts of whatever is being said. When taking notes by hand, we can’t keep up so we’re forced to think about what we’re hearing and record a précis of the subject matter. That means that we’re more apt to retain the handwritten notes.

Most of this is summarized in an article Hetty Roessingh. She makes the case for taking notes by hand and the joys of Moleskines and MontBlancs. If you’re one of those longtime readers, you know that I am all in on digital. I try to avoid paper as much as I can and certainly for note-taking. Still, it’s hard to convince myself that maybe, this once, the psychologists might not have a point. What to do? I certainly don’t want to hunt up my pads and pencils again.

Fortunately, you can have it both ways. If you’re a college student, this probably isn’t news but for those of us no longer enjoying the university life it may be welcome news. There are several ways of taking handwritten notes on, say, an iPad and even having them converted to text. This video by Ali Abdaal shows how he used an iPad, an Apple Pencil, and Notability to combine handwritten notes with his digital lifestyle. I loved this video when I first saw it and immediately got myself an Apple Pencil and a copy of Notability. I’ve been using them ever since and love them even though I don’t take notes that often anymore.

If you still have to take notes and think that maybe the psychologists are right about the superiority of handwritten notes, be sure to take a look at Abdaal’s video. It shows how you can have the best of both worlds. Actually, you can have better than either of the two alternatives.

Posted in General | Tagged | Leave a comment

Binder for Your Writing Projects

When writers ask for software suggestions, one of the most frequent recommendations I see—other than the evil whose name must not be uttered—is Scrivener. The idea is that you can write in any order you like and keep project notes with the rest of your work. Of course, Scrivener is proprietary software and probably keeps your data in some sort of proprietary format (I’m not sure about this) so it should make any wary writer nervous. All your data is local and old versions continue to work so it’s not as bad as a lot of other commercial software.

Still, if you’re paranoid or just like supporting open source and having your text data in text, you’ll probably prefer Emacs, Vim, or some other text editor. There are a lot of such solutions including, of course, Org mode. On the other hand, people who have used Scrivener really like the way it organizes their writing projects and even if they move on they say they miss that aspect of it.

If you’re one of those people, help is at hand. William Rankin has announced that he’s just released version 0.4.1 of Binder and that it’s available in MELPA and MELPA-stable. Binder is an Emacs minor mode for handling multi-file writing projects. Rankin says that it’s heavily influenced by Scrivener and therefore may be just the thing for folks wanting to write in, say, Markdown or Org while still enjoying a Scrivener-like experience.

I haven’t tried it yet—although I intend to—and it’s still fairly early in the development cycle but it seems like a great addition to the Emacs arsenal for writers. If you’re involved with (largish) writing projects, you might want to give it a try.

Posted in General | Tagged | Leave a comment

Panic’s Nova Editor

My friend Watts has been wandering around in the editor wilderness for the almost 20 years that I’ve known him. He’s used them all: Vim, Emacs, BBEdit, TextMate, VS Code, Sublime Text, and probably any other editor you’ve ever heard of. Some people like to try different beers in an eternal quest for the perfect quaff. Watts is like that but with editors. He’s a technical writer and has pretty much settled on BBEdit for his writing but doesn’t like it as much for actual coding. So the search goes on if only for a coding editor.

His most recent experiment involves Panic’s Nova editor. It’s a new editor—apparently replacing their Coda editor—that has a lot of nice features. He’s been using it since it was in beta and now that it’s been released he’s written a review. If you haven’t (yet) been called to the One True Editor and are looking for an editor, take a look at Watts’ review. Perhaps Nova is what you’re looking for. Nova is for the Mac only so unless you’re a member of the Apple cult it’s not the editor for you.

Even if you aren’t in the market for a new editor, the review is worth reading. If you use one of the “real editors™,” you’ll love his comments about which users may want to switch to Nova. Speaking of Emacs and Vim users, he says,

If you’re an Emacs or Vim power user, we both know you’re just reading this out of academic interest and you’re not going to switch. C’mon.

As I’ve said before, Vim and Emacs users tend to keep it in the family and if they switch editors, they switch to the other editor in the family.

Watts is a good writer and his review is interesting so take a look.

Posted in General | Tagged | Leave a comment