nvim-orgmode / nvim-orgmode/orgmode

No way to set `#+FILETAGS` programmatically.

Open
#989 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Lua
Stars
3.9k
Forks
190
Avg merge
2d 13h
Merged PRs (30d)
7

Description

As suggested by @kristijanhusak in https://github.com/nvim-orgmode/orgmode/pull/878#discussion_r1974916880, this issue is to remind us that there currently is no way to add or remove file-global tags in the #+FILETAGS directive.

This is a bother because org-attach has an auto-tag feature that it wants to both use on headlines (if the cursor is under a headline) and on files as a whole (if the cursor is above the first headline).

FWIW, this is also an issue in the current version of Emacs org-attach, see https://github.com/emacs-mirror/emacs/blob/492adf20b91520e96fb198e6e936e3145359c43b/lisp/org/org-attach.el#L532.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the org-attach auto-tag behavior and the existing handling of the #+FILETAGS directive. Define how programmatic add and remove operations should work for file-global tags, then verify that both file-level and headline-level auto-tagging behave as intended.

Written by the indexing model from the issue text.

Assessment

Tech stack
lua
Domain
tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.