It's a simple Neovim plugin that provides a global note in a float window. It could also provide other global, project local, file local notes (if it's required).
local global_note = require("global-note")
global_note.setup()
vim.keymap.set("n", "<leader>n", global_note.toggle_note, {
desc = "Toggle global note",
})
{
-- Filename to use for default note (preset).
-- string or fun(): string
filename = "global.md",
-- Directory to keep default note (preset).
-- string or fun(): string
directory = vim.fn.stdpath("data") .. "/global-note/",
-- Floating window title.
-- string or fun(): string
title = "Global note",
-- Ex command name.
-- string
command_name = "GlobalNote",
-- A nvim_open_win config to show float window.
-- table or fun(): table
window_config = function()
local window_height = vim.api.nvim_list_uis()[1].height
local window_width = vim.api.nvim_list_uis()[1].width
return {
relative = "editor",
border = "single",
title = "Note",
title_pos = "center",
width = math.floor(0.7 * window_width),
height = math.floor(0.85 * window_height),
row = math.floor(0.05 * window_height),
col = math.floor(0.15 * window_width),
}
end,
-- It's called after the window creation.
-- fun(buffer_id: number, window_id: number)
post_open = function(_, _) end,
-- Whether to use autosave. Autosave saves buffer on closing window
-- or exiting Neovim.
-- boolean
autosave = true,
-- Additional presets to create other global, project local, file local
-- and other notes.
-- { [name]: table } - tables there have the same fields as the current table.
additional_presets = {},
}
You can use additional presets to have other global notes, project local notes, file local notes or anything you can come up with.
A preset is a list of options that can be used during opening a note.
All additional presets inherit default
preset. default
preset is a
list of options that are in the setup's root).
Simple example:
require("global-note").setup({
filename = "global.md",
directory = "~/notes/",
additional_presets = {
projects = {
filename = "projects-to-do.md",
title = "List of projects",
command_name = "ProjectsNote",
-- All not specified options are used from the root.
},
food = {
filename = "want-to-eat.md",
title = "List of food",
command_name = "FoodNote",
-- All not specified options are used from the root.
},
},
})
-- Functions to toggle notes:
require("global-note").toggle_note()
require("global-note").toggle_note("projects")
require("global-note").toggle_note("food")
-- Commands to toggle notes (they are generated by command_name field):
-- :GlobalNote -- by default
-- :ProjectsNote
-- :FoodNote
:warning: Usecases require some functions from below!
local global_note = require("global-note")
global_note.setup({
additional_presets = {
project_local = {
command_name = "ProjectNote",
filename = function()
return get_project_name() .. ".md"
end,
title = "Project note",
},
}
})
vim.keymap.set("n", "<leader>n", function()
global_note.toggle_note("project_local")
end, {
desc = "Toggle project note",
})
local global_note = require("global-note")
global_note.setup({
additional_presets = {
git_branch_local = {
command_name = "GitBranchNote",
directory = function()
return vim.fn.stdpath("data") .. "/global-note/" .. get_project_name()
end,
filename = function()
local git_branch = get_git_branch()
if git_branch == nil then
return nil
end
return get_git_branch():gsub("[^%w-]", "-") .. ".md"
end,
title = get_git_branch,
},
}
})
vim.keymap.set("n", "<leader>n", function()
global_note.toggle_note("git_branch_local")
end, {
desc = "Toggle git branch note",
})
Functions for usecases above!:
local get_project_name = function()
local project_directory, err = vim.loop.cwd()
if project_directory == nil then
vim.notify(err, vim.log.levels.WARN)
return nil
end
local project_name = vim.fs.basename(project_directory)
if project_name == nil then
vim.notify("Unable to get the project name", vim.log.levels.WARN)
return nil
end
return project_name
end
local get_project_name = function()
local result = vim.system({
"git",
"rev-parse",
"--show-toplevel",
}, {
text = true,
}):wait()
if result.stderr ~= "" then
vim.notify(result.stderr, vim.log.levels.WARN)
return nil
end
local project_directory = result.stdout:gsub("\n", "")
local project_name = vim.fs.basename(project_directory)
if project_name == nil then
vim.notify("Unable to get the project name", vim.log.levels.WARN)
return nil
end
return project_name
end
local get_project_name = function()
local result = vim.system({
"git",
"symbolic-ref",
"--short",
"HEAD",
}, {
text = true,
}):wait()
if result.stderr ~= "" then
vim.notify(result.stderr, vim.log.levels.WARN)
return nil
end
return result.stdout:gsub("\n", "")
end