From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: What the difference between the non-source blocks? Date: Sat, 15 Jun 2013 14:48:03 +0200 Message-ID: <87d2rnk0ak.fsf@gmail.com> References: <87fvwjkbw9.fsf@gmail.com> <87bo77kbn3.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38878) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Unpte-0005em-2A for emacs-orgmode@gnu.org; Sat, 15 Jun 2013 08:47:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Unptb-0008BN-E9 for emacs-orgmode@gnu.org; Sat, 15 Jun 2013 08:47:57 -0400 Received: from mail-wi0-x230.google.com ([2a00:1450:400c:c05::230]:59846) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Unptb-0008B6-7v for emacs-orgmode@gnu.org; Sat, 15 Jun 2013 08:47:55 -0400 Received: by mail-wi0-f176.google.com with SMTP id ey16so1081429wid.15 for ; Sat, 15 Jun 2013 05:47:54 -0700 (PDT) In-Reply-To: <87bo77kbn3.fsf@gmail.com> (Thorsten Jolitz's message of "Sat, 15 Jun 2013 10:42:56 +0200") 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: Thorsten Jolitz Cc: emacs-orgmode@gnu.org Hello, Thorsten Jolitz writes: > I usually use my gut feeling to decide if I use an EXAMPLE or a QUOTE or > a VERSE block. I would prefer to have a kind of mental decision like > > ,--------------- > | if A > | then EXAMPLE > | else if B > | then QUOTE > | else VERSE > `--------------- > > or so. So what would be a complete list of these "verbatim" environments > in Org-mode, and how could their chacteristics be described in a few > words? Can I find that in the manual or somewhere else? > > In section 15.2. Easy Templates I find > > | block | use for? | > --------------------- > |EXAMPLE | | > |QUOTE | | > |VERSE | | > |CENTER | | > > Is this a complete list? What are the criteria to choose one or the > other? > > Thanks for tips or a related link. >From the most restrictive environment to the least one: - example block :: Indentation, blank lines (excepted at the beginning and the end of the block) and line breaks are preserved. No Org syntax whatsoever is recognized within. This is like a source block without a language (you can number lines...). - verse block :: Indentation, blank lines (excepted at the beginning and the end of the block) and line breaks are preserved. Org objects are recognized (e.g., emphasis) but not elements (e.g., paragraphs) - quote block and center block :: They can contain anything, including elements (e.g., paragraphs, lists...). Center blocks center their contents (duh!) and Quote blocks make them stand out in some way. Regards, -- Nicolas Goaziou