Org mode for Emacs
Org Mode は、極めて柔軟な構造化されたプレーンテキストのファイルフォーマットです。いくつかのシンプルな要素で構成されているのに、多用途で、簡単なことから複雑なことまで対応します。つまり、初心者から熟練者まで幅広いユーザが満足できます。
Org Mode が提供する機能を以下に例示しました。そのパワフルさがひと目で分かります。(*で始まる)見出しをクリックしてみましょう。見出しに紐付いた構造化された記述が折りたたまれ、必要な情報だけが表示されるのを楽しんでください。
#+title: Example Org File #+author: TEC #+date: 2020-10-27
Outlining
Headings and folding make structured editing a breeze.
Plain text makes it easy to sync and version control Org files.
* Revamp orgmode.org website
Outlining
Headings and folding make structured editing a breeze. Plain text makes it easy to sync and version control Org files.Agenda
List todos across all your files. Filter content, and update it in place.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
Prose
* Learn Org
Org makes easy things trivial and complex things practical. You don't need to learn Org before using Org: read the quickstart page and you should be good to go. If you need more, Org will be here 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
Babel
Perform literate programming in org, with notebook-like live code execution in the buffer.#+begin_src python
from pathlib import Path cssRatios = [] for css_min in 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
Evaluated results
#+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) |
関連文献
さらに…
text/org
が、Orgファイルの デファクト なメディアタイプです。拡張子は .org
を使います。ほとんどOSが、拡張子が .org
のファイルを Emacs で開くことを知りませんが、ちょっとした設定をすることで開けるようになります。
EmacsLisp で書かれた Org Mode の模範的な実装が、最も高機能であることは間違いありません。その一方で、Org Modeと連携する様々なツールが存在しています。
Worg (World Org)
Org Mode には多くのユースケースがあり、それらを文書化するのは簡単ではありません。単一のページですべて表示することも困難です。その代わりに、コミュニティベースの wiki である Worg が、文書を記録したり情報を共有する場所として使われています。Org Modeの使い方から、Org Modeを使った様々な操作ついて知ることができるでしょう。
次のようなコンテンツがあります。
- The FAQ
- Org hacks
- A list of tutorials
- Documentation on all hooks, commands and options
- Org in the wild
- …などなど
Worg は、Org ファイルを格納する Git リポジトリで管理されています。そして、それらのファイルが HTML 形式に変換されてウェブページとなります。使い方は、The first time you contribute to Worg (英語) を見てください。
~$ git clone https://git.sr.ht/~bzg/worg