Introduction to org-mode emacs

In fact, this is not even a translation, but a free statement of my thoughts on this topic, after getting acquainted with the indicated source. That is - processing. Some things that seemed obvious were deliberately excluded from the text. Some that seemed useful - added.

Introduction

It was described quite well here .

How to connect it

If you have version 22 and higher, you already have it. If not, install the new version. :)

Activation

Paste the next thing in our ~ / .emacs

( require 'org-install )
( add-to-list 'auto-mode-alist ' ( "\\. org $" . org-mode ))
( define-key global-map "\ C-cl" 'org-store-link )
( define-key global-map "\ C-ca" 'org-agenda )
( setq org-log-done t )

And from now on we will be sure that we have all the most basic. We will further define what “org-store-link” and “org-agenda” are.
')
The author thinks that it would be good to make a separate daddy for * .org files.

Basic things

Creating and maintaining a new .org file

Just get the .org file in the intended folder, open it with emax. And if you have everything we wrote above in .emacs, org-mode will automatically turn on.

Just a task list (headline)

Looks like this:


The headline is what is marked with an asterisk. It’s good that on the official Org-Mode website there was a spur that helped find the command: M + RET, which this headline creates. To not reach for an asterisk each time, you can use it.

To create a headline of another level, we must first create the headline of the first level, and, being in it, press M + S + (right / left arrow). It is clear that he will refuse to create a zero level.

It is noteworthy that M + RET creates a headline of the same level with the previous one. And if the first level - he jumps over one line.

If later we want to mark any of the healdines as a task to be performed, it is enough to simply press C + c C + t. By poking the combination again, we will see that the task changes its status from TODO to DONE, and everything will look like this:

And if you press again (the third time), then any status will be removed - there will be only a note of closing and the very inscription of the headline.

We use headlines to structure the document

Sometimes, the best way to describe your ideas will be their outlining.
And this is how it may look in practice:

Now let's do the filling

You can easily add any text under your headings (all with the same headlines):

Links to other places

In order to create a link, it is enough to use such a template - [[link] [description]].
And this is how it will look like during editing:


After editing, only the description itself will remain:


To create a link, you can also use a combination of C + c C + l. In the mini-buffer, emacs prompts you first to write a link, then after pressing RET to create it. While in the mini-buffer, you can also press TAB, to see what kind of links there are.

To open the newly created links, you must point to the link and poke C + C C + o. Or C + u C + c C + o - if you want to open it in another window.

For the sake of interest, you can go to another file, click C + c l there. And the link to this file will fit in the link store. Going to any of our .org file, we can extract any saved links from this repository using the same C + c C + l command.

The most observant readers may have already noticed that this command is the one we entered in ~ / .emacs at the beginning.

Document overview

When you feel that you want to reduce the amount of what is written a little, you can press shift-TAB and you will get this

Notice that now only the first level headers are shown.

And when we press it a couple more times, it will expand more and more to us:


And more:

Let's try more cool chips

Before we finish, let's try to master: the global TODO list (global TODO list), scheduling, and the agenda (agenda) in org-mode. All this is used for different types of displaying TODO things - with different priorities, from different .org files, for convenience.

Installation

First we need to set the variable org-agenda-files, which will tell org-mode, in which files we should look for TODO, and scheduled (scheduled) things.

Let's imagine that we have 3 .org files: one for work, the other for home, the third for school.
Then we have to add the following to our ~ / .emacs file:

( setq org-agenda-files ( list "~ / org / work.org"
"~ / org / school.org"
"~ / org / home.org" ))

Global TODO Sheet

We poke Cc at to enter it. Org-mode will scan all org-agenda-files and present a list of all valid TODO items:


There you can move the cursor to any TODO thing, and press t to mark it as completed (DONE). Or press RET to enter it and jump to the place and the file where it is located.

Scheduling tasks and using the agenda

Let's try to hover over any task. Clicking on C + c C + s will open a calendar where we can select any date:


After we do this and press RET, a note will appear under the task, “scheduled” (SCHEDULED), with the date:


We can also use C + c C + d to designate “deadlines” (DEADLINE), according to a similar principle.

Now save our file and click C + ca a. The schedule for this week will be displayed:


Now we can press l (as Leonid) to include the “log” view. It will look something like this:

Conclusion

It was just a summary of the capabilities of emacs Org-Mode. In order to get more detailed information about him, below I have provided several links.

A useful feature for introducing the use of org-mode to your daily life may be the possibility described in this article . And if you really want to get acquainted with the description of all the basic features of Org-Mode, you can click C + hi C + s org C + m C + m in emacs itself, or you can use this link by viewing the manual on it - and everything will be fine.