worg-about.org

   1 #+TITLE:      About Worg
   2 #+AUTHOR:     Worg people
   3 #+EMAIL:      mdl AT imapmail DOT org
   4 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
   5 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
   6 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
   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 f:t *:t tex:t d:(HIDE) tags:not-in-toc
  11 #+HTML_LINK_UP:    index.html
  12 #+HTML_LINK_HOME:  https://orgmode.org/worg/
  13
  14 # This file is released by its authors and contributors under the GNU
  15 # Free Documentation license v1.3 or later, code examples are released
  16 # under the GNU General Public License v3 or later.
  17
  18 * What is Worg?  What is its relation to Org?
  19
  20 [[http://www.orgmode.org][Org]] is an [[http://www.gnu.org/software/emacs/][Emacs]] mode for /keeping notes, maintaining to-do lists, and
  21 doing project planning with a fast and effective plain-text system/
  22 (as the [[http://www.orgmode.org/org.html][Org manual]] says).
  23
  24 Worg is a /collectively/-built knowledge database about [[https://orgmode.org][Org]],
  25 planning in plain text, and other related topics.
  26
  27 * Why use Org-mode for creating a collaborative website?
  28
  29 Because Org makes it easy, fast and effective to edit *well-structured*
  30 files.  Ever wanted to edit a [[file:org-tutorials/tables.org][table]] in a wiki?  Ever wanted to change the
  31 outline structure in a wikipage?  Ever wanted to edit lists quickly?  Org
  32 lets you do this.
  33
  34 Because Org-mode makes *beautiful* documents: it supports links, font
  35 beautification, examples, etc.  And you can export those documents to
  36 HTML, LaTeX, or DocBook.
  37
  38 Because Org is also a powerful *task-management system*.  Hopefully sharing
  39 a [[file:todo.org][TODO file]] will make it easy for everyone to know where he could help.
  40
  41 * So Worg is a bit like a wiki, no?
  42
  43 No.  Yes.  Kind of.  Here are a few differences:
  44
  45 - you edit the pages *using Emacs*, not a cheesy web interface;
  46
  47 - the Worg website (repository) is maintained using [[http://git-scm.com/][git]];
  48
  49 - even if people are invited to merge their changes into the [[https://orgmode.org/worg/][main Worg
  50   website]], they are free to start a new Worgie of their own.  Using git
  51   makes Worg a *distributed* community website.
  52
  53 - there is an important difference: Org is a very fast and effective plain
  54   text task-management system.  Meaning that you can add the Worg todo
  55   file (=todo.org= in the Worg directory) to your =org-agenda-files= and
  56   see your list of task populated by tasks added by other people...
  57
  58 * Who can participate in the editing of Worg?
  59
  60 Everyone with a minimal knowledge of Org (and Emacs) and git.  See the
  61 page describing how to use [[file:worg-git.org][git for editing Worg]] for details.
  62
  63 * Do I need to register somewhere?
  64
  65 You just need to send your requested username to [[mailto:tec@tecosaur.com][Timothy]], he will
  66 create an account on [[https://code.orgmode.org][code.orgmode.org]] for you --- see [[file:worg-git.org][how to use git
  67 for Worg]] for more information.
  68
  69 * So what is contained in Worg?
  70
  71 Everything related to Org, project planning in plain text, and the Org
  72 community.  Go crazy!
  73
  74 * Who's in charge of Worg?
  75
  76 Worg was started by [[http://bzg.fr][Bastien]] in the hope that other Org-ers around will
  77 bite into this and start sharing tutorials, example of codes, etc.
  78
  79 Worg is currently maintained by [[file:users/mlundin.org][Matt Lundin]]. Feel free to [[mailto:mdlATimapmailDOTorg][contact him]] if
  80 you have any questions about the site.
  81
  82 * OK, I want to contribute to Worg now!
  83
  84 The first thing you need to know is [[file:worg-git.org][how to use git for Worg]].
  85
  86 The second thing you might be interested in is general advice and
  87 conventions on how to [[file:worg-editing.org][let Worg grow]].
  88
  89 If you're interested in knowing how Worg publishes itself as a website,
  90 check the [[file:worg-setup.org][Worg setup]] page.