show-a-license

A site to provide an easy way to show licenses and their human-readable explanations.

Your help is needed! ❤️

Contribute by explaining licenses. Check out this issue. 📝 📖

Usage

Whether you just want to show a license or see its human-readable explanation, you can use this website. It provides a nice querystring API documented below:

• #license-<license> (hash): set the license to display
• fullname=<name>: set the copyright holder name
• year=<name>: set the starting copyright yea
• hide_explanations=<true|false> (default: false): hide the explanations column

Developer installation

• cd build; node update-licenses-list.js; cd ..
• In the end, run in parallel npm run watch and npm start
• Open in your browser http://localhost:9000/index.html.

Examples

• To see the MIT license access this url: https://ionicabizau.github.io/show-a-license#license-mit
• To set the copyright holder name, use the fullname=<name> querystring parameter: https://ionicabizau.github.io/show-a-license?fullname=Alice#license-mit
• To set the starting copyright year use the year parameter: https://ionicabizau.github.io/show-a-license?year=2013&fullname=Alice#license-mit
• To hide the explanations column, you have to use hide_explanations=true: https://ionicabizau.github.io/show-a-license?hide_explanations=true&year=2013&fullname=Alice#license-mit

❓ Get Help

There are few ways to get help:

1. Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
2. For bug reports and feature requests, open issues. 🐛
3. For direct and quick help, you can use Codementor. 🚀

😋 How to contribute

Have an idea? Found a bug? See how to contribute.

💖 Support my projects

I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously, this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).

However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:

• Starring and sharing the projects you like 🚀

• —I love books! I will remember you after years if you buy me one. 😁 📖

• —You can make one-time donations via PayPal. I'll probably buy a coffee tea. 🍵

• —Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).

• Bitcoin—You can send me bitcoins at this address (or scanning the code below): 1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6

  

Thanks! ❤️

Explaining a license

Explanations are kept in txt files in the explanations directory, having the license names (e.g. mit.txt).

Contributions in this directions are really appreciated.

1. Fork this repository.
2. Edit the explanations/<license>.txt file (you can follow explanations/mit.txt as example).
3. Add yourself as contributor in package.json.
4. Raise a pull request! 🎉

Adding a new license

If the license you're searching for is missing, make sure you add it.

1. Fork this repository.
2. Add a new file in the licenses directory, named <license>.txt (replace <license> with the license name) and then do the same in the explanations directory (you can follow the MIT license example: see explanations/mit.txt and licenses/mit.txt).
3. Give nice, funny and useful explanation in the explanations/<license>.txt file you added.
4. Add yourself as contributor in package.json.
5. Raise a pull request! 🎉

🍰 Thanks

• github/choosealicense.com–a good inspiration source (some ideas and CSS were taken from here) ❇️
• @Cerberus-tm–who had the idea for the site name 🍰

📜 License

MIT © Ionică Bizău