How to add RefTeX support
[Worg/babel-doc.git] / worg-about.org
blob3d9f23d200afa3389e5d98255d4e99f4f32f6931
1 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
2 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
3 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) 
4 #+TITLE:      I said: "Hello Worg!"
5 #+AUTHOR:     Worg people
6 #+EMAIL:      bzg AT altern DOT org
7 #+LANGUAGE:   en
8 #+PRIORITIES: A C B
9 #+CATEGORY:   worg
10 #+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
12 [[file:index.org][{Back to Worg's index}]]
14 * What is Org?  What is Worg?
16 [[http://www.orgmode.org][Org]] is an [[http://www.gnu.org/software/emacs/][Emacs]] mode for /keeping notes, maintaining to-do lists, and doing
17 project planning with a fast and effective plain-text system./ (as the [[http://www.orgmode.org/org.html][Org
18 manual]] says.)
20 Worg is an attempt to /collectively/ built a knowledge database about [[http://orgmode.org][Org]],
21 planning in plain text and other related topics.
23 * Why using Org-mode for creating a collaborative website?
25 Because Org makes it easy, fast and effective to edit *well-structured*
26 files.  Ever wanted to edit a [[file:org-tutorials/tables.org][table]] in a wiki?  Ever wanted to change the
27 outline structure in a wikipage?  Ever wanted to edit lists quickly?  Org
28 lets you do this.
30 Because Org-mode makes *beautiful* documents : it support links, font
31 beautification, examples, etc.  And you can export those documents to HTML
32 or LaTeX.
34 Because Org is also a powerful *task-management system*.  Hopefully sharing
35 a [[file:worg-todo.org][TODO file]] will make it easy for everyone to know where he could help.
37 * So it's a bit like a wiki, no?
39 No.  Yes.  Kind of.  Here are a few differences:
41 - you edit the pages *using Emacs*, not a cheesy web interface;
43 - the Worg website (repository) is maintained using [[google:git%20cvs][git]];
45 - even if people are invited to merge their changes into the [[http://www.cognition.ens.fr/~guerry/worg/][main Worg
46   website]], they are free to start a new Worgie of their own.  Using git
47   makes Worg a *distributed* community website.
49 - there is important difference: Org is a very fast and effective plain
50   text task-management system.  Meaning that you can add the Worg todo
51   file (=worg-todo.org= in the Worg directory) to your =org-agenda-files= and
52   see your list of task populated by tasks added by other people... 
54 * Who can participate?
56 Everyone with a minimal knowledge of Org (and Emacs) and git.  See the
57 page describing how to use [[file:worg-git.org][git for editing Worg]] for details.
59 * Do I need to register somewhere?
61 It's better to register on http://repo.or.cz/reguser.cgi but you can
62 also add changes to the Worg repository anonymously.
64 * So, what will be the content of this website?
66 Everything related to Org, project planning in plain text and the Org
67 community.  Go crazy!
69 * Who are these people?
71 Worg was started by [[http://www.cognition.ens.fr/~guerry/][Bastien]] in the hope that other Org-ers around will
72 bite into this and start sharing tutorials, example of codes, etc.
74 * Ok, I want to start now!
76 The first thing you need to know is [[file:worg-git.org][how to use git for Worg]].  The second
77 thing you might be interested in are general advices and conventions on how
78 to [[file:worg-editing.org][let Worg grow]].