worg-about.org 3.4 KB

What is Org? What is Worg?

Org is an Emacs mode for keeping notes, maintaining to-do lists, and doing project planning with a fast and effective plain-text system. (as the Org manual says.)

Worg is an attempt to collectively build a knowledge database about Org, planning in plain text and other related topics.

Why use Org-mode for creating a collaborative website?

Because Org makes it easy, fast and effective to edit *well-structured* files. Ever wanted to edit a table in a wiki? Ever wanted to change the outline structure in a wikipage? Ever wanted to edit lists quickly? Org lets you do this.

Because Org-mode makes beautiful documents : it support links, font beautification, examples, etc. And you can export those documents to HTML, LaTeX, or DocBook.

Because Org is also a powerful task-management system. Hopefully sharing a TODO file will make it easy for everyone to know where he could help.

So it's a bit like a wiki, no?

No. Yes. Kind of. Here are a few differences:

  • you edit the pages using Emacs, not a cheesy web interface;
  • the Worg website (repository) is maintained using git;
  • even if people are invited to merge their changes into the [[http://orgmode.org/worg/][main Worg
  • website]], they are free to start a new Worgie of their own. Using git makes Worg a *distributed* community website.
  • there is an important difference: Org is a very fast and effective plain
  • text task-management system. Meaning that you can add the Worg todo file (=worg-todo.org= in the Worg directory) to your =org-agenda-files= and see your list of task populated by tasks added by other people...

Who can participate?

Everyone with a minimal knowledge of Org (and Emacs) and git. See the page describing how to use git for editing Worg for details.

Do I need to register somewhere?

It's better to register on http://repo.or.cz/reguser.cgi but you can also add changes to the Worg repository anonymously.

So, what will be the content of this website?

Everything related to Org, project planning in plain text and the Org community. Go crazy!

Who are these people?

Worg was started by Bastien in the hope that other Org-ers around will bite into this and start sharing tutorials, example of codes, etc.

OK, I want to start now!

The first thing you need to know is how to use git for Worg.

The second thing you might be interested in are general advices and conventions on how to let Worg grow.

If you're interested in knowing how Worg publishes itself as a website, check the Worg setup page.