#텍스트린터 발레 한글 버전 : 제작
2024-09-23 Note notes textlint vale대략 파악 된다. 아. 이렇게 간단하게 할 수 있다니. 작정하고 덤벼들면 발레로 다 만들 수 있겠다.
[SYS]: You are a helpful assistant. Please write in Korean language. [ME]: 혹시 textlint 프로젝트에 대해서 알고 있니?
[AI]: 네, textlint 프로젝트에 대해서 알고 있습니다. textlint는 JavaScript로 작성된 오픈 소스 텍스트 린터입니다. 주로 문법, 스타일, 맞춤법 등의 오류를 찾아내고 수정하는 데 사용됩니다. 다양한 플러그인을 통해 확장할 수 있으며, 사용자 정의 규칙을 설정할 수도 있습니다. 특정 프로젝트나 문서의 품질을 유지하는 데 유용하게 사용될 수 있습니다. 특정한 질문이 있으시면 말씀해 주세요!
[ME]: 그래. 주로 일본어 플러그인만 있는데, 유사한 목적으로 한글 플러그인을 만들고 싶어. 어떻게 하면 될까?
[AI]: 한글 플러그인을 만들기 위해서는 다음 단계를 따를 수 있습니다:
기본적인 준비:
- Node.js와 npm이 설치되어 있어야 합니다.
- textlint를 설치합니다. 다음 명령어를 사용합니다: ```sh npm install textlint –save-dev ```
기본 파일 구조 만들기:
- 자신의 플러그인 프로젝트를 위한 디렉토리를 만듭니다.
- 예를 들어 `textlint-plugin-korean`이라는 디렉토리를 생성합니다.
- `package.json` 파일을 생성하고 기본적인 메타데이터와 의존성을 정의합니다.
플러그인 파일 작성:
- `lib/index.js` 파일을 생성합니다. 이것이 플러그인의 진입점(entry point) 파일이 됩니다.
- 기본적인 구문은 다음과 같습니다: ```javascript module.exports = { Processor: function() { return { preProcess(text, filePath) { / 텍스트를 AST(Abstract Syntax Tree)로 변환 return text; }, postProcess(messages, filePath) { / AST를 통해 메시지를 생성 return { messages: messages, filePath: filePath }; } }; } }; ```
룰(Rule) 작성:
`lib/rules` 디렉토리를 생성하고, 예를 들어 `no-doubled-conjunctive.js` 같은 파일을 생성합니다.
내용을 작성합니다: ```javascript module.exports = function(context) { const {Syntax, RuleError, report, getSource} = context;
return { Syntax.Str { const text = getSource(node); const regex = 그리고 그리고; // 여기에 원하는 규칙 적용
if (regex.test(text)) { report(node, new RuleError(“중복된 접속사가 발견되었습니다.”)); } } }; }; ```
테스트 작성:
`test` 디렉토리를 생성하고 테스트 파일을 작성합니다.
예를 들어 `test/no-doubled-conjunctive-test.js` 파일을 생성합니다.
내용을 작성합니다: ```javascript const TextLintTester = require(’textlint-tester’); const rule = require(’../lib/rules/no-doubled-conjunctive’);
const tester = new TextLintTester();
tester.run(’no-doubled-conjunctive’, rule, { valid: [ ‘이것은 올바른 문장입니다.’ ], invalid: [ { text: ‘그리고 그리고 오류가 발생했습니다.’, errors: [ { message: ‘중복된 접속사가 발견되었습니다.’ } ] } ] }); ```
배포 준비:
- `npm publish`를 통해 npm에 배포할 수 있습니다.
- `package.json`에 필요한 메타데이터와 의존성을 자세히 기입합니다.
이 단계를 따르면 textlint용 한글 플러그인을 생성할 수 있습니다. 여기서 소개한 예제는 매우 기초적인 예제입니다. 실제 사용 환경에 맞게 더 복잡한 규칙과 기능을 추가할 수 있습니다.
[ME]: 혹시 vale라는 린터도 알고 있니? 주로 영문을 지원하는 것 같아. 특히 yaml 파일로 규칙을 지정하면 여러가지 기존 린터들을 호출하는 구조인 것 같아. yale 용으로 위의 규칙을 지원하게 할 수 있을까?
[AI]: 네, Vale에 대해서도 알고 있습니다. Vale는 다양한 스타일 가이드를 지원하는 플러그러블(pluggable) 문서 스타일 린터입니다. 사용자들은 YAML 파일을 사용하여 규칙을 정의하고 이를 통해 문서의 일관성을 유지할 수 있습니다.
Vale에서 사용자 정의 규칙을 작성하여 `no-doubled-conjunctive`와 같은 규칙을 적용하려면 다음 단계를 따를 수 있습니다:
Vale 설치 및 설정:
- Vale를 설치합니다. macOS에서는 Homebrew를 사용하여 설치할 수 있습니다: ```sh brew install vale ```
- 또는 다른 플랫폼에서는 Vale 문서에서 제공하는 방법에 따라 설치할 수 있습니다.
YAML 파일로 규칙 정의:
- 프로젝트 루트 디렉토리에 `.vale` 디렉토리를 생성합니다.
- YAML 형식의 설정 파일(예: `.vale/vale.ini`)을 생성합니다.
- 설정 파일에 다음 내용을 추가합니다: ```ini StylesPath = styles [*.md] BasedOnStyles = Korean ```
규칙 파일 만들기:
- `.vale/styles/Korean` 디렉토리를 생성합니다.
- 여기에 `no-doubled-conjunctive.yml` 파일을 생성하고 다음과 같이 규칙을 정의합니다: ```yaml extends: existence message: 중복된 접속사가 발견되었습니다: ‘$1’ level: error scope: text match: \b(그리고 그리고)\b ```
규칙 활성화:
- 설정 파일(`.vale/vale.ini`)에서 정의한 규칙을 활성화합니다: ```ini StylesPath = styles [*.md] BasedOnStyles = Korean ```
테스트 및 실행:
- 테스트할 Markdown 파일이나 텍스트 파일을 작성하고, 예를 들어 `test.md`에 다음과 같은 내용을 포함시킵니다: ``` 이것은 올바른 문장입니다. 그리고 그리고 오류가 발생했습니다. ```
- Vale를 실행하여 파일을 검사합니다: ```sh vale test.md ```
이 설정을 통해 Vale가 지정된 규칙에 따라 문서를 검사하고, “그리고 그리고"와 같은 중복 접속사를 발견하면 오류 메시지를 출력하게 됩니다.
Vale는 매우 유연한 도구로, 다양한 문법 규칙을 YAML 파일을 통해 손쉽게 정의하고 사용할 수 있습니다. 추가적인 고급 기능과 설정 방법은 Vale의 공식 문서를 참고하면 도움이 됩니다.
[ME]:
Related-Notes
- [2024-09-15]
- #린터: 왜 발레:인가? YAML 포멧