डेटा लीक के जोखिम के बिना एक ऑफ़लाइन व्याकरण परीक्षक Harper कैसे स्थापित करें
TuBrief 편집팀
2026년 7월 25일
0
Computing/Software원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
커뮤니티의 다른 글
댓글 (0)
Log in to leave a comment
아직 작성된 글이 없습니다
원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
Log in to leave a comment
아직 작성된 글이 없습니다
जब कॉर्पोरेट सुरक्षा नीतियों के कारण Grammarly जैसे बाहरी AI टूल ब्लॉक कर दिए जाते हैं, तो डेवलपर्स के लिए स्थिति कठिन हो जाती है। तकनीकी दस्तावेज़ों या कोड टिप्पणियों में वर्तनी की गलतियाँ छोड़कर उन्हें रिलीज़ करने से विश्वसनीयता घटती है, लेकिन एक-एक करके मैन्युअल रूप से जाँच करने में बहुत अधिक समय बर्बाद होता है।
Harper इस समस्या को बड़े ही साफ-सुथरे तरीके से हल करता है। Rust में विकसित एक ऑफ़लाइन-केवल व्याकरण जाँच इंजन होने के नाते, यह बाहरी सर्वरों के साथ संचार को पूरी तरह से अवरुद्ध कर देता है। LanguageTool के विपरीत—जो Java-आधारित है और सैकड़ों मेगाबाइट मेमोरी की खपत करता है—Harper की मेमोरी खपत केवल कुछ दसियों मेगाबाइट के स्तर पर होती है। 10ms से कम के प्रतिक्रिया समय (response time) पर काम करने के कारण, यह आपके एडिटर को धीमा नहीं करेगा।
harper-ls आपके टर्मिनल/सिस्टम के भीतर केवल स्थानीय CPU संसाधनों का उपयोग करके सिंटैक्स विश्लेषण (parsing) करता है। बस अपने ऑपरेटिंग सिस्टम के पैकेज मैनेजर का उपयोग करके बाइनरी इंस्टॉल करें और इसे अपने एडिटर में एक मानक LSP के रूप में पंजीकृत करें।
बाइनरी इंस्टॉल करने के लिए अपने टर्मिनल में निम्नलिखित कमांड चलाएँ:
brew install harpercargo install harper-ls --lockedscoop install harperNeovim में, आप nvim-lspconfig का उपयोग करके लक्षित फ़ाइल प्रकारों और लिंटर नियमों को कॉन्फ़िगर कर सकते हैं।
`lua
local lspconfig = require('lspconfig')
lspconfig.harper_ls.setup({
filetypes = { 'markdown', 'gitcommit', 'rust', 'go', 'typescript', 'python' },
settings = {
["harper-ls"] = {
userDictPath = "~/config/harper/user_dict.txt",
workspaceDictPath = ".harper-dictionary.txt",
linters = {
SpellCheck = true,
SpelledNumbers = false,
AnA = true,
SentenceCapitalization = false,
UnclosedQuotes = true,
WrongApostrophe = false,
LongSentences = true,
RepeatedWords = true,
Spaces = true,
CorrectNumberSuffix = true
}
}
}
})
`
Neovim 0.11 या उच्चतर के नेटिव LSP API का उपयोग करते समय, vim.lsp.config['harper'] को कॉन्फ़िगर करें और vim.lsp.enable('harper') को कॉल करें। VS Code उपयोगकर्ताओं के लिए, बस elijah-potter.harper एक्सटेंशन इंस्टॉल करें और .vscode/settings.json में "harper.path": "/usr/local/bin/harper-ls" पाथ निर्दिष्ट करें।
Harper में एक अंतर्निहित Tree-sitter AST पार्सर है, इसलिए यह वास्तविक सोर्स कोड को छोड़ देता है और केवल कमेंट ब्लॉक के भीतर अंग्रेजी टेक्स्ट का चयन करके उसकी जाँच करता है। यदि आप किसी विशिष्ट फ़ंक्शन कमेंट को पूरी तरह से जाँच से बाहर करना चाहते हैं, तो एक इनलाइन निर्देश (inline directive) जोड़ें।
`javascript
// harper:ignore
function processInternalSecurityToken() {
// spellcheck:ignore
// 내부 보안 토큰 로직
}
`
यदि आप केवल डिफ़ॉल्ट अंग्रेजी शब्दकोश का उपयोग करते हैं, तो gRPC, OAuth2, और Prometheus जैसे तकनीकी शब्दों को त्रुटियों के रूप में माना जाएगा। एक पदानुक्रमित (hierarchical) शब्दकोश संरचना का उपयोग करके, आप चेतावनी के शोर को तुरंत समाप्त कर सकते हैं।
Harper शब्दों को 4 स्तरों में सत्यापित करता है:
| शब्दकोश स्तर | भंडारण स्थान | उद्देश्य |
|---|---|---|
| Static Dictionary | harper-ls बाइनरी में अंतर्निहित |
अपरिवर्तनीय डिफ़ॉल्ट अंग्रेजी शब्द DB |
| User Dictionary | ~/.config/harper-ls/dictionary.txt |
व्यक्तिगत विकास वातावरण के लिए वैश्विक शब्दकोश |
| Workspace Dictionary | प्रोजेक्ट रूट .harper-dictionary.txt |
प्रोजेक्ट-विशिष्ट शब्दावली शब्दकोश (Git द्वारा प्रबंधित) |
| File-Local Dictionary | OS डेटा पाथ के भीतर सहेजा गया | एकल फ़ाइल-विशिष्ट पहचानकर्ता भंडारण |
.harper-dictionary.txt फ़ाइल बनाएँ।`text
Kubernetes
gRPC
OAuth2
OpenTelemetry
Prometheus
mTLS
Netty
Etcd
`
Ctrl + ., Neovim: Code Action की-बाइंडिंग) का उपयोग करें और शब्द को सीधे .harper-dictionary.txt में जोड़ें।इस फ़ाइल को Git रिपॉजिटरी में प्रतिबद्ध (commit) करके, टीम के सभी सदस्य समान शब्द सूची साझा कर सकते हैं।
कमेंट लिखते समय असुविधाजनक नियमों को अक्षम करें:
SentenceCapitalization: कमेंट के पहले अक्षर को कैपिटल में बाध्य करने वाले नियम को अक्षम करने के लिए false पर सेट करें।LongSentences: तकनीकी दस्तावेज़ीकरण में स्वाभाविक रूप से होने वाले लंबे वाक्यों के लिए चेतावनियों को अक्षम करने के लिए false पर सेट करें।SpellCheck और UnclosedQuotes: वर्तनी की त्रुटियों और बंद न हुए उद्धरण चिह्नों (unclosed quotes) की जाँच के लिए इन्हें true पर छोड़ दें।डेवलपर्स द्वारा एडिटर में छूटी हुई वर्तनी की गलतियों को PR चरण में ही ब्लॉक कर दिया जाना चाहिए। पाइपलाइन से harper-cli CLI टूल को जोड़कर, आप मेन ब्रांच में मर्ज करने से पहले व्याकरण की त्रुटियों को स्वचालित रूप से फ़िल्टर कर सकते हैं।
.github/workflows/harper-lint.yml फ़ाइल में केवल परिवर्तित मार्कडाउन फ़ाइलों की जाँच करने के लिए एक जॉब परिभाषित करें।
`yaml
name: Technical Documentation Linting
on:
pull_request:
paths:
- 'docs/'
- '.md'
jobs:
harper-grammar-check:
runs-on: ubuntu-latest
steps:
- name: Checkout Repository
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Install Rust Toolchain
uses: dtolnay/rust-toolchain@stable
- name: Cache Harper CLI Binary
uses: actions/cache@v3
with:
path: ~/.cargo/bin/harper-cli
key: ${{ runner.os }}-harper-cli-${{ hashFiles('**/Cargo.lock') }}
- name: Install Harper CLI
run: |
if ! command -v harper-cli &> /dev/null; then
cargo install harper-cli --locked
fi
- name: Get Changed Markdown Files
id: changed-files
run: |
git fetch origin ${{ github.base_ref }}
FILES=$(git diff --name-only --diff-filter=AM origin/${{ github.base_ref }} HEAD | grep '\.md$' || true)
echo "files=$FILES" >> $GITHUB_OUTPUT
- name: Run Harper Lint Check
if: steps.changed-files.outputs.files != ''
run: |
ERRORS=0
for file in ${{ steps.changed-files.outputs.files }}; do
echo "Linting $file with Harper..."
harper-cli lint "$file" || ERRORS=$((ERRORS+1))
done
if [ $ERRORS -gt 0 ]; then
echo "Harper validation failed with $ERRORS error(s)."
exit 1
fi
`
यदि आप प्रोजेक्ट रूट से .harper-dictionary.txt फ़ाइल को भी कमिट करते हैं, तो CI रनर भी उसी शब्द सूची के आधार पर जाँच करेगा जिसका उपयोग एडिटर करता है। यदि आप MkDocs या Docusaurus जैसे स्टैटिक साइट जनरेटर (SSG) का उपयोग कर रहे हैं, तो बिल्ड स्क्रिप्ट चलाने से ठीक पहले harper-cli lint docs/ कमांड को निष्पादित करने के लिए कॉन्फ़िगर करना अधिक सुरक्षित होता है।