Several New Neorg Features

[vhyrro]

If you've been tracking Neorg recently you may have seen that there's been no activity on the main branch, but if you have a keen eye you'll have seen that Neorg has actually gotten a tonne of new stuff over the past 3 or so days in the unstable branch. Features move to the main branch when they've been extensively documented via wiki entries. Let's discuss what I've added so far:

Core Changes

• Improved performance with module loading
• Fixed issues with module configurations getting incorrectly merged or not merged at all if a module
  got loaded too quickly
• Remove the _meta function for metamodules (useless)
• Removed the ability to unload modules. Neorg simply has too many references and cross-references that it has to handle internally to be able to support module unloading - once you dock a module, it's docked forever now :P
• Refactored some stuff in core.autocommands
• Foreign modules can now broadcast events of different types

Workflow

Workspaces are slowly getting more and more features. I added a core.ui module that can handle stuff like floating windows, mainly input prompts.

Creating new files

To add a new note to your workspace first make sure you are in an actual workspace (not in the default one). The next step will only work if you use core.keybinds's automatic keybind generation: press <NeorgLeader>nn; the neorg leader by default is <Leader>o - nn stands for new note. There you can enter a name for a file and it will get automatically created in the root of your workspace. You can provide strings like work/todo.norg and Neorg will create a work directory with the todo.norg file inside for you. You can also omit the .norg extension completely in your string and Neorg will figure it out. Once we refresh the wiki entries the people who don't use the default keybinds will get the documentation to be able to bind the keys themselves.

Automatic Metadata Generation

Upon entering any .norg file if that file does not have a @document.meta tag already Neorg will attempt to generate one at the top level.

Jumping between Code and Notes

Neorg has gained the ability to jump between your code and your notes! You can now also kickstart the Neorg core without having to enter a .norg file, simply running :Neorg with no arguments will do that. If you have core.norg.dirman configured and enabled upon kickstarting the core it will attempt to set the workspace to the one you were in prior to the current session. So if the last time I used Neorg my workspace was set to e.g. work kickstarting the core will open up the work's index.norg file.

After that you can edit as many files as you see fit. Once you are ready to return to your work run :Neorg return - all .norg buffers will be closed and you will be back on track. The current workspace will also be unset and you will be back where you started.

Traversing Headings

A new mode has been added into the core - traverse-heading mode. This mode can be enabled via :Neorg set-mode traverse-heading or via the autogenerated keybind <NeorgLeader>mh (mode heading). In this mode the j and k keys move to the next and previous heading instead of going line by line. To move back to norg mode press <NeorgLeader>mn (mode norg) or run :Neorg set-mode norg. You can move individual lines in traverse-heading mode with gj and gk.

Indents

Indents have gotten a pretty big update. We now have support for real time indenting and current-line indenting. Those are pretty fancy buzzwords, but what you should know is that Neorg can now indent
your lines as you type, making the experience that much nicer. Also headings are a lot more strictly
indented now, giving you a more structured feel. Obviously all indents can be configured and changed as you see fit - we just need to write the documentation for it lol

Telescope integration (not released yet)

I've been also working on Telescope integration in the background. You can fuzzy find by heading, fuzzy find an element in the current document and automatically insert a link to it, fuzzy search workspaces when no default workspace is present etc. I wanna flesh it out a bit more before I release it tho

GIFs

Moving between Code and Neorg + adding notes

Realtime indentation

Traversing Headings with traverse-heading mode

Hope y'all enjoy!

[vhyrro]

I also wanted to throw in the fact that I've added some basic tangling support! 0.1 is looking closer than ever. I'll only really show off the tangling once I get it to a "nice enough" state. After we get tangling, it'll be as easy as:

• Finish off telescope.nvim integration
• Add some extra editing supports (like pressing enter to go to a link location) amongst other things
• Hopefully improve a few indents in the indentation engine here and there
• Maybe some extra bug fixes
• Update the ROADMAP.md and specification
  And that's it! That's the core code for 0.1 done. LET'S GO. After that I would love to spend a couple of days strictly on the TreeSitter parser and making it more intelligent. Then we're ready to rock and roll with first release.