artsy/YoastSEO.js

Name: YoastSEO.js

Owner: Artsy

Description: Analyze content on a page and give SEO feedback as well as render a snippet preview.

Forked from: Yoast/YoastSEO.js

Created: 2016-09-02 16:07:24.0

Updated: 2016-10-22 09:37:12.0

Pushed: 2017-01-10 21:50:49.0

Homepage:

Size: 5087

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Build Status Code Climate Test Coverage Inline docs

YoastSEO.js

Text analysis and assessment library in JavaScript. This library can generate interesting metrics about a text and assess these metrics to give you an assessment which can be used to improve the text.

Screenshot of the assessment of the given text

Also included is a preview of the Google search results which can be assessed using the library.

Installation

You can install YoastSEO.js using npm:

install https://github.com/Yoast/YoastSEO.js#develop
Usage

If you want the complete experience with UI and everything you can use the App. You need to have a few HTML elements to make this work: A snippet preview container, a focusKeyword input element and a content input field.

SnippetPreview = require( "yoastseo" ).SnippetPreview;
App = require( "yoastseo" ).App;

ow.onload = function() {
var focusKeywordField = document.getElementById( "focusKeyword" );
var contentField = document.getElementById( "content" );

var snippetPreview = new SnippetPreview({
    targetElement: document.getElementById( "snippet" )
});

var app = new App({
    snippetPreview: snippetPreview,
    targets: {
        output: "output"
    },
    callbacks: {
        getData: function() {
            return {
                keyword: focusKeywordField.value,
                text: contentField.value
            };
        }
    }
});

app.refresh();

focusKeywordField.addEventListener( 'change', app.analyzeTimer.bind( app ) );
contentField.addEventListener( 'change', app.analyzeTimer.bind( app ) );

You can also invoke internal components directly to be able to work with the raw data. To get metrics about the text you can use the Researcher:

Researcher = require( "yoastseo" ).Researcher;

researcher = new Researcher( new Paper( "Text that has been written" ) );

ole.log( researcher.getResearch( "wordCountInText" ) );
Change log

Please see CHANGELOG for more information what has changed recently.

Documentation

The data that will be analyzed by YoastSEO.js can be modified by plugins. Plugins can also add new research and assessments. To find out how to do this, checkout out the customization documentation.

Testing
test

Generate coverage using the --coverage flag.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email security [at] yoast.com instead of using the issue tracker.

Credits
License

We follow the GPL. Please see License file for more information.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.