emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Re: Beginners guide to Org customization
@ 2009-02-06 11:09 Rustom Mody
  0 siblings, 0 replies; 9+ messages in thread
From: Rustom Mody @ 2009-02-06 11:09 UTC (permalink / raw)
  To: emacs-orgmode

The idea of helping to ease org customizations is good and will reduce
the barrier to entry to new persons.
But it seems that 40 is too large for the new user and too small for
the power user.
Instead if we split up org usage into some broad categories, the
relevant customizations for that would be less bulky and so more
accessible.

Here is a tentative list of categories with some example customizations

* Web publishing
   #+AUTHOR
   #+OPTIONS : toc:nil
* Latex publishing
* Brainstorming
  (setq org-odd-levels-only t)
  (setq org-hide-leading-stars t)

* My-own-private hyperlink system
  (define-key global-map "\C-cr" 'org-remember)
  (define-key global-map "\C-cl" 'org-store-link)

* Time/project mgmt
*** Agenda-ing
*** Time tracking
*** GTD-ing
*** Journalling
* Tables and spreadsheets

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

* Re: Beginners guide to Org customization
  2009-02-05 18:01     ` Bernt Hansen
@ 2009-02-05 21:40       ` Carsten Dominik
  0 siblings, 0 replies; 9+ messages in thread
From: Carsten Dominik @ 2009-02-05 21:40 UTC (permalink / raw)
  To: Bernt Hansen; +Cc: emacs-orgmode Mailinglist


On Feb 5, 2009, at 7:01 PM, Bernt Hansen wrote:

> Carsten,
>
> That looks really good! (except for the FIXME at the bottom ;) )
>
> I really like this version :)
>
> I haven't verified that the setup steps you described actually work.
> Somebody(tm) should probably do that with a minimal emacs setup.
>
> I also haven't verified all the links referenced in the document go to
> appropriate places.
>
> Hmmm my setup doesn't have (org-remember-insinuate) (well it does
> now!) -- I wonder what breaks if that is missing.

org-remember-insinuate is simply a shortcut for the
old setup where you had to add functions to hooks yourself.
The definition of it is:

(defun org-remember-insinuate ()
   "Setup remember.el for use with Org-mode."
   (org-require-remember)
   (setq remember-annotation-functions '(org-remember-annotation))
   (setq remember-handler-functions '(org-remember-handler))
   (add-hook 'remember-mode-hook 'org-remember-apply-template))

It actually does one more thing:  If remember.el is not
found, it defines a miniature, just functional version of it.

- Carsten


>
>
> -Bernt
>
> Carsten Dominik <dominik@science.uva.nl> writes:
>
>> I have my home^h^h^h^h trainwork up as a new
>> attempt for the "Beginners Guide".
>> A lot more appropriate now, I think.  Bernt?
>>
>> - Carsten
>>
>> http://orgmode.org/worg/org-customization-guide.php
>>
>>
>> On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:
>>
>>> Carsten Dominik <dominik@science.uva.nl> writes:
>>>
>>>> I have made a structured list of 43 (which one can
>>>> we remove, please????) Variables that came in as frequently
>>>> customized variables in the customization survey.  It is not
>>>> exactly the top 43, I have used some additional judgement.
>>>
>>> I think a lot of these variables are things you play with _after_
>>> using
>>> org-mode for awhile.  Maybe the following variables should be
>>> introduced
>>> later?
>>>
>>> - org-archive-location
>>>
>>>   the default works, and you don't archive anytime soon after
>>> starting
>>>   to use org-mode.
>>>
>>> - org-startup-folded
>>>
>>>   start with #STARTUP first?
>>>
>>> - org-odd-levels-only
>>>
>>>   Talk about the conversion functions too (org-convert-to-odd-levels
>>>   and org-convert-to-oddeven-levels.)  I switched my files back and
>>>   forth a few times but ended up with oddeven levels due to the  
>>> depth
>>>   of some of my tasks.
>>>
>>> - org-special-ctrl-a/e
>>> - org-special-ctrl-k
>>>
>>>   I should maybe try these one day :)
>>>
>>> I've used org-mode for a few years now and I don't currently use  
>>> these
>>> variables. They're great to have but not essential to getting  
>>> started.
>>>
>>> The default values for the variables work in most cases.  I think  
>>> the
>>> ones that should be listed first are the ones you really have to
>>> customize to get org-mode to work for you.  Beginners will not want
>>> nor
>>> need this amount of detail to be productive with org-mode.  Having  
>>> too
>>> many variables to set up or play with up front may just scare people
>>> away.
>>>
>>> Maybe we just need to stress that customizations are optional and  
>>> you
>>> can completely ignore entire sections that don't apply to you
>>> (clocking,
>>> exporting, etc.) until you feel you need these additional features.
>>>
>>> HTH,
>>> Bernt

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

* Re: Beginners guide to Org customization
  2009-02-05 17:29   ` Carsten Dominik
@ 2009-02-05 18:01     ` Bernt Hansen
  2009-02-05 21:40       ` Carsten Dominik
  0 siblings, 1 reply; 9+ messages in thread
From: Bernt Hansen @ 2009-02-05 18:01 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode Mailinglist

Carsten,

That looks really good! (except for the FIXME at the bottom ;) )

I really like this version :)

I haven't verified that the setup steps you described actually work.
Somebody(tm) should probably do that with a minimal emacs setup.

I also haven't verified all the links referenced in the document go to
appropriate places.

Hmmm my setup doesn't have (org-remember-insinuate) (well it does
now!) -- I wonder what breaks if that is missing.

-Bernt

Carsten Dominik <dominik@science.uva.nl> writes:

> I have my home^h^h^h^h trainwork up as a new
> attempt for the "Beginners Guide".
> A lot more appropriate now, I think.  Bernt?
>
> - Carsten
>
> http://orgmode.org/worg/org-customization-guide.php
>
>
> On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:
>
>> Carsten Dominik <dominik@science.uva.nl> writes:
>>
>>> I have made a structured list of 43 (which one can
>>> we remove, please????) Variables that came in as frequently
>>> customized variables in the customization survey.  It is not
>>> exactly the top 43, I have used some additional judgement.
>>
>> I think a lot of these variables are things you play with _after_
>> using
>> org-mode for awhile.  Maybe the following variables should be
>> introduced
>> later?
>>
>>  - org-archive-location
>>
>>    the default works, and you don't archive anytime soon after
>> starting
>>    to use org-mode.
>>
>>  - org-startup-folded
>>
>>    start with #STARTUP first?
>>
>>  - org-odd-levels-only
>>
>>    Talk about the conversion functions too (org-convert-to-odd-levels
>>    and org-convert-to-oddeven-levels.)  I switched my files back and
>>    forth a few times but ended up with oddeven levels due to the depth
>>    of some of my tasks.
>>
>>  - org-special-ctrl-a/e
>>  - org-special-ctrl-k
>>
>>    I should maybe try these one day :)
>>
>> I've used org-mode for a few years now and I don't currently use these
>> variables. They're great to have but not essential to getting started.
>>
>> The default values for the variables work in most cases.  I think the
>> ones that should be listed first are the ones you really have to
>> customize to get org-mode to work for you.  Beginners will not want
>> nor
>> need this amount of detail to be productive with org-mode.  Having too
>> many variables to set up or play with up front may just scare people
>> away.
>>
>> Maybe we just need to stress that customizations are optional and you
>> can completely ignore entire sections that don't apply to you
>> (clocking,
>> exporting, etc.) until you feel you need these additional features.
>>
>> HTH,
>> Bernt

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

* Re: Beginners guide to Org customization
  2009-02-05 14:21 ` Bernt Hansen
  2009-02-05 14:34   ` Carsten Dominik
@ 2009-02-05 17:29   ` Carsten Dominik
  2009-02-05 18:01     ` Bernt Hansen
  1 sibling, 1 reply; 9+ messages in thread
From: Carsten Dominik @ 2009-02-05 17:29 UTC (permalink / raw)
  To: Bernt Hansen; +Cc: emacs-orgmode Mailinglist

I have my home^h^h^h^h trainwork up as a new
attempt for the "Beginners Guide".
A lot more appropriate now, I think.  Bernt?

- Carsten

http://orgmode.org/worg/org-customization-guide.php


On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:

> Carsten Dominik <dominik@science.uva.nl> writes:
>
>> I have made a structured list of 43 (which one can
>> we remove, please????) Variables that came in as frequently
>> customized variables in the customization survey.  It is not
>> exactly the top 43, I have used some additional judgement.
>
> I think a lot of these variables are things you play with _after_  
> using
> org-mode for awhile.  Maybe the following variables should be  
> introduced
> later?
>
>  - org-archive-location
>
>    the default works, and you don't archive anytime soon after  
> starting
>    to use org-mode.
>
>  - org-startup-folded
>
>    start with #STARTUP first?
>
>  - org-odd-levels-only
>
>    Talk about the conversion functions too (org-convert-to-odd-levels
>    and org-convert-to-oddeven-levels.)  I switched my files back and
>    forth a few times but ended up with oddeven levels due to the depth
>    of some of my tasks.
>
>  - org-special-ctrl-a/e
>  - org-special-ctrl-k
>
>    I should maybe try these one day :)
>
> I've used org-mode for a few years now and I don't currently use these
> variables. They're great to have but not essential to getting started.
>
> The default values for the variables work in most cases.  I think the
> ones that should be listed first are the ones you really have to
> customize to get org-mode to work for you.  Beginners will not want  
> nor
> need this amount of detail to be productive with org-mode.  Having too
> many variables to set up or play with up front may just scare people
> away.
>
> Maybe we just need to stress that customizations are optional and you
> can completely ignore entire sections that don't apply to you  
> (clocking,
> exporting, etc.) until you feel you need these additional features.
>
> HTH,
> Bernt

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

* Re: Beginners guide to Org customization
  2009-02-05 14:21 ` Bernt Hansen
@ 2009-02-05 14:34   ` Carsten Dominik
  2009-02-05 17:29   ` Carsten Dominik
  1 sibling, 0 replies; 9+ messages in thread
From: Carsten Dominik @ 2009-02-05 14:34 UTC (permalink / raw)
  To: Bernt Hansen; +Cc: emacs-orgmode Mailinglist

Hi Bernt, good suggestions, thanks.

The list I made closely adheres to the most frequently set variables.
But I think you are right, we should be more restrictive here.

I will do what you suggest.  I think I will even remove the entire
clock section, for example, and instead add documentation about clock
persistence to the manual (actually, I just did that).

- Carsten

On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:

> Carsten Dominik <dominik@science.uva.nl> writes:
>
>> I have made a structured list of 43 (which one can
>> we remove, please????) Variables that came in as frequently
>> customized variables in the customization survey.  It is not
>> exactly the top 43, I have used some additional judgement.
>
> I think a lot of these variables are things you play with _after_  
> using
> org-mode for awhile.  Maybe the following variables should be  
> introduced
> later?
>
>  - org-archive-location
>
>    the default works, and you don't archive anytime soon after  
> starting
>    to use org-mode.
>
>  - org-startup-folded
>
>    start with #STARTUP first?
>
>  - org-odd-levels-only
>
>    Talk about the conversion functions too (org-convert-to-odd-levels
>    and org-convert-to-oddeven-levels.)  I switched my files back and
>    forth a few times but ended up with oddeven levels due to the depth
>    of some of my tasks.
>
>  - org-special-ctrl-a/e
>  - org-special-ctrl-k
>
>    I should maybe try these one day :)
>
> I've used org-mode for a few years now and I don't currently use these
> variables. They're great to have but not essential to getting started.
>
> The default values for the variables work in most cases.  I think the
> ones that should be listed first are the ones you really have to
> customize to get org-mode to work for you.  Beginners will not want  
> nor
> need this amount of detail to be productive with org-mode.  Having too
> many variables to set up or play with up front may just scare people
> away.
>
> Maybe we just need to stress that customizations are optional and you
> can completely ignore entire sections that don't apply to you  
> (clocking,
> exporting, etc.) until you feel you need these additional features.
>
> HTH,
> Bernt

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

* Re: Beginners guide to Org customization
  2009-02-05 11:54 Carsten Dominik
  2009-02-05 13:25 ` David Lord
@ 2009-02-05 14:21 ` Bernt Hansen
  2009-02-05 14:34   ` Carsten Dominik
  2009-02-05 17:29   ` Carsten Dominik
  1 sibling, 2 replies; 9+ messages in thread
From: Bernt Hansen @ 2009-02-05 14:21 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode Mailinglist

Carsten Dominik <dominik@science.uva.nl> writes:

> I have made a structured list of 43 (which one can
> we remove, please????) Variables that came in as frequently
> customized variables in the customization survey.  It is not
> exactly the top 43, I have used some additional judgement.

I think a lot of these variables are things you play with _after_ using
org-mode for awhile.  Maybe the following variables should be introduced
later?

  - org-archive-location

    the default works, and you don't archive anytime soon after starting
    to use org-mode.

  - org-startup-folded

    start with #STARTUP first?

  - org-odd-levels-only

    Talk about the conversion functions too (org-convert-to-odd-levels
    and org-convert-to-oddeven-levels.)  I switched my files back and
    forth a few times but ended up with oddeven levels due to the depth
    of some of my tasks.

  - org-special-ctrl-a/e
  - org-special-ctrl-k

    I should maybe try these one day :)

I've used org-mode for a few years now and I don't currently use these
variables. They're great to have but not essential to getting started.

The default values for the variables work in most cases.  I think the
ones that should be listed first are the ones you really have to
customize to get org-mode to work for you.  Beginners will not want nor
need this amount of detail to be productive with org-mode.  Having too
many variables to set up or play with up front may just scare people
away.

Maybe we just need to stress that customizations are optional and you
can completely ignore entire sections that don't apply to you (clocking,
exporting, etc.) until you feel you need these additional features.

HTH,
Bernt

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

* Re: Beginners guide to Org customization
  2009-02-05 13:25 ` David Lord
@ 2009-02-05 13:52   ` Carsten Dominik
  0 siblings, 0 replies; 9+ messages in thread
From: Carsten Dominik @ 2009-02-05 13:52 UTC (permalink / raw)
  To: David Lord; +Cc: emacs-orgmode Mailinglist

Yes, you are right.

This is done.

- Carsten

On Feb 5, 2009, at 2:25 PM, David Lord wrote:

> Carsten,
>
> I can see that org-clock-persistence-insinuate appeared in 6.11 but I
> can't find it in the manual.  Does it need to be added?
>
> Regards
> David Lord
>
> 2009/2/5 Carsten Dominik <dominik@science.uva.nl>:
>> Hi,
>>
>> I have made a structured list of 43 (which one can
>> we remove, please????) Variables that came in as frequently
>> customized variables in the customization survey.  It is not
>> exactly the top 43, I have used some additional judgement.
>>
>> Comment are welcome.
>>
>>  http://orgmode.org/worg/org-customization-guide.php
>>
>>
>> - Carsten

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

* Re: Beginners guide to Org customization
  2009-02-05 11:54 Carsten Dominik
@ 2009-02-05 13:25 ` David Lord
  2009-02-05 13:52   ` Carsten Dominik
  2009-02-05 14:21 ` Bernt Hansen
  1 sibling, 1 reply; 9+ messages in thread
From: David Lord @ 2009-02-05 13:25 UTC (permalink / raw)
  To: Carsten Dominik; +Cc: emacs-orgmode Mailinglist

Carsten,

I can see that org-clock-persistence-insinuate appeared in 6.11 but I
can't find it in the manual.  Does it need to be added?

Regards
David Lord

2009/2/5 Carsten Dominik <dominik@science.uva.nl>:
> Hi,
>
> I have made a structured list of 43 (which one can
> we remove, please????) Variables that came in as frequently
> customized variables in the customization survey.  It is not
> exactly the top 43, I have used some additional judgement.
>
> Comment are welcome.
>
>   http://orgmode.org/worg/org-customization-guide.php
>
>
> - Carsten

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

* Beginners guide to Org customization
@ 2009-02-05 11:54 Carsten Dominik
  2009-02-05 13:25 ` David Lord
  2009-02-05 14:21 ` Bernt Hansen
  0 siblings, 2 replies; 9+ messages in thread
From: Carsten Dominik @ 2009-02-05 11:54 UTC (permalink / raw)
  To: emacs-orgmode Mailinglist

Hi,

I have made a structured list of 43 (which one can
we remove, please????) Variables that came in as frequently
customized variables in the customization survey.  It is not
exactly the top 43, I have used some additional judgement.

Comment are welcome.

    http://orgmode.org/worg/org-customization-guide.php


- Carsten

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

end of thread, other threads:[~2009-02-06 11:09 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2009-02-06 11:09 Beginners guide to Org customization Rustom Mody
  -- strict thread matches above, loose matches on Subject: below --
2009-02-05 11:54 Carsten Dominik
2009-02-05 13:25 ` David Lord
2009-02-05 13:52   ` Carsten Dominik
2009-02-05 14:21 ` Bernt Hansen
2009-02-05 14:34   ` Carsten Dominik
2009-02-05 17:29   ` Carsten Dominik
2009-02-05 18:01     ` Bernt Hansen
2009-02-05 21:40       ` Carsten Dominik

Code repositories for project(s) associated with this 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).