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:      About Worg
   5 #+AUTHOR:     Worg people
   6 #+EMAIL:      mdl AT imapmail 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 Worg?  What is its relation to Org?
  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
  17 doing project planning with a fast and effective plain-text system/
  18 (as the [[http://www.orgmode.org/org.html][Org manual]] says).
  19
  20 Worg is a /collectively/-built knowledge database about [[http://orgmode.org][Org]],
  21 planning in plain text, and other related topics.
  22
  23 * Why use 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 supports links, font
  31 beautification, examples, etc.  And you can export those documents to
  32 HTML, LaTeX, or DocBook.
  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 Worg is 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 [[http://git-scm.com/][git]];
  44
  45 - even if people are invited to merge their changes into the [[http://orgmode.org/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 an 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 in the editing of Worg?
  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/reguser.cgi but you can
  62 also add changes to the Worg repository anonymously.
  63
  64 * So what is contained in Worg?
  65
  66 Everything related to Org, project planning in plain text, and the Org
  67 community.  Go crazy!
  68
  69 * Who's in charge of Worg?
  70
  71 Worg was started by [[http://www.cognition.ens.fr/~guerry/][Bastien]]
  72 in the hope that other Org-ers around will bite into this and start
  73 sharing tutorials, example of codes, etc.
  74
  75 Worg is currently maintained by [[file:users/mlundin.org][Matt Lundin]]. Feel free to [[mailto:mdlATimapmailDOTorg][contact him]] if
  76 you have any questions about the site.
  77
  78 * OK, I want to contribute to Worg now!
  79
  80 The first thing you need to know is [[file:worg-git.org][how to use git for Worg]].
  81
  82 The second thing you might be interested in is general advice and
  83 conventions on how to [[file:worg-editing.org][let Worg grow]].
  84
  85 If you're interested in knowing how Worg publishes itself as a website,
  86 check the [[file:worg-setup.org][Worg setup]] page.