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