Re: [O] "Reference Dump" rant

2017-11-21 Thread Eric Abrahamsen
"Thomas S. Dye"  writes:

> Lawrence Bottorff writes:
>
>>> > I guess I'm saying it would be nice to have a big omnibus O'Reilly-style
>>> > tutorial on how to use org-mode. I've hung with org-mode because I think
>>> > it's great and, IMHO, should become a standard tool in all
>>> > STEM/STEM-education settings. Think of all those high schools (and even
>>> > colleges) forcing students to use "graphic calculators." What a waste!
>
> Worg has some fits and starts in the direction of tutorials and such.
> It might be a good place to start.

Here's my highest-scoring Hacker News post of all time, about using Org's
agenda functions:

https://news.ycombinator.com/item?id=11386943




Re: [O] "Reference Dump" rant

2017-11-21 Thread Lawrence Bottorff
Yes, Worg is great. If a user is really driven they can scarf up all the
various tutorial bits and pieces and begin to have a clue. BTW, where can I
get the source for the latest manual?

On Tue, Nov 21, 2017 at 9:03 PM, Thomas S. Dye  wrote:

>
> Lawrence Bottorff writes:
>
> >> > I guess I'm saying it would be nice to have a big omnibus
> O'Reilly-style
> >> > tutorial on how to use org-mode. I've hung with org-mode because I
> think
> >> > it's great and, IMHO, should become a standard tool in all
> >> > STEM/STEM-education settings. Think of all those high schools (and
> even
> >> > colleges) forcing students to use "graphic calculators." What a waste!
>
> Worg has some fits and starts in the direction of tutorials and such.
> It might be a good place to start.
>
> All the best,
> Tom
>
> --
> Thomas S. Dye
> http://www.tsdye.com
>


Re: [O] "Reference Dump" rant

2017-11-21 Thread Thomas S. Dye

Lawrence Bottorff writes:

>> > I guess I'm saying it would be nice to have a big omnibus O'Reilly-style
>> > tutorial on how to use org-mode. I've hung with org-mode because I think
>> > it's great and, IMHO, should become a standard tool in all
>> > STEM/STEM-education settings. Think of all those high schools (and even
>> > colleges) forcing students to use "graphic calculators." What a waste!

Worg has some fits and starts in the direction of tutorials and such.
It might be a good place to start.

All the best,
Tom

--
Thomas S. Dye
http://www.tsdye.com



Re: [O] "Reference Dump" rant

2017-11-21 Thread Lawrence Bottorff
So yes, the complainer (that's me) shouldn't just complain, he should
become the improver. Yes, let me see what I can come up with.

On Tue, Nov 21, 2017 at 3:52 PM, Tim Cross  wrote:

> Hi Lawrence,
>
> glad you like org-mode. I also think it is a great tool.
>
> One of the great things about org-mode is that it is used by a very wide
> range of people. I know of a couple of people who are not at all
> technical who use org-mode just for general organisation and writing. It
> certainly isn't something just for the 'Sheldons'.
>
> If you believe there are some areas of the org documentation which needs
> to be improved or augmented, I would strongly encourage you to
> contribute. One of the bigger challenges faced by community efforts like
> org-mode is documentation. Often, those who write and develop the
> solution are too close to it to write clear and comprehensive
> documentation. It needs contributions from users like yourself who don't
> have the low level knowledge which can blind you to higher level
> usability issues. As you will see from this list, documentation fixes
> and contributions are not uncommon and are certainly welcomed - in fact,
> that is one of the nice things about org-mode, the extent to which
> community contributions are accepted.
>
> regards,
>
> Tim
>
> Lawrence Bottorff  writes:
>
> > As many might gather from seeing so many of my beginner posts, I'm not
> > exactly a Sheldon Cooper type, i.e., someone who has the A-ha! angel
> > standing by 24/7 with her hand on his shoulder. So today I thought I'd
> > upgrade my knowledge of org-mode tables. So I go to the section of the
> > "manual" on tables. Experimenting on the commands, I get this fairly
> > quickly:
> >
> > | p | q | p implies q |
> > |---+---+---|
> > | T | T | T|
> > | T | F | F|
> > | F | T | T|
> > | F | F | T|
> >
> > which looks perfect in my buffer, but not so good on an HTML export,
> i.e.,
> > the third column values seem too crowded to the left. Hence, how does one
> > justify that last column to be center? Googling, I kept being directed to
> > this
> >  html#Column-width-and-alignment>
> > page,
> > which supposedly tells me how. Long story short, the A-ha! angel smiled,
> > and in the end I guessed that I'm supposed to do this:
> >
> > | p | q | p implies q |
> > |---+---+---|
> > | T | T | T|
> > | T | F | F|
> > | F | T | T|
> > | F | F | T|
> > |||  |
> >
> > which does in fact move the third column contents to the center -- on
> > export only. But that's not the norm for me, mainly because the
> explanation
> > has no example. Sure, it said, *To set the width of a column, one field
> > anywhere in the column may contain just the string ‘’ where ‘N’ is an
> > integer specifying the width of the column in characters. *But it's
> really
> > not so obvious that you create an extra dummy row and stick  in it --
> at
> > least not to me.
> >
> > I know from math courses that a text passage can be terribly opaque --
> *until
> > you get it -- *then it seemed obvious. However, I can see any beginner
> with
> > org-mode getting frustrated often with the Manual. And of course I can
> site
> > many similar examples where only the Sheldon types would get it.
> >
> > I guess I'm saying it would be nice to have a big omnibus O'Reilly-style
> > tutorial on how to use org-mode. I've hung with org-mode because I think
> > it's great and, IMHO, should become a standard tool in all
> > STEM/STEM-education settings. Think of all those high schools (and even
> > colleges) forcing students to use "graphic calculators." What a waste!
> >
> > LB
>
>
> --
> Tim Cross
>


Re: [O] Do not inherit unnumbered property: help needed

2017-11-21 Thread Nicolas Goaziou
Nicolas Goaziou  writes:


> Akater  writes:
>
>> I got an impression that UNNUMBERED's children get cut off prior to
>> what user can do,
>
> UNNUMBERED headings are not cut off, at least not by "ox.el".
>
>> hence writing a simple backend won't help, and I'll have to patch org
>> (ox) source. Do you know for sure I'm wrong?
>
> I'm quite certain you're wrong.
>
>> That's what I asked for
>> originally---which function is responsible for excluding unnumbered's
>> children from exported entries.
>
> Three functions actually check UNNUMBERED properties:
>
> - org-export-numbered-headline-p
> - org-export-collect-headlines
> - org-export-excluded-from-toc-p
>
> You can ignore the last two because it's a special case (when value is
> "notoc").
>
> So, if you want to control UNNUMBERED property, just don't trust
> `org-export-numbered-headline-p', or any function calling it.

On second thought, we might as well give more flexibility to the users,
that is, as long as one doesn't expect to get something meaningful from
every UNNUMBERED combination.

It is now possible to change UNNUMBERED status mid-tree, like any other
inherited property.

Regards,



Re: [O] Deletion immediately after insertion should leave org-mode tables unaltered but it doesn't

2017-11-21 Thread Nicolas Goaziou
Hello,

Ruy Exel  writes:

> This is indeed a good idea as it mimics the creation of a row in emacs
> text-mode with "C-o".

This is now implemented.

Regards,

-- 
Nicolas Goaziou0x80A93738



Re: [O] [rfc] org-dired

2017-11-21 Thread Nicolas Goaziou
Hello,

Marco Wahl  writes:

> I followed you suggestions and I think the new version is cleaner.

It looks good. Thank you!

Regards,

-- 
Nicolas Goaziou0x80A93738



Re: [O] [PATCH] ox.el: Define subtitle macro

2017-11-21 Thread Nicolas Goaziou
Hello,

Jens Lechtenboerger  writes:

> Thanks for your reply.  That would be great but goes way beyond my
> current understanding of org internals.  I've never heard of `split'
> behaviour.  Currently I don't have time to investigate this.

For the record, I implemented a "keyword" macro (master branch).

Feedback welcome.

Regards,

-- 
Nicolas Goaziou



Re: [O] Public TODO agendas

2017-11-21 Thread Tim Landscheidt
Tim Cross  wrote:

> I don't think tramp will work in this way, at least not without some
> sort of special client running on the remote http server and
> modifications to tramp to work with that client. The HTTP protocol will
> not easily fit with tramp - in fact, it is such a big 'disconnect'
> between tramp and http, you really would be trying to push a round peg
> into a square hole. It would be far easier to use other built-in bits of
> Emacs functionality along with some sort of remote http service agent to
> satisfy this use case (assuming you want bi-directional updates
> i.e. pull down an org file, update and push back up - just pulling down
> the file and appending it would be easy enough, but going the other way
> adds a lot of additional complexity).

> […]

To point out what "easy enough" in Emacs means (for
read-only access): M-x url-handler-mode RET, C-x C-f
http://www.gnu.org/software/emacs/ RET :-).

Tim




Re: [O] Potential bug: embedded dot fails on require ob-graphviz-dot

2017-11-21 Thread Kaushal Modi
On Mon, Nov 20, 2017 at 10:42 PM Eric Thomas  wrote:

> * Here is an example of dot in action in orgmode
> 
>

<>
<>

What an irony! :P

But a great example of dot-lang and ox-reveal :)
-- 

Kaushal Modi


Re: [O] "Reference Dump" rant

2017-11-21 Thread Tim Cross
Hi Lawrence,

glad you like org-mode. I also think it is a great tool.

One of the great things about org-mode is that it is used by a very wide
range of people. I know of a couple of people who are not at all
technical who use org-mode just for general organisation and writing. It
certainly isn't something just for the 'Sheldons'.

If you believe there are some areas of the org documentation which needs
to be improved or augmented, I would strongly encourage you to
contribute. One of the bigger challenges faced by community efforts like
org-mode is documentation. Often, those who write and develop the
solution are too close to it to write clear and comprehensive
documentation. It needs contributions from users like yourself who don't
have the low level knowledge which can blind you to higher level
usability issues. As you will see from this list, documentation fixes
and contributions are not uncommon and are certainly welcomed - in fact,
that is one of the nice things about org-mode, the extent to which
community contributions are accepted.

regards,

Tim

Lawrence Bottorff  writes:

> As many might gather from seeing so many of my beginner posts, I'm not
> exactly a Sheldon Cooper type, i.e., someone who has the A-ha! angel
> standing by 24/7 with her hand on his shoulder. So today I thought I'd
> upgrade my knowledge of org-mode tables. So I go to the section of the
> "manual" on tables. Experimenting on the commands, I get this fairly
> quickly:
>
> | p | q | p implies q |
> |---+---+---|
> | T | T | T|
> | T | F | F|
> | F | T | T|
> | F | F | T|
>
> which looks perfect in my buffer, but not so good on an HTML export, i.e.,
> the third column values seem too crowded to the left. Hence, how does one
> justify that last column to be center? Googling, I kept being directed to
> this
> 
> page,
> which supposedly tells me how. Long story short, the A-ha! angel smiled,
> and in the end I guessed that I'm supposed to do this:
>
> | p | q | p implies q |
> |---+---+---|
> | T | T | T|
> | T | F | F|
> | F | T | T|
> | F | F | T|
> |||  |
>
> which does in fact move the third column contents to the center -- on
> export only. But that's not the norm for me, mainly because the explanation
> has no example. Sure, it said, *To set the width of a column, one field
> anywhere in the column may contain just the string ‘’ where ‘N’ is an
> integer specifying the width of the column in characters. *But it's really
> not so obvious that you create an extra dummy row and stick  in it -- at
> least not to me.
>
> I know from math courses that a text passage can be terribly opaque -- *until
> you get it -- *then it seemed obvious. However, I can see any beginner with
> org-mode getting frustrated often with the Manual. And of course I can site
> many similar examples where only the Sheldon types would get it.
>
> I guess I'm saying it would be nice to have a big omnibus O'Reilly-style
> tutorial on how to use org-mode. I've hung with org-mode because I think
> it's great and, IMHO, should become a standard tool in all
> STEM/STEM-education settings. Think of all those high schools (and even
> colleges) forcing students to use "graphic calculators." What a waste!
>
> LB


-- 
Tim Cross



[O] "Reference Dump" rant

2017-11-21 Thread Lawrence Bottorff
As many might gather from seeing so many of my beginner posts, I'm not
exactly a Sheldon Cooper type, i.e., someone who has the A-ha! angel
standing by 24/7 with her hand on his shoulder. So today I thought I'd
upgrade my knowledge of org-mode tables. So I go to the section of the
"manual" on tables. Experimenting on the commands, I get this fairly
quickly:

| p | q | p implies q |
|---+---+---|
| T | T | T|
| T | F | F|
| F | T | T|
| F | F | T|

which looks perfect in my buffer, but not so good on an HTML export, i.e.,
the third column values seem too crowded to the left. Hence, how does one
justify that last column to be center? Googling, I kept being directed to
this

page,
which supposedly tells me how. Long story short, the A-ha! angel smiled,
and in the end I guessed that I'm supposed to do this:

| p | q | p implies q |
|---+---+---|
| T | T | T|
| T | F | F|
| F | T | T|
| F | F | T|
|||  |

which does in fact move the third column contents to the center -- on
export only. But that's not the norm for me, mainly because the explanation
has no example. Sure, it said, *To set the width of a column, one field
anywhere in the column may contain just the string ‘’ where ‘N’ is an
integer specifying the width of the column in characters. *But it's really
not so obvious that you create an extra dummy row and stick  in it -- at
least not to me.

I know from math courses that a text passage can be terribly opaque -- *until
you get it -- *then it seemed obvious. However, I can see any beginner with
org-mode getting frustrated often with the Manual. And of course I can site
many similar examples where only the Sheldon types would get it.

I guess I'm saying it would be nice to have a big omnibus O'Reilly-style
tutorial on how to use org-mode. I've hung with org-mode because I think
it's great and, IMHO, should become a standard tool in all
STEM/STEM-education settings. Think of all those high schools (and even
colleges) forcing students to use "graphic calculators." What a waste!

LB


[O] File name format in ARCHIVE property

2017-11-21 Thread Roland Everaert
Hi,

I would like to archive subtree in an archive file with the format:

%s-_archive

Where  is the current year and month. Is this possible and if yes
how?

Where can I find the possible formatting option for that property?


Regards,


Roland.


Re: [O] Public TODO agendas

2017-11-21 Thread numbch...@gmail.com
Maybe just use an auto sync solution like Dropbox, WebDAV etc?
And add a hook on `after-save-hook` to auto export org file to HTML, then
sync HTML files.
Somewhere hosting those HTML files can be viewed. and editing those
original org files directly.

[stardiviner] GPG key ID: 47C32433
IRC(freeenode): stardiviner Twitter:  @numbchild
Key fingerprint = 9BAA 92BC CDDD B9EF 3B36  CB99 B8C4 B8E5 47C3 2433
Blog: http://stardiviner.github.io/

On Tue, Nov 21, 2017 at 5:07 AM, Tim Cross  wrote:

>
> I don't think tramp will work in this way, at least not without some
> sort of special client running on the remote http server and
> modifications to tramp to work with that client. The HTTP protocol will
> not easily fit with tramp - in fact, it is such a big 'disconnect'
> between tramp and http, you really would be trying to push a round peg
> into a square hole. It would be far easier to use other built-in bits of
> Emacs functionality along with some sort of remote http service agent to
> satisfy this use case (assuming you want bi-directional updates
> i.e. pull down an org file, update and push back up - just pulling down
> the file and appending it would be easy enough, but going the other way
> adds a lot of additional complexity).
>
> Perhaps this is more something which could fit in with mobile org
> efforts?
>
> Tim
>
>
>
> Eric S Fraga  writes:
>
> > On Monday, 20 Nov 2017 at 21:13, numbch...@gmail.com wrote:
> >> I have similar function requirement. Based on your TRAMP method, I think
> >> remote file are just can be transported through any protocols like HTTP,
> >> for example remote file like http://example.org/test.org can be
> downloaded,
> >> then append to org-agenda files list. This is just an rough idea.
> >
> > I am not sure this is possible.  If I try http: as the protocol, tramp
> > tells me that only localhost is allowed.  Maybe I do not have tramp
> > configured properly?
>
>
> --
> Tim Cross
>


Re: [O] ob-python newline & indentation behavior

2017-11-21 Thread Jack Kamm
Yes, I'm starting to see now how difficult it is to properly support
":session :results value". I would vote to remove it from ob-python...

I think the patch still improves ":session :results output" so I will
simplify it and restrict to that case, leaving ":session :results value"
unchanged for now.

Sorry for sending this twice Kyle, forgot to reply all.

On 21 Nov 2017 4:04 am, "Kyle Meyer"  wrote:

> Jack Kamm  writes:
>
> > In response to this:
> >
> >> I can't think of a good solution, though.  Stepping back a bit, I think
> >> it's unfortunate that python blocks handle ":results value" differently
> >> depending on whether the block is hooked up to a session or not.  For
> >> non-sessions, you have to use return.  Using the same approach
> >> (org-babel-python-wrapper-method) for ":session :results value", we
> >> could then get the return value reliably, but the problem with this
> >> approach is that any variables defined in a ":results value" block
> >> wouldn't be defined in the session after executing the block because the
> >> code is wrapped in a function.
> >
> > How about if we used the "globals()" and "locals()" functions in Python?
> >
> > Something like this at the end of the wrapper block, before return:
> >
> > for k, v in locals().items():
> > globals()[k] = v
>
> Hmm, placing that code "before return" is a problem.  Like with
> non-session ":results value" blocks, the user would be responsible for
> inserting the return (or even multiple return's), so we can't know where
> to insert the above code without parsing the block :/
>
> > Another bug with the current approach is that it breaks if common idioms
> > like "for _ in range(10)" are used. ("_" is used to inspect the last
> output
> > of the shell, an obscure feature I hadn't known about until now).
>
> Right.  Also, IIRC the built-in interactive python and ipython treat
> multiline blocks differently.  With
>
> if True:
> "ipython ignores my existence"
>
> the built-in shell binds "_" to the string's value, but ipython doesn't.
>
> --
> Kyle
>