Classifier english article(a, an).
Based on:
So, We can not define
We want to avoid false-positive.
If you want to defined new word, please specify
Or
Please pull request to a.ts or an.ts.
For bugs and feature requests, please create an issue.
Based on:
- rigoneri/indefinite-article.js: JavaScript function that returns the indefinite articles "a" or "an" based on a given word or phrase.
- gitpan/Lingua-EN-Inflexion: Read-only release history for Lingua-EN-Inflexion
- rossmeissl/indefinitearticle: Indefinite article identification for Ruby strings
Feature
This library Classifier english word toa
an
unknown
Why "unknown"
Whether to use "a" or "an" depends on the pronunciation of the word that follows it. Use "a" before any consonant sound; use "an" before any vowel sound.So, We can not define
a
or an
for a new word.We want to avoid false-positive.
If you want to defined new word, please specify
option
.Or
Please pull request to a.ts or an.ts.
Install
Install with npm:npm install english-article-classifier
Usage
API
export interface ReturnClassifyArticle {
type: "a" | "an" | "unknown";
reason: string;
}
export interface classifyArticleOptions {
forceA?: string[];
forceAn?: string[];
}
export declare function classifyArticle(phrase: string, options?: classifyArticleOptions): ReturnClassifyArticle;
classifyArticle
return an object that has type
and reason
.
Example
"use strict";
const {classifyArticle} = require("./lib/english-article-classifier.js");
console.log(classifyArticle("hour"));
/*
{ type: 'an',
reason: 'Specific start of words that should be proceeded by \'an\'' }
*/
console.log(classifyArticle("union"));
/*
{ type: 'a',
reason: 'Special cases where a word that begins with a vowel should be proceeded by \'a\'' }
*/
console.log(classifyArticle("word"));
/*
{ type: 'a',
reason: 'Other words that begins with a vowel should be proceeded by \'a\'' }
*/
console.log(classifyArticle("ZXCVBNM", {
forceA: ["ZXCVBNM"]
}));
/*
{ type: 'a',
reason: 'User defined words that should be proceeded by \'a\'' }
*/
console.log(classifyArticle("ZXCVBNM", {
forceAn: ["ZXCVBNM"]
}));
/*
{ type: 'an',
reason: 'User defined words that should be proceeded by \'an\'' }
*/
Changelog
See Releases page.Running tests
Install devDependencies and Runnpm test
:npm i -d && npm test
Contributing
Pull requests and stars are always welcome.For bugs and feature requests, please create an issue.
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D