diff --git a/README.md b/README.md index d1e8fd27..28b8ca81 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -## Conky +# Conky [![Build Status](https://travis-ci.org/brndnmtthws/conky.png)](https://travis-ci.org/brndnmtthws/conky) [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=conky&metric=alert_status)](https://sonarcloud.io/dashboard/index/conky) @@ -18,9 +18,9 @@ Conky can display more than 300 built-in objects, including support for: * Built-in support for many popular music players ([MPD][], [XMMS2][], [BMPx][], [Audacious][]). * Can be extended using built-in [**Lua**](lua) support, or any of your - own scripts and programs ([more](Lua Interface)). + own scripts and programs ([more](https://github.com/brndnmtthws/conky/wiki#tutorial)). * Built-in [**Imlib2**][Imlib2] and [**Cairo**][cairo] bindings for arbitrary drawing - with Lua ([more](wiki/Lua-API)). + with Lua ([more](https://github.com/brndnmtthws/conky/wiki/Lua-API)). * Runs on Linux, FreeBSD, OpenBSD, DragonFlyBSD, NetBSD, Solaris, Haiku OS, and macOS! ... and much much more. @@ -34,45 +34,41 @@ bars and graph widgets, with different fonts and colours. [![screenshot](https://github.com/brndnmtthws/conky/wiki/configs/ke49/screenshot-thumb.png)](https://raw.github.com/wiki/brndnmtthws/conky/configs/ke49/screenshot.png) [![screenshot](https://github.com/brndnmtthws/conky/wiki/configs/jc/screenshot-thumb.png)](https://raw.github.com/wiki/brndnmtthws/conky/configs/jc/screenshot.png) -See the [User Configs](https://github.com/brndnmtthws/conky/wiki/User-Configs) section of the wiki for more -screenshots and their associated Conky config files. +See the User Configs below for more screenshots and associated config files. ### Documentation The [GitHub Wiki](https://github.com/brndnmtthws/conky/wiki) serves as a central hub for all of -Conky's documentation. Quick links: +Conky's documentation. -* [Install](https://github.com/brndnmtthws/conky/wiki/Installation) -* [Configure](https://github.com/brndnmtthws/conky/wiki/Configuration-Settings) +* [Installation](https://github.com/brndnmtthws/conky/wiki/Installation) +* [Configuration Settings](https://github.com/brndnmtthws/conky/wiki/Configuration-Settings) * [User Configs](https://github.com/brndnmtthws/conky/wiki/User-Configs) * [Frequently Asked Questions](https://github.com/brndnmtthws/conky/wiki/FAQ) ### License -Conky is licensed under the terms of the [GPLv3](LICENSE.GPL) and +Conky is licensed under the terms of the [GPLv3](LICENSE) and [BSD](LICENSE.BSD) licenses. ### Contributing -To submit code changes, please open pull requests against [the GitHub repository](https://github.com/brndnmtthws/conky/edit/master/README.md). Patches submitted in issues, email, or elsewhere will likely be ignored. Here's some general guidelines when submitting PRs: +To report bugs or issues, open [new issues](https://github.com/brndnmtthws/conky/issues/new). +To submit code changes, open [new pull requests](https://github.com/brndnmtthws/conky/compare). - * In your pull request, please: - * Describe the changes, why they were necessary, etc - * Describe how the changes affect existing behaviour - * Describe how you tested and validated your changes - * Include any relevant screenshots/evidence demonstrating that the changes work and have been tested +Patches submitted in issues, email, or elsewhere will likely be ignored. When submitting PRs, please: + + * Describe the changes, why they were necessary, etc + * Describe how the changes affect existing behaviour + * Describe how you tested and validated your changes + * Include any relevant screenshots/evidence demonstrating that the changes work and have been tested * Any new source files should include a GPLv3 license header * Any contributed code must be GPLv3 licensed -[MPD]: http://musicpd.org/ -[XMMS2]: http://wiki.xmms2.xmms.se/index.php/Main_Page -[BMPx]: http://bmpx.backtrace.info/site/BMPx_Homepage -[Audacious]: http://audacious-media-player.org/ -[luawiki]: http://en.wikipedia.org/wiki/Lua_%28programming_language%29 -[stable-src]: https://github.com/brndnmtthws/conky/archive/1.9.0.tar.gz -[devel-src]: https://github.com/brndnmtthws/conky/archive/master.tar.gz -[wiki]: https://github.com/brndnmtthws/conky/wiki -[lists]: http://sourceforge.net/mail/?group_id=143975 -[ircconky]: irc://irc.freenode.net/conky -[Imlib2]: http://docs.enlightenment.org/api/imlib2/html/ -[cairo]: http://www.cairographics.org/ +[MPD]: https://musicpd.org/ +[XMMS2]: https://github.com/xmms2/wiki/wiki +[BMPx]: https://www.beep-media-player.org/ +[Audacious]: https://audacious-media-player.org/ +[luawiki]: https://en.wikipedia.org/wiki/Lua_%28programming_language%29 +[Imlib2]: https://docs.enlightenment.org/api/imlib2/html/ +[cairo]: https://www.cairographics.org/