From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ilya Shlyakhter Subject: suggestion for the manual: mention the "#+BEGIN_SRC org" trick when describing drawers and plainlists Date: Wed, 7 Mar 2012 20:13:41 -0500 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=bcaec502d790963f4704bab0fc52 Return-path: Received: from eggs.gnu.org ([208.118.235.92]:46790) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S5RvO-0000Lv-A8 for emacs-orgmode@gnu.org; Wed, 07 Mar 2012 20:13:47 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S5RvM-0007LG-FX for emacs-orgmode@gnu.org; Wed, 07 Mar 2012 20:13:45 -0500 Received: from mail-vx0-f169.google.com ([209.85.220.169]:56266) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S5RvM-0007Ks-90 for emacs-orgmode@gnu.org; Wed, 07 Mar 2012 20:13:44 -0500 Received: by vcbfk14 with SMTP id fk14so6969362vcb.0 for ; Wed, 07 Mar 2012 17:13:41 -0800 (PST) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode --bcaec502d790963f4704bab0fc52 Content-Type: text/plain; charset=ISO-8859-1 In Org, entry text can't have substructure (other than drawers and plain lists): you can't have an entry that has some text, then a subtree, then more text. I just (re-)discovered that you can get around that by using "#+BEGIN_SRC org" to include arbitrary org subtrees in the middle of entry text. That's useful not just when writing in Org about Org, but anytime you want to insert an extended sidenote in the middle of an entry. As with all source blocks, you edit it in its native (Org) mode and it exports correctly. You can copy links from the main Org and past them into the nested Org. Just wish I'd learned this sooner :) So, maybe mention this in the manual in the sections on drawers and plainlists. ilya --bcaec502d790963f4704bab0fc52 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable In Org, entry text can't have substructure (other than drawers and plai= n lists): you can't have an entry that
has some text, then a subtree= , then more text.
I just (re-)discovered that you can get around that by= using "#+BEGIN_SRC org" to include arbitrary org
subtrees in the middle of entry text.=A0=A0 That's useful not just when= writing in Org about Org, but anytime you want
to insert an extended si= denote in the middle of an entry.=A0 As with all source blocks, you edit it= in its native (Org)
mode and it exports correctly.=A0 You can copy links from the main Org and = past them into the nested Org.

Just wish I'd learned this sooner= :)=A0 So, maybe mention this in the manual in the sections on drawers and = plainlists.

ilya

--bcaec502d790963f4704bab0fc52--