Automate your badges on markdown files with all-shields-cli

Automate your badges on markdown files with all-shields-cli

Tool to help automate your badges of shields.io from .all-shieldsrc

Badge generator of shields.io from .all-shieldsrc dotfile: Tool to help automate your badges of shields.io from a dotfile for your markdown files. Inspired by all-contributors-cli

🦌 Badges generator from dotfiles for any markdown

Tool to help automate your badges of shields.io, badgen.net, fury.io and snyk.io from .all-shieldsrc dotfile for your markdown files. You can use Liquid variables like {{name}} or {{version}} which refer to your package.json.

Inspired by all-contributors-cli

Resources: [all-shields-cli on npm] [all-shields-cli on github]

💡 Features

  • [✔️] Easy to use
  • [✔️] MIT License
  • [✔️] Support: shields.io
  • [✔️] Support: fury.io
  • [✔️] Support: snyk.io
  • [✔️] Support: badgen.net
  • [✔️] Full customizations!
  • [✔️] Liquid Variables
  • [✔️] Tool to help automate your badges on markdown.
  • [✔️] Badges generator from dotfiles for any markdown

👔 Screenshot

Badges generator from dotfiles for any markdown

🚀 Installation

  1. In your node project run: npm install @ptkdev/all-shields-cli --save-dev
  2. In your package.json add script:
     ...
     "scripts": {
         "all-shields-cli": "all-shields-generate"
     }
     ...
    
  3. Create .all-shieldsrc and paste sample:
    {
     "files": [
         "README.md"
     ],
     "shields": [
         {
             "id": "my-badges",
             "badges": [
                 {
                     "url": "https://www.npmjs.com/package/@ptkdev/all-shields-cli",
                     "color": "lightgray",
                     "label": "package name",
                     "title": "package name",
                     "message": "all-shields-cli",
                     "style": "flat",
                     "logo": "",
                     "platform": "shields"
                 }
             ]
         }
     ]
    }
    
  4. Add in your README.md the html comment (my-badges is id from the previous step):

    <!-- all-shields/my-badges:START -->
    <!-- all-shields/my-badges:END -->
    
  5. Run npm run all-shields-cli

See folder examples, run with node example.js. Below is available a description of options values.

🔑 Liquid variables

In your .all-shieldsrc dotfile you can use liquid variables like {{name}} or {{version}} which refer to your package.json. Key of package.json is name of liquid variable {{key_from_package.json}}

💫 License

  • Code and Contributions have MIT License
  • Images and logos have CC BY-NC 4.0 License (Freepik Premium License)
  • Documentations and Translations have CC BY 4.0 License

❤️ Thanks! Leave a feedback!