From mboxrd@z Thu Jan  1 00:00:00 1970
From: Sebastian Rose <sebastian_rose@gmx.de>
Subject: Re: How to define TODOs within continuous text the best way?
Date: Sat, 28 Mar 2009 18:16:33 +0100
Message-ID: <873acx8t5a.fsf@kassiopeya.MSHEIMNETZ>
References: <49CE32EC.5060508@gmx.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1LncCU-0004Sh-FX
	for emacs-orgmode@gnu.org; Sat, 28 Mar 2009 13:20:06 -0400
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1LncCP-0004GT-66
	for emacs-orgmode@gnu.org; Sat, 28 Mar 2009 13:20:05 -0400
Received: from [199.232.76.173] (port=58740 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1LncCO-0004GI-Vq
	for emacs-orgmode@gnu.org; Sat, 28 Mar 2009 13:20:01 -0400
Received: from mail.gmx.net ([213.165.64.20]:36171)
	by monty-python.gnu.org with smtp (Exim 4.60)
	(envelope-from <sebastian_rose@gmx.de>) id 1LncCO-0004rC-GA
	for emacs-orgmode@gnu.org; Sat, 28 Mar 2009 13:20:00 -0400
In-Reply-To: <49CE32EC.5060508@gmx.de> (Karl Maihofer's message of "Sat, 28
	Mar 2009 15:23:40 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Karl Maihofer <ignoramus@gmx.de>
Cc: emacs-orgmode@gnu.org


Karl Maihofer <ignoramus@gmx.de> writes:
> Perhaps it is possible to define TODOs as a very deep-level heading,
> that isn't needed, like "********** TODO text" and change the export
> function that this level isn't exported as a heading but as a
> "div"-Container? Or every heading that contains "TODO" is not exported
> as a heading but as a div-container?


Yes, this is possible. By default only the first three levels are
exported as headlines. Any headline that is deeper nested, is exported
as a list item.

The variable in question is

   `org-export-headline-levels'


> What is the best way to handle TODOs within continuous text?

Those list items are not displayed inline, but produce no entry in the
TOC.


I have several commands like that defined (\rzidea, ...) and some
produce a box with an icon and frame, that does not use the margin.


Here's the inline version:

=> --->8----------------------------->8----------------------------->8---

\newcommand { \rztodoinline }
[1]
{\colorbox[rgb]{1,0.4,0.2}{\textbf{TODO}}{\textbf{~#1}}}

<= ---8<-----------------------------8<-----------------------------8<---





For things I need to fix in the document itself, I prefer a more visible
presentation of TODOs. For LaTeX/PDF I even use this here:


=> --->8----------------------------->8----------------------------->8---
* Headline

  some text here...

  \rztodo{Description of todo.}

  more text here...

<= ---8<-----------------------------8<-----------------------------8<---


\rztodo is command defined in an LaTeX include file:


=> --->8----------------------------->8----------------------------->8---

\newcommand { \rztodo }
[1]
{%
  \medskip
  \nopagebreak
  \noindent
  \rule{\textwidth}{0.5pt}\\*[1mm]
  \marginpar{\colorbox[rgb]{1,0.4,0.2}{\textbf{TODO}}}
  #1\\*[-1mm]
  \rule{\textwidth}{0.5pt}\\
  \nopagebreak[3]
}

<= ---8<-----------------------------8<-----------------------------8<---



This creates a _very_ visible box in the margin and the result looks
like this (TODO is white on red):

=> --->8----------------------------->8----------------------------->8---

1 Headline

  some text here...

  ------------------------------------------------------  +------+
  Description of todo.                                    | TODO |
  ------------------------------------------------------  +------+

  more text here...

<= ---8<-----------------------------8<-----------------------------8<---



Best Regards,


   Sebastian