Vale 문서 테스트

GitLab 문서에서 문법, 스타일, 단어 사용을 검사하는 Vale 린터의 설치, 구성, 규칙 관리, 결과 처리 방법을 설명합니다.

Vale 은 영어의 문법, 스타일, 단어 사용을 검사하는 린터입니다. Vale 구성은 프로젝트 루트 디렉터리에 있는 .vale.ini 파일에 저장됩니다. 예를 들어 gitlab 프로젝트의 .vale.ini 가 여기에 해당합니다. Vale은 여러 유형의 검사를 확장하는 커스텀 규칙 생성을 지원하며, GitLab은 이러한 규칙을 프로젝트의 문서 디렉터리에 저장합니다. 예를 들어 gitlab 프로젝트의 doc/.vale 디렉터리 가 여기에 해당합니다. 이 구성은 빌드 파이프라인에서도 사용되며, 파이프라인에서는 오류 수준 규칙 이 강제됩니다. Vale은 다음 환경에서 사용할 수 있습니다. 명령줄 . 코드 에디터 . Git 훅 . Git 훅에서는 (CI/CD 파이프라인과 동일한 구성으로) 오류만 보고하며, 제안이나 경고는 보고하지 않습니다. Vale 설치 # 다음 중 한 가지 방법으로 vale 을 설치합니다. mise . 예를 들면 다음과 같습니다. mise use -g vale 패키지 관리자: macOS에서 brew 를 사용하는 경우 brew install vale 을 실행합니다. Linux에서는 배포판의 패키지 관리자나 릴리스된 바이너리 를 사용합니다. 에디터에서 Vale 구성 # 에디터에서 린터를 사용하면 명령줄에서 명령을 실행하는 것보다 편리합니다. 에디터에서 Vale을 구성하려면 상황에 맞게 다음 중 하나를 설치합니다. Visual Studio Code ChrisChinchilla.vale-vscode 확장 . 이 플러그인은 일부 경고만 표시 하도록 구성할 수 있습니다. Sublime Text SublimeLinter-vale 패키지 . Vale 제안이 (오류가 표시되는 방식인) 빨간색 대신 파란색으로 표시되도록 하려면 SublimeLinter 구성에 vale 구성을 추가합니다. "vale" : { "styles" : [ { "mark_style" : "outline" , "scope" : "region.bluish" , "types" : [ "suggestion" ] } ] } LSP for Sublime Text 패키지 LSP-vale-ls . Vim ALE 플러그인 . JetBrains 플러그인 . Emacs Flycheck 확장 . Flycheck 이 Vale과 동작하도록 하는 최소 구성은 다음과 같습니다. (flycheck-define-checker vale "A checker for prose" :command ("vale" "--output" "line" "--no-wrap" source) :standard-input nil :error-patterns ((error line-start (file-name) ":" line ":" column ":" (id (one-or-more (not (any ":")))) ":" (message) line-end)) :modes (markdown-mode org-mode text-mode) :next-checkers ((t . markdown-markdownlint-cli)) ) (ad