Created byCarsten Dominik in2003, maintained byIhor Radchenko and developed bymany others.
Org is a highly flexible structured plain text file format, composedof a few simple, yet versatile, structures — constructed to be bothsimple enough for the novice andpowerful enough for the expert.
Get a glimpse of the expressive power Org offers in the example below.Click the headings and links to discover how Org intelligently folds structural content.
#+title:Example Org File#+author:TEC#+date:2020-10-27
* Revamp orgmode.org website
The/beauty/ of org*must* be shared.
[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]
**DONE Make screenshots
CLOSED:[2020-09-03 Thu 18:24]
**DONE Restyle Site CSS
Go through[[file:style.scss][stylesheet]]
**TODO Check CSS on main pages
* Learn Org
Org makes easy things trivial and complex things practical.You don't need to learn Org before using Org: read the quickstartpage and you should be good to go. If you need more, Org will behere for you as well: dive into the manual and join the community!
** Feedback
#+include: "other/feedback.org*manual" :only-contents t
* Check CSS minification ratios
#+begin_src python
from pathlibimport PathcssRatios = []for css_minin Path("resources/style").glob("*.min.css"):css = css_min.with_suffix('').with_suffix('.css') cssRatios.append([css.name,"{:.0f}% minified ({:4.1f} KiB)".format(100 * css_min.stat().st_size / css.stat().st_size, css_min.stat().st_size /1000)])return cssRatios
#+end_src
#+RESULTS:
| index.css | 76% minified ( 1.4 KiB) || org-demo.css | 77% minified ( 2.8 KiB) || errors.css | 74% minified ( 4.9 KiB) || org.css | 75% minified (10.7 KiB) |
Beyond thequickstart and themanual, Org has aguide and a wealth ofcommunity-written documentation onWorg .
Nearly every Org user has a story to tell about how Org enables andempowers them — some have found it so useful that they have written(scientific) papers about the value of Org for conductingreproducibleresearch. Some have produced third party tools to enjoy Org outside ofEmacs, such as mobile applications.
Thede factomimetype for Org files istext/org
. Org files use the.org
extension. Most operating systems don't know to open.org
files in Emacs, but they can be configured to do so without mucheffort.
While the reference implementation of Org in Emacs lisp is by far themost featureful, there are many additionaltools that work with Org.
New features:
<No new features added to Org mode recently>
Org and Org-mode have so many use cases that it is simply not possibleto easily document them, let alone show them all off on a single page.As a result,Worg serves as a community wiki and provides a place todocument and share information about all aspects of using and workingwith Org.
For example, Worg contains:
Worg is maintained as a Git repository of Org files that are publishedas an HTML website. Newcontributors are welcome.
~$ git clone https://git.sr.ht/~bzg/worg
Org mailing list is the central place where to connect with Orgcommunity. You cansubscribe to the list and browse the list archive onlist.orgmode.org or onthis mailman page.
If you are not a subscriber to the list, you can still send an emailtoemacs-orgmode@gnu.org, we will add you to the whitelist of peoplewho can reach the list.
You canread more on the mailing list and more information onOrg newson the social web.
You can also connect with other org-thusiasts via IRC at#org-mode
onLibera.Chat.
The fulllist of contributors to Org mode is maintained inWorg andyou can also check the manual'sacknowledgments.
The Emacs starter kitsDoom,Spacemacs andScimax come with a curatedset of packages and configurations that aim to enhance Org mode (andEmacs more generally) for particular use cases. They include Orgalong with integrations betweenorg-mode
and other modes (such asevil-mode
). Here are links to the current packages included withDoom, andSpacemacs.Scimax is deeply integrated with Org so a goodplace to start is themanual.Doom installs a version of Org that isclose to the developmentHEAD
, whileSpacemacs andScimax track orgelpa.
Starter kits often make significant changes to the default userexperience for Emacs. If you are looking for something closer tovanilla Emacs there are popular configs such asPurcell's emacs.d thatinclude org-mode customization and Org-related packages.
While the full set of Orgfeatures is currently exclusive to Emacs,basic functionality for Org files has been implemented for a varietyof editors and mobile apps. Here are some extensions and apps thatenable support for Org files.
Created byTEC with
licensed under theGNU FDL 1.3 — see thesource code for this website.