Re: [Patch] Show org file title in org-clock clocktable

[Ihor Radchenko]

Duy Nguyen <ddnguyen2101@gmail.com> writes:

> Please find attached a patch to allow users to show the org file titles
> (i.e. the value of #+title) instead of the file name in the org-clock
> clocktable.

Thanks for the contribution!

> I created this patch as I am using a combination of org-roam and org-agenda
> to manage my tasks, where each project has its own org-roam file (and
> therefore, a #+title). For my work I also need to generate weekly time
> reports, with my todos spread over different org(-roam) files. I think the
> clocktable looks nicer with the org file title than the name generated by
> org-roam, which also has some other irrelevant information (for the
> clocktable) in it such as date and time created. I believe this feature
> could be useful for other users as well who have their tasks spread over
> multiple org-roam files like me. The feature can easily be used by adding
> ":filetitle t" as an option in the clocktable.

Sounds reasonable.

> Please note that the org-clock-get-file-prop function is heavily inspired
> by vulpea-buffer-prop-get from the vulpea package - I just copied it over
> and made some adjustments to make it work for the envisioned use case.

Please use the built-in org-collect-keywords instead.

> Allow user to show org file title instead of file name in the
> clocktable.  If the file does not have a title defined, the file name
> will be shown in the clocktable.

This is a user-facing change and should be documented in etc/ORG-NEWS file.


-- 
Ihor Radchenko,
Org mode contributor,
Learn more about Org mode at https://orgmode.org/.
Support Org development at https://liberapay.com/org-mode,
or support my work at https://liberapay.com/yantar92