Browse Source

Added David O'Toole Tutorial

Bastien Guerry 12 years ago
parent
commit
13906d54f3

BIN
images/dto/tutorial-1.png


BIN
images/dto/tutorial-10.png


BIN
images/dto/tutorial-11.png


BIN
images/dto/tutorial-12.png


BIN
images/dto/tutorial-13.png


BIN
images/dto/tutorial-14.png


BIN
images/dto/tutorial-15.png


BIN
images/dto/tutorial-16.png


BIN
images/dto/tutorial-2.png


BIN
images/dto/tutorial-3.png


BIN
images/dto/tutorial-4.png


BIN
images/dto/tutorial-5.png


BIN
images/dto/tutorial-6.png


BIN
images/dto/tutorial-7.png


BIN
images/dto/tutorial-9.png


+ 261 - 0
org-tutorials/orgtutorial_dto.org

@@ -0,0 +1,261 @@
+#+OPTIONS:    H:3 num:nil toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
+#+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
+#+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
+#+TAGS:       Write(w) Update(u) Fix(f) Check(c) 
+#+TITLE:      [No title for now, please update]
+#+AUTHOR:     David O'Toole
+#+EMAIL:      dto AT gnu DOT org
+#+LANGUAGE:   en
+#+PRIORITIES: A C B
+#+CATEGORY:   worg
+
+# This file is the default header for new Org files in Worg.  Feel free
+# to tailor it to your needs.
+
+[[file:index.org][{Back to Worg's index}]]
+
+* Introduction
+
+Org-mode is a personal information management and outlining tool for
+Emacs. This document is intended to give the reader a "feel" for
+org-mode and to teach basic usage with step-by-step instructions and
+plentiful screenshots. It is not intended to replace the [[http://orgmode.org/org.html][manual]], as
+only a subset of org-mode's features are covered. 
+
+This tutorial has been translated into [[http://www.cognition.ens.fr/~guerry/orgtutorialfr.html"][French]], [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fOrgTutorial"][Japanese]], [[http://hokmen.chan.googlepages.com/OrgTutorial.en-cn.html"][Chinese]], and
+[[http://jmjeong.com/index.php?display=Emacs/OrgMode"][Korean]]. Special thanks to the translators.
+
+** Obtaining org-mode
+
+You can download org-mode from the [[http://orgmode.org/][org-mode home page.]] You should
+download at least [[http://orgmode.org/org.zip][the latest version]] to follow along with this tutorial. 
+
+** Installation
+
+Add the following to your .emacs:
+
+: (add-to-list 'load-path "PATH_TO_WHERE_YOU_UNPACKED_ORGMODE")
+: (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)
+
+This will make sure org gets loaded, and some basic global key
+combinations are defined.  We'll go over what "org-store-link" and
+"org-agenda" do later in this document.
+
+One more thing---it's best to set aside a separate directory where
+your org files will be kept. I recommend using ~/org. 
+
+* The basics
+
+This section illustrates basic org-mode usage by showing how I used
+org-mode to create this document.
+
+** Creating a new file
+
+If you've configured your Emacs initialization file as suggested
+above, Emacs should enter org-mode whenever you visit or create a file
+with the extension ".org". 
+
+I created a new file called "OrgTutorial.org" and saw the "Org"
+indicator in the modeline, showing that we've entered org-mode. 
+
+** Simple task list
+
+First I entered a *headline* called "Tasks" to keep tasks under. This
+isn't necessary but is often convenient, especially when you want to
+keep tasks separate from the body of a document you're writing. 
+
+First-level headlines begin with one star; second-level headlines
+begin with two stars, and so on.
+
+In org-mode, TODO items are always headlines. I entered a TODO item
+for "Start new org file for tutorial." 
+
+file:../images/dto/tutorial-1.png
+
+This is a bit silly, because we've already started a new file. So,
+let's mark the TODO item DONE by moving the cursor onto that line and
+hitting *C-c C-t*, which runs the command *org-todo*.
+
+Here is the result: 
+
+file:../images/dto/tutorial-2.png
+
+Notice how org-mode uses a timestamp to record when a TODO item was
+closed. 
+
+Let's add some more TODO items. Position the cursor on the next line,
+and hit *M-shift-RET* to call *org-insert-todo-heading*. You can hit
+it several times to add several TODOs. 
+
+file:../images/dto/tutorial-3.png
+
+
+** Using headlines to structure a document
+
+Often the best way to organize your ideas is an outline. My next step
+is to outline the different topics of the tutorial. By doing this, you
+break up the intimidating blank page into a series of
+less-intimidating smaller chunks. Then it becomes easier to fill them
+in.
+
+Remember that one star begins a first-level heading, and two stars
+begin a second-level heading. If you need deeper nesting, go ahead and
+use three or more stars!
+
+Here is what it looked like after I finished outlining the document:
+
+file:../images/dto/tutorial-4.png
+
+Notice I marked "Outline document" as DONE after I finished.
+
+** Filling in the sections
+
+You can easily add body text underneath any headline. 
+
+file:../images/dto/tutorial-5.png
+
+** Links to other places
+
+In the section on "Obtaining Org-mode" I need to provide a link to the
+org-mode website. A special bracket syntax is used when linking:
+
+: [[link][description]]
+
+Watch how I first type the link and description, leaving open the last
+bracket:
+
+file:../images/dto/tutorial-6.png
+
+Then when I type the last bracket, the link "collapses" and simply
+shows the description. 
+
+file:../images/dto/tutorial-7.png
+
+Try moving the cursor over the link and press *C-c C-o*
+for *org-open-at-point*.
+
+You can also link to local files. Try visiting another file---for
+example, your emacs initialization file. Then hit *C-c l* to
+call *org-store-link*. You'll see a message that a link was stored to
+the current location in the file you're visiting. 
+
+Then switch back to your org-mode buffer and paste the link
+using *C-c C-l* to call *org-insert-link*. (You may need to press the
+arrow keys to scroll through and find the link you just recorded.)
+
+** Overviews of a document
+
+By this time, my document is getting longer and I can no longer fit it
+all on one screen. Org-mode makes it easy to get an overview of your
+document by pressing *shift-TAB*. 
+
+file:../images/dto/tutorial-9.png
+
+Notice that just the top-level headings are shown.  You can
+hit *shift-TAB* again to show *all* headings, including TODO items:
+
+file:../images/dto/tutorial-10.png
+
+Then hit it again to show a normal view of the document, with section
+bodies shown: 
+
+file:../images/dto/tutorial-11.png
+
+** Adding notes to a task
+
+You can put as much text as you want under a TODO item's heading. In
+fact, you can even have subheadings under a TODO, and TODOs within
+TODOs! 
+
+Being able to annotate tasks makes it easy to collect related links
+and thoughts along with a task. Being able to nest tasks is great for
+modeling workflow---quite often, a larger task is broken into smaller
+subtasks you want to check off as you do them. 
+
+* A taste of advanced features
+
+Before we finish, we'll touch on org-mode's global TODO list,
+scheduling, and agenda features. These are used to combine relevant
+TODO items from different org files into a prioritized, chronological
+display. You can also use it to see which tasks were completed, and
+when.
+
+** Setup
+
+First you must set the variable *org-agenda-files* so that org-mode
+will know which files to search for TODOs and scheduled items. 
+
+Let's imagine you already have several org files---say, one for work,
+one for home, and one for school.
+
+Then you'd add the following to your emacs initialization file:
+
+: (setq org-agenda-files (list "~/org/work.org"
+:                              "~/org/school.org" 
+:                              "~/org/home.org"))
+
+** The global TODO list
+
+Press *C-c a t* to enter the global todo list. Org-mode will scan the
+files in *org-agenda-files* and present a listing of all the open TODO
+items:
+
+file:../images/dto/tutorial-16.png
+
+You can move the cursor around to the different todo items, and
+hit "t" to mark an item DONE, or hit *RET* to jump to the source file
+where the TODO is located. 
+
+** Scheduling tasks and using the agenda 
+
+Let's say I want to schedule "Finish document" for today. I move the
+cursor to the line after the TODO item "Finish document", and hit 
+ *C-c C-s* to run *org-schedule*. The calendar pops up, and I can
+ either enter or click the desired date: 
+
+file:../images/dto/tutorial-12.png
+
+Once I select the date, org-mode inserts a scheduling timestamp after
+the TODO item: 
+
+file:../images/dto/tutorial-13.png
+
+Now save your file, and hit *C-c a a* for *org-agenda*. A display of
+this week's scheduled items are displayed: 
+
+file:../images/dto/tutorial-14.png
+
+Now press "l" (lowercase L) to turn on log display. This displays the
+all finished tasks and their completion times. 
+
+file:../images/dto/tutorial-15.png
+
+* Farewell
+
+This has been only a brief tour of org-mode. More excitement awaits
+you at the [[http://orgmode.org/org.html][online org-mode manual.]]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+