remark-lint-books-links

Checks that all resources links are formatted according to vhf/free-programming-books guidelines

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
remark-lint-books-links
2.1.07 years ago8 years agoMinified + gzip package size for remark-lint-books-links in KB

Readme

remark-lint-books-links
This remark-lint rule was created for free-programming-books-lint to enforce free-programming-books formatting guidelines.
This rule only applies to list items starting with a link. It enforces the following things:
Author
If an author is mentioned, it's done with ・-・ (middots represent spaces, so, a dash surrounded by single spaces)
* [Another Awesome Book - John Doe](http://example.com/book.html)
* [Another Awesome Book](http://example.com/book.html)- John Doe
* [Another Awesome Book](http://example.com/book.html) - John Doe

Yields:
1:3-1:65: Missing a space before author
Format
If the URL in the link refers to a PDF, that format is mentioned.
* [Another Awesome Book](http://example.com/book.pdf)(PDF)
* [Another Awesome Book](http://example.com/book.pdf)
* [Another Awesome Book](http://example.com/book.pdf) (PDF)

Yields:
1:3-1:59: Missing a space before PDF indication
2:3-2:54: Missing PDF indication
Author and Format
The author comes before the format:
* [Another Awesome Book](http://example.com/book.pdf)- John Doe
* [Another Awesome Book](http://example.com/book.pdf) - John Doe
* [Another Awesome Book](http://example.com/book.pdf) - John Doe (PDF)

Yields:
1:3-1:64: Missing a space before author
1:3-1:64: Missing PDF indication
2:3-2:65: Missing PDF indication

Using the rule

Via .remarkrc

npm install -g remark-cli
npm install remark-lint remark-lint-books-links

Then, set up your .mdastrc:
{
  "plugins": [
    "lint",
    "lint-books-links"
  ]
}

Now you can use the following command to run the lint:
remark xxx.md

Via CLI

npm install -g remark-cli
npm install remark-lint remark-lint-books-links
remark -u lint -u lint-books-links xxx.md