Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Getting Things Done in Neorg #99

Merged
merged 253 commits into from
Oct 7, 2021
Merged

Getting Things Done in Neorg #99

merged 253 commits into from
Oct 7, 2021

Conversation

danymat
Copy link
Member

@danymat danymat commented Sep 8, 2021

This is the continuation of #60. We now track the PR from the gtd_base branch.

*Note: The GTD specifications are out, you can read them at GTD Specs (or by going to the gtd-branch and doing :h neorg gtd) 🥳 *
Note2: If you have some insights to share for the GTD spec, feel free to go to #67.

Configurations

require('neorg').setup {
    load = {
        ...
        ["core.norg.dirman"] = {
            config = {
                workspaces = {
                    main = "~/neorg",
                    gtd = "~/gtd" -- Create a new workspace 
                }
            }
        },
        ["core.gtd.base"] = {
            config = {
                workspace = "gtd" -- assign the workspace,
                exclude = { "file_to_exclude.norg" } -- Optional: all excluded files from the workspace are not part of the gtd workflow
            }
        },
        ...
    },
   
}

Summary

  • Please check :h neorg-gtd for the gtd specifications, and how the format works/
  • There are 3 actions you can do:
  1. Add your task to the inbox: :Neorg gtd capture
  2. Edit your task :Neorg gtd edit (the cursor should be over a task)
  3. View all your tasks aggregated in a pretty curated way: :Neorg gtd views

Please check out the comments below for more updates and showcases!

danymat and others added 30 commits August 8, 2021 21:46
Divided documentation in USAGE/KEYBINDS/REQUIRES following the best
practices
This is the start of command capabilities for gtd. At the moment it
supports :Neorg gtd capture, which will call the funciton
add_task_to_inbox()
At the moment it only defines the command, since i'm waiting for a
function to open a file.
I defined a new function called open_file() in dirman, and used it to
open the list when :Neorg gtd list inbox is called
At the moment it supports the syntax discussed in #61

For example:

This is a task @home +"This is a project"

will be written in inbox as:

* This is a project
** home
- [ ] This is a task
I forgot to add the - [ ], before the task content
The due date support is done via $due:..., with ... being one of the following ($ treated as number):

- $d: days from now (e.g 2d is 2 days from now)
- $w: weeks from now (e.g 2w is 2 weeks from now)
- $m: months from now (e.g 2m is 2 months from now)
- tomorrow: tomorrow's date
- today: today's date
- Any date with the format specified below
The format for date is YY-mm-dd
I added the support for start dates, with the same syntax as due dates.

Futhermore, I refactored the finders to be only one function doing all,
and the syntax is specified in module.private.syntax
Instead of calling the function for each syntax, i iterated through
them, which is better for lisibility
    - Add temporary `:Neorg gtd select_date` command to test the new
      selection system
    - Make capture popups close on `<CR>`
    - Remove async startup in Neorg
    - Format with stylua (the most important feature)
In order to add or modify a syntax, we now only need to set or change
values in the module.private.syntax table
@danymat
Copy link
Member Author

danymat commented Oct 3, 2021

Hello everyone, I just merged the new UI features @vhyrro worked on, and I ported them onto the GTD specs.
There are now 2 commands:

  • :Neorg gtd quick_actions

This popup allows you to display your gtd tasks and projects, sorted by contexts, waiting fors, etc.

Quick.actions.mov

It allows you to add a task to inbox too:

Add.to.inbox.mov
  • Neorg gtd edit

This popup allows you to edit a task over the cursor (there are still small limitations for creating contexts, but it works quite well, see #123) :

I'm very excited about the directions where GTD is going, and hopefully once #123 is closed and a little more stress testing, I will be okay to merge into unstable in order to receive feedback about GTD users.

@danymat danymat mentioned this pull request Oct 5, 2021
1 task
@vhyrro vhyrro marked this pull request as ready for review October 6, 2021 17:02
@danymat danymat merged commit 0a01a52 into unstable Oct 7, 2021
@danymat danymat deleted the gtd_base branch October 7, 2021 18:30
@danymat danymat mentioned this pull request Nov 15, 2021
11 tasks
vhyrro pushed a commit that referenced this pull request Jan 24, 2022
Getting Things Done in Neorg
esquires pushed a commit to esquires/neorg that referenced this pull request Apr 12, 2022
Getting Things Done in Neorg

Former-commit-id: 8ab5719
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Calendar and appointments
3 participants