[Orgmode] Can I publish one block of org file?

2009-09-15 Thread Water Lin

I am using org to write my draft. After finish the writing, I will copy
to my blog poster and edit something like linker, pictures.

This way works but is a little slow and should be very careful or else
it is very easy to forget some linkers, pictures, etc.

I am trying to find a way to write full text in org mode. I think it is
a good way to do following:
---
After I finish the writing, I select the block of my article, then use a
command to publish it to basic html and copy the html code into memory.


I don't need whole html elements, just need the customized html code for
the block.

I try to read the org help doc but can't find anything related to
it. Please give me a start stone, thanks...
-- 
Water Lin's blog: http://blog.waterlin.org
Email: water...@ymail.com
__
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com 



___
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


Re: [Orgmode] Unnumbered sections in LaTeX export

2009-09-15 Thread Thomas S. Dye


On Sep 14, 2009, at 5:34 PM, Sebastian Rose wrote:


Thomas S. Dye t...@tsdye.com writes:

On Sep 14, 2009, at 10:21 AM, Sebastian Rose wrote:


Thomas S. Dye t...@tsdye.com writes:

Aloha all,

The variable org-export-latex-classes has a specification for  
unnumbered
sections but I haven't found any documentation how to mark  up  
the org file

to
activate them.  I might have missed something  obvious.  Could  
someone give

me a
pointer to documentation or some  help how to markup the org file?

All the best,
Tom


Thomas,

Are you looking for

 M-x customize-variable RET org-export-with-section-numbers RET

??

As Matt wrote, per file setting is:

#+OPTIONS: num:nil




Sebastian


Yes, that is it.  Thanks!

Is there any way to set this for an individual headline?  Or, is it  
effective

only for the entire file, or portion of file, that is  exported?

All the best,
Tom



No. There is just the global default (`org-export-with-section- 
numbers')

and the per-file setting. Both entire files.


Best wishes


  Sebastian


Thanks Sebastian.  I appreciate the expert assistance.  I have a  
simple export to Beamer working and was trying to implement automatic  
export of columns, too.  The starred sections were going to be  
placeholders for the columns heading level when it wasn't used.  I've  
found that skipping a headline level in the source causes the latex  
exporter to skip over subsequent inferior levels, so it isn't possible  
to assign a heading level to columns and then use them or not as the  
case requires.  I'm actually quite happy with the simple export I have  
working.  Beamer templates that show the document structure are easy  
to write to using org-mode, where document structure is so important.


All the best,
Tom




___
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


Re: [Orgmode] Problem with quoting in #+BEGIN blocks

2009-09-15 Thread Carsten Dominik


On Sep 14, 2009, at 8:41 AM, Roman Geus wrote:


Hello

I'm fairly new to org-mode, and I am surprised about the quoting
behavior in #+BEGIN_EXAMPLE blocks:

The following org file, results in two level 1 titles (* ASCII report
and * Part 1) when the file is reopened in emacs.

* ASCII report
#+BEGIN_EXAMPLE
*
* Part 1
*
bla, bla, bla
#END_EXAMPLE

I expected * Part 1 to be interpreted as ordinary text.


Hi Roman,

first of all, it is #+END_EXAMPLE, not #END_EXAMPLE

For export it then works fine.  To avoid the interpretation of
* Part 1 as a headline inside Org-mode, quote it like this:

#+BEGIN_EXAMPLE
,*
,* Part 1
,*
bla, bla, bla
#+END_EXAMPLE

If you use C-c ' to edit snippets like this, the quoting is automatic.

HTH

- Carsten



Is this working as intended?

Thanks and regards,
Roman Geus

PS: I'm using org-mode 6.30 on GNU emacs 22.2.1 (Linux)


___
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




___
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


Re: [Orgmode] Re: org-convert-to-odd-levels bug

2009-09-15 Thread Carsten Dominik

Fixed, thanks.

- Carsten

On Sep 13, 2009, at 7:57 PM, Michael Brand wrote:


Michael Brand wrote:

with org-version 6.30e I get
* Org Mode
***  Introduction
*   Installation


I have noticed only now that this happens only when the buffer's  
mode has not yet been changed to org-mode. If a fix of this would be  
simple it would help in not caring about when setting the org-mode  
e. g. when migrating files from outline-mode to org-mode.



___
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




___
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


Re: [Orgmode] configure latex fragments preview

2009-09-15 Thread Carsten Dominik

Hi Nick,

:scale is use to change the -D dpi setting, which also changes the  
image size.


- Carsten

On Sep 14, 2009, at 8:39 PM, Nick Dokos wrote:


Nicolas Goaziou n.goaz...@gmail.com wrote:


This is some minor annoyance, but I would like to find a solution  
for it

anyway.

The preview image of a latex fragment produced by C-c C-x C-l is so
small that I sometimes find it hard to read.

In order to solve that situation, I modified org-format-latex- 
header so

that the template for the preview starts with
\documentclass[17pt]{extarticle}.

Though, I find it not quite satisfying as there is little control on
that size (I would like it to be a bit less than 17pt). Thus my  
question
(eventually) : is it possible to play with dvipng options like  
scale or

dpi directly, without modifying org.el ?

And if it doesn't exist, could a variable be introduced to fine- 
tune it ?


As a last note, I think there is a Latex only way to solve all of  
this,

but I wouldn't like to depends on too much latex packages or tricks.



The call to dvipng in org.el looks like this:

,
| ...
| (call-process dvipng nil nil nil
|   -fg fg -bg bg
|   -D dpi
|   ;;-x scale -y scale
|   -T tight
|   -o pngfile
|   dvifile)
| ...
`

Try modifying it to this:

,
|   ...
| (call-process dvipng nil nil nil
|   -fg fg -bg bg
|   -D dpi
|   ;;-x scale -y scale
| -x 2074
|   -T tight
|   -o pngfile
|   dvifile)
`

The dvipng man page suggests values for the -x option:

,
|-x num
|Set the x magnification ratio to num/1000. Overrides  
the magnification specified in the
|DVI file.  Must be between 10 and 10.  It is  
recommended that you use standard mag‐
|step values (1095, 1200, 1440, 1728, 2074, 2488, 2986,  
and so on) to help reduce the
|total number of PK files generated.  num may be a real  
number, not an integer, for

|increased precision.
`

Note the commented out -x/-y options in org.el: afaict, there is no -y
option, but perhaps Carsten can reintroduce the -x option, and then  
use

scale to set it properly (although the value of scale will need to be,
ahem, scaled).  If so, then you 'd be able to get what you want by
customizing org-format-latex-options:

,
| org-format-latex-options is a variable defined in `org.el'.
| Its value is
| (:foreground default :background default :scale 1.0 :html- 
foreground Black :html-background Transparent :html-scale  
1.0 :matchers

|  (begin $1 $ $$ \\( \\[))
|
|
| Documentation:
| Options for creating images from LaTeX fragments.
| This is a property list with the following properties:
| :foreground  the foreground color for images embedded in Emacs,  
e.g. Black.

|  `default' means use the foreground of the default face.
| :background  the background color, or Transparent.
|  `default' means use the background of the default face.
| :scale   a scaling factor for the size of the images.
| :html-foreground, :html-background, :html-scale
|  the same numbers for HTML export.
| :matchersa list indicating which matchers should be used to
|  find LaTeX fragments.  Valid members of this list are:
|  begin  find environments
|  $1 find single characters surrounded by $.$
|  $  find math expressions surrounded by $...$
|  $$ find math expressions surrounded by $$$$
|  \( find math expressions surrounded by \(...\)
|  \ [find math expressions surrounded by \ [...\]
|
| You can customize this variable.
`

HTH,
Nick


___
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




___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Carsten Dominik

Hi Eric,

thank you very much for this fantastic contribution to Org.

- Carsten

On Sep 14, 2009, at 2:44 PM, Eric Schulte wrote:


Dan Davison and I (Eric Schulte) are happy to announce that Org-babel
has now been released as a contributed package in Org-mode with
corresponding documentation on worg [1].

Org-babel provides the following functionality:
- Source-code execution and control of output in org buffers
- currently supported languages [2]:
  - emacs-lisp
  - shell scripts
  - R
  - ruby
  - python
  - SQL
  - gnuplot
  - dot
  - ditaa
  - asymptote
  - Haskell
  - OCaml
  - css
  - sass
- results of code execution can be [3]:
  - passed to other source-code blocks
  - inserted into Org buffer as Org-mode table
  - inserted into Org buffer as escaped text
  - inserted into Org buffer as raw Org-mode text
  - dropped to a file and linked to from Org-mode buffer (e.g. ditaa)
  - ignored
- Meta-programming language for org mode: each source-code block is
treated as a function which can accept arguments in the form of:
- entire org-mode tables
- output of other source-code blocks
- raw text
- values of cells in Org-mode tables using the Org spreadsheet
  functionality
- Spreadsheet enhancement: source-code blocks can be called from
spreadsheet functions within tables
- Community maintained library of useful code blocks [4]
- reproducible research [5]
- literate programming with org-mode [6]
- Org-babel has special support for embedding your emacs
  initialization in literate Org-mode files [7]

To activate Org-babel simply grab the latest version of Org-mode and  
add

the following to your Emacs init (more complete instructions at [8]).

(require 'org-babel-init)

Thanks -- Eric

Footnotes:
[1]  http://orgmode.org/worg/org-contrib/babel/org-babel.php

[2]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#languages

[3]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#header-arguments

[4]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#library-of-babel

[5]  
http://orgmode.org/worg/org-contrib/babel/org-babel.php#reproducable-research

[6]  
http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-programming

[7]  
http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-emacs-initialization

[8]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#getting-started


___
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




___
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


Re: [Orgmode] configure latex fragments preview

2009-09-15 Thread Carsten Dominik

Hi Nick,

:scale is use to change the -D dpi setting, which also changes the  
image size.


- Carsten

On Sep 14, 2009, at 8:39 PM, Nick Dokos wrote:


Nicolas Goaziou n.goaz...@gmail.com wrote:


This is some minor annoyance, but I would like to find a solution  
for it

anyway.

The preview image of a latex fragment produced by C-c C-x C-l is so
small that I sometimes find it hard to read.

In order to solve that situation, I modified org-format-latex- 
header so

that the template for the preview starts with
\documentclass[17pt]{extarticle}.

Though, I find it not quite satisfying as there is little control on
that size (I would like it to be a bit less than 17pt). Thus my  
question
(eventually) : is it possible to play with dvipng options like  
scale or

dpi directly, without modifying org.el ?

And if it doesn't exist, could a variable be introduced to fine- 
tune it ?


As a last note, I think there is a Latex only way to solve all of  
this,

but I wouldn't like to depends on too much latex packages or tricks.



The call to dvipng in org.el looks like this:

,
| ...
| (call-process dvipng nil nil nil
|   -fg fg -bg bg
|   -D dpi
|   ;;-x scale -y scale
|   -T tight
|   -o pngfile
|   dvifile)
| ...
`

Try modifying it to this:

,
|   ...
| (call-process dvipng nil nil nil
|   -fg fg -bg bg
|   -D dpi
|   ;;-x scale -y scale
| -x 2074
|   -T tight
|   -o pngfile
|   dvifile)
`

The dvipng man page suggests values for the -x option:

,
|-x num
|Set the x magnification ratio to num/1000. Overrides  
the magnification specified in the
|DVI file.  Must be between 10 and 10.  It is  
recommended that you use standard mag‐
|step values (1095, 1200, 1440, 1728, 2074, 2488, 2986,  
and so on) to help reduce the
|total number of PK files generated.  num may be a real  
number, not an integer, for

|increased precision.
`

Note the commented out -x/-y options in org.el: afaict, there is no -y
option, but perhaps Carsten can reintroduce the -x option, and then  
use

scale to set it properly (although the value of scale will need to be,
ahem, scaled).  If so, then you 'd be able to get what you want by
customizing org-format-latex-options:

,
| org-format-latex-options is a variable defined in `org.el'.
| Its value is
| (:foreground default :background default :scale 1.0 :html- 
foreground Black :html-background Transparent :html-scale  
1.0 :matchers

|  (begin $1 $ $$ \\( \\[))
|
|
| Documentation:
| Options for creating images from LaTeX fragments.
| This is a property list with the following properties:
| :foreground  the foreground color for images embedded in Emacs,  
e.g. Black.

|  `default' means use the foreground of the default face.
| :background  the background color, or Transparent.
|  `default' means use the background of the default face.
| :scale   a scaling factor for the size of the images.
| :html-foreground, :html-background, :html-scale
|  the same numbers for HTML export.
| :matchersa list indicating which matchers should be used to
|  find LaTeX fragments.  Valid members of this list are:
|  begin  find environments
|  $1 find single characters surrounded by $.$
|  $  find math expressions surrounded by $...$
|  $$ find math expressions surrounded by $$$$
|  \( find math expressions surrounded by \(...\)
|  \ [find math expressions surrounded by \ [...\]
|
| You can customize this variable.
`

HTH,
Nick


___
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




___
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


[Orgmode] org-babel

2009-09-15 Thread Jörg Hagmann
org-babel doesn't work here. First question: do I have the current 
org-version? I updated today and have 6.30trans (On 2 computers, Mac 
Leopard and ubuntu).


If that's ok, next:
I have

(require 'org-babel-init)
(require 'org-babel-ruby)  ;; requires ruby, irb, ruby-mode, and 
inf-ruby

(org-babel-load-library-of-babel)

in .emacs

Starting emacs gives the Message:

An error has occurred while loading `/Users/bonasia/.emacs':
File error: Cannot open load file, org-babel-init

I either don't have the current version or misunderstood something.

Thanks, Jörg


___
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


Re: [Orgmode] Re: RSI

2009-09-15 Thread Eric S Fraga
At Mon, 14 Sep 2009 18:56:27 -0600,
Dave Täht wrote:
 What I'd like is numlock to do the right thing, which to me, when on,
 is to not only turn on the numeric keypad, but shift the !...@#$%^*()
 characters so they don't need to be shifted to reach.
 
 And I don't know how to do that in xmodmap.

I am not sure how to make the numlock key turn into a toggle that
would make the number keys reverse their meaning.  However, you could
make the numlock key act as a modifier key which, in conjunction with
any number key, would give the number you want.  Or maybe the caps
lock key will do what you want?

Sorry I cannot be more helpful here; my use of xmodmap is limited to
remapping specific keys such as the windows keys, the alg-gr key and
the caps lock key.


___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Carsten Dominik

Hi Jörg,

you need to have the contrib/lisp directory of Org on your load path.

- Carsten

On Sep 15, 2009, at 9:58 AM, Jörg Hagmann wrote:

org-babel doesn't work here. First question: do I have the current  
org-version? I updated today and have 6.30trans (On 2 computers, Mac  
Leopard and ubuntu).


If that's ok, next:
I have

(require 'org-babel-init)
(require 'org-babel-ruby)  ;; requires ruby, irb, ruby-mode, and  
inf-ruby

(org-babel-load-library-of-babel)

in .emacs

Starting emacs gives the Message:

An error has occurred while loading `/Users/bonasia/.emacs':
File error: Cannot open load file, org-babel-init

I either don't have the current version or misunderstood something.

Thanks, Jörg


___
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




___
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


[Orgmode] Re: Can I publish one block of org file?

2009-09-15 Thread Bernt Hansen
Water Lin water...@ymail.com writes:

 I am using org to write my draft. After finish the writing, I will copy
 to my blog poster and edit something like linker, pictures.

 This way works but is a little slow and should be very careful or else
 it is very easy to forget some linkers, pictures, etc.

 I am trying to find a way to write full text in org mode. I think it is
 a good way to do following:
 ---
 After I finish the writing, I select the block of my article, then use a
 command to publish it to basic html and copy the html code into memory.


 I don't need whole html elements, just need the customized html code for
 the block.

 I try to read the org help doc but can't find anything related to
 it. Please give me a start stone, thanks...

Narrow to subtree (C-x n s) and then export.

-Bernt


___
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


[Orgmode] Re: Can I publish one block of org file?

2009-09-15 Thread Matt Lundin
Water Lin water...@ymail.com writes:

 I am using org to write my draft. After finish the writing, I will copy
 to my blog poster and edit something like linker, pictures.

 This way works but is a little slow and should be very careful or else
 it is very easy to forget some linkers, pictures, etc.

 I am trying to find a way to write full text in org mode. I think it is
 a good way to do following:
 ---
 After I finish the writing, I select the block of my article, then use a
 command to publish it to basic html and copy the html code into memory.


 I don't need whole html elements, just need the customized html code for
 the block.

 I try to read the org help doc but can't find anything related to
 it. Please give me a start stone, thanks...

C-u M-x org-export-region-as-html

or

C-u C-c C-e R

From the doc-string:

,
| org-export-region-as-html is an interactive compiled Lisp function in
| `org-html.el'.
| 
| (org-export-region-as-html beg end optional body-only buffer)
| 
| Convert region from beg to end in org-mode buffer to HTML.
| If prefix arg body-only is set, omit file header, footer, and table of
| contents, and only produce the region of converted text, useful for
| cut-and-paste operations.
| If buffer is a buffer or a string, use/create that buffer as a target
| of the converted HTML.  If buffer is the symbol `string', return the
| produced HTML as a string and leave not buffer behind.  For example,
| a Lisp program could call this function in the following way:
| 
|   (setq html (org-export-region-as-html beg end t 'string))
| 
| When called interactively, the output buffer is selected, and shown
| in a window.  A non-interactive call will only return the buffer.
`

Best,
Matt


___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Jörg Hagmann

Thank you, David and Carsten.

Now it works with shell scripts.

With Ruby, I get:
Source block produced no output (Using the first example from the manual)

Ruby versions 1.8.6 on the Mac, 1.8.7 on ubuntu.

?

Thanks, Jörg

Carsten Dominik wrote:

Hi Jörg,

you need to have the contrib/lisp directory of Org on your load path.

- Carsten

On Sep 15, 2009, at 9:58 AM, Jörg Hagmann wrote:

org-babel doesn't work here. First question: do I have the current 
org-version? I updated today and have 6.30trans (On 2 computers, Mac 
Leopard and ubuntu).


If that's ok, next:
I have

(require 'org-babel-init)
(require 'org-babel-ruby)  ;; requires ruby, irb, ruby-mode, and 
inf-ruby

(org-babel-load-library-of-babel)

in .emacs

Starting emacs gives the Message:

An error has occurred while loading `/Users/bonasia/.emacs':
File error: Cannot open load file, org-babel-init

I either don't have the current version or misunderstood something.

Thanks, Jörg


___
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




--
Prof. Jörg Hagmann-Zanolari MD
University of Basel
Department of Biomedicine
Institute of Biochemistry and Genetics
Mattenstrasse 28
CH-4058 Basel
Switzerland
Phone +41 (0)61 267 3565



___
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


Re: [Orgmode] Re: LaTeX export bugs?

2009-09-15 Thread Francesco Pizzolante
Hi,

Carsten Dominik wrote:
 On Jul 1, 2009, at 10:21 PM, Sébastien Vauban wrote:
 Other things I've noticed:

 - Even with version 6.28, the `#+TBLNAME' tag must be located in column 0
 (at
  least, for the highlighting features to work)

 Fixed, thanks.

I'm using orgmode 6.30c and I still have this problem: if the #+TBLNAME: tag
is not located in column 0, the remote reference does not work.

Here's my little test:

#+TBLNAME: A
|   | T |
|---+---|
|   |  2.00 |
|   |  5.00 |
|---+---|
| # |  9.00 |
| ^ | total |
#+TBLFM: $2=vsum(@-...@-ii);%.2f

#+TBLNAME: price
   |T |PU | Total |
   |--+---+---|
   | 9.00 | 10.25 | 92.25 |
   |--+---+---|
#+TBLFM: @2$1=remote(A,$total);%.2f::@2$3=$1*$2;%.2f


Just add a few spaces at the first line and when you recompute the second
table you get a Can't find remote table A message.

Moreover, in a LaTeX environment, using the orgtbl minor mode, the
highlighting (font locking) does not work on the #+TBLNAME: line, even if
located in column 0.

Thanks.
F.


___
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


Re: [Orgmode] Re: LaTeX export bugs?

2009-09-15 Thread Carsten Dominik

Hi Francesco,

indeed, it looks like I did make a mistake when recently trying to fix  
this.


I believe I have got it right this time (current git version), please  
verify.


- Carsten

On Sep 15, 2009, at 1:11 PM, Francesco Pizzolante wrote:


Hi,

Carsten Dominik wrote:

On Jul 1, 2009, at 10:21 PM, Sébastien Vauban wrote:

Other things I've noticed:

- Even with version 6.28, the `#+TBLNAME' tag must be located in  
column 0

(at
least, for the highlighting features to work)


Fixed, thanks.


I'm using orgmode 6.30c and I still have this problem: if the # 
+TBLNAME: tag

is not located in column 0, the remote reference does not work.

Here's my little test:

#+TBLNAME: A
   |   | T |
   |---+---|
   |   |  2.00 |
   |   |  5.00 |
   |---+---|
   | # |  9.00 |
   | ^ | total |
   #+TBLFM: $2=vsum(@-...@-ii);%.2f

   #+TBLNAME: price
  |T |PU | Total |
  |--+---+---|
  | 9.00 | 10.25 | 92.25 |
  |--+---+---|
   #+TBLFM: @2$1=remote(A,$total);%.2f::@2$3=$1*$2;%.2f


Just add a few spaces at the first line and when you recompute the  
second

table you get a Can't find remote table A message.

Moreover, in a LaTeX environment, using the orgtbl minor mode, the
highlighting (font locking) does not work on the #+TBLNAME: line,  
even if

located in column 0.

Thanks.
F.


___
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




___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Miguel Fernando Cabrera
Dan and Eric,

Just reading the documentation one can get excited by the possibilities it
brings to org-mode.
Thank you for this great contribution.

I have one question, as mentioned in the document on can pass a table to the
code block. Is possible to send a  as a parameter a dynamic clock table?.
For example to create a pie-chart of the clock-table data using R?



-- 
Miguel Fernando Cabrera
http://mfcabrera.com/A los hombres fuertes les pasa lo que a los
barriletes; se elevan cuando es
mayor el viento que se opone a su ascenso. - José Ingenieros



On Mon, Sep 14, 2009 at 8:44 AM, Eric Schulte schulte.e...@gmail.comwrote:

 Dan Davison and I (Eric Schulte) are happy to announce that Org-babel
 has now been released as a contributed package in Org-mode with
 corresponding documentation on worg [1].

 Org-babel provides the following functionality:
 - Source-code execution and control of output in org buffers
  - currently supported languages [2]:
- emacs-lisp
- shell scripts
- R
- ruby
- python
- SQL
- gnuplot
- dot
- ditaa
- asymptote
- Haskell
- OCaml
- css
- sass
  - results of code execution can be [3]:
- passed to other source-code blocks
- inserted into Org buffer as Org-mode table
- inserted into Org buffer as escaped text
- inserted into Org buffer as raw Org-mode text
- dropped to a file and linked to from Org-mode buffer (e.g. ditaa)
- ignored
 - Meta-programming language for org mode: each source-code block is
  treated as a function which can accept arguments in the form of:
  - entire org-mode tables
  - output of other source-code blocks
  - raw text
  - values of cells in Org-mode tables using the Org spreadsheet
functionality
 - Spreadsheet enhancement: source-code blocks can be called from
  spreadsheet functions within tables
 - Community maintained library of useful code blocks [4]
 - reproducible research [5]
 - literate programming with org-mode [6]
  - Org-babel has special support for embedding your emacs
initialization in literate Org-mode files [7]

 To activate Org-babel simply grab the latest version of Org-mode and add
 the following to your Emacs init (more complete instructions at [8]).

 (require 'org-babel-init)

 Thanks -- Eric

 Footnotes:
 [1]  http://orgmode.org/worg/org-contrib/babel/org-babel.php

 [2]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#languages

 [3]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#header-arguments

 [4]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#library-of-babel

 [5]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#reproducable-research

 [6]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-programming

 [7]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-emacs-initialization

 [8]
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#getting-started


 ___
 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

___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Jörg Hagmann
Sorry for the question below. I needed require 'date'; maybe a first 
example not needing to load anything would avoid this kind of noise.


In any case, thanks a lot for this tool!

Cheers, Jörg

Jörg Hagmann wrote:

Thank you, David and Carsten.

Now it works with shell scripts.

With Ruby, I get:
Source block produced no output (Using the first example from the manual)

Ruby versions 1.8.6 on the Mac, 1.8.7 on ubuntu.

?

Thanks, Jörg

Carsten Dominik wrote:

Hi Jörg,

you need to have the contrib/lisp directory of Org on your load path.

- Carsten

On Sep 15, 2009, at 9:58 AM, Jörg Hagmann wrote:

org-babel doesn't work here. First question: do I have the current 
org-version? I updated today and have 6.30trans (On 2 computers, Mac 
Leopard and ubuntu).


If that's ok, next:
I have

(require 'org-babel-init)
(require 'org-babel-ruby)  ;; requires ruby, irb, ruby-mode, and 
inf-ruby

(org-babel-load-library-of-babel)

in .emacs

Starting emacs gives the Message:

An error has occurred while loading `/Users/bonasia/.emacs':
File error: Cannot open load file, org-babel-init

I either don't have the current version or misunderstood something.

Thanks, Jörg


___
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






--
Prof. Jörg Hagmann-Zanolari MD
University of Basel
Department of Biomedicine
Institute of Biochemistry and Genetics
Mattenstrasse 28
CH-4058 Basel
Switzerland
Phone +41 (0)61 267 3565



___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Eric Schulte
Hi Jörg,

Thanks for the catch, I've added require 'date' to the initial ruby
example. -- Eric

Jörg Hagmann joerg.hagm...@unibas.ch writes:

 Sorry for the question below. I needed require 'date'; maybe a first
 example not needing to load anything would avoid this kind of noise.

 In any case, thanks a lot for this tool!

 Cheers, Jörg

 Jörg Hagmann wrote:
 Thank you, David and Carsten.

 Now it works with shell scripts.

 With Ruby, I get:
 Source block produced no output (Using the first example from the manual)

 Ruby versions 1.8.6 on the Mac, 1.8.7 on ubuntu.

 ?

 Thanks, Jörg

 Carsten Dominik wrote:
 Hi Jörg,

 you need to have the contrib/lisp directory of Org on your load path.

 - Carsten

 On Sep 15, 2009, at 9:58 AM, Jörg Hagmann wrote:

 org-babel doesn't work here. First question: do I have the current
 org-version? I updated today and have 6.30trans (On 2 computers,
 Mac Leopard and ubuntu).

 If that's ok, next:
 I have

 (require 'org-babel-init)
 (require 'org-babel-ruby)  ;; requires ruby, irb, ruby-mode,
 and inf-ruby
 (org-babel-load-library-of-babel)

 in .emacs

 Starting emacs gives the Message:

 An error has occurred while loading `/Users/bonasia/.emacs':
 File error: Cannot open load file, org-babel-init

 I either don't have the current version or misunderstood something.

 Thanks, Jörg


 ___
 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




___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Eric Schulte
Hi Miguel,

This feature is currently not implemented, however I will take a look at
including it.  For such a feature to work you would have to add a name
to your dynamic clock table, something like...

#+BEGIN: clocktable :maxlevel 2 :block today :scope tree1 :link t :name 
todays-clock
#+END: clocktable

I'll let you know if I get this working. -- Eric

Miguel Fernando Cabrera mfcabr...@gmail.com writes:

 Dan and Eric,

 Just reading the documentation one can get excited by the possibilities it 
 brings to org-mode.
 Thank you for this great contribution.

 I have one question, as mentioned in the document on can pass a table to the 
 code block. Is possible
 to send a  as a parameter a dynamic clock table?. For example to create a 
 pie-chart of the
 clock-table data using R?

 --
 Miguel Fernando Cabrera
 A los hombres fuertes les pasa lo que a los barriletes; se elevan cuando es
 mayor el viento que se opone a su ascenso. - José Ingenieros

 On Mon, Sep 14, 2009 at 8:44 AM, Eric Schulte schulte.e...@gmail.com wrote:

 Dan Davison and I (Eric Schulte) are happy to announce that Org-babel
 has now been released as a contributed package in Org-mode with
 corresponding documentation on worg [1].

 Org-babel provides the following functionality:
 - Source-code execution and control of output in org buffers
  - currently supported languages [2]:
    - emacs-lisp
    - shell scripts
    - R
    - ruby
    - python
    - SQL
    - gnuplot
    - dot
    - ditaa
    - asymptote
    - Haskell
    - OCaml
    - css
    - sass
  - results of code execution can be [3]:
    - passed to other source-code blocks
    - inserted into Org buffer as Org-mode table
    - inserted into Org buffer as escaped text
    - inserted into Org buffer as raw Org-mode text
    - dropped to a file and linked to from Org-mode buffer (e.g. ditaa)
    - ignored
 - Meta-programming language for org mode: each source-code block is
  treated as a function which can accept arguments in the form of:
  - entire org-mode tables
  - output of other source-code blocks
  - raw text
  - values of cells in Org-mode tables using the Org spreadsheet
    functionality
 - Spreadsheet enhancement: source-code blocks can be called from
  spreadsheet functions within tables
 - Community maintained library of useful code blocks [4]
 - reproducible research [5]
 - literate programming with org-mode [6]
  - Org-babel has special support for embedding your emacs
    initialization in literate Org-mode files [7]

 To activate Org-babel simply grab the latest version of Org-mode and add
 the following to your Emacs init (more complete instructions at [8]).

 (require 'org-babel-init)

 Thanks -- Eric

 Footnotes:
 [1]  http://orgmode.org/worg/org-contrib/babel/org-babel.php

 [2]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#languages

 [3]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#header-arguments

 [4]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#library-of-babel

 [5]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#reproducable-research

 [6]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-programming

 [7]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#literate-emacs-initialization

 [8]  
 http://orgmode.org/worg/org-contrib/babel/org-babel.php#getting-started

 ___
 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

 ___
 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


___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Eric Schulte
Hi Miguel,

It seems I spoke too soon, It looks like the current version of
Org-babel will support dynamic clock tables if they are structured as
the following with a #+tblname: line preceding the block.

--8---cut here---start-8---
#+TBLNAME: todays-clock
#+BEGIN: clocktable :maxlevel 2 :block today :scope tree1 :link t
Clock summary at [2009-09-15 Tue 08:51], for Tuesday, September 15, 2009.

| L | Headline | Time   |  |
|---+--++--|
|   | *Total time* | *1:10* |  |
|---+--++--|
| 1 | top  | 1:10   |  |
| 2 | show all || 1:00 |
| 2 | later|| 0:10 |
#+END: clocktable

#+begin_src emacs-lisp :var data=todays-clock
(length (car data))
#+end_src

#+resname:
: 4

#+begin_src emacs-lisp :var data=todays-clock
(length data)
#+end_src

#+resname:
: 4
--8---cut here---end---8---

Unfortunately I don't know much about R, so converting the times to
something easily graphed in a pie chart may be a little bit more
difficult.

Best -- Eric


___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Stephan Schmitt

Hi Eric,

apropos require:  if the result of an emacs-lisp source block is a list, a 
function from org-table.el is needed (orgtbl-to-orgtbl, or so) which is not 
loaded by default.  In other words, somewhere a (require org-table) is missing.


Nice tool, btw,
Stephan

Eric Schulte wrote:

Hi Jörg,

Thanks for the catch, I've added require 'date' to the initial ruby
example. -- Eric

Jörg Hagmann joerg.hagm...@unibas.ch writes:


Sorry for the question below. I needed require 'date'; maybe a first
example not needing to load anything would avoid this kind of noise.

In any case, thanks a lot for this tool!

Cheers, Jörg

Jörg Hagmann wrote:

Thank you, David and Carsten.

Now it works with shell scripts.

With Ruby, I get:
Source block produced no output (Using the first example from the manual)

Ruby versions 1.8.6 on the Mac, 1.8.7 on ubuntu.

?

Thanks, Jörg




___
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



___
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


Re: [Orgmode] org-babel

2009-09-15 Thread Eric Schulte
Hi Stephan,

You are correct, surprisingly org-table isn't explicitly required
anywhere in org-babel.  It must have already been loaded in every
previous usage.  I've just pushed a fix to this issue.

Thanks -- Eric

Stephan Schmitt drmab...@cs.tu-berlin.de writes:

 Hi Eric,

 apropos require:  if the result of an emacs-lisp source block is a
 list, a function from org-table.el is needed (orgtbl-to-orgtbl, or so)
 which is not loaded by default.  In other words, somewhere a (require
 org-table) is missing.

 Nice tool, btw,
   Stephan

 Eric Schulte wrote:
 Hi Jörg,

 Thanks for the catch, I've added require 'date' to the initial ruby
 example. -- Eric

 Jörg Hagmann joerg.hagm...@unibas.ch writes:

 Sorry for the question below. I needed require 'date'; maybe a first
 example not needing to load anything would avoid this kind of noise.

 In any case, thanks a lot for this tool!

 Cheers, Jörg

 Jörg Hagmann wrote:
 Thank you, David and Carsten.

 Now it works with shell scripts.

 With Ruby, I get:
 Source block produced no output (Using the first example from the manual)

 Ruby versions 1.8.6 on the Mac, 1.8.7 on ubuntu.

 ?

 Thanks, Jörg



 ___
 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


___
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


[Orgmode] Bug (?): Columnview in emacsclient broken?

2009-09-15 Thread Memnon Anon
Ein Bild sagt mehr als tausend Worte ;)

Hi!

I am having trouble using column view in an emacsclient (X11) session.
Here are screenshots of what happens:

The outline:
http://www.box.net/shared/lamexveohc

The outline when Columnview is active:
http://www.box.net/shared/33rbasmk25
[View with browser, wget does not work :(]

I searched the list archive, but the only reported problem afaics that 
might be related is in this thread: 
http://thread.gmane.org/gmane.emacs.orgmode/9661/focus=9699

There seems to be nothing in my setup causing this behaviour ...
I append the sample outline for a quick test, does anyone else see this
problem?

P.S.: org-submit-bug-report is nice, thanks for this ;)

#+COLUMNS: %35ITEM %4TODO %19SCHEDULED %10TAGS %5ESTIMATE{:} %5CLOCKSUM
* Sample File
  :PROPERTIES:
  :ESTIMATE:   02:10
  :END:
** Heading 1
   :PROPERTIES:
   :ESTIMATE:   0:10
   :END:
** Heading 2
   :PROPERTIES:
   :ESTIMATE:   01:00
   :END:
*** Sub 1
:PROPERTIES:
:ESTIMATE:   01:00
:END:


Emacs  : GNU Emacs 23.1.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2009-08-03 on raven, modified by Debian
Package: Org-mode version 6.30e

current state:
==
(setq
 org-log-done 'time
 org-clock-in-switch-to-state STARTED
 org-agenda-files '(~/life/organizer.org)
 org-after-todo-state-change-hook '(org-clock-out-if-current)
 org-clock-history-length 35
 org-deadline-warning-days 3
 org-export-preprocess-hook '(org-export-blocks-preprocess)
 org-tab-first-hook '(org-hide-block-toggle-maybe)
 org-src-mode-hook '(org-src-mode-configure-edit-buffer)
 org-finalize-agenda-hook '(my-org-agenda-to-appt)
 org-confirm-shell-link-function 'yes-or-no-p
 org-clock-persist t
 org-agenda-include-all-todo t
 org-todo-keywords '(TODO(t) STARTED(s!) WAITING(w@/!) APPT(a)
 | DONE(d!)
 CANCELLED(c@/!))
 org-agenda-before-write-hook '(org-agenda-add-entry-text)
 org-default-notes-file ~/life//organizer.org
 org-directory ~/life/
 org-cycle-hook '(org-cycle-hide-archived-subtrees
 org-cycle-hide-drawers
  org-cycle-show-empty-lines 
org-optimize-window-after-visibility-change)
 org-mode-hook '((lambda nil (make-variable-buffer-local (quote
 yas/trigger-key))
  (setq yas/trigger-key [tab])
  (define-key yas/keymap [tab] (quote
 yas/next-field-group)) (flyspell-mode 1))
 org-clock-load
 #[nil \300\301\302\303\304$\207
   [org-add-hook change-major-mode-hook
 org-show-block-all append local] 5]
 )
 org-confirm-elisp-link-function 'yes-or-no-p
 org-log-into-drawer LOGBOOK
 org-agenda-mode-hook '((lambda nil (hl-line-mode 1)))
 org-agenda-start-on-weekday nil
 org-occur-hook '(org-first-headline-recenter)
 org-from-is-user-regexp \\Memnon Anon\\
 org-agenda-log-mode-items '(clock)
 org-remember-templates '(( 116 * TODO %?\n  %U\n %i\n  %a
 ~/life/organizer.org Inbox)
  ( 97 * APPT: %?\n%^T\n %U\n %i\n  %a 
~/life/organizer.org Inbox))
 )



___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Sebastian Rose
Eric Schulte schulte.e...@gmail.com writes:
 Dan Davison and I (Eric Schulte) are happy to announce that Org-babel
 has now been released as a contributed package in Org-mode with
 corresponding documentation on worg [1].


What else should I say - THIS IS GREAT NEWS!!



I wonder how complicated it would be to add more languages. Especially
PHP, JavaScript (e.g. per rhino) and Perl.

Is there some documentation or advice on the net in that concern? I'd
like to add a language I understand besides Bash... :)

Hmmm - maybe `org-babel-sh.el' is a good starting point.





* Some thoughts


I actually wonder, if all those interpreted languages are different at
all. Why not add an generic call to interpreters. Executing Shell
scripts or Perl, Php, JavaScript... makes no big difference here. On
Linux at least, they all work with either shebang or called with OPTION
FILENAME.

To execute a temporary file without shebang, all interpreters take a
filename:

rhino -f FILE  # -f is optional
php   -f FILE  # -f is optional
perl FILE

Or execute code directly (which is useless for us, since we would need
to quote the code correctly...):

rhino -e  CODE...
perl  -e  CODE...
php   -r  CODE...


So how about:

  #+srcname: generic-circumference(a)
  #+begin_src javascript :interpreter rhino -f

  print ( Write me to temp file and call `rhino -f TMPFILE' )
  java.lang.System.out.println ( 2 * a * java.lang.Math.PI )

  #+end_src

This way, a source block written on my Linux-System would execute on her
MAC and his Windows machine without change (provided the interpreter is
installed and in $PATH... `org-program-exists' ... to use interpreters
without having them in $PATH, a customizable map could be used).






BTW: I just discovered rhino - looks interesting, seems you can
(de-)serialize Java(Script) objects... and thus keep track of things
between sessions ;) start programs, call Java Methods...  See
https://developer.mozilla.org/en/Rhino_Shell



Best wishes,

  Sebastian


___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Eric Schulte
Hi Sebastian,

Sebastian Rose sebastian_r...@gmx.de writes:

 Eric Schulte schulte.e...@gmail.com writes:
 Dan Davison and I (Eric Schulte) are happy to announce that Org-babel
 has now been released as a contributed package in Org-mode with
 corresponding documentation on worg [1].


 What else should I say - THIS IS GREAT NEWS!!


Thanks, I hope fellow Orgers find it useful


 I wonder how complicated it would be to add more languages. Especially
 PHP, JavaScript (e.g. per rhino) and Perl.


Yes, I must admit the current set of implemented language is very
specific to Dan and my personal needs.  I really hope that other people
add the languages they need/use, and I tried to design the structure of
org-babel to make the addition of new languages as painless as possible.


 Is there some documentation or advice on the net in that concern? I'd
 like to add a language I understand besides Bash... :)

 Hmmm - maybe `org-babel-sh.el' is a good starting point.


Yes, currently the best way to get a feel for how to add languages would
be to start with an existing language file (I'd suggest
org-babel-python.el or org-babel-ruby.el, or for simpler less
comprehensive language support look at org-babel-ditaa or
org-babel-haskell) and make changes from there.  I agree that a brief
tutorial for adding language support would be helpful.

Basically Org-babel expects any new language file to define two
functions...

- org-babel-execute:lang-name (body params) :: which executes the code
 in body according to the header arguments in params, and

- org-babel-prep-session:ruby (session params) :: which starts an
 interactive session in session setting any variables from params


 * Some thoughts


 I actually wonder, if all those interpreted languages are different at
 all. Why not add an generic call to interpreters. Executing Shell
 scripts or Perl, Php, JavaScript... makes no big difference here. On
 Linux at least, they all work with either shebang or called with OPTION
 FILENAME.


There are two key language specific features which keep us from treating
all interpreted languages identically.
1) Org-babel collects the last value of a source-code block to be
   returned (see [1]) and this value needs to be collected and
   potentially converted into elisp in a language specific manner
2) Org-babel has support for evaluation in a session allowing
   persistence of state between different blocks which use the same
   session.  I now notice that the :session header argument is not
   currently documented on the Worg page.  I'll try to add this
   documentation soon.  The sessions are handled through Emacs comint
   buffers which are very language specific.


 To execute a temporary file without shebang, all interpreters take a
 filename:

 rhino -f FILE  # -f is optional
 php   -f FILE  # -f is optional
 perl FILE

 Or execute code directly (which is useless for us, since we would need
 to quote the code correctly...):

 rhino -e  CODE...
 perl  -e  CODE...
 php   -r  CODE...


I agree that it would be possible to implement a much more general
code-evaluation mechanism based on execution of temporary files, but we
would lose the nice features mentioned above.



 So how about:

   #+srcname: generic-circumference(a)
   #+begin_src javascript :interpreter rhino -f

   print ( Write me to temp file and call `rhino -f TMPFILE' )
   java.lang.System.out.println ( 2 * a * java.lang.Math.PI )

   #+end_src

 This way, a source block written on my Linux-System would execute on her
 MAC and his Windows machine without change (provided the interpreter is
 installed and in $PATH... `org-program-exists' ... to use interpreters
 without having them in $PATH, a customizable map could be used).


Under the current setup, all source-code blocks should be executable on
*any* system which supports the required language and Emacs modes
mentioned in the commented elisp block at [2]

Best -- Eric







 BTW: I just discovered rhino - looks interesting, seems you can
 (de-)serialize Java(Script) objects... and thus keep track of things
 between sessions ;) start programs, call Java Methods...  See
 https://developer.mozilla.org/en/Rhino_Shell



 Best wishes,

   Sebastian

Footnotes: 
[1]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#results

[2]  http://orgmode.org/worg/org-contrib/babel/org-babel.php#languages



___
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


[Orgmode] Re: iPhone app for Org view and capture

2009-09-15 Thread news
Sven Bretfeld sven.bretf...@gmx.ch writes:

 Richard Moreland r...@ncogni.to writes:

 Here is a teaser video of the app running in the simulator:  
 http://ncogni.to/
 mobileorg-demo1.mov

 Very nice, congratulations. The unavoidable question: Will there be an
 Android port as well?


You might be interested to know that with the android scripting
environment you can access the android API from emacs.
I've written a little recipe to make phone calls directly from your bbdb
buffer in emacs on android. See here: 
http://www.emacswiki.org/emacs/EmacsOnAndroid


-- 
aleblanc



___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Eric Schulte
Rick Moynihan rick.moyni...@gmail.com writes:


 Was having a similar idea, as I language I'd love to use with this is
 my current fave clojure:

 http://clojure.org/


Everyone I talk to seems to love clojure, I need to find an excuse to
use it myself.


 It's a language based on the JVM and consequently being able to pass
 in command line options to the interpreter is important...  I'd
 imagine most of the time the source blocks within a single file would
 share the vast majority of environment settings too (for example
 setting the JVM's class path) so being able to specify these values to
 pass to the interpreter, once at the top of the file would be really
 nice.


This should be easily implemented using a new header argument (languages
are free to define new header arguments as they see fit).  For an
example of a language passing command line options through header
arguments, see the org-babel-ditaa.el file which defines a :cmdline
header argument allowing arguments to be passed to the ditaa command as
in the example below where the -r and -S options are passed to the ditaa
command.

--8---cut here---start-8---
#+begin_src ditaa :file blue.png :cmdline -r -S
+-+
| cBLU|
| |
|++
||cPNK|
|||
+++
#+end_src
--8---cut here---end---8---

Cheers -- Eric


 R.


___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Sebastian Rose
Eric Schulte schulte.e...@gmail.com writes:
 Sebastian Rose sebastian_r...@gmx.de writes:

 Eric Schulte schulte.e...@gmail.com writes:


 Yes, currently the best way to get a feel for how to add languages would
 be to start with an existing language file (I'd suggest
 org-babel-python.el or org-babel-ruby.el, or for simpler less
 comprehensive language support look at org-babel-ditaa or
 org-babel-haskell) and make changes from there.  I agree that a brief
 tutorial for adding language support would be helpful.


 A skeleton maybe?
 And just a few comments describing the I/O of the basic functions
 (and/or the global vars/containers that take the results).



 Good idea, I'm attaching an org-babel-template.el file which tries to be
 just that.  I'd be interested to hear how it works for you, or if you
 want to make any changes.  Once there is a good version maybe it would
 be a good thing to either add to the babel/lisp/langs directory, or at
 least to post on Worg.


Ahhh - now that I get simple output from PHP...
simple already worked for my, by taking the org-babel-python.el,
replacing org-babel-python-evaluate by org-babel-sh-evaluate and replace
all `python' and `sh' by `php'.

(OK - and wrap the `full-body' into `?php ' and ' ?').

But then I screwed it up by replacing the modified org-babel-sh-evaluate
by the  org-babel-python-evaluate function again - now I don't get the
results out... but I'm on the track.



OK - I'll try the template. I need to understand the whole thing anyway
:)


Best wishes

  Sebastian


___
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


[Orgmode] Documentation wishlist items

2009-09-15 Thread Ethan
Hi guys,

I've been studying org-mode for a few months now, and I think I'm finally
getting the hang of it. It's really overwhelming, and I really appreciate
the efforts that must have gone into the manual and the worg project. But I
think it still needs work.

The fundamental problem is that org-mode isn't a planner, it isn't an
organizer. It's a toolkit full of tools which people use differently, in
lots of ways, to build their own planner/organizer. To understand org-mode,
you have to understand all of the tools available, and the options you have
for each, and the ways they interact with the other tools. In my opinion,
the documentation doesn't explore the interactions well enough, it doesn't
present the tools in an order that is conducive to learning, and it never
explains why you might choose one option of tool instead of another.

For example, let's take Archiving. The documentation I'm reading right now,
at http://orgmode.org/manual/Archiving.html#Archiving, puts archiving in
Document Structure, section 2.6, before TODO keywords, tags, the agenda,
or anything else. There's one paragraph about what archiving means, then
five or six paragraphs about how a headline with the ARCHIVE tag behaves,
and then a section about moving trees and where you could move them. It
isn't clear what workflows you might use Archive Sibling in, or why C-u C-c
C-x C-s would archive *children* of the selected headline instead of the
headline itself.

Another good example is TODO keywords, categories, and tags. It isn't clear
what they all are, or why they are distinct, or what the differences are,
and it's easy to confuse them with similarly-named but completely distinct
concepts like properties.

In other words, to really understand the manual, you have to read it twice
-- once to hear about all the concepts, and once more to see how they
relate. And then to start using org-mode, you have to play with a bunch of
different possible arrangements of the concepts, see which things you like,
and finally settle on an arrangement that suits you a little bit, before
starting the endless path of tweakage.

Reading HOWTO's like Bernt Hansen's and Charles Cave's are really
interesting to see how people work, but even documents like these don't
explain *why* they set things up in this way. For example, Bernt Hansen's
document explains that his toplevel headings are main categories, and
shows that they each have a CATEGORY property, but doesn't explain what that
buys him, or what problem that solves.

In short, after studying org-mode for a long time, I finally feel ready to
start using it -- not that I understand it, but that I know where the most
important knobs are. I feel like it would have been a lot easier for me to
start using it if I had started with a tutorial that explained a single
workflow and how org-mode supported it, and I feel like the org-mode manual
could have gone a long way in making this learning easier. For example, the
documentation for C-u C-c C-x C-s could say something like This supports
workflows where there is a top-level Projects heading, and each heading
underneath represents a project. You could then use this command to archive
all projects which didn't have open TODO items..

I wish I could offer more concrete improvements in the form of patches and
so on! Maybe as I learn more about org-mode I can do this too, but I wanted
to offer this criticism while it was still fresh in my mind.

Thanks for everything!

Ethan
___
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


[Orgmode] Org-mode Mercurial mirror on Bitbucket

2009-09-15 Thread Greg Newman
I've had my friends over at Bitbucket.org create a org-mode mirror of the
git repo for me (and anyone who prefers Mercurial) to pull from.This repo is
updated every hour against the git repository.

http://bitbucket.org/mirror/org-mode/

Carsten, I hope you don't mind.  It is read only.  If it's a problem I'll be
happy to tell them to take it down.

Cheers,


*Greg Newman*

http://20seven.org

twitter: 20seven
___
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


[Orgmode] suggestion: simplify depth stepping of document structure (outline) visibility

2009-09-15 Thread Michael Brand

Hi all,

I would like much more to increase the heading visibility depth step by step 
like with the following if it would be much easier to type

step 1 to see level  1:C-u 1 S-Tab
step 2 to see levels 1..2: C-u 2 S-Tab
step 3 to see levels 1..3: C-u 3 S-Tab
step 4 to see levels 1..4: C-u 4 S-Tab
and so on until not repeated any more (no cycling, only as a sequence)

Did I miss some simpler work flow to do something similar (not cycling with Tab 
or S-Tab)?

Are there others who would like this sequence to be easily stepped through?

Which constantly repeatable key command as convenient as possible like cycling 
with Tab or S-Tab would be suitable?

I would suggest that any key command different to this new key command would 
stop stepping the sequence and that the first invoke of this new key command 
again would reset the visibility to overview again like `C-u 1 S-Tab' does 
(similar to the nice cycle reset behavior of a first `S-Tab').

The point on e. g. a level 3 heading would be nice to be there again after 
going through steps 1 to 3 (similar to the nice behavior of e. g. `S-Tab S-Tab 
S-Tab' when the point was in a body before).

- Michael


___
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


[Orgmode] suggestion: simplify step by step heading level diving of document structure (outline)

2009-09-15 Thread Michael Brand

Hi all,

I would like much more to increase the heading visibility depth step by step 
like with the following if it would be much easier to type

step 1 to see level  1:C-u 1 S-Tab
step 2 to see levels 1..2: C-u 2 S-Tab
step 3 to see levels 1..3: C-u 3 S-Tab
step 4 to see levels 1..4: C-u 4 S-Tab
and so on until not repeated any more (no cycling, only as a sequence)

Did I miss some simpler work flow to do something similar (not cycling with Tab 
or S-Tab)?

Are there others who would like this sequence to be easily stepped through?

Which constantly repeatable key command as convenient as possible like cycling 
with Tab or S-Tab would be suitable?

I would suggest that any key command different to this new key command would 
stop stepping the sequence and that the first invoke of this new key command 
again would reset the visibility to overview again like `C-u 1 S-Tab' does 
(similar to the nice cycle reset behavior of a first `S-Tab').

The point on e. g. a level 3 heading would be nice to be there again after 
going through steps 1 to 3 (similar to the nice behavior of e. g. `S-Tab S-Tab 
S-Tab' when the point was in a body before).

- Michael


___
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


Re: [Orgmode] [Announcement] Org-babel initial release

2009-09-15 Thread Eric Schulte
Rick Moynihan rick.moyni...@gmail.com writes:

 I'd imagine most of the time the source blocks within a single file
 would share the vast majority of environment settings too (for example
 setting the JVM's class path) so being able to specify these values to
 pass to the interpreter, once at the top of the file would be really
 nice.


I addressed the passing command line portion of your comment earlier
but neglected the setting file-wide header arguments portion.

RE: setting file-wide header arguments

it is now possible to set header arguments for subtrees of a file using
properties, for example the following will have :results silent set for
all of it's code blocks.

* silent
  :PROPERTIES:
  :results:  silent
  :END:

I agree file-wide settings would be useful, but they are not yet
implemented.

Best -- Eric


___
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


Re: [Orgmode] Unnumbered sections in LaTeX export

2009-09-15 Thread Thomas S. Dye


On Sep 15, 2009, at 7:42 AM, Sebastian Rose wrote:


Thomas S. Dye t...@tsdye.com writes:

Thanks Sebastian.  I appreciate the expert assistance.  I have a  
simple export
to Beamer working and was trying to implement automatic  export of  
columns, too.
The starred sections were going to be  placeholders for the columns  
heading
level when it wasn't used.  I've  found that skipping a headline  
level in the
source causes the latex  exporter to skip over subsequent inferior  
levels, so it
isn't possible  to assign a heading level to columns and then use  
them or not as

the  case requires.


You could try to add a class to `org-export-latex-classes'. For such a
class, you can define a mapping for each headline level:


 (my-beamer-class \\documentclass...\\usepackage{beamer}
  (\\chapter{%s} . \\my-chapter*{%s})
  (\\section{%s} . \\my-section*{%s})
  (\\subsection{%s} . \\my-subsection*{%s})
  (\\subsubsection{%s} . \\my-subsubsection*{%s})))

I don't know if this is an easy thing to do, since I only did this  
once

a long time ago.
But it seems it's worth a try.


See:
http://orgmode.org/manual/Sectioning-structure.html#Sectioning-structure
http://127.0.0.1/devel/org-notes/org-search.php?speedbar=1main=/devel/org-notes/org-search.php




 Sebastian


Yes, that is what I'm playing around with.  I have a useful, but  
simple export to beamer working.  I've been trying without success to  
implement beamer's \begin{columns} ... \end{columns} environment.   
This is a fairly common construct in beamer that occurs inside some  
frames but not in others.  It seems natural to put it like this:


 (\\section{%s} . \\section{%s})
 (\\subsection{%s} . \\subsection{%s})
 (\\begin{frame}\\frametitle{%s} \\end{frame} \\begin{frame}\ 
\frametitle{%s} \\end{frame})
(\\begin{columns}\\label{%s} \\end{columns} \\begin{columns}\ 
\label{%s} \\end{columns})


where the \label{%s} puts the mandatory use of %s somewhere it won't  
affect the LaTeX compilation.


The problem with this is that for frames where columns aren't wanted,  
simply leaving out the fourth level in org means that everything below  
it won't be exported.


This example results in an empty frame (Item 1 and Item 2 are dropped  
from the export):


* Section head
** Subsection head
*** Frame title
* Item 1
* Item 2

It seems that a placeholder of some kind is needed if the columns  
environment isn't wanted.


Initially, I explored using the definition for the unnumbered  
sections, like this:


(\\begin{columns}\\label{%s} \\end{columns} %%\\begin{columns}\ 
\label{%s} %%\\end{columns})


which would use a LaTeX comment as a placeholder.  This won't work  
because the switch for numbered/unnumbered sections is set at the file  
level and not for individual instances.


Then, I thought to define a do-nothing environment in LaTeX

\newenvironment{nocolumns}{}{}

set it up in .emacs like this:

(\\begin{%s} \\end{%s} \\begin{%s} \\end{%s})

and then put this in my .org file:

* Section head
** Subsection head
*** Frame title
 nocolumns
* Item 1
* Item 2

But this doesn't work because %s doesn't expand in \\end{%s}.  I get  
\begin{nocolumns} ... \end{%s}, which LaTeX doesn't like.


So, I'm stumped for now, but still pleased to have a simple export  
from org to beamer working, albeit one that produces frames without  
columns.


All the best,
Tom





___
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


[Orgmode] suggestion: simplify step by step heading level diving

2009-09-15 Thread Michael Brand

Hi all,

I would like much more to increase the heading visibility depth step by step 
like with the following if it would be much easier to type

step 1 to see level  1:C-u 1 S-Tab
step 2 to see levels 1..2: C-u 2 S-Tab
step 3 to see levels 1..3: C-u 3 S-Tab
step 4 to see levels 1..4: C-u 4 S-Tab
and so on until not repeated any more (no cycling, only as a sequence)

Did I miss some simpler work flow to do something similar (not cycling with Tab 
or S-Tab)?

Are there others who would like this diving sequence to be easily stepped 
through?

Which constantly repeatable key command as convenient as possible like cycling 
with Tab or S-Tab would be suitable?

I would suggest that any key command different to this new key command would 
stop stepping and that the first invoke of this new key command again would 
reset the visibility to overview again like `C-u 1 S-Tab' does (similar to the 
nice cycle reset behavior of a first `S-Tab').

The point on e. g. a level 3 heading would be nice to be there again after 
going through steps 1 to 3 (similar to the nice behavior of e. g. `S-Tab S-Tab 
S-Tab' when the point was in a body before).

- Michael


___
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


[Orgmode] suggestion: simplify step by step heading level diving

2009-09-15 Thread Michael Brand

Hi all,

I would like much more to increase the heading visibility depth step by step 
like with the following if it would be much easier to type

step 1 to see level  1:C-u 1 S-Tab
step 2 to see levels 1..2: C-u 2 S-Tab
step 3 to see levels 1..3: C-u 3 S-Tab
step 4 to see levels 1..4: C-u 4 S-Tab
and so on until not repeated any more (no cycling, only as a sequence)

Did I miss some simpler work flow to do something similar (not cycling with Tab 
or S-Tab)?

Are there others who would like this sequence to be easily stepped through?

Which constantly repeatable key command as convenient as possible similar to 
the simple cycling with Tab or S-Tab would be suitable?

I would suggest that any key command different to this new key command would 
stop stepping the sequence and that the first invoke of this new key command 
again would reset the visibility to overview again like `C-u 1 S-Tab' does 
(similar to the nice cycle reset behavior of a first `S-Tab').

The point on e. g. a level 3 heading would be nice to be there again after 
going through steps 1 to 3 (similar to the nice behavior of e. g. `S-Tab S-Tab 
S-Tab' when the point was in a body before).

- Michael


___
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


[Orgmode] Re: Documentation wishlist items

2009-09-15 Thread Sean Sieger
Ethan ethan.glasser.c...@gmail.com writes:

Thanks for the mail Ethan.  I approached Org ... I don't know, a few
years ago having really really taken advantage of Outline.  I promptly
made a mess, trying things I thought I needed to and went back to
Outline and organization that was natural to me.  The experience helped
me formulate goals and I came back to Org only weeks ago armed with
fairly precise ideas.

The fundamental problem is that org-mode isn't a planner, it isn't
an organizer. It's a toolkit full of tools which people use
differently, in lots of ways, to build their own
planner/organizer. To understand org-mode, you have to understand
all of the tools available, and the options you have for each, and
the ways they interact with the other tools.

Nah, to understand what Org can do for me, I needed to understand myself
and my limitations.

In my opinion, the documentation doesn't explore the interactions
well enough, it doesn't present the tools in an order that is
conducive to learning, and it never explains why you might choose
one option of tool instead of another.

Right.  That documentation has evolved in the little time I've been
reading it.  It does explain, and so does this list that the fundamental
... um, primary action is to quickly Capture.  That's how I came to Org
this time---getting a ~/.notes file going.  Capturing fleeting thoughts
and appending them to that file and then discerning what and how to
organize them.

[...]

I wish I could offer more concrete improvements in the form of
patches and so on! Maybe as I learn more about org-mode I can do
this too, but I wanted to offer this criticism while it was still
fresh in my mind.

... Just captured something my six year-old daughter said on the phone.
I should concentrate on her.  I'll do F8 (remember's bound to it)
several more times in talking with her.



___
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


Re: [Orgmode] Org-mode Mercurial mirror on Bitbucket

2009-09-15 Thread Bastien
Greg Newman g...@20seven.org writes:

 I've had my friends over at Bitbucket.org create a org-mode mirror of the
 git repo for me (and anyone who prefers Mercurial) to pull from.This repo is
 updated every hour against the git repository.

 http://bitbucket.org/mirror/org-mode/

I think it is useful.  Perhaps people using this repo should be advised
to create patches preferrably against the git repo?  At least a link to
the official repo would be nice.

Thanks!

-- 
 Bastien


___
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


Re: [Orgmode] Org-mode Mercurial mirror on Bitbucket

2009-09-15 Thread Greg Newman
Great point Bastien.  I'll update the wiki on it in the morning with some
detailed information and links to the git repo and official site.

On Tue, Sep 15, 2009 at 8:07 PM, Bastien bastiengue...@googlemail.comwrote:

 Greg Newman g...@20seven.org writes:

  I've had my friends over at Bitbucket.org create a org-mode mirror of the
  git repo for me (and anyone who prefers Mercurial) to pull from.This repo
 is
  updated every hour against the git repository.
 
  http://bitbucket.org/mirror/org-mode/

 I think it is useful.  Perhaps people using this repo should be advised
 to create patches preferrably against the git repo?  At least a link to
 the official repo would be nice.

 Thanks!

 --
  Bastien

___
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


[Orgmode] Re: suggestion: simplify depth stepping of document structure (outline) visibility

2009-09-15 Thread Bernt Hansen
Michael Brand michael.br...@alumni.ethz.ch writes:

 I would like much more to increase the heading visibility depth step by step 
 like with the following if it would be much easier to type

 step 1 to see level  1:C-u 1 S-Tab
 step 2 to see levels 1..2: C-u 2 S-Tab
 step 3 to see levels 1..3: C-u 3 S-Tab
 step 4 to see levels 1..4: C-u 4 S-Tab
 and so on until not repeated any more (no cycling, only as a sequence)

 Did I miss some simpler work flow to do something similar (not cycling with 
 Tab or S-Tab)?

 Are there others who would like this sequence to be easily stepped through?

 Which constantly repeatable key command as convenient as possible like 
 cycling with Tab or S-Tab would be suitable?

 I would suggest that any key command different to this new key command would 
 stop stepping the sequence and that the first invoke of this new key command 
 again would reset the visibility to overview again like `C-u 1 S-Tab' does 
 (similar to the nice cycle reset behavior of a first `S-Tab').

 The point on e. g. a level 3 heading would be nice to be there again after 
 going through steps 1 to 3 (similar to the nice behavior of e. g. `S-Tab 
 S-Tab S-Tab' when the point was in a body before).

Hi Michael,

In case you aren't aware of it you can view sublevels for a tree with
C-c C-k and match specific levels with a tags match (C-c / m LEVEL=n
RET).

HTH,
-Bernt


___
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


Re: [Orgmode] Documentation wishlist items

2009-09-15 Thread Sebastian Rose
Ethan ethan.glasser.c...@gmail.com writes:
 Hi guys,

 I've been studying org-mode for a few months now, and I think I'm finally
 getting the hang of it. It's really overwhelming, and I really appreciate
 the efforts that must have gone into the manual and the worg project. But I
 think it still needs work.

 The fundamental problem is that org-mode isn't a planner, it isn't an
 organizer. It's a toolkit full of tools which people use differently, in
 lots of ways, to build their own planner/organizer. To understand org-mode,
 you have to understand all of the tools available, and the options you have
 for each, and the ways they interact with the other tools. In my opinion,
 the documentation doesn't explore the interactions well enough, it doesn't
 present the tools in an order that is conducive to learning, and it never
 explains why you might choose one option of tool instead of another.

Hmm. I think of myself as a control freak, but I never felt I'd have to
understand everything in Org-mode. I don't. It works out the box, and
the manual helped, in that it is a reference (not complete maybe, but
complete enough).



Documentation is not such an easy thing to do and a lot of work, too. A
tutorial _is_ missing. We had some discussions here about that, but no
one got around to it. I think about it every so often, but writing a
tutorial is such a big thing to do.

Personally, I think that one or two fictive characters would fit
best. People, simply using Org-mode to take notes, plan, publish and so
on.

The entire thing should start _very_ simple and without any
customization at all. I see customization in chapter 15 - no earlier
really unless unavoidable.



Here is some kind of outline for such a tutorial.


Chapter 1

  It simply starts when Alice starts Emacs to take a note or jot down
  some ideas (brainstorming?). Headlines are moved around and later
  filled with text (not sure, but maybe add promotion and demotion
  here, too).

Chapter 2

  Alice adds a simple list. This would repeat the shortcuts for adding
  and moving headlines (they are the same, just in a similar but
  slightly different context. This shows for the first time in this
  tutorial, that all those keys are well structured).

Chapter 3

  Alice adds the TODO keyword to one of the headlines. I.e. she holds
  down the shift key while adding a headline.

Chapter 5

  Alice starts to work on her first TODO, and changes the TODO state to
  STARTED. After she finishes her work, she feels so good and switches
  the TODO state to DONE. (Note: We will not add any configuration
  options here at all. Alice just does it, and enjoys what Org-mode does
  for her [1]).

Chapter 6 (was Chapter 4)

  Alice is so exited, that she adds another TODO item. But what she does
  now, is even more:
  Alice does the same/similar for plain list items: hold down the shift
  key, while adding an item. This is the time we introduce the `very
  busy C-c C-c' key as the shortcut, that updates something. Here the
  check boxes.

Chapter 9

  Alice gets tired of open the Org-file, add a note, save the buffer and
  close the file. She finds out about remember (or maybe Carl told her
  about it - or she tells Carl how to do it? Maybe Alice is an
  Org-pro... and Carl is one of her customers?).
  Again, she just uses remember as it comes with Org-mode. No special
  configuration necessary.







That's about the speed and the first Chapters for a tutorial, I think
[2].

A Page would look like this (e.g. Chapter 5):

= ---8-8-8---

  - previous chapter indexnext chapter -

* Chapter 5: Getting things DONE

  Little introduction in what Alice will do in this chapter.

  Alice starts to work on her first TODO. Alice changes the TODO state
  to STARTED.  More text describing how she changes the TODO state
  (S-RIGHT), what she does - something in Emacs maybe - is Alice an
  author or programmer?..

  ... When finished, After she finishes her work, she feels so good and
  switches the TODO state to DONE. She uses the same shortcut
  again. Alice enjoys what Org-mode does for her. She notes the new
  little drawer (maybe, if this is the default) and the nice green color
  of the `DONE' keyword.

   ,---.
   ! Box 'WHAT WE HAVE LEARNED IN THIS CHAPTER |
   !   |
   ! S-RIGHT changes the TODO state|
   `---´


  See also:
 - list of links to advanced features
 - for the impatient and the curious.
 - In the tutorial
 - or the Org-mode manual, worg, mailing list...


  - previous chapterindex next chapter -


= ---8-8-8---


While this looks a little childish, it will be really relaxed
reading. In the ideal case, children would be able to follow, and adults

[Orgmode] Re: Documentation wishlist items

2009-09-15 Thread Matt Lundin
Ethan ethan.glasser.c...@gmail.com writes:

 Hi guys,

 I've been studying org-mode for a few months now, and I think I'm
 finally getting the hang of it. 

I'm still saying the same thing after 1 year. :)

 It's really overwhelming, and I really appreciate the efforts that
 must have gone into the manual and the worg project. But I think it
 still needs work.

 The fundamental problem is that org-mode isn't a planner, it isn't an
 organizer. 

???

 It's a toolkit full of tools which people use differently,
 in lots of ways, to build their own planner/organizer. To understand
 org-mode, you have to understand all of the tools available, and the
 options you have for each, and the ways they interact with the other
 tools.

I must respectfully disagree here. The org-mode basics are quite simple.
Create an outline, organize it however you see fit, mark actions as
TODOs, schedule, view and review using the agenda. To take advantage of
org, you really don't need to know much more than that. The basic
concepts would apply to any outliner or basic task management tool.

All the other features---clocking, properties, column view, exporting,
publishing, tags, tables/spreadsheets, effort estimates, etc.---are
there in the background in the event that you need them. 

Heck, even without all the extras, org would still be a world-class
outliner.

 For example, let's take Archiving. The documentation I'm reading right
 now, at http://orgmode.org/manual/Archiving.html#Archiving, puts
 archiving in Document Structure, section 2.6, before TODO keywords,
 tags, the agenda, or anything else. There's one paragraph about what
 archiving means, then five or six paragraphs about how a headline with
 the ARCHIVE tag behaves, and then a section about moving trees and
 where you could move them. It isn't clear what workflows you might use
 Archive Sibling in, or why C-u C-c C-x C-s would archive *children* of
 the selected headline instead of the headline itself.

The manual is not your only source of information. I make heavy use of
C-h v and C-h f to learn more about particular variables and functions.

 Another good example is TODO keywords, categories, and tags. It isn't
 clear what they all are, or why they are distinct, or what the
 differences are, and it's easy to confuse them with similarly-named but
 completely distinct concepts like properties.

Here's how I see it.

1) TODO keywords: How does this item fit into my workflow?

2) Category: What group does this tree belong to? (This is the word that
   appears next to the item in the agenda.)

3) Tags: What words do I want to add to this item/tree to enable me to
   find it easily. (Commonly used for GTD contexts.)

4) Properties: What extra data would I like to attach to this item?
   (Commonly used to set special options for a subtree/item, but also
   very useful for creating ad-hoc databases.)

In my opinion, one of the biggest decisions new users have to make is
how to designate projects. Should I use a TODO keyword, a tag, or a
second level headline? I prefer the todo keyword PROJECT myself, but
any of these would work fine.

And if you regret the decision three months from now, you can always use
org-map-entries to change your project items en masse.

 Reading HOWTO's like Bernt Hansen's and Charles Cave's are really
 interesting to see how people work, but even documents like these don't
 explain *why* they set things up in this way. For example, Bernt
 Hansen's document explains that his toplevel headings are main
 categories, and shows that they each have a CATEGORY property, but
 doesn't explain what that buys him, or what problem that solves.

My guess is that this allows him to see what group an item belongs to in
the agenda view, since categories are listed in the left column.

But this is like asking why someone puts their pots in the cupboard next
to the oven rather than above the sink, or why someone uses legal pads
rather than a spiral notebook.

My recommendation: Just start creating trees, use only a few TODO
states, and allow the organization to evolve in the way that feels the
most comfortable to you.

Best,
Matt


___
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