worg-about.org

   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
  11
  12 [[file:index.org][{Back to Worg's index}]]
  13
  14 * What is Org?  What is Worg?
  15
  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.)
  19
  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.
  22
  23 * Why using Org-mode for creating a collaborative website?
  24
  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.
  29
  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.
  33
  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.
  36
  37 * So it's a bit like a wiki, no?
  38
  39 No.  Yes.  Kind of.  Here are a few differences:
  40
  41 - you edit the pages *using Emacs*, not a cheesy web interface;
  42
  43 - the Worg website (repository) is maintained using [[google:git%20cvs][git]];
  44
  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.
  48
  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...
  53
  54 * Who can participate?
  55
  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.
  58
  59 * Do I need to register somewhere?
  60
  61 It's better to register on http://repo.or.cz/m/reguser.cgi/ but you can
  62 also add changes to the Worg repository anonymously.
  63
  64 * So, what will be the content of this website?
  65
  66 Everything related to Org, project planning in plain text and the Org
  67 community.  Go crazy!
  68
  69 * Who are these people?
  70
  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.
  73
  74 * Ok, I want to start now!
  75
  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]].
  79
  80
  81
  82
  83
  84
  85