fyi, a package for communication between org and gui browser

2022-03-01 Thread Samuel Wales
in sacha's list:

https://github.com/bitspook/spookfox

have not tried it, but it looks like it might end up being useful for
too many firefox tabs, annotation of web locations, reusing of ff
tabs, bidir capture-ish things.

-- 
The Kafka Pandemic

A blog about science, health, human rights, and misopathy:
https://thekafkapandemic.blogspot.com



Inline src block element not parsed correctly for export when in a list item

2022-03-01 Thread Kaushal Modi
Hello,

I believe I have come across a corner case issue where the inline src
block element doesn't get parsed as one, if:

1. That src block is in a list item (plain list, definition list, etc.), AND
2. That src block wraps around when auto-filling.

This issue can be reproduced on the main branch:

Org mode version 9.5 (release_9.5-505-gef666)

MWE:

=
#+author:
#+options: toc:nil

Run ~C-c C-e t A~.

* Doesn't export correctly if inline src block is in a wrapped list
- abcdefg abcdefg abcdefg abcdefg src_org[:exports code]{[[abc
  def][bar]]}.
* Exports correctly
** .. if the inline src block wraps in a paragraph
abcdefg abcdefg abcdefg abcdefg src_org[:exports code]{[[abc
def][bar]]}.
** .. if the inline src block is in a list but doesn't wrap
- abcdefg abcdefg abcdefg abcdefg src_org[:exports code]{[[abc def][bar]]}.
=

Upon pasting the above snippet in an Org buffer and running `C-c C-e t
A`, I get:

=
Run `C-c C-e t A'.


1 Doesn't export correctly if inline src block is in a wrapped list
===

  - abcdefg abcdefg abcdefg abcdefg src_org[:exports code]{[[abc
  def][bar]]}.


2 Exports correctly


2.1 .. if the inline src block wraps in a paragraph
~~~

  abcdefg abcdefg abcdefg abcdefg `[[abc def][bar]]'.


2.2 .. if the inline src block is in a list but doesn't wrap


  - abcdefg abcdefg abcdefg abcdefg `[[abc def][bar]]'.
=


Note that incorrect export of the inline src block in section 1 above.
The remaining sections exports correctly because either the inline src
block is not in a list item, or it doesn't wrap to the next line.

--
Kaushal Modi



Re: How do you manage complex project with Org-mode

2022-03-01 Thread Milan Zamazal
> "SG" == Sébastien Gendre  writes:

SG> But, as a student, I regularly have big and important projects
SG> to do for the school. The kind of project who need several days
SG> to be done, with deadlines too soon, and if you fail one them
SG> the consequences can be disastrous. And generally, I have to
SG> many of these project in the same time and not enough time to do
SG> all the work. So, I also need to follow the progress of each
SG> project to choose which is sufficiently advanced to be stop for
SG> the benefit of another less advanced project.

SG> And I don't know how to manage this kind of projects with
SG> Org-mode. How to do it, without failing a 6 days project because
SG> I spent to much time on something else and I have only 3 days
SG> left with 3 half-day important appointment I cannot cancel. I
SG> can't risk failing a single one of these project by trying. So,
SG> when I am in a period with a lot of these projects, I stop using
SG> Org-mode and concentrate on doing these project as fast as I
SG> can. And because I often have this kind of project, I spend most
SG> of the year without being able to use Org-mode.

Hi, I’d join the suggestion to keep things simple in the beginning.  My
task flow is different from yours but in order not to miss really
important things, I use the following:

- Deadlines, with longer in-advance warnings when needed (e.g. “-3w” in
  DEADLINE).

- I use priority A for and only for stuff that is on risk of really bad
  consequences if not handled ASAP.  And I schedule such stuff to a
  future date if it doesn’t make sense to work on it now for any reason.

As for progress, I’d say that if you don’t know how far are you with
your short-term tasks and which of them require attention currently then
you might have a problem with your workflow.  Maybe you are too
overloaded or you don’t split your time among the tasks appropriately.
Org mode is a good tool to implement support for different workflows but
cannot help if a used workflow doesn’t work very well for you.  Again,
starting simple with Org mode and paying attention first to how you work
and how it could be improved generally might be a good idea (and a
life-long process for many of us).

Regards,
Milan




Re: org-modern

2022-03-01 Thread Tim Cross


William Denton  writes:

> I noticed org-modern in the list of new packages available:
>
> https://github.com/minad/org-modern
>
> Worth a look by any Org users, just for the screenshots comparing Org buffers 
> normally and with
> org-modern.  Fine work from Daniel Mendler, who I think is on this list.  I'm 
> trying it out
> right now.
>

I was looking at this package and it looks interesting. However, I do
wonder how much of an impact it has on org performance. I suspect it
will have a significant impact on large org files. Would be interested
in hearing how people find it with larger files.



Re: How do you manage complex project with Org-mode

2022-03-01 Thread Antonio Carlos Padoan Junior


Hello,

I'm not sure if I will help you with my advice, but I really appreciate
to use taskjuggler mixed with org-mode. There is somewhere in the web an
org-exporter to taskjuggler. I think recently a topic on this matter
appeared in this list.

Taskjuggler can help you optimizing complex plannings and can be used in a
professional context.

For sure you will need to invest some time on it but it is a good
middle-term investment.

Good luck,
--
Antonio Carlos PADOAN JUNIOR
GPG fingerprint:
243F 237F 2DD3 4DCA 4EA3  1341 2481 90F9 B421 A6C9



org-modern

2022-03-01 Thread William Denton

I noticed org-modern in the list of new packages available:

https://github.com/minad/org-modern

Worth a look by any Org users, just for the screenshots comparing Org buffers 
normally and with org-modern.  Fine work from Daniel Mendler, who I think is on 
this list.  I'm trying it out right now.


Bill

--
William Denton
https://www.miskatonic.org/
Librarian, artist and licensed private investigator.
Toronto, Canada



Re: [BUG] org-insert-link should use DEFAULT in read-string when asking for description

2022-03-01 Thread Max Nikulin

On 27/02/2022 23:16, Visuwesh wrote:

[ஞாயிறு, பிப்ரவரி 27 2022] Max Nikulin wrote:

On 26/02/2022 21:16, Visuwesh wrote:

[சனி, பிப்ரவரி 26 2022] Max Nikulin wrote:


Are you suggesting replacing
  (read-string "rs-initial: " "Some initial")
by
  (read-string "rs-default: " nil nil "Some default")
?

Yes, exactly.


However you agreed that it would be regression since empty description
use case would be impossible.


No.  It is impossible to do it using read-string, but it is possible to
do it by writing a function that calls read-from-minibuffer (and I gave
an example of a function that does this).


I admit that I forgot about this but Emacs can be made to not translate
empty string to the default argument if you DTRT when calling
`read-from-minibuffer' (and `read-shell-command' does this).  If writing
a new function just to get this functionality is too much, then I guess



 2. The reason why I cited read-shell-command does not have anything
to do with the usefulness of empty string (or shell command).  I
merely wanted to point out that you can have BOTH the DEFAULT
argument (and no INITIAL), and can make the empty string a valid
output from the function (i.e., without getting substituted by
the DEFAULT argument).


In my opinion deprecation of the INITIAL argument without some descent 
replacement was a mistake. I suspect that such statement appeared 
without realizing of the problem with discriminating default vs. empty 
value. `read-string' oversimplify it by assumption that users do not 
need empty values at all. Your first argument was that INITIAL is 
deprecated but in the next message you pointed to a function that still 
uses the INITIAL argument. On the other hand `read-shell-command' 
belongs to command for which empty return value is hardly meaningful 
despite it is possible. That is why I disputed that `read-shell-command' 
is a good example of `read-from-minibuffer' usage in the context of 
`org-insert-link'.



Please read the docstring of read-from-minibuffer.  You would be better
served by reading it than me replicating it here.  And I gave
read-shell-command as an example so others could study the function.

In essence, you can get the old behaviour (1) but you need to type M-n
beforehand.  Its one more key but it is far better than the current
behaviour since it is consistent with rest of the Emacs ecosystem (see
below also).


I do not think it is a good idea to require extra M-n to keep the 
*current* description when a user hit C-c C-l to edit the link target 
with no intention to touch its description.



With every command I use, when I know that the DEFAULT argument will be
of no use, I simply start typing.  However, with org-insert-link I have
to clear the input _first_ then start typing.  This never happens
elsewhere, even in grep (which you cite as an example)!


I agree that it is great to be able to just start typing to replace 
default description. Unfortunately similar to significant fraction of 
interfaces, `org-insert-link' behavior is a result of trade-offs and 
compromises. If you see a way to improve it, please, submit a patch or 
at least post a code that can be tried from a src block or from the 
*scratch* buffer to evaluate possible regressions and unaddressed use cases.




Using pandoc to convert LaTeX math to MathML

2022-03-01 Thread David Lukeš
Hi all,

I recently wanted to set up LaTeX-to-MathML conversion in Org exports
and got a bit frustrated trying to get either of the two options
recommended in the docs (MathToWeb and LaTeXML) to work. But then I
realized I should be able to use Pandoc for this -- and indeed, `(setq
org-latex-to-mathml-convert-command "pandoc -f latex -t html5 --mathml
%I -o %o")' seems to work!

So I'm wondering -- is it maybe worth adding this option to the docs?
MathToWeb and LaTeXML are both relatively obscure compared to Pandoc.
What's more, chances are users will already have Pandoc installed, as
it enables additional export capabilities for Org.

What are your thoughts?

Best,

David



Re: How do you manage complex project with Org-mode

2022-03-01 Thread Tim Cross


Sébastien Gendre  writes:

> Hello,
>
> I don't know if it's the correct place to ask it. If not, sorry to ask in
> the wrong place.
>

I think it is the correct place. This is a list for general org mode
discussions. Such discussions can be technical or about how to use org mode.

> How do you manage complex project with Org-mode ?
>
> I used Org-mode for several periods of time in recent years. It worked
> very well for short and day to day tasks. When only a few of theme have
> deadlines and when you have plenty of time to do them.
>
> But, as a student, I regularly have big and important projects to do for
> the school. The kind of project who need several days to be done, with
> deadlines too soon, and if you fail one them the consequences can be
> disastrous. And generally, I have to many of these project in the same
> time and not enough time to do all the work. So, I also need to follow
> the progress of each project to choose which is sufficiently advanced to
> be stop for the benefit of another less advanced project.
>
> And I don't know how to manage this kind of projects with Org-mode. How
> to do it, without failing a 6 days project because I spent to much time
> on something else and I have only 3 days left with 3 half-day important
> appointment I cannot cancel. I can't risk failing a single one of these
> project by trying. So, when I am in a period with a lot of these
> projects, I stop using Org-mode and concentrate on doing these project
> as fast as I can. And because I often have this kind of project, I spend
> most of the year without being able to use Org-mode.
>

The first thing I would say is that org mode is NOT going to solve your
problems of too many tasks with competing priorities in too short a time
period or mitigate the impact from missed deadlines etc. In fact, no
project management software can do this.

Org mode is merely a tool which can help you manage tasks, deadlines,
schedules, priorities and project information. It can help you track
your tasks so fewer are overlooked/forgotten, it can help you manage
your deadlines and scheduling of time and it can help you manage
priorities and provide you with an overview of things that can alert you
to issues earlier, allowing for a wider range of mitigation
strategies. However, it is just a tool and how well you use that tool
will come down to experience and self discipline.


> So, if you have any suggestion on how to manage, in Org-mode, projects
> with:
> * Lot of work to do (many days)
> * Short deadline (not enough time)
> * High importance (disastrous consequences in my future in case of fail)
> * Many of them in the same time
> * Progression need to be followed to chose where to sacrifice time to
>   limit the damages
>

That list is almost an exact match for the job criteria on the last job
I applied for, which highlights the point these are individual skills
which need to be learned, primarily through experience and not something
which can be solved by a software tool. Such tools can help ensure
things don't fall through the gaps during busy stressful projects, can
help you assess how much work needs to be done and where corners will
need to be cut or deadlines changed, scope reduced or quality
decreased. At some point, you have to make a call as to what you will
manage in your org-mode files. Too much or too detailed and too much
time will be spent gathering and managing the data. Too little or
insufficient detail and decisions on what has to be sacrificed are
likely to be misguided or wrong. Unfortunately, there is no formula to
calculate this. It will depend on the environment, types of projects and
individual experience and preferences.

The key to using org mode to manage projects is largely about
incremental refinement. You start by defining a plan on how to use org
mode, you then implement that plan and start using it. You then review
how well it is working at some point and take the experience to that
point, both positive and negative, into a new cycle, starting with a new
plan (refined plan), implement, use review and continue this cycle
(probably indefinitely, but likely with longer cycles).

In general, I would recommend the following

- Start simple. Don't try to do everything all at once. Org is extremely
  flexible with a lot of built-in functionality. Trying to use all of it
  all at once is likely going to make it a burden rather than an aid.

- Start with a default org-mode configuration. A mistake I've seen
  people make many times is to immediately start by configuring new and
  complicated TODO states or complicated capture templates or extensive
  tag hierarchies and complex priority levels. Avoid the temptation to
  over engineer your requirements. Use the default configuration for a
  time and then evaluate things and decide where to make some small
  changes.

- Don't let the tail wag the dog. Remember, org mode is there to make
  your life easier. If you find your now spending all your time 

Re: How do you manage complex project with Org-mode

2022-03-01 Thread Dr. Arne Babenhauserheide
Hello Seb,

It sounds like org-mode can be a great fit.

Sébastien Gendre  writes:
> But, as a student, I regularly have big and important projects to do for
> the school. The kind of project who need several days to be done, with
> deadlines too soon, and if you fail one them the consequences can be
> disastrous. And generally, I have to many of these project in the same
> time and not enough time to do all the work. So, I also need to follow
> the progress of each project to choose which is sufficiently advanced to
> be stop for the benefit of another less advanced project.

Do I understand it right that what you need is to track the time
required to reach milestones, not following the *progress*? So following
progress seems like it would take more mental bandwidth than needed.

You could have one org-mode task (headline) per milestone, with a
DEADLINE (org-deadline), and then SCHEDULE (org-schedule) appointments.

To track how much time you will still need, you can use org-set-effort.
I did that at work for a while to train to get better at estimating. By
having the effort in a clocktable I could see progress *when needed*.
Hitting R in the org-agenda shows the clockreport-mode and you can see
the Effort in the agenda by setting
(org-agenda-clockreport-parameter-plist (quote (:link t :maxlevel 2
:properties ("Effort". For a while I had the clocktable active by
default.

You can also add that to the column-mode (org-columns) to get a quick
overview for a file (leave with org-columns-quit). Customize:
(org-columns-default-format
   "%25ITEM %TODO %3PRIORITY %TAGS %17Effort(Estimated Effort){:} %CLOCKSUM")

> And I don't know how to manage this kind of projects with Org-mode. How
> to do it, without failing a 6 days project because I spent to much time
> on something else and I have only 3 days left with 3 half-day important
> appointment I cannot cancel. I can't risk failing a single one of these
> project by trying. So, when I am in a period with a lot of these
> projects, I stop using Org-mode and concentrate on doing these project
> as fast as I can. And because I often have this kind of project, I spend
> most of the year without being able to use Org-mode.

I found that org-mode is the only organization tool for which using the
tool actually reduces the time I need for organization. That works by
taking notes in org-mode, too, and keeping it simple.

What I do:

** Custom starting point: agenda-with-kanban
  A function to show the agenda it besides the Kanban table. I start
  each day and after each larger break by hitting F12. It shows me the
  agenda and entry points into my work. This enables me to stay focussed.

** One planning file
  I have a single file for all my tasks. That keeps working
  surprisingly long. Once a year or so it needs some cleanup to become
  faster again.

** Kanban Table at the top
  I have a kanban table. It shows as most important information the
  tasks I am doing right now. If I am doing more than three work-tasks
  at the same time, it’s warning sign that I’m becoming inefficient.
  With this I start every day in org-mode by clicking on the link of the
  project from the kanban table to get to its notes (which I also track
  in org-mode). See
  https://www.draketo.de/light/english/free-software/el-kanban-org-table
  → https://hg.sr.ht/~arnebab/kanban.el

** Capture tasks for Projects
  Projects have as many tasks as I need to track. At work they are
  usually Stories (3-5 days). Nowadays I create new tasks by using
  org-capture templates with one template per larger project and one for
  bugs, but I used to just use two templates (which might be a
  better fit for you):
  - (i) task to start immediately and
  - (l) task to start later

** Setup

(with-eval-after-load 'org
  (setq org-agenda-custom-commands
'(("o" "Agenda and TODOs"
   ((agenda) ; nil ((org-agenda-compact-blocks 
nil)(org-agenda-block-separator ?-)(org-agenda-overriding-header "")))
(tags-todo "-notodo-TERMIN" ((org-agenda-block-separator ?-)))
(tags "KANBAN" ((org-agenda-block-separator ?-)
(org-agenda-compact-blocks nil)
(org-agenda-overriding-header ""
  (defun my/org-agenda-show-kanban ()
  (interactive)
  (save-excursion
(search-forward ":KANBAN:")
(org-agenda-goto)
(org-narrow-to-subtree)
(show-all)
(fit-window-to-buffer)
(widen)
(recenter-top-bottom 0)))

(defun agenda-and-todo ()
  (interactive)
  (org-agenda nil "o")
  (delete-other-windows)
  (my/org-agenda-show-kanban)
;;  desktop systemsettings shortcuts: map f12 to
;;emacsclient -e '(progn (show-frame)(agenda-and-todo))'
(global-set-key (kbd "") 'agenda-and-todo)



> So, if you have any suggestion on how to manage, in Org-mode, projects
> with:
> * Lot of work to do (many days)
> * Short deadline (not enough time)

This is something to fix. Also outside org. Always feeling like having
to