Samþætting við ritla¶

Emacs (Apheleia)¶

Apheleia keyrir ytri sníðmótunartól við vistun minnissvæðis og varðveitir staðsetningu bendils.

(with-eval-after-load 'apheleia
  (push '(snapper . ("snapper" "--format" "org")) apheleia-formatters)
  (push '(org-mode . snapper) apheleia-mode-alist)
  ;; Add for other formats:
  (push '(latex-mode . snapper) apheleia-mode-alist)
  (push '(markdown-mode . snapper) apheleia-mode-alist))

--format flaggið sjálfgreinir út frá skráarendingu, svo þú getur sleppt því ef skrárnar þínar hafa staðlaðar endingar.

Vim / Neovim¶

Notaðu formatprg til að síga í gegnum snapper:

autocmd FileType org setlocal formatprg=snapper\ --format\ org
autocmd FileType tex setlocal formatprg=snapper\ --format\ latex
autocmd FileType markdown setlocal formatprg=snapper\ --format\ markdown

Síðan gq til að endursníða valinn texta, eða gggqG til að endursníða allt minnissvæðið.

Fyrir Neovim með conform.nvim:

require("conform").setup({
  formatters = {
    snapper = {
      command = "snapper",
      args = { "--format", "$FILETYPE" },
      stdin = true,
    },
  },
  formatters_by_ft = {
    org = { "snapper" },
    tex = { "snapper" },
    markdown = { "snapper" },
  },
})

VS Code extension (recommended)¶

Install TurtleTech.snapper from the VS Code Marketplace.

The extension provides:

Format-on-save via the built-in LSP server
Range formatting (format just the selected text)
Diagnostics (flags lines with multiple sentences)
Code actions (quick fixes to split multi-sentence lines)
Status bar indicator showing LSP connection state
Project configuration via .snapperrc.toml

To format on save, add to your settings.json:

{
  "editor.formatOnSave": true,
  "[markdown]": { "editor.defaultFormatter": "TurtleTech.snapper" },
  "[latex]": { "editor.defaultFormatter": "TurtleTech.snapper" },
  "[org]": { "editor.defaultFormatter": "TurtleTech.snapper" }
}

To use a custom binary path:

{
  "snapper.path": "/path/to/snapper"
}

The extension also works with VSCodium and code-oss (Arch Linux). Download the .vsix from GitHub Releases and install manually if the Marketplace is unavailable.

Manual VS Code setup (without extension)¶

Notaðu „Run on Save“ viðbótina með sérsniðinni skipun:

{
  "emeraldwalk.runonsave": {
    "commands": [
      {
        "match": "\\.(org|tex|md|rst)$",
        "cmd": "snapper --in-place ${file}"
      }
    ]
  }
}

LSP (any editor with LSP support)¶

Snapper ships a Language Server Protocol implementation. Start it with:

snapper lsp

This provides document formatting, range formatting, and diagnostics (flags lines with multiple sentences) over the standard LSP protocol on stdin/stdout.

Neovim (snapper.nvim plugin)¶

The snapper.nvim plugin (in editors/nvim/) handles LSP lifecycle, format-on-save, keymaps, and conform.nvim integration. See the plugin README for installation and configuration.

For manual LSP setup without the plugin:

vim.api.nvim_create_autocmd("FileType", {
  pattern = { "org", "tex", "markdown" },
  callback = function()
    vim.lsp.start({
      name = "snapper",
      cmd = { "snapper", "lsp" },
    })
  end,
})

Emacs (eglot)¶

(add-to-list 'eglot-server-programs
             '((org-mode latex-mode markdown-mode) "snapper" "lsp"))

VS Code¶

Add to settings.json (requires a generic LSP client extension):

{
  "lsp.servers": {
    "snapper": {
      "command": "snapper",
      "args": ["lsp"],
      "filetypes": ["org", "tex", "markdown"]
    }
  }
}

Helix¶

Add to ~/.config/helix/languages.toml:

[[language]]
name = "org"
language-servers = ["snapper"]

[language-server.snapper]
command = "snapper"
args = ["lsp"]

Obsidian¶

Install the snapper plugin from Obsidian Community Plugins (Settings > Community Plugins > Browse > search „Snapper“).

The plugin uses a WebAssembly build of snapper – no binary installation needed.

Commands:

„Format entire note“ – formats the active note
„Format selection“ – formats the selected text

Settings: format-on-save, max line width, language, extra abbreviations. Format auto-detects from the note’s file extension.

For manual installation (before the plugin is listed in Community Plugins):

Download main.js and manifest.json from GitHub Releases
Copy both files to .obsidian/plugins/snapper/ in your vault
Enable the plugin in Settings > Community Plugins

Microsoft Word¶

The snapper Word add-in provides a task pane for formatting documents with semantic line breaks. It uses a WebAssembly build – no binary installation needed.

Install from AppSource¶

In Word: Insert > Get Add-ins > search „Snapper“.

Sideloading (development)¶

Download the add-in ZIP from GitHub Releases
In Word: Insert > My Add-ins > Upload My Add-in
Select the manifest.xml from the extracted ZIP

The task pane provides:

„Format Document“ – formats all paragraphs
„Format Selection“ – formats the selected text
Settings for max width, language, and extra abbreviations

Almennt (hvaða ritill sem er)¶

Snapper les af stdin og skrifar á stdout sjálfgefið. Sérhver ritill sem styður að síga í gegnum ytra forrit virkar:

cat paper.org | snapper --format org