emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Making an org file more readable
@ 2009-08-24  5:30 PT
  2009-08-24  5:46 ` Nick Dokos
  0 siblings, 1 reply; 7+ messages in thread
From: PT @ 2009-08-24  5:30 UTC (permalink / raw)
  To: emacs-orgmode

My main gripe with org is that the appearance is too
crowded. Even if the header lines have different colors the
individual projects and sections I keep in the file have no visual
separation between them. For example, sometimes I'd like to add
empty lines after a header, so there is some visual space before
the next header begins. The problem is the empty lines at the end
of the content are folded too when the content is folded.

I know it's more of an outline issue than an org issue, but I ask
here nevertheless: did anyone find a good way to separate the
headers from each other in a big org file visually, so it is more
readable?

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Making an org file more readable
  2009-08-24  5:30 Making an org file more readable PT
@ 2009-08-24  5:46 ` Nick Dokos
  2009-08-24  5:55   ` PT
  2009-08-24 11:11   ` PT
  0 siblings, 2 replies; 7+ messages in thread
From: Nick Dokos @ 2009-08-24  5:46 UTC (permalink / raw)
  To: PT; +Cc: emacs-orgmode

PT <spamfilteraccount@gmail.com> wrote:

> My main gripe with org is that the appearance is too
> crowded. Even if the header lines have different colors the
> individual projects and sections I keep in the file have no visual
> separation between them. For example, sometimes I'd like to add
> empty lines after a header, so there is some visual space before
> the next header begins. The problem is the empty lines at the end
> of the content are folded too when the content is folded.
> 
> I know it's more of an outline issue than an org issue, but I ask
> here nevertheless: did anyone find a good way to separate the
> headers from each other in a big org file visually, so it is more
> readable?
> 

You *can* get an empty line between two headers by having two empty lines at
the end of the first section: the first empty line is considered part of
the section and is folded with it, but the second one remains. E.g.


,----
| 
| * foo
| This is a test.
| ** baz
| and another
| 
| 
| ** hunoz
| and one more
| 
| 
| * bar
`----

When you fold it, it becomes

,----
| 
| * foo...
| 
| * bar
`----

HTH,
Nick

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Making an org file more readable
  2009-08-24  5:46 ` Nick Dokos
@ 2009-08-24  5:55   ` PT
  2009-08-24 11:11   ` PT
  1 sibling, 0 replies; 7+ messages in thread
From: PT @ 2009-08-24  5:55 UTC (permalink / raw)
  To: emacs-orgmode

Nick Dokos <nicholas.dokos <at> hp.com> writes:
> 
> You *can* get an empty line between two headers by having two empty lines at
> the end of the first section: the first empty line is considered part of
> the section and is folded with it, but the second one remains. E.g.

For some reason, I didn't try that. :) Thanks. One annoyance less.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Making an org file more readable
  2009-08-24  5:46 ` Nick Dokos
  2009-08-24  5:55   ` PT
@ 2009-08-24 11:11   ` PT
  2009-08-24 14:18     ` Carsten Dominik
  1 sibling, 1 reply; 7+ messages in thread
From: PT @ 2009-08-24 11:11 UTC (permalink / raw)
  To: emacs-orgmode

Nick Dokos <nicholas.dokos <at> hp.com> writes:
> 
> You *can* get an empty line between two headers by having two empty lines at
> the end of the first section: the first empty line is considered part of
> the section and is folded with it, but the second one remains. E.g.

One more thing for those who don't know this:

I took a look at the relevant part of outline.el and turns out
one empty line is enough if outline-blank-line is set to t.


It's almost perfect. It would be perfect if outline would leave
alone all empty lines after the content, so if I have e.g. two
empty lines there then it would fold non-empty lines only leaving
both empty lines visible, so that I could use as many
empty lines for separation as I want.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Re: Making an org file more readable
  2009-08-24 11:11   ` PT
@ 2009-08-24 14:18     ` Carsten Dominik
  2009-09-04  5:10       ` PT
  0 siblings, 1 reply; 7+ messages in thread
From: Carsten Dominik @ 2009-08-24 14:18 UTC (permalink / raw)
  To: PT; +Cc: emacs-orgmode


On Aug 24, 2009, at 1:11 PM, PT wrote:

> Nick Dokos <nicholas.dokos <at> hp.com> writes:
>>
>> You *can* get an empty line between two headers by having two empty  
>> lines at
>> the end of the first section: the first empty line is considered  
>> part of
>> the section and is folded with it, but the second one remains. E.g.
>
> One more thing for those who don't know this:
>
> I took a look at the relevant part of outline.el and turns out
> one empty line is enough if outline-blank-line is set to t.
>
>
> It's almost perfect. It would be perfect if outline would leave
> alone all empty lines after the content, so if I have e.g. two
> empty lines there then it would fold non-empty lines only leaving
> both empty lines visible, so that I could use as many
> empty lines for separation as I want.

Actually, Org pretty much overrules what outline does in this context.

I have just pushed a modification so that you can, after pulling
from git, set org-cycle-separator-lines to a negative number.
If you set it to -N, N empty lines will be required in order
to get a separation.  But, if there are enough empty lines,
all will be shown.

You might want to set this to -1., I like my old value of +2 best.

- Carsten

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Making an org file more readable
  2009-08-24 14:18     ` Carsten Dominik
@ 2009-09-04  5:10       ` PT
  2009-09-04  8:59         ` Carsten Dominik
  0 siblings, 1 reply; 7+ messages in thread
From: PT @ 2009-09-04  5:10 UTC (permalink / raw)
  To: emacs-orgmode

Carsten Dominik <carsten.dominik <at> gmail.com> writes:

> 
> I have just pushed a modification so that you can, after pulling
> from git, set org-cycle-separator-lines to a negative number.
> If you set it to -N, N empty lines will be required in order
> to get a separation.  But, if there are enough empty lines,
> all will be shown.
> 
> You might want to set this to -1., I like my old value of +2 best.

I tried this new setting with 6.30 and it works well, thanks for
this.

The only strange case is when a header line doesn't have any
content, only empty lines.

So if there are 2 empty lines between headers

* header1


* header2


Then the first empty line after header1 is folded regardless of
the -1 setting.  If I understand the feature correctly no folding
should occur in this case either.

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: Re: Making an org file more readable
  2009-09-04  5:10       ` PT
@ 2009-09-04  8:59         ` Carsten Dominik
  0 siblings, 0 replies; 7+ messages in thread
From: Carsten Dominik @ 2009-09-04  8:59 UTC (permalink / raw)
  To: PT; +Cc: emacs-orgmode

Fixed, thanks.

- Carsten

On Sep 4, 2009, at 7:10 AM, PT wrote:

> Carsten Dominik <carsten.dominik <at> gmail.com> writes:
>
>>
>> I have just pushed a modification so that you can, after pulling
>> from git, set org-cycle-separator-lines to a negative number.
>> If you set it to -N, N empty lines will be required in order
>> to get a separation.  But, if there are enough empty lines,
>> all will be shown.
>>
>> You might want to set this to -1., I like my old value of +2 best.
>
> I tried this new setting with 6.30 and it works well, thanks for
> this.
>
> The only strange case is when a header line doesn't have any
> content, only empty lines.
>
> So if there are 2 empty lines between headers
>
> * header1
>
>
> * header2
>
>
> Then the first empty line after header1 is folded regardless of
> the -1 setting.  If I understand the feature correctly no folding
> should occur in this case either.
>
>
>
> _______________________________________________
> 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

^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2009-09-04  9:00 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2009-08-24  5:30 Making an org file more readable PT
2009-08-24  5:46 ` Nick Dokos
2009-08-24  5:55   ` PT
2009-08-24 11:11   ` PT
2009-08-24 14:18     ` Carsten Dominik
2009-09-04  5:10       ` PT
2009-09-04  8:59         ` Carsten Dominik

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).