Skip to content

webdoky/content

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ba7c357 · Sep 22, 2022
Jul 10, 2022
Oct 16, 2021
Sep 22, 2022
Jul 31, 2022
Oct 16, 2021
Oct 16, 2021
Oct 16, 2021
Jul 31, 2022
Aug 5, 2022
Oct 16, 2021
Sep 7, 2022
Oct 16, 2021
Sep 3, 2021
Oct 30, 2021
Jun 23, 2022
Jul 16, 2022
Jan 11, 2022
Jul 20, 2022
Aug 14, 2021
Sep 8, 2022
May 28, 2022
Jan 11, 2022

Repository files navigation

WebDoky - контент

uk en

Що це

Тут знаходиться вміст вебдокументації з WebDoky. Фактично це статті з MDN, перекладені українською (див. ліцензію на вміст цього репозиторію)

LanguageTool перевірка

У репозиторій вбудована перевірка тексту (в форматі HTML або Markdown) в репозиторії за допомогою докеризованого LanguageTool. Наразі працює лише на Unix-подібних ОС [#12]

Передумови

  1. Docker
  2. Node.js >= 14
  3. Yarn

Налаштування

Команда yarn у директорії проєкту встановить JavaScript-залежності та підготує Docker-образ.

Використання

Запуск команди yarn run check у директорії проєкту:

  1. Запустить Docker-контейнер із LanguageTool.
  2. Дочекається доступності LanguageTool.
  3. Перевірить наявні файли перекладу у форматах HTML та Markdown.
  4. Виведе результати перевірки у консоль.
  5. Зупинить Docker-контейнер із LanguageTool.
  6. Завершиться із кодом виходу 0 у випадку успіху, інакше - 1.

Також команда приймає шлях до певного файлу у вигляді аргументу командного рядка. Наприклад:

yarn run check README.md

Рецепти

# Перевірити всі наявні файли вмісту
yarn run check

# Перевірити конкретний файл
yarn run check README.md

# Перевірити лише свіже змінені/додані файли
yarn run check-diff

Винятки

Щоб додати слово незнайоме LanguageTool, але котре LanguageTool мусить використовувати для створення пропозицій виправлень - додайте його окремим рядком у файл uk_spelling_additions.txt.

Щоб додати слово незнайоме LanguageTool, котре слід просто ігнорувати - додайте його окремим рядком у файл uk_ignore_additions.txt (у більшості випадків слід віддавати перевагу uk_spelling_additions.txt).

Щоб заборонити слово, котре LanguageTool обробляє як нормативне - додайте його окремим рядком у файл uk_prohibited_additions.txt.

Щоб зміни у вищеназваних текстових файлах почали діяти, слід запустити команду yarn rebuild.

Вимкнення правила

Щоб вимкнути певне правило LanguageTool - додайте його окремим рядком у файл disabled_rules.txt. Така зміна не вимагає повторного збирання Docker-образу.

About

The place where our translated content is going to live in

Resources

License

Stars

Watchers

Forks

Languages