Browse Source

Optimized the main page for newbies.

I wrote a short introduction to Org-mode and Worg.
I re-organized the entire index page to make sense to newbies and
make it easier to find pages for non-newbies.
I also made a few obvious rewording and re-orgs of auxiliary pages.
Huy Z 8 years ago
parent
commit
bc19dc2828
5 changed files with 132 additions and 110 deletions
  1. 104 84
      index.org
  2. 2 1
      org-contrib/index.org
  3. 5 6
      org-translators.org
  4. 1 3
      users/index.org
  5. 20 16
      worgers.org

+ 104 - 84
index.org

@@ -1,7 +1,7 @@
 #+STARTUP:    align fold nodlcheck hidestars oddeven intestate
 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
-#+TITLE:      Hello Worg!
+#+TITLE:      Hello Worg, the Org-Mode Community!
 #+AUTHOR:     Worg people
 #+EMAIL:      mdl AT imapmail DOT org
 #+LANGUAGE:   en
@@ -9,18 +9,13 @@
 #+CATEGORY:   worg
 #+OPTIONS:    H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil d:(HIDE) tags:not-in-toc
 
-*Current discussion*: how would you reorganize [[file:org-faq.org][Org's FAQ]] ([[http://article.gmane.org/gmane.emacs.orgmode/31794][start of the
- discussion]])?
+------------------------------------------------------------------------------
+*Current discussion*: how would you reorganize [[file:org-faq.org][The Org-mode FAQ]]?
+See [[http://article.gmane.org/gmane.emacs.orgmode/31794][start of the discussion]].
 
-*Current Work*: Updating and editing [[file:org-hacks.org][org-hacks]] and [[file:org-glossary.org][org-glossary]]
-Improving the ability of [[file:index.org][this page]] to introduce new users to Worg.
-
-[[http://www.gnu.org/software/emacs/][Emacs]] is a text editor.  [[http://orgmode.org][Org-mode]] is an Emacs tool written by Carsten
-Dominik, and currently maintained by Bastien Guerry that can help you
-organize your life with plain text files. =Worg= is a set of Org
-files collectively edited by people who like Org-mode and want to
-share [[file:org-tutorials/index.org][tutorials]] ideas, code snippets, etc. Worg is maintained by
-Matthew Lundin and a group of [[file:worgers.org][org-mode users]] and maybe [[file:worg-todo.org][you]].
+*Current Work*:
+- Updating and editing [[file:org-hacks.org][org-hacks]] and [[file:org-glossary.org][org-glossary]]
+------------------------------------------------------------------------------
 
 #+BEGIN: timestamp :string "Last update: " :format "%Y-%m-%d @ %H:%M"
 
@@ -49,106 +44,131 @@ Matthew Lundin and a group of [[file:worgers.org][org-mode users]] and maybe [[f
 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en"></script>
 #+END_HTML
 
-* How you can help
-
-- Please read section [[http://orgmode.org/org.html#Feedback][Feedback]] of Org's manual.
-- Help us improving Org by [[file:org-tests/index.org][testing]]!
-- Share your Org-Mode knowledge by [[file:worg-about.org][contributing to Worg]].
-
-* Pages about Org
+# We put true links to the server, as sitemap.org and theindex.org are
+# generated on the server during the publication
+Worg [[http://orgmode.org/worg/sitemap.html][sitemap]] and [[http://orgmode.org/worg/theindex.html][index]] [Under development]
+
+* Introduction to Org-Mode (and Worg)
+
+[[http://orgmode.org][Org-mode]] is a powerful system for organizing your complex life with simple
+plain-text files.  It seamlessly integrates all your notes, mindmaps, TODO lists,
+calendar, day planner, and project schedules into a single system that can be easily
+searched (e.g. by grep), encrypted (e.g. by GnuPG), backed up and synced (e.g. 
+by Dropbox), imported/exported, and accessed on the go (e.g. on an iPhone or Android
+smartphone).
+It can even be used for authoring web pages and documents.
+
+Check out some [[file:org-screenshots.org][screenshots of Org-mode]] in action.  See [[file:org-quotes.org][what people have to say]] about
+Org-mode, and read a few [[file:org-testimonies/index.org][user stories]]!
+
+Org-mode is distributed as part of the popular [[http://www.gnu.org/software/emacs/][Emacs]] text editor and runs wherever
+Emacs runs, including on Linux, Windows, and Mac.
+Written by Carsten Dominik, it is currently maintained by Bastien Guerry
+and used by many helpful people who, like you, are desperate to get and stay
+organized.
+
+The page you're reading is part of =Worg=, a section of the [[http://orgmode.org/][Org-mode web site]]
+that is written by a volunteer community of Org-mode fans.
+It includes tutorials, ideas, code snippets, etc., shared to make your introduction
+and customization of Org-mode as easy as possible.  Worg is maintained by
+Matthew Lundin, a group of [[file:worgers.org][Worg contributors]], and maybe [[file:worg-todo.org][you]].
+
+* Org-Mode Resources
   :PROPERTIES:
   :ID:       A6F83C16-B1B9-405A-B996-8D2CA1274DEB
   :END:
 
-** The main resources
-- http://orgmode.org : Carsten Dominik's official page for Org
-- [[file:org-tutorials/index.org][Org Tutorials]]      : Your best starting point
-- [[file:org-contrib/babel/index.org][Org Babel]]          : The embedded code evaluation and literate
-  programming subsystem by Eric Schulte and Dan Davison.
-- [[file:org-faq.org][The Org-mode FAQ]]   : Check here before writing to the mailing list
-- [[file:org-mailing-list.org][Org mailing list]]   : For unanswered questions, ideas and discussion
-- [[http://orgmode.org/manual/index.html][The Org-mode manual]] : Extensive and complete documentation
-- [[file:org-glossary.org][The Org Glossary]]: An explanation of org-mode terminology
-- [[file:org-dependencies.org][Org dependencies]]   : Dependencies on external packages (mostly LaTeX for now) - WIP.
-- [[file:org-configs/index.org][Org configuration]]  : Beginners customization guide, examples, survey,
+** Learn Org-Mode
+
+- [[http://orgmode.org/][Org-mode Main Page]]      : The official page for Org-mode
+- [[file:org-tutorials/index.org][Org-mode Tutorials]]      : Your best starting point
+- [[file:org-glossary.org][Org-mode Glossary]]       : An explanation of org-mode terminology
+- [[http://orgmode.org/manual/index.html][Org-mode Manual]] 	  : Extensive and complete documentation
+- [[file:org-configs/index.org][Org-mode configuration]]  : Beginner's customization guide, examples, survey,
   and a list of all hooks
-- [[file:org-contrib/index.org][Contributed packages]] : Available modules and documentation
-- [[file:org-contribute.org][How to contribute to Org?]] : Guideline for patches and other contributions
-- [[file:org-issues.org][A simple issue tracker]] : Keeps track of open issues and other things
-  about Org mode based on the mailing list
-- [[file:org-tools/index.org][The Org Tools]] : List of external tools useful for handling Org files. 
-** Sitemap and index
 
-# We put true links to the server, as sitemap.org and theindex.org are
-# generated on the server during the publication
+** Get Help with Org-Mode
+
+- [[file:org-faq.org][Org-mode FAQ]]   	  : Check here before writing to the mailing list
+- [[file:org-mailing-list.org][Org-mode Mailing List]]   : For unanswered questions, suggestions, and
+  discussion
+- Org-mode IRC Channel    : For live Q&A, go to #org-mode on [[http://freenode.net/][Freenode]]
 
-- Worg comes with a [[http://orgmode.org/worg/sitemap.html][sitemap]]
-- ... and an [[http://orgmode.org/worg/theindex.html][index]] (empty for now)
+** Use Org-Mode Effectively
 
-** Other stuff
+- Use Org-mode as a [[file:org-gtd-etc.org][task management system]] (perfect for GTD and the
+  [[http://www.pomodorotechnique.com/][Pomodoro Technique]])
+- Author [[file:org-blog-wiki.org][Blogs and Wikis with Org-mode]] (see [[file:org-web.org][example web wages]])
+- Integrate [[file:org-mac.org][Org-mode with Mac OS X]]
+
+** Dive Deeper into Org-Mode
+
+- [[file:org-blog-articles.org][Blog posts]]              : Read a variety of articles from introductions to
+  specific customizations
+- [[file:org-hacks.org][Org-mode Hacks]]          : Copy code snippets from other users
+- Tools
+  - [[file:org-translators.org][Org-mode conversion tools]]  : Import into and export out of Org-mode
+  - [[file:org-tools/index.org][Org-mode parsing libraries]] : Parse and analyze .org files
+- [[file:org-dependencies.org][Org-mode dependencies]]   : Dependencies on external packages for advanced
+  functionality.
+
+** Third-Party Contributions
+
+- [[file:org-contrib/index.org][Contributed packages]], including extensive documentation
+- Repository of contributed code:
+  1. the =contrib/= directory of the Org-mode package
+  2. the [[http://orgmode.org/worg/code/][code]] directory of Worg
+     - [[http://orgmode.org/worg/code/org-info-js][org-info-js]] by Sebastian Rose: great javascript
+       tool to navigate through a HTML page (as exported by Org) the way you
+       navigate through an Org or an info manual, i.e. supporting folding,
+       previous/next buttons, etc.
+- [[file:org-devel.org][Additions under development]]
 
-- A list of past and future IRL [[file:orgcamps.org][OrgCamps]]
-- [[file:org-quotes.org][Quotes about Org]]
-- [[file:org-people.org][Pictures of Org-mode people]]
-- [[file:org-gtd-etc.org][Org task management systems]]
-- [[file:org-testimonies/index.org][People describing how they use Org]]
-- [[file:org-blog-articles.org][Blog posts about Org]]
-- [[file:org-screenshots.org][Screenshots of Org in action]]
-- [[file:org-web.org][Web Pages Made with Org]]
-- [[file:org-translators.org][Org Translators]]
-- [[file:org-hacks.org][Hacks around Org]]
-- [[file:org-blog-wiki.org][Blogs and Wikis with Org-mode]]
-- [[file:org-mac.org][Org and Mac OS X]]
 
 # FIXME: should we add this?
 
 #- [[file:org-survey.org][Org survey results]]
 #- [[file:org-code/index.org][Org add-ons]] should be documented here and maybe not in the manual?
 
-* Pages about Worg
+* Join the Community
 
-- [[file:worg-about.org][About the Worg project]]
-- [[file:worg-setup.org][About the Worg setup on the server]]
-- [[file:worg-maintainance.org][About Worg maintainer and gardners]]
-- A list of [[file:users/index.org][Worg's users]]
-- [[file:worg-git.org][A introduction to git for Worgers]]
-- [[file:worg-editing.org][Conventions and tools for editing Worg]]
-- [[file:worg-todo.org][The Worg TODO file]]
-- [[file:worg-git-ssh-key.org][How to create your own SSH key for repo.or.cz?]]
-- [[http://repo.or.cz/w/Worg.git][Recent changes to Worg]] (git log at repo.or.cz)
-- [[http://orgmode.org/worg/sources/][Org-mode source documents of all Worg pages]]
+- Check out the list of [[file:worgers.org][Worgers and their User Pages]] and a few
+  [[file:org-people.org][profiles of the Org-mode Community]] (with photos ☺)
+- Meet other users in the flesh at [[file:orgcamps.org][OrgCamps]]
 
-* Code around Org
+** Help out
 
-You can check around for code both in the =contrib/= directory of
-the Org package and in the =code/= directory of Worg.  Also, there is
-some development of org additions current happening in Worg (see
-[[file:org-devel.org]]).
+- [[Maintenance%20of%20Worg][Improve Worg]] by sharing your knowledge about Org-mode.
+- Improve Org-mode:
+  - Send [[http://orgmode.org/org.html#Feedback][bug reports]] after checking the [[file:org-issues.org][issue tracker]]
+  - Help [[file:org-tests/index.org][test]]
+  - [[file:org-contribute.org][Contribute to Org-mode]]
 
-** org-info-js by Sebastian Rose
+* Maintenance of Worg
 
-For now the [[http://orgmode.org/worg/code/][code]] directory of Worg only contains =org-info-js= by
-Sebastian Rose -- check it [[http://orgmode.org/worg/code/org-info-js][here]].  =org-info-js= is a great javascript
-tool to navigate through a HTML page (as exported by Org) the way you
-navigate through an Org or an info manual, i.e. supporting folding,
-previous/next buttons, etc.
+- Intro
+  - [[file:worg-about.org][About the Worg project]]
+  - [[file:worg-setup.org][How Worg is set up on the server]]
+  - [[file:worg-maintainance.org][About Worg maintainer and gardners]]
+- Tasks
+  - [[file:worg-todo.org][The Worg TODO file]]
+- Howtos
+  - [[file:worg-git.org][An introduction to git for Worgers]]
+  - [[file:worg-editing.org][Conventions and tools for editing Worg]]
+  - [[file:worg-git-ssh-key.org][How to create your own SSH key for repo.or.cz?]]
+- Miscellaneous
+  - [[http://repo.or.cz/w/Worg.git][Recent changes to Worg]] (git log at repo.or.cz)
+  - [[http://orgmode.org/worg/sources/][Org-mode source documents of all Worg pages]]
 
-#* Pages about planning and GTD
-#
-#- [[file:planning/readings.org][Readings]]
-
-* Latest edits on the Worg git repository
+** Latest changes to the Worg git repository
 
 #+BEGIN_HTML
 <script language="JavaScript" src="http://itde.vccs.edu/rss2js/feed2js.php?src=http%3A%2F%2Frepo.or.cz%2Fw%2FWorg.git%3Fa%3Drss&chan=n&num=10&desc=0&date=n&targ=n" type="text/javascript"></script>
-
 #+END_HTML
 
- - You can also follow edits via [[http://repo.or.cz/w/Worg.git/rss][RSS]] or [[http://repo.or.cz/w/Worg.git/atom][ATOM]] (courtesy of repo.or.cz)
+Note: You can also subscribe to changes via [[http://repo.or.cz/w/Worg.git/rss][RSS]] or [[http://repo.or.cz/w/Worg.git/atom][ATOM]] (courtesy of repo.or.cz).
 
 * Git'r done!
 
 If you like losing your time by reading stuff on how to get organized,
 go and check the [[file:gitrdone.org][Git'r done!]] page..
-
-

+ 2 - 1
org-contrib/index.org

@@ -35,7 +35,8 @@ hopefully have some documentation.
   of the Org core, and [[http://orgmode.org/manual/Protocols.html#Protocols][documented in the manual]].
 
 - [[file:babel/index.org][Org-babel -- execution of source code blocks]] ::
-  Written by /Eric Schulte/ and /Dan Davison/ \\
+  The embedded code evaluation and literate programming subsystem
+  written by /Eric Schulte/ and /Dan Davison/ \\
   Org Babel is now part of the Org core and [[http://orgmode.org/manual/Working-with-source-code.html#Working-with-source-code"][documented in the manual]].
 
 - /org-bookmark.el/ -- support for links to Emacs bookmarks ::

+ 5 - 6
org-translators.org

@@ -2,7 +2,7 @@
 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
-#+TITLE:      Org translators, from and to Org
+#+TITLE:      Org-mode Import/Export Tools
 #+AUTHOR:     Worg people
 #+EMAIL:      mdl AT imapmail DOT org
 #+LANGUAGE:   en
@@ -14,17 +14,17 @@
 
 [[file:index.org][{Back to Worg's index}]]
 
-This page lists the various translators that have been written to
-transform Org into some format, and to turn some format into Org.
+This page lists the various conversion tools that have been written to
+export Org-mode data and import external data into the Org-mode system.
 
-** Org-mode to XXX
+** Org-mode Export Tools
 
    - [[http://www.cognition.ens.fr/~guerry/u/org2rem.el][From Org-mode to remind]] by [[http://www.cognition.ens.fr/~guerry/][Bastien Guerry]].
      
    - From Org-mode to Freemind by Marco Vezzoli, this is available in
      the contrib directory of the distribution.
 
-** XXX to Org-mode
+** Org-mode Import Tools
 
    - [[http://www.olafdietsche.de/palm/palm2orgmode.pl][From Palm TODO database to Orgmode]].  This Translator was
      written by [[http://www.olafdietsche.de/][Olaf Dietsche]].
@@ -51,7 +51,6 @@ transform Org into some format, and to turn some format into Org.
      [[http://thread.gmane.org/gmane.emacs.orgmode/6224/focus%3D6266][contest for the most compact translator]] - but it works very well
      anyway.
 
-
 ** Bi-directional
     
    Unfortunately nothing so far.

+ 1 - 3
users/index.org

@@ -14,6 +14,4 @@
 
 [[file:../index.org][{Back to Worg's index}]]
 
-| Bastien        | [[file:bzg.org][bzg.org]]   | <2008-09-05 ven> |
-| Sebastian Rose | [[file:srose.org][srose.org]] | <2008-09-05 ven> |
-| Raffi          | [[file:rpr.org][rpr.org]]   | <2009-08-03>     |
+This page was integrated into [[file:~/git/Worg/worgers.org][Worgers and their User Pages]]

+ 20 - 16
worgers.org

@@ -2,7 +2,7 @@
 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
-#+TITLE:      The list of Worgers
+#+TITLE:      Worgers and their User Pages
 #+AUTHOR:     Worg people
 #+EMAIL:      mdl AT imapmail DOT org
 #+LANGUAGE:   en
@@ -16,21 +16,25 @@
 
 This is the list of Worgers:
 
-| Adam Spiers          | http://adamspiers.org/                           |
-| Bastien Guerry       | http://www.cognition.ens.fr/~guerry/             |
-| Carsten Dominik      | http://www.astro.uva.nl/~dominik                 |
-| Daniel Clemente      |                                                  |
-| Dave O'Toole         |                                                  |
-| Drew Raines          |                                                  |
-| Mark A. Hershberger  |                                                  |
-| Matt Lundin          |                                                  |
-| Pete Phillips        |                                                  |
-| Phil Jackson         |                                                  |
-| Rustom Moody         |                                                  |
-| Sam Kleinman (tycho) | http://tychoish.com/ http://criticalfutures.com/ |
-| Sven Bretfeld        |                                                  |
-| Sebastian Rose       | sebastian\_rose at gmx de                        |
-| Wes Hardaker         | http://www.hardakers.net/                        |
+| Name                 | Contact                                          | Worg User Page | Last Updated     |
+|----------------------+--------------------------------------------------+----------------+------------------|
+| Adam Spiers          | http://adamspiers.org/                           |                |                  |
+| Bastien Guerry       | http://www.cognition.ens.fr/~guerry/             | [[file:bzg.org][bzg.org]]        | <2008-09-05 ven> |
+| Carsten Dominik      | http://www.astro.uva.nl/~dominik                 |                |                  |
+| Daniel Clemente      |                                                  |                |                  |
+| Dave O'Toole         |                                                  |                |                  |
+| Drew Raines          |                                                  |                |                  |
+| Huy Z                |                                                  |                |                  |
+| Mark A. Hershberger  |                                                  |                |                  |
+| Matt Lundin          |                                                  |                |                  |
+| Pete Phillips        |                                                  |                |                  |
+| Phil Jackson         |                                                  |                |                  |
+| Raffi                |                                                  | [[file:rpr.org][rpr.org]]        | <2009-08-03>     |
+| Rustom Moody         |                                                  |                |                  |
+| Sam Kleinman (tycho) | http://tychoish.com/ http://criticalfutures.com/ |                |                  |
+| Sven Bretfeld        |                                                  |                |                  |
+| Sebastian Rose       | sebastian\_rose at gmx de                        | [[file:srose.org][srose.org]]      | <2008-09-05 ven> |
+| Wes Hardaker         | http://www.hardakers.net/                        |                |                  |
 
 # Feel free to create a page with your name like sven-bretfeld.org