-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Breaking: remove remark-git-contributors plugin
If you had a CONTRIBUTORS.md it will no longer be updated. Ref #38
- Loading branch information
Showing
4 changed files
with
12 additions
and
62 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -26,12 +26,10 @@ | |
- [`validateLinks`](#validatelinks) | ||
- [`paddedTable`](#paddedtable) | ||
- [`toc`](#toc) | ||
- [`contributors`](#contributors) | ||
- [`plugins`](#plugins) | ||
- [`fixers`](#fixers) | ||
- [Opt-in Features](#opt-in-features) | ||
- [Table of Contents](#table-of-contents-1) | ||
- [Contributors Table](#contributors-table) | ||
- [Reporters](#reporters) | ||
- [Install](#install) | ||
- [License](#license) | ||
|
@@ -230,10 +228,6 @@ Boolean. Set to `false` to keep markdown tables compact. A temporary option unti | |
|
||
Boolean. Set to `false` to skip generating (or replacing) a Table of Contents. A temporary option until we write a more flexible plugin ([#36](https://github.com/vweevers/hallmark/issues/36)). | ||
|
||
### `contributors` | ||
|
||
String or array. See [Contributors Table](#contributors-table) for details. Aliased as `community`. Set to `false` to disable this feature entirely. | ||
|
||
### `plugins` | ||
|
||
An array of extra plugins, to be applied in both lint and fix mode. | ||
|
@@ -256,42 +250,6 @@ Add this heading to a markdown file: | |
|
||
Running `hallmark fix` will then create or update a table of contents. | ||
|
||
### Contributors Table | ||
|
||
_Note: this feature might get removed in a next major version ([#38](https://github.com/vweevers/hallmark/issues/38))._ | ||
|
||
Add this heading to an otherwise empty `CONTRIBUTORS.md`: | ||
|
||
```markdown | ||
# Contributors | ||
``` | ||
|
||
Or this heading to a `README.md`: | ||
|
||
```markdown | ||
## Contributors | ||
``` | ||
|
||
Running `hallmark fix` will then render contributors from `git` history to a markdown table. To add links to GitHub and social profiles of contributors, add the `contributors` [Package Option](#package-options): | ||
|
||
```json | ||
"hallmark": { | ||
"contributors": [{ | ||
"name": "Sara", | ||
"email": "[email protected]", | ||
"github": "sara", | ||
"twitter": "sara" | ||
}] | ||
} | ||
``` | ||
|
||
Where `contributors` is either: | ||
|
||
- An array in the form of `[{ email, name, … }, … ]`; | ||
- A module id or path to a file that exports `contributors` or `{ contributors }`. | ||
|
||
Alternatively, put the metadata in the [`author` or `contributors` fields](https://docs.npmjs.com/files/package.json#people-fields-author-contributors) in `package.json`. For details, please see [`remark-git-contributors`](https://github.com/remarkjs/remark-git-contributors#metadata). | ||
|
||
## Reporters | ||
|
||
Various reporters are available: | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters