emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Carsten Dominik <carsten.dominik@gmail.com>
To: Baoqiu Cui <cbaoqiu@yahoo.com>, Matthew Lundin <mdl@imapmail.org>
Cc: emacs-orgmode Mailinglist <emacs-orgmode@gnu.org>
Subject: Re: Re: Feature request (org-empty-line-terminates-plain-lists)
Date: Tue, 24 Mar 2009 09:48:00 +0100	[thread overview]
Message-ID: <BE648146-C304-41D4-A44C-8D3F43B937F0@gmail.com> (raw)
In-Reply-To: <byc63hztpio.fsf@muchbodyking-lm.gateway.2wire.net>

Hi Matt, Baoqiu,

this is a difficult issue.

Indentation is what governs the end of lists.  However, this concept
conflicts with the face that some constructs in Org cannot be indented
at all, in particular things like #+begin_example ena the like.

You are both right that tables and ": ..." examples could be written
with correct indentation, but this is only a partial solution.

Currently, the HTML exporter handles all these constructs as
"indentation irrelevant" and puts them into the list structure.
Given the fact that some special constructs cannot be indented,
this is the only way to have a source code example or a blockquote
as part of a list item.

As you noted correctly, LaTeX export does treat indentation of examples
and tables significantly and terminates list.  Clearly inconsistent.

Possible solutions:

1. Allow #+begin_example and friends to be indented and remove the same
    amount of whitespace from all example lines as the #+begin line has.
    This is possible, but would require a lot of work in the LaTeX  
exporter.
    It would also cause a lot of problems with the edit-source-code  
stuff
    with "C-c '", because we could then no longer use indentation
    functionality while editing the examples.

2. Adapt the LaTeX exporter to work like the HTML exporter, ignoring
    indentation of tables and example.  The, introduce a special list
    item like "- ___" to explicitly terminate a list if this should be  
necessary.

I welcome comments on this issue.

- Carsten

On Mar 24, 2009, at 7:15 AM, Baoqiu Cui wrote:

> Matthew Lundin <mdl@imapmail.org> writes:
>
>> Carsten,
>>
>> Matthew Lundin <mdl@imapmail.org> writes:
>>
>>> If I may be so bold, I'd like to request an additional setting for
>>> org-empty-line-terminates-plain-lists. Namely, I was wondering if it
>>> would be possible to add an option whereby 2 empty lines would  
>>> terminate
>>> a plain list.
>>
>> Please disregard this request. I think I did not identify the problem
>> correctly. The problem, instead, lies in the html export.
>>
>> When a plain list is followed by a paragraph, the list is closed in  
>> the
>> the export before the paragraph.
>>
>> --8<---------------cut here---------------start------------->8---
>> - Item One
>>
>> - Item Two
>>
>> Here is the paragraph.
>> --8<---------------cut here---------------end--------------->8---
>>
>> results in....
>>
>> ,----
>> | <ul>
>> | <li>
>> | Item One
>> |
>> | </li>
>> | <li>
>> | Item Two
>> |
>> | </li>
>> | </ul>
>> |
>> | <p>Here is the paragraph.
>> | </p>
>> `----
>>
>> But when a table follows the list, as in...
>>
>> --8<---------------cut here---------------start------------->8---
>> - Item One
>>
>> - Item Two
>>
>> | Table cell | Another table cell |
>> --8<---------------cut here---------------end--------------->8---
>
> In my opinion, whether this table should terminate the list or be
> included in "Item Two" has to be decided by the indentation level of  
> the
> table.  In this case, since there is no indentation at all for the
> table, it should terminate the list.  The table would be considered  
> part
> of "Item Two" if it is written in the following way
>
> ------------------------------------------------------------------------
> - Item One
>
> - Item Two
>
>  | Table cell | Another table cell |
> ------------------------------------------------------------------------
>
> I ran into this little ambiguity problem when I was testing the  
> DocBook
> exporter, but have not got chance to resolve this problem.  Similar
> problem also exists for literal examples (and maybe other types of
> blocks):
>
>
> ------------------------------------------------------------------------
> - Item One
>
> - Item Two
>
>  : Some example from a text file
>  : Another line in the example
> ------------------------------------------------------------------------
>
> In this case, the literal example lines should be considered part of
> "Item Two".  If the two spaces before ':' do not exist, this literal
> example will terminate the list.
>
> Is this reasonable?
>
> Baoqiu
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

  reply	other threads:[~2009-03-24  8:48 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-03-23 21:28 Feature request (org-empty-line-terminates-plain-lists) Matthew Lundin
2009-03-23 23:08 ` Matthew Lundin
2009-03-24  6:15   ` Baoqiu Cui
2009-03-24  8:48     ` Carsten Dominik [this message]
2009-03-24 23:13       ` Matthew Lundin
2009-03-25  6:37       ` Baoqiu Cui
2009-06-08 17:59         ` Carsten Dominik
2009-03-25  6:49 ` Samuel Wales

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=BE648146-C304-41D4-A44C-8D3F43B937F0@gmail.com \
    --to=carsten.dominik@gmail.com \
    --cc=cbaoqiu@yahoo.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=mdl@imapmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).