Skip to content
This repository has been archived by the owner on Nov 22, 2019. It is now read-only.
/ vale-linter Public archive

A GitHub bot built with ProBot to lint PRs using the Vale tool

License

Notifications You must be signed in to change notification settings

warrenbuckley/vale-linter

Repository files navigation

Vale Linter

Offical GitHub Linter

The Vale team has released an official GitHub Action that does Vale linting and would recommend you use that instead
https://github.com/errata-ai/vale-action

What is this?

This is a tool to automatically lint PRs of Markdown files to ensure they follow a vocabulary style guide and uses GitHub Checks API to highlight errors on the line numbers directly on the PR for contextual feedback.

What is Vale?

Vale is a natural language linter that supports plain text, markup (Markdown, reStructuredText, AsciiDoc, and HTML), and source code comments. Vale doesn't attempt to offer a one-size-fits-all collection of rules—instead, it strives to make customization as easy as possible. https://github.com/errata-ai/vale

Configuration

After installation create a new file in the default/master branch of your repository at the following location .github/vale-linter.yml

As with all YML files, be careful that line indentations does not catch you out

Example YML

# Configuration of the Vale Linter ProBot tool
# github.com/warrenbuckley/vale-linter

Vale:

  # If this feature is enabled or disabled
  Enabled: true

  Paths:
    # Path to the vale configuration file
    Configuration: "_vale.ini"

    # Path to the folder of Vale docstyles to use/copy
    # NOTE: If you update the styles path in _vale.ini remember to update this path too
    Styles: "vale/DocsStyles/"

  Success: 
    Header: "YAY you done it"
    Message: "The Vale Docs linter did not find any issues WARREN!"
    ShowImage: true
    ImageUrl: "https://media.giphy.com/media/6nuiJjOOQBBn2/giphy.gif"

  Error: 
    Header: "BOOOO it failed"
    Message: "Try again"
    ShowImage: true
    ImageUrl: "https://media.giphy.com/media/r00LEeXVOt0xG/giphy.gif"

Development Setup

# Install dependencies
npm install

# Run typescript
npm run build

# Run the bot
npm start

Contributing

If you have suggestions for how vale-linter could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the Contributing Guide.

License

ISC © 2019 Warren Buckley [email protected]

About

A GitHub bot built with ProBot to lint PRs using the Vale tool

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published