vale в NvChad (Neovim)

Вступ

vale.sh є одним із найкращих проектів із відкритим кодом для технічних авторів, які хочуть покращити свій голос і послідовність стилю. Його можна використовувати з низкою редакторів майже на всіх основних платформах ОС (Linux, MacOS, Windows). Ви можете дізнатися більше про проект, перейшовши на веб-сайт vale.sh. Цей посібник допоможе вам додати vale до NvChad. Оскільки він включений до пакетів Mason для встановлення, процес не є надто складним, хоча він вимагає незначного редагування та налаштування, щоб розпочати роботу. Щоб було зрозуміло, NvChad насправді є менеджером конфігурації для редактора Neovim, тому з цього моменту посиланням буде nvim.

Передумови

• Знайомство з NvChad 2.0 є корисним
• Можливість змінювати файли з командного рядка за допомогою улюбленого редактора. (vi або ваш улюблений)

Встановлення vale за допомогою Mason

Встановлення vale з NvChad за допомогою Mason дозволить підтримувати пакет в актуальному стані за допомогою кількох додаткових кроків. Періодичний запуск Mason з nvim покаже вам, чи є оновлення, які потрібно встановити, і дозволить вам оновлювати їх звідти. Це включає vale після встановлення. Давайте почнемо із запуску nvim, щоб отримати порожній файл, а потім перейдемо в командний режим за допомогою SHIFT+:+Mason, що має показати інтерфейс, подібний до цього:

Замість того, щоб переглядати весь список пакунків, скористаємося пунктом меню 4, щоб обмежити список лінтерами. Натисніть 4 і прокрутіть список униз, доки не знайдете vale, а потім, встановивши курсор у цьому рядку, натисніть i, щоб установити. Тепер у вашому списку має відображатися встановлений vale:

Налаштування та ініціалізація vale

Існує два методи, якими можна скористатися для налаштування vale. Ви можете вибрати свій улюблений із двох наведених нижче варіантів. В одному ви створите файли конфігурації всередині шляху двійкового файлу vale, а потім перемістите їх у свою домашню теку, а в іншому ви створите файли конфігурації безпосередньо у своїй домашній теці. Вони однаково добре працюють. Другий варіант має менше ручних кроків, але вимагає довгого шляху до двійкового файлу vale.

Підказка

Якщо ви хочете приховати папку «styles» (нижче), трохи змініть вміст .vale.ini під час створення, змінивши параметр «StylesPath» з «styles» на щось приховане, наприклад «.styles» або « .vale_styles." Приклад:

StylesPath = .vale_styles

Просто встановити vale недостатньо. Вам потрібно декілька додаткових речей. По-перше, вам потрібен файл .vale.ini, який зберігатиметься в корені вашої домашньої папки. Далі вам потрібно буде створити каталог «styles» за допомогою vale sync.

Встановлення зі шляху двійкового файлу vale

Якщо ви перебуваєте на шляху до двійкового файлу vale тут: ~/.local/share/nvim/mason/packages/vale/, ви можете просто створити . vale.ini тут, згенеруйте каталог «styles», а потім перемістіть обидва у свій домашній кореневий ~/. Створити файл .vale.ini легко за допомогою утиліти налаштування з веб-сайту vale.sh. Тут виберіть «Посібник із стилю документації Red Hat» для базового стилю та «alex» для додаткового стилю. Використання «alex» є необов’язковим, але це допоможе вам вловити та виправити гендерні, поляризаційні, расові слова тощо, що є важливим. Якщо ви виберете ці параметри, ваш екран має виглядати так:

Просто скопіюйте вміст внизу, створіть файл .vale.ini за допомогою улюбленого редактора та вставте те, що ви скопіювали.

Потрібно створити папку «styles». Зробіть це, запустивши двійковий файл vale за допомогою команди sync. Знову ж таки, якщо ви робите це з каталогу ~/.local/share/nvim/mason/packages/vale/, просто виконайте:

./vale sync

Після завершення це покаже наступне:

Скопіюйте .vale.ini та папку styles до кореня домашньої папки:

cp .vale.ini ~/
cp -rf styles ~/

Встановлення з вашого домашнього каталогу

Якщо ви бажаєте не копіювати файли, а просто хочете створити їх у своєму домашньому каталозі, ви можете скористатися цією командою з ~/:

Спочатку створіть .vale.ini у своїй домашній папці за допомогою веб-сайту vale.sh. Знову ж таки, виберіть «Посібник із стилю документації Red Hat» для базового стилю та «alex» для додаткового стилю. Потім скопіюйте вміст у файл .vale.ini.

Далі запустіть команду vale sync. Оскільки ви перебуваєте у своєму домашньому каталозі, вам знадобиться повний шлях до двійкового файлу:

~/.local/share/nvim/mason/packages/vale/vale sync

У цьому випадку немає необхідності копіювати файли, оскільки вони будуть створені в кореневому каталозі.

Змінити файл null-ls.lua

Потрібен ще один останній крок. Вам потрібно змінити файл null-ls.lua, знайдений у ~/.config/nvim/lua/custom/configs/, і додати лінтер vale.

Якщо у вас не встановлено інших лінтерів, створіть розділ із двома тире (коментарями) під назвою «лінтери», а потім розмістіть туди цей код:

b.diagnostics.vale,

Після завершення ваш файл виглядатиме приблизно так:

Висновки та заключні думки

Звичайний запуск nvim тепер викликає vale, і ваші документи тепер порівнюватимуться з вибраним стилем. Якщо відкрити наявний файл, буде запущено vale та показано будь-які позначені елементи, тоді як відкриття нового файлу нічого не покаже в режимі вставки. Після виходу з режиму вставки ваш файл буде перевірено. Завдяки цьому екран не захаращується. vale — це чудовий продукт із відкритим вихідним кодом із чудовою інтеграцією в багато редакторів. NvChad не є винятком, і хоча для його запуску та запуску потрібно виконати кілька кроків, це не складна процедура.

---

Востаннє оновлено: September 15, 2023

Author: Steven Spencer

Contributors: Franco Colussi, Krista Burdine, Serge, Ganna Zhyrnova