index.org

   1 #+title:      Hello Worg, the Org-Mode Community!
   2 #+author:     Worg people
   3 #+email:      mdl AT imapmail DOT org
   4 #+startup:    align fold nodlcheck hidestars oddeven intestate
   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 #+category:   worg
   9 #+options:    H:3 num:nil toc:t \n:nil ::t |:t ^:t -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
  10
  11 # For this dynamic block to work, you need to add code/elisp/worg.el in
  12 # your load-path.
  13
  14 # Let say that you like [[http://www.gnu.org/software/emacs/][Emacs]] and that you like using [[https://orgmode.org][org-mode]] for editing
  15 # structured files in Emacs.  Then you might want to /share/ some =.org=
  16 # files and ask people to edit them with you.  This is what *Worg* is [[file:worg-about.org][about]]:
  17 # collaboratively editing Org files to build a knowledge database about
  18 # =.org= itself (and planning-related stuff.)
  19
  20 #+begin_export html
  21 <form action="http://www.google.com/cse" id="cse-search-box">
  22   <div>
  23     <input type="hidden" name="cx" value="002987994228320350715:z4glpcrritm" />
  24     <input type="hidden" name="ie" value="UTF-8" />
  25     <input type="text" name="q" size="31" />
  26     <input type="submit" name="sa" value="Search" />
  27   </div>
  28 </form>
  29 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en"></script>
  30 #+end_export
  31
  32 # We put true links to the server, as sitemap.org and theindex.org are
  33 # generated on the server during the publication
  34 [[https://orgmode.org/worg/sitemap.html][Sitemap]] and [[https://orgmode.org/worg/theindex.html][index]]
  35
  36 * Introduction to Org-Mode and Worg
  37
  38 [[https://orgmode.org][Org-mode]] is a powerful system for organizing your complex life with
  39 simple plain-text files.  It seamlessly integrates all your notes,
  40 mindmaps, TODO lists, calendar, day planner, and project schedules
  41 into a single system that can be easily searched (e.g. by grep),
  42 encrypted (e.g. by [[http://www.gnupg.org/][GnuPG]]), backed up and synced (e.g.  by Dropbox),
  43 imported/exported, and [[file:org-faq.org::*MobileOrg][accessed on the go]] (e.g. on an iPhone or
  44 Android smartphone).  It can even be used for authoring web pages and
  45 documents.
  46
  47 Check out some [[file:org-screenshots.org][screenshots of Org-mode]] in action.  See [[file:org-quotes.org][what people have to
  48 say]] about Org-mode, and read a few [[file:org-testimonies/index.org][user stories]]!
  49
  50 Org-mode is distributed as part of the popular [[http://www.gnu.org/software/emacs/][Emacs]] text editor and runs
  51 wherever Emacs runs, including on GNU-Linux, Windows, and Mac.  Written by
  52 Carsten Dominik, it is currently maintained by Bastien Guerry and used by
  53 many helpful people who, like you, are desperate to get and stay organized.
  54
  55 The page you're reading is part of =Worg=, a section of the [[https://orgmode.org/][Org-mode web
  56 site]] that is written by a volunteer community of Org-mode fans.  It
  57 includes tutorials, ideas, code snippets, etc., shared to make your
  58 introduction and customization of Org-mode as easy as possible.  Worg is
  59 maintained by Matthew Lundin, a group of [[file:worgers.org][Worg contributors]], and maybe [[file:worg-todo.org][you]].
  60
  61 * Org-Mode Resources
  62   :PROPERTIES:
  63   :ID:       A6F83C16-B1B9-405A-B996-8D2CA1274DEB
  64   :END:
  65
  66 ** Learn Org-Mode
  67
  68 #+index: Tutorials
  69 #+index: Glossary
  70
  71 - [[https://orgmode.org/][Org-mode Main Page]]               : The official page for Org-mode
  72 - [[file:org-tutorials/index.org][Org-mode Tutorials]]               : Your best starting point
  73 - [[file:org-glossary.org][Org-mode Glossary]]                : An explanation of org-mode terminology
  74 - [[https://orgmode.org/manual/index.html][Org-mode Manual]]               : Extensive and complete documentation
  75 - [[https://orgmode.org/guide/index.html][Org-mode Guide]]                   : Not extensive, but complete documentation
  76   - Spanish translation of the orgguide ([[file:orgguide/orgguide.es.texi][texi]] - [[http://www.davidam.com/docu/orgguide.es.html][html]])
  77 - [[file:org-configs/index.org][Org-mode configuration]]           : Beginner's customization guide, examples, survey,
  78   and a list of all hooks
  79 - [[file:orgcard.org][Org-mode reference card]]          : check the [[file:orgcard.org][HTML]], [[https://orgmode.org/orgcard.pdf][pdf]] and [[https://orgmode.org/orgcard.txt][ASCII]] versions.
  80   - French translation of the orgcard ([[file:code/latex/fr-orgcard.tex][tex]] - [[file:images/bzg/fr-orgcard.pdf][pdf]])
  81 - [[file:exporters/index.org][New exporter]]            : Preliminary documentation for the new exporter.
  82
  83 ** Library of Babel
  84
  85 A collection of generally useful code blocks available as a [[file:library-of-babel.org][HTML]] or
  86 [[https://orgmode.org/worg/library-of-babel.org][.org]] file.
  87
  88 ** Get Help with Org-Mode
  89
  90 - [[file:org-faq.org][Org-mode FAQ]]      : Check here before writing to the mailing list
  91 - [[file:org-mailing-list.org][Org-mode Mailing List]]   : For unanswered questions, suggestions, and
  92   discussion
  93 - Org-mode IRC Channel    : For live Q&A, go to =#org-mode= on [[http://freenode.net/][Freenode]]
  94
  95 ** Use Org-Mode Effectively
  96
  97 - Use Org-mode as a [[file:org-gtd-etc.org][task management system]] (perfect for GTD and the
  98   Pomodoro Technique)
  99 - Author [[file:org-blog-wiki.org][Blogs and Wikis with Org-mode]] (see [[file:org-web.org][example web pages]])
 100 - Integrate [[file:org-mac.org][Org-mode with Mac OS X]]
 101 - Synchronize org-mode files easily with [[https://github.com/simonthum/git-sync][git-sync]], a [[file:org-tutorials/org-vcs.org][VCS of your choice]], or [[file:org-tutorials/unison-sync.org][Unison]]
 102
 103 ** Dive Deeper into Org-Mode
 104
 105 - [[file:dev/index.org][Org-mode for developers]] : reference documentation for developers
 106 - [[file:org-blog-articles.org][Blog posts]]              : Read a variety of articles from introductions to
 107   specific customizations
 108 - [[file:org-hacks.org][Org-mode Hacks]]          : Copy code snippets from other users
 109 - [[file:org-contrib/babel/index.org][Org Babel]] : Learn about [[https://en.wikipedia.org/wiki/Literate_programming][Literate programming]] within Org-mode
 110 - Tools
 111   - [[file:org-translators.org][Org-mode conversion tools]]  : Import into and export out of Org-mode
 112   - [[file:org-tools/index.org][Org-mode parsing libraries]] : Parse and analyze .org files
 113 - [[file:org-dependencies.org][Org-mode dependencies]] : Dependencies on external packages for advanced
 114   functionality [Work in progress]
 115 - [[file:org-papers.org][Org-papers]] : Whitepapers and books about Org-mode
 116
 117 ** Check Out Third-Party Contributions
 118
 119 - [[file:org-contrib/index.org][Contributed packages]], including extensive documentation
 120 - Repository of contributed code:
 121   1. the =contrib/= directory of the Org-mode package
 122   2. the [[https://orgmode.org/worg/code/][code]] directory of Worg
 123      - [[https://orgmode.org/worg/code/org-info-js/index.html][org-info-js]] by Sebastian Rose: great javascript
 124        tool to navigate through a HTML page (as exported by Org) the way you
 125        navigate through an Org or an info manual, i.e. supporting folding,
 126        previous/next buttons, etc.
 127 - [[file:org-devel.org][Additions under development]]
 128
 129 # FIXME: should we add this?
 130
 131 # [[file:org-survey.org][Org survey results]]
 132 # [[file:org-code/index.org][Org add-ons]] should be documented here and maybe not in the manual?
 133
 134 * Join the Community
 135
 136 - Check out the list of [[file:worgers.org][Worgers and their User Pages]] and a few
 137   [[file:org-people.org][profiles of the Org-mode Community]] (with photos ☺)
 138 - Meet other users in the flesh at [[file:orgcamps.org][OrgCamps]]
 139
 140 ** Help out
 141
 142 - Improve Worg by sharing your knowledge about Org-mode: see [[Maintenance of Worg]].
 143 - Improve Org-mode:
 144   - Send [[https://orgmode.org/org.html#Feedback][bug reports]] after checking the [[file:org-issues.org][issue tracker]]
 145   - Help [[file:org-tests/index.org][test]]
 146   - [[file:org-contribute.org][Contribute to Org-mode]]
 147
 148 * Maintenance of Worg
 149
 150 - Intro
 151   - [[file:worg-about.org][About the Worg project]]
 152   - [[file:worg-setup.org][How Worg is set up on the server]]
 153   - [[file:worg-maintainance.org][About Worg maintainer and gardners]]
 154 - Tasks
 155   - [[file:worg-todo.org][The Worg TODO file]]
 156 - Howtos
 157   - [[file:worg-git.org][An introduction to git for Worgers]]
 158   - [[file:worg-editing.org][Conventions and tools for editing Worg]]
 159   - [[file:worg-git-ssh-key.org][How to create your own SSH key?]]
 160 - Miscellaneous
 161   - [[https://code.orgmode.org/bzg/worg/commits/master][Recent changes to Worg]]
 162   - [[https://orgmode.org/worg/sources/][Org-mode source documents of all Worg pages]]
 163
 164 ** Latest changes to the Worg git repository
 165
 166 #+begin_export html
 167 <script language="JavaScript" src="http://feed2js.org//feed2js.php?src=http%3A%2F%2Forgmode.org%2Fw%2F%3Fp%3Dworg.git%3Ba%3Drss%3Bopt%3D--no-merges&num=10&au=y&date=y&targ=y&utf=y"  charset="UTF-8" type="text/javascript"></script>
 168
 169 <noscript>
 170 <a href="http://feed2js.org//feed2js.php?src=http%3A%2F%2Forgmode.org%2Fw%2F%3Fp%3Dworg.git%3Ba%3Drss%3Bopt%3D--no-merges&num=10&au=y&date=y&targ=y&utf=y&html=y">View RSS feed</a>
 171 </noscript>
 172 #+end_export
 173
 174 Note: You can also subscribe to changes via [[http://repo.or.cz/worg.git/rss][RSS]] or [[http://repo.or.cz/worg.git/atom][ATOM]] (both courtesy of repo.or.cz).
 175
 176 * Git'r done!
 177
 178 If you like losing your time by reading stuff on how to get organized,
 179 go and check the [[file:gitrdone.org][Git'r done!]] page.