branch: externals/colorful-mode commit 013cc76decf4e0998f49c24a0aefbb8a21295bad Author: Elias G. B. Perez <eg642...@gmail.com> Commit: Elias G. B. Perez <eg642...@gmail.com>
Initial release --- .project | 0 COPYING.org | 594 ++++++++++++++++++++++++++++++++++++++++++ README.org | 72 +++++ assets/colorful-mode-logo.svg | 191 ++++++++++++++ assets/elisp_logo_warning.svg | 193 ++++++++++++++ assets/gif1.gif | Bin 0 -> 195595 bytes assets/gif2.gif | Bin 0 -> 252770 bytes assets/gif3.gif | Bin 0 -> 476643 bytes assets/screenshot1.png | Bin 0 -> 27970 bytes assets/screenshot2.png | Bin 0 -> 50190 bytes assets/screenshot3.png | Bin 0 -> 33258 bytes assets/screenshot4.png | Bin 0 -> 32048 bytes colorful-mode.el | 337 ++++++++++++++++++++++++ 13 files changed, 1387 insertions(+) diff --git a/.project b/.project new file mode 100644 index 0000000000..e69de29bb2 diff --git a/COPYING.org b/COPYING.org new file mode 100644 index 0000000000..5e348028f7 --- /dev/null +++ b/COPYING.org @@ -0,0 +1,594 @@ +* GNU General Public License + +/Version 3, 29 June 2007/ +/Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/> + +Everyone is permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +** Preamble + +The GNU General Public License is a free, copyleft license for software and other +kinds of works. + +The licenses for most software and other practical works are designed to take away +your freedom to share and change the works. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change all versions of a +program--to make sure it remains free software for all its users. We, the Free +Software Foundation, use the GNU General Public License for most of our software; it +applies also to any other work released this way by its authors. You can apply it to +your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our General +Public Licenses are designed to make sure that you have the freedom to distribute +copies of free software (and charge for them if you wish), that you receive source +code or can get it if you want it, that you can change the software or use pieces of +it in new free programs, and that you know you can do these things. + +To protect your rights, we need to prevent others from denying you these rights or +asking you to surrender the rights. Therefore, you have certain responsibilities if +you distribute copies of the software, or if you modify it: responsibilities to +respect the freedom of others. + +For example, if you distribute copies of such a program, whether gratis or for a fee, +you must pass on to the recipients the same freedoms that you received. You must make +sure that they, too, receive or can get the source code. And you must show them these +terms so they know their rights. + +Developers that use the GNU GPL protect your rights with two steps: *(1)* assert +copyright on the software, and *(2)* offer you this License giving you legal permission +to copy, distribute and/or modify it. + +For the developers' and authors' protection, the GPL clearly explains that there is +no warranty for this free software. For both users' and authors' sake, the GPL +requires that modified versions be marked as changed, so that their problems will not +be attributed erroneously to authors of previous versions. + +Some devices are designed to deny users access to install or run modified versions of +the software inside them, although the manufacturer can do so. This is fundamentally +incompatible with the aim of protecting users' freedom to change the software. The +systematic pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we have designed +this version of the GPL to prohibit the practice for those products. If such problems +arise substantially in other domains, we stand ready to extend this provision to +those domains in future versions of the GPL, as needed to protect the freedom of +users. + +Finally, every program is threatened constantly by software patents. States should +not allow patents to restrict development and use of software on general-purpose +computers, but in those that do, we wish to avoid the special danger that patents +applied to a free program could make it effectively proprietary. To prevent this, the +GPL assures that patents cannot be used to render the program non-free. + +The precise terms and conditions for copying, distribution and modification follow. + +** TERMS AND CONDITIONS + +*** 0. Definitions + +“This License” refers to version 3 of the GNU General Public License. + +“Copyright” also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + +“The Program” refers to any copyrightable work licensed under this +License. Each licensee is addressed as “you”. “Licensees” and +“recipients” may be individuals or organizations. + +To “modify” a work means to copy from or adapt all or part of the work in +a fashion requiring copyright permission, other than the making of an exact copy. The +resulting work is called a “modified version” of the earlier work or a +work “based on” the earlier work. + +A “covered work” means either the unmodified Program or a work based on +the Program. + +To “propagate” a work means to do anything with it that, without +permission, would make you directly or secondarily liable for infringement under +applicable copyright law, except executing it on a computer or modifying a private +copy. Propagation includes copying, distribution (with or without modification), +making available to the public, and in some countries other activities as well. + +To “convey” a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through a computer +network, with no transfer of a copy, is not conveying. + +An interactive user interface displays “Appropriate Legal Notices” to the +extent that it includes a convenient and prominently visible feature that *(1)* +displays an appropriate copyright notice, and *(2)* tells the user that there is no +warranty for the work (except to the extent that warranties are provided), that +licensees may convey the work under this License, and how to view a copy of this +License. If the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + +*** 1. Source Code + +The “source code” for a work means the preferred form of the work for +making modifications to it. “Object code” means any non-source form of a +work. + +A “Standard Interface” means an interface that either is an official +standard defined by a recognized standards body, or, in the case of interfaces +specified for a particular programming language, one that is widely used among +developers working in that language. + +The “System Libraries” of an executable work include anything, other than +the work as a whole, that *(a)* is included in the normal form of packaging a Major +Component, but which is not part of that Major Component, and *(b)* serves only to +enable use of the work with that Major Component, or to implement a Standard +Interface for which an implementation is available to the public in source code form. +A “Major Component”, in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system (if any) on which +the executable work runs, or a compiler used to produce the work, or an object code +interpreter used to run it. + +The “Corresponding Source” for a work in object code form means all the +source code needed to generate, install, and (for an executable work) run the object +code and to modify the work, including scripts to control those activities. However, +it does not include the work's System Libraries, or general-purpose tools or +generally available free programs which are used unmodified in performing those +activities but which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for the work, and +the source code for shared libraries and dynamically linked subprograms that the work +is specifically designed to require, such as by intimate data communication or +control flow between those subprograms and other parts of the work. + +The Corresponding Source need not include anything that users can regenerate +automatically from other parts of the Corresponding Source. + +The Corresponding Source for a work in source code form is that same work. + +*** 2. Basic Permissions + +All rights granted under this License are granted for the term of copyright on the +Program, and are irrevocable provided the stated conditions are met. This License +explicitly affirms your unlimited permission to run the unmodified Program. The +output from running a covered work is covered by this License only if the output, +given its content, constitutes a covered work. This License acknowledges your rights +of fair use or other equivalent, as provided by copyright law. + +You may make, run and propagate covered works that you do not convey, without +conditions so long as your license otherwise remains in force. You may convey covered +works to others for the sole purpose of having them make modifications exclusively +for you, or provide you with facilities for running those works, provided that you +comply with the terms of this License in conveying all material for which you do not +control copyright. Those thus making or running the covered works for you must do so +exclusively on your behalf, under your direction and control, on terms that prohibit +them from making any copies of your copyrighted material outside their relationship +with you. + +Conveying under any other circumstances is permitted solely under the conditions +stated below. Sublicensing is not allowed; section 10 makes it unnecessary. + +*** 3. Protecting Users' Legal Rights From Anti-Circumvention Law + +No covered work shall be deemed part of an effective technological measure under any +applicable law fulfilling obligations under article 11 of the WIPO copyright treaty +adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention +of such measures. + +When you convey a covered work, you waive any legal power to forbid circumvention of +technological measures to the extent such circumvention is effected by exercising +rights under this License with respect to the covered work, and you disclaim any +intention to limit operation or modification of the work as a means of enforcing, +against the work's users, your or third parties' legal rights to forbid circumvention +of technological measures. + +*** 4. Conveying Verbatim Copies + +You may convey verbatim copies of the Program's source code as you receive it, in any +medium, provided that you conspicuously and appropriately publish on each copy an +appropriate copyright notice; keep intact all notices stating that this License and +any non-permissive terms added in accord with section 7 apply to the code; keep +intact all notices of the absence of any warranty; and give all recipients a copy of +this License along with the Program. + +You may charge any price or no price for each copy that you convey, and you may offer +support or warranty protection for a fee. + +*** 5. Conveying Modified Source Versions + +You may convey a work based on the Program, or the modifications to produce it from +the Program, in the form of source code under the terms of section 4, provided that +you also meet all of these conditions: + +- *a)* The work must carry prominent notices stating that you modified it, and giving a +relevant date. +- *b)* The work must carry prominent notices stating that it is released under this +License and any conditions added under section 7. This requirement modifies the +requirement in section 4 to “keep intact all notices”. +- *c)* You must license the entire work, as a whole, under this License to anyone who +comes into possession of a copy. This License will therefore apply, along with any +applicable section 7 additional terms, to the whole of the work, and all its parts, +regardless of how they are packaged. This License gives no permission to license the +work in any other way, but it does not invalidate such permission if you have +separately received it. +- *d)* If the work has interactive user interfaces, each must display Appropriate Legal +Notices; however, if the Program has interactive interfaces that do not display +Appropriate Legal Notices, your work need not make them do so. + +A compilation of a covered work with other separate and independent works, which are +not by their nature extensions of the covered work, and which are not combined with +it such as to form a larger program, in or on a volume of a storage or distribution +medium, is called an “aggregate” if the compilation and its resulting +copyright are not used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work in an aggregate +does not cause this License to apply to the other parts of the aggregate. + +*** 6. Conveying Non-Source Forms + +You may convey a covered work in object code form under the terms of sections 4 and +5, provided that you also convey the machine-readable Corresponding Source under the +terms of this License, in one of these ways: + +- *a)* Convey the object code in, or embodied in, a physical product (including a +physical distribution medium), accompanied by the Corresponding Source fixed on a +durable physical medium customarily used for software interchange. +- *b)* Convey the object code in, or embodied in, a physical product (including a +physical distribution medium), accompanied by a written offer, valid for at least +three years and valid for as long as you offer spare parts or customer support for +that product model, to give anyone who possesses the object code either *(1)* a copy of +the Corresponding Source for all the software in the product that is covered by this +License, on a durable physical medium customarily used for software interchange, for +a price no more than your reasonable cost of physically performing this conveying of +source, or *(2)* access to copy the Corresponding Source from a network server at no +charge. +- *c)* Convey individual copies of the object code with a copy of the written offer to +provide the Corresponding Source. This alternative is allowed only occasionally and +noncommercially, and only if you received the object code with such an offer, in +accord with subsection 6b. +- *d)* Convey the object code by offering access from a designated place (gratis or for +a charge), and offer equivalent access to the Corresponding Source in the same way +through the same place at no further charge. You need not require recipients to copy +the Corresponding Source along with the object code. If the place to copy the object +code is a network server, the Corresponding Source may be on a different server +(operated by you or a third party) that supports equivalent copying facilities, +provided you maintain clear directions next to the object code saying where to find +the Corresponding Source. Regardless of what server hosts the Corresponding Source, +you remain obligated to ensure that it is available for as long as needed to satisfy +these requirements. +- *e)* Convey the object code using peer-to-peer transmission, provided you inform +other peers where the object code and Corresponding Source of the work are being +offered to the general public at no charge under subsection 6d. + +A separable portion of the object code, whose source code is excluded from the +Corresponding Source as a System Library, need not be included in conveying the +object code work. + +A “User Product” is either *(1)* a “consumer product”, which +means any tangible personal property which is normally used for personal, family, or +household purposes, or *(2)* anything designed or sold for incorporation into a +dwelling. In determining whether a product is a consumer product, doubtful cases +shall be resolved in favor of coverage. For a particular product received by a +particular user, “normally used” refers to a typical or common use of +that class of product, regardless of the status of the particular user or of the way +in which the particular user actually uses, or expects or is expected to use, the +product. A product is a consumer product regardless of whether the product has +substantial commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + +“Installation Information” for a User Product means any methods, +procedures, authorization keys, or other information required to install and execute +modified versions of a covered work in that User Product from a modified version of +its Corresponding Source. The information must suffice to ensure that the continued +functioning of the modified object code is in no case prevented or interfered with +solely because modification has been made. + +If you convey an object code work under this section in, or with, or specifically for +use in, a User Product, and the conveying occurs as part of a transaction in which +the right of possession and use of the User Product is transferred to the recipient +in perpetuity or for a fixed term (regardless of how the transaction is +characterized), the Corresponding Source conveyed under this section must be +accompanied by the Installation Information. But this requirement does not apply if +neither you nor any third party retains the ability to install modified object code +on the User Product (for example, the work has been installed in ROM). + +The requirement to provide Installation Information does not include a requirement to +continue to provide support service, warranty, or updates for a work that has been +modified or installed by the recipient, or for the User Product in which it has been +modified or installed. Access to a network may be denied when the modification itself +materially and adversely affects the operation of the network or violates the rules +and protocols for communication across the network. + +Corresponding Source conveyed, and Installation Information provided, in accord with +this section must be in a format that is publicly documented (and with an +implementation available to the public in source code form), and must require no +special password or key for unpacking, reading or copying. + +*** 7. Additional Terms + +“Additional permissions” are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. Additional +permissions that are applicable to the entire Program shall be treated as though they +were included in this License, to the extent that they are valid under applicable +law. If additional permissions apply only to part of the Program, that part may be +used separately under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option remove any +additional permissions from that copy, or from any part of it. (Additional +permissions may be written to require their own removal in certain cases when you +modify the work.) You may place additional permissions on material, added by you to a +covered work, for which you have or can give appropriate copyright permission. + +Notwithstanding any other provision of this License, for material you add to a +covered work, you may (if authorized by the copyright holders of that material) +supplement the terms of this License with terms: + +- *a)* Disclaiming warranty or limiting liability differently from the terms of +sections 15 and 16 of this License; or +- *b)* Requiring preservation of specified reasonable legal notices or author +attributions in that material or in the Appropriate Legal Notices displayed by works +containing it; or +- *c)* Prohibiting misrepresentation of the origin of that material, or requiring that +modified versions of such material be marked in reasonable ways as different from the +original version; or +- *d)* Limiting the use for publicity purposes of names of licensors or authors of the +material; or +- *e)* Declining to grant rights under trademark law for use of some trade names, +trademarks, or service marks; or +- *f)* Requiring indemnification of licensors and authors of that material by anyone +who conveys the material (or modified versions of it) with contractual assumptions of +liability to the recipient, for any liability that these contractual assumptions +directly impose on those licensors and authors. + +All other non-permissive additional terms are considered “further +restrictions” within the meaning of section 10. If the Program as you received +it, or any part of it, contains a notice stating that it is governed by this License +along with a term that is a further restriction, you may remove that term. If a +license document contains a further restriction but permits relicensing or conveying +under this License, you may add to a covered work material governed by the terms of +that license document, provided that the further restriction does not survive such +relicensing or conveying. + +If you add terms to a covered work in accord with this section, you must place, in +the relevant source files, a statement of the additional terms that apply to those +files, or a notice indicating where to find the applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the form of a +separately written license, or stated as exceptions; the above requirements apply +either way. + +*** 8. Termination + +You may not propagate or modify a covered work except as expressly provided under +this License. Any attempt otherwise to propagate or modify it is void, and will +automatically terminate your rights under this License (including any patent licenses +granted under the third paragraph of section 11). + +However, if you cease all violation of this License, then your license from a +particular copyright holder is reinstated *(a)* provisionally, unless and until the +copyright holder explicitly and finally terminates your license, and *(b)* permanently, +if the copyright holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + +Moreover, your license from a particular copyright holder is reinstated permanently +if the copyright holder notifies you of the violation by some reasonable means, this +is the first time you have received notice of violation of this License (for any +work) from that copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + +Termination of your rights under this section does not terminate the licenses of +parties who have received copies or rights from you under this License. If your +rights have been terminated and not permanently reinstated, you do not qualify to +receive new licenses for the same material under section 10. + +*** 9. Acceptance Not Required for Having Copies + +You are not required to accept this License in order to receive or run a copy of the +Program. Ancillary propagation of a covered work occurring solely as a consequence of +using peer-to-peer transmission to receive a copy likewise does not require +acceptance. However, nothing other than this License grants you permission to +propagate or modify any covered work. These actions infringe copyright if you do not +accept this License. Therefore, by modifying or propagating a covered work, you +indicate your acceptance of this License to do so. + +*** 10. Automatic Licensing of Downstream Recipients + +Each time you convey a covered work, the recipient automatically receives a license +from the original licensors, to run, modify and propagate that work, subject to this +License. You are not responsible for enforcing compliance by third parties with this +License. + +An “entity transaction” is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an organization, or +merging organizations. If propagation of a covered work results from an entity +transaction, each party to that transaction who receives a copy of the work also +receives whatever licenses to the work the party's predecessor in interest had or +could give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if the predecessor +has it or can get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the rights granted or +affirmed under this License. For example, you may not impose a license fee, royalty, +or other charge for exercise of rights granted under this License, and you may not +initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging +that any patent claim is infringed by making, using, selling, offering for sale, or +importing the Program or any portion of it. + +*** 11. Patents + +A “contributor” is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work thus +licensed is called the contributor's “contributor version”. + +A contributor's “essential patent claims” are all patent claims owned or +controlled by the contributor, whether already acquired or hereafter acquired, that +would be infringed by some manner, permitted by this License, of making, using, or +selling its contributor version, but do not include claims that would be infringed +only as a consequence of further modification of the contributor version. For +purposes of this definition, “control” includes the right to grant patent +sublicenses in a manner consistent with the requirements of this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free patent license +under the contributor's essential patent claims, to make, use, sell, offer for sale, +import and otherwise run, modify and propagate the contents of its contributor +version. + +In the following three paragraphs, a “patent license” is any express +agreement or commitment, however denominated, not to enforce a patent (such as an +express permission to practice a patent or covenant not to sue for patent +infringement). To “grant” such a patent license to a party means to make +such an agreement or commitment not to enforce a patent against the party. + +If you convey a covered work, knowingly relying on a patent license, and the +Corresponding Source of the work is not available for anyone to copy, free of charge +and under the terms of this License, through a publicly available network server or +other readily accessible means, then you must either *(1)* cause the Corresponding +Source to be so available, or *(2)* arrange to deprive yourself of the benefit of the +patent license for this particular work, or *(3)* arrange, in a manner consistent with +the requirements of this License, to extend the patent license to downstream +recipients. “Knowingly relying” means you have actual knowledge that, but +for the patent license, your conveying the covered work in a country, or your +recipient's use of the covered work in a country, would infringe one or more +identifiable patents in that country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or arrangement, you +convey, or propagate by procuring conveyance of, a covered work, and grant a patent +license to some of the parties receiving the covered work authorizing them to use, +propagate, modify or convey a specific copy of the covered work, then the patent +license you grant is automatically extended to all recipients of the covered work and +works based on it. + +A patent license is “discriminatory” if it does not include within the +scope of its coverage, prohibits the exercise of, or is conditioned on the +non-exercise of one or more of the rights that are specifically granted under this +License. You may not convey a covered work if you are a party to an arrangement with +a third party that is in the business of distributing software, under which you make +payment to the third party based on the extent of your activity of conveying the +work, and under which the third party grants, to any of the parties who would receive +the covered work from you, a discriminatory patent license *(a)* in connection with +copies of the covered work conveyed by you (or copies made from those copies), or *(b)* +primarily for and in connection with specific products or compilations that contain +the covered work, unless you entered into that arrangement, or that patent license +was granted, prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting any implied +license or other defenses to infringement that may otherwise be available to you +under applicable patent law. + +*** 12. No Surrender of Others' Freedom + +If conditions are imposed on you (whether by court order, agreement or otherwise) +that contradict the conditions of this License, they do not excuse you from the +conditions of this License. If you cannot convey a covered work so as to satisfy +simultaneously your obligations under this License and any other pertinent +obligations, then as a consequence you may not convey it at all. For example, if you +agree to terms that obligate you to collect a royalty for further conveying from +those to whom you convey the Program, the only way you could satisfy both those terms +and this License would be to refrain entirely from conveying the Program. + +*** 13. Use with the GNU Affero General Public License + +Notwithstanding any other provision of this License, you have permission to link or +combine any covered work with a work licensed under version 3 of the GNU Affero +General Public License into a single combined work, and to convey the resulting work. +The terms of this License will continue to apply to the part which is the covered +work, but the special requirements of the GNU Affero General Public License, section +13, concerning interaction through a network will apply to the combination as such. + +*** 14. Revised Versions of this License + +The Free Software Foundation may publish revised and/or new versions of the GNU +General Public License from time to time. Such new versions will be similar in spirit +to the present version, but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Program specifies that +a certain numbered version of the GNU General Public License “or any later +version” applies to it, you have the option of following the terms and +conditions either of that numbered version or of any later version published by the +Free Software Foundation. If the Program does not specify a version number of the GNU +General Public License, you may choose any version ever published by the Free +Software Foundation. + +If the Program specifies that a proxy can decide which future versions of the GNU +General Public License can be used, that proxy's public statement of acceptance of a +version permanently authorizes you to choose that version for the Program. + +Later license versions may give you additional or different permissions. However, no +additional obligations are imposed on any author or copyright holder as a result of +your choosing to follow a later version. + +*** 15. Disclaimer of Warranty + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER +EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE +QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE +DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +*** 16. Limitation of Liability + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY +COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS +PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, +INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE +OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE +WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + +*** 17. Interpretation of Sections 15 and 16 + +If the disclaimer of warranty and limitation of liability provided above cannot be +given local legal effect according to their terms, reviewing courts shall apply local +law that most closely approximates an absolute waiver of all civil liability in +connection with the Program, unless a warranty or assumption of liability accompanies +a copy of the Program in return for a fee. + +/END OF TERMS AND CONDITIONS/ + +** How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible use to +the public, the best way to achieve this is to make it free software which everyone +can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach them +to the start of each source file to most effectively state the exclusion of warranty; +and each file should have at least the “copyright” line and a pointer to +where the full notice is found. + + <one line to give the program's name and a brief idea of what it does.> + Copyright (C) <year> <name of author> + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see <http://www.gnu.org/licenses/>. + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short notice like this +when it starts in an interactive mode: + + <program> Copyright (C) <year> <name of author> + This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type 'show c' for details. + +The hypothetical commands =show w= and =show c= should show the appropriate parts of +the General Public License. Of course, your program's commands might be different; +for a GUI interface, you would use an “about box”. + +You should also get your employer (if you work as a programmer) or school, if any, to +sign a “copyright disclaimer” for the program, if necessary. For more +information on this, and how to apply and follow the GNU GPL, see +<http://www.gnu.org/licenses/> + +The GNU General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may consider it +more useful to permit linking proprietary applications with the library. If this is +what you want to do, use the GNU Lesser General Public License instead of this +License. But first, please read +<http://www.gnu.org/philosophy/why-not-lgpl.html> diff --git a/README.org b/README.org new file mode 100644 index 0000000000..59c6ebcfe1 --- /dev/null +++ b/README.org @@ -0,0 +1,72 @@ +#+title: [[./assets/colorful-mode-logo.svg]] +#+subtitle: Preview any color in your buffer +#+author: Elias G.B. Perez +#+language: en +#+export_file_name: colorful-mode.texi +#+texinfo_dir_category: Emacs misc features +#+texinfo_dir_title: colorful-mode: (colorful-mode). +#+texinfo_dir_desc: Preview color hexs in your buffer + +#+html: <img src="./assets/elisp_logo_warning.svg" align="right" width="10%"> + +🟠colorful-mode is a minor mode that allow you preview *color hex* and +*color names*, in your current buffer in a user friendly way based on +🌈[[https://elpa.gnu.org/packages/rainbow-mode.html][rainbow-mode.el]]. + +* Features 🔧 +- Preview emacs colors names and hex in your current buffer /(soon + support for CSS rgb)/. +- Changing highlighted colors to other formats. +- Preview colors with highlights or using a prefix string. + +* Screenshots and animated GIFs 📷 +#+CAPTION: with prefix instead highliht +[[./assets/gif1.gif]] + +[[./assets/gif2.gif]] +[[./assets/gif3.gif]] +[[./assets/screenshot1.png]] +[[./assets/screenshot2.png]] +[[./assets/screenshot3.png]] +#+CAPTION: with a custom prefix (in this example a nerd font character) +[[./assets/screenshot4.png]] + +* Installation 📦 +Currently colorful-mode is not available in any elisp package archive, +however you can install it with =package-vc-install= + +Run =M-x package-vc-install= +And type =https://github.com/DevelopmentCool2449/colorful-mode.git= + +For emacs 30 users you can use =use-package= + +#+begin_src emacs-lisp + (use-package colorful-mode + :vc (:url "https://github.com/DevelopmentCool2449/colorful-mode.git" + :rev :newest) + ...) +#+end_src + +* How does it compare to =rainbow-mode=? +=colorful-mode= improves =rainbow-mode= in adding more features +and fixing some /(and old)/ bugs. + +The intention is to provide a featured alternative to =rainbow.el= +with a user-friendy approach + + +* Plans for future +Currently this repo will only be used for feature-request /(i can't +promise to do them)/, send bug reports, and feedback /(i would greatly +appreciate this since i'm not expert in elisp)/. + +Due I have plans for submit it to *GNU ELPA* /(and maybe MELPA)/ *Pull +Resquest will not be accepted* (unless your contribution is less than +15 lines [see: [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Copyright-Assignment.html][Copyright Assignment]]] and this package is ready for +submit to ELPA and you are willing to assign copyright to FSF) + +Also i will try to make this package as stable as possible before +submit it to ELPA, later that *I won't be able to be the mantainer* of +this package, However I would like if someone would be able to be the +mantainer (if you are interested please email me +<eg642...@gmail.com>). diff --git a/assets/colorful-mode-logo.svg b/assets/colorful-mode-logo.svg new file mode 100644 index 0000000000..39daba5b96 --- /dev/null +++ b/assets/colorful-mode-logo.svg @@ -0,0 +1,191 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Created with Inkscape (http://www.inkscape.org/) --> + +<svg + width="184.95564mm" + height="41.755249mm" + viewBox="0 0 61.651881 13.918416" + version="1.1" + id="svg1" + inkscape:version="1.3.2 (091e20e, 2023-11-25, custom)" + sodipodi:docname="colorful-mode-logo.svg" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns="http://www.w3.org/2000/svg" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:cc="http://creativecommons.org/ns#"> + <sodipodi:namedview + id="namedview1" + pagecolor="#505050" + bordercolor="#ffffff" + borderopacity="1" + inkscape:showpageshadow="0" + inkscape:pageopacity="0" + inkscape:pagecheckerboard="1" + inkscape:deskcolor="#505050" + inkscape:document-units="mm" + inkscape:zoom="0.69166115" + inkscape:cx="333.97857" + inkscape:cy="57.108889" + inkscape:window-width="1292" + inkscape:window-height="745" + inkscape:window-x="66" + inkscape:window-y="-8" + inkscape:window-maximized="1" + inkscape:current-layer="layer1" /> + <defs + id="defs1"> + <linearGradient + id="linearGradient23" + inkscape:collect="always"> + <stop + style="stop-color:#353232;stop-opacity:1;" + offset="0" + id="stop23" /> + <stop + style="stop-color:#422e2e;stop-opacity:1;" + offset="1" + id="stop24" /> + </linearGradient> + <inkscape:path-effect + effect="spiro" + id="path-effect3" + is_visible="true" + lpeversion="1" /> + <linearGradient + id="swatch2" + inkscape:swatch="solid"> + <stop + style="stop-color:#332aa7;stop-opacity:1;" + offset="0" + id="stop2" /> + </linearGradient> + <rect + x="134.09746" + y="536.75128" + width="231.32713" + height="53.132954" + id="rect12" /> + <rect + x="119.61275" + y="540.30206" + width="250.47115" + height="46.004906" + id="rect11" /> + <rect + x="140.24208" + y="526.26929" + width="213.71407" + height="80.360466" + id="rect1" /> + <linearGradient + inkscape:collect="always" + xlink:href="#linearGradient23" + id="linearGradient24" + x1="27.692263" + y1="88.359756" + x2="40.067112" + y2="101.13702" + gradientUnits="userSpaceOnUse" /> + </defs> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-26.914163,-86.195259)"> + <g + id="g21" + transform="matrix(0.7035566,0,0,0.7035566,10.108821,26.350167)"> + <path + id="circle17" + style="fill:#353232;fill-rule:evenodd;stroke:url(#linearGradient24);stroke-width:1.42135;paint-order:fill markers stroke" + d="m 42.958537,94.952278 a 9.1807966,9.1807966 0 0 1 -9.180797,9.180792 9.1807966,9.1807966 0 0 1 -9.180796,-9.180792 9.1807966,9.1807966 0 0 1 9.180796,-9.180796 9.1807966,9.1807966 0 0 1 9.180797,9.180796 z" /> + <path + id="path2" + style="fill:#e58409;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 25.802798,99.454348 7.967989,-4.600236 -7.886857,-4.55321 a 9.1807966,9.1807966 0 0 0 -1.286743,4.651395 9.1807966,9.1807966 0 0 0 1.205611,4.502051 z" /> + <path + id="path21" + style="fill:#d3ef04;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 33.771304,94.854112 -7.968506,4.600236 a 9.1807966,9.1807966 0 0 0 7.968506,4.678272 z" /> + <path + id="path20" + style="fill:#792aa7;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 33.771304,94.854112 v 9.278508 a 9.1807966,9.1807966 0 0 0 0.0062,5.1e-4 9.1807966,9.1807966 0 0 0 7.972124,-4.672581 z" /> + <path + id="path19" + style="fill:#2815df;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 33.771304,94.854112 7.978325,4.606437 a 9.1807966,9.1807966 0 0 0 1.208711,-4.508252 9.1807966,9.1807966 0 0 0 -1.275374,-4.665865 z" /> + <path + id="path18" + style="fill:#d70005;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 33.771304,85.771979 a 9.1807966,9.1807966 0 0 0 -7.887374,4.528923 l 7.886857,4.55321 h 5.17e-4 z" /> + <path + id="path17" + style="fill:#00d123;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5;stroke-dasharray:none;stroke-opacity:1;paint-order:fill markers stroke" + d="m 33.771304,85.771979 v 9.082133 l 7.911662,-4.56768 a 9.1807966,9.1807966 0 0 0 -7.905461,-4.51497 9.1807966,9.1807966 0 0 0 -0.0062,5.17e-4 z" /> + </g> + <path + id="rect24" + style="fill:#b53c3c;fill-opacity:1;fill-rule:evenodd;stroke-width:0.761968;paint-order:fill markers stroke" + d="m 40.494091,88.968628 h 19.211414 v 9.56333 H 40.494091 Z" /> + <path + id="rect25" + style="fill:#664a83;fill-rule:evenodd;stroke-width:0.636983;paint-order:fill markers stroke" + d="M 59.210648,88.968628 H 72.63649 v 9.56333 H 59.210648 Z" /> + <g + id="text2" + style="font-size:9.87777px;font-family:'Fira Sans';-inkscape-font-specification:'Fira Sans';letter-spacing:0.264583px;fill:#332aa7;fill-rule:evenodd;stroke-width:0.264583;paint-order:fill markers stroke" + aria-label="olorful"> + <path + style="fill:#3f3b3b" + d="m 43.191642,91.353532 q 1.096432,0 1.698976,0.730955 0.612422,0.730955 0.612422,1.985432 0,0.809977 -0.276578,1.432277 -0.276577,0.612422 -0.800099,0.958144 -0.523522,0.335844 -1.244599,0.335844 -1.096433,0 -1.708854,-0.730955 -0.612422,-0.730955 -0.612422,-1.985432 0,-0.809977 0.276577,-1.422399 0.276578,-0.6223 0.8001,-0.958144 0.523522,-0.345722 1.254477,-0.345722 z m 0,0.730955 q -1.353255,0 -1.353255,1.99531 0,1.985432 1.343377,1.985432 1.343377,0 1.343377,-1.99531 0,-1. [...] + id="path25" /> + <path + style="font-style:italic;-inkscape-font-specification:'Fira Sans Italic';fill:#3f3b3b" + d="m 62.83005,90.000278 q -0.424744,0 -0.642055,0.197555 -0.217311,0.187678 -0.2667,0.582789 l -0.09878,0.691443 h 1.254477 l -0.197556,0.701322 H 61.72374 l -0.592666,4.217808 q -0.09878,0.721077 -0.335844,1.145821 -0.227189,0.434622 -0.602544,0.701322 -0.365478,0.2667 -1.007533,0.543278 l -0.256822,-0.681567 q 0.414866,-0.187677 0.651933,-0.365477 0.246944,-0.1778 0.404988,-0.493889 0.167923,-0.316088 0.246945,-0.849488 l 0.592666,-4.217808 H 59.90623 l 0.09878,-0.701322 h 0.9 [...] + id="path26" /> + <path + style="fill:#3f3b3b" + d="m 67.875479,96.67765 h -0.780344 l -0.06915,-0.809977 q -0.296333,0.484011 -0.681566,0.7112 -0.385233,0.217311 -0.938388,0.217311 -0.681566,0 -1.066799,-0.414867 -0.385233,-0.414866 -0.385233,-1.175454 v -3.733798 h 0.908755 v 3.63502 q 0,0.5334 0.187677,0.760588 0.187678,0.217311 0.612422,0.217311 0.760588,0 1.303866,-0.898877 v -3.714042 h 0.908755 z m 3.178532,0.118534 q -0.503766,0 -0.800099,-0.296333 -0.286456,-0.306211 -0.286456,-0.849489 v -6.272384 l 0.908755,-0.10865 [...] + id="path27" /> + </g> + <path + style="font-style:italic;font-weight:300;font-size:4.9389px;font-family:'Fira Sans';-inkscape-font-specification:'Fira Sans Light Italic';letter-spacing:0.264583px;fill:#3f3b3b;fill-rule:evenodd;stroke-width:0.5;paint-order:fill markers stroke" + d="m 73.654073,89.708517 0.03951,-0.246945 h 1.298931 l -0.03457,0.246945 z m 5.124464,-1.214969 q 0.256823,0 0.400051,0.167922 0.148167,0.162984 0.148167,0.454379 0,0.07902 -0.01482,0.177801 l -0.261762,1.83727 H 78.76372 l 0.256823,-1.812576 q 0.01482,-0.09878 0.01482,-0.1778 0,-0.40499 -0.340785,-0.40499 -0.227189,0 -0.439562,0.22225 -0.212372,0.222251 -0.429684,0.612424 l -0.22225,1.560692 h -0.286457 l 0.256823,-1.812576 q 0.01482,-0.09878 0.01482,-0.1778 0,-0.40499 -0.340784 [...] + id="text3" + aria-label="-mode" /> + <path + style="font-size:12.7px;font-family:'Lucida Console';-inkscape-font-specification:'Lucida Console';letter-spacing:0.264583px;fill:#ffffff;fill-rule:evenodd;stroke-width:0.8;paint-order:fill markers stroke" + d="m 36.785435,96.780312 q -1.227832,0.440283 -2.313037,0.440283 -1.897559,0 -3.057178,-1.134815 -1.159619,-1.141015 -1.159619,-2.995166 0,-1.878955 1.153418,-3.044775 1.153418,-1.16582 3.013769,-1.16582 1.054199,0 2.257227,0.359668 v 1.122412 q -1.227832,-0.564307 -2.294434,-0.564307 -1.234033,0 -2.033984,0.905371 -0.79375,0.905371 -0.79375,2.306836 0,1.413867 0.89917,2.313037 0.89917,0.89917 2.313037,0.89917 0.855761,0 2.015381,-0.446484 z" + id="text21" + aria-label="C" /> + </g> + <metadata + id="metadata12"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <cc:license + rdf:resource="http://creativecommons.org/licenses/by-sa/4.0/" /> + </cc:Work> + <cc:License + rdf:about="http://creativecommons.org/licenses/by-sa/4.0/"> + <cc:permits + rdf:resource="http://creativecommons.org/ns#Reproduction" /> + <cc:permits + rdf:resource="http://creativecommons.org/ns#Distribution" /> + <cc:requires + rdf:resource="http://creativecommons.org/ns#Notice" /> + <cc:requires + rdf:resource="http://creativecommons.org/ns#Attribution" /> + <cc:permits + rdf:resource="http://creativecommons.org/ns#DerivativeWorks" /> + <cc:requires + rdf:resource="http://creativecommons.org/ns#ShareAlike" /> + </cc:License> + </rdf:RDF> + </metadata> +</svg> diff --git a/assets/elisp_logo_warning.svg b/assets/elisp_logo_warning.svg new file mode 100644 index 0000000000..f111cc10af --- /dev/null +++ b/assets/elisp_logo_warning.svg @@ -0,0 +1,193 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Created with Inkscape (http://www.inkscape.org/) --> + +<svg:svg + width="108.11634" + height="167.61635" + id="svg2" + version="1.1" + xml:space="preserve" + sodipodi:docname="elisp_logo_warning.svg" + inkscape:version="1.3.2 (091e20e, 2023-11-25, custom)" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:dc="http://purl.org/dc/elements/1.1/"><sodipodi:namedview + id="namedview1" + pagecolor="#505050" + bordercolor="#ffffff" + borderopacity="1" + inkscape:showpageshadow="0" + inkscape:pageopacity="0" + inkscape:pagecheckerboard="1" + inkscape:deskcolor="#505050" + inkscape:zoom="3.2753368" + inkscape:cx="54.040244" + inkscape:cy="83.502863" + inkscape:window-width="1292" + inkscape:window-height="745" + inkscape:window-x="66" + inkscape:window-y="-8" + inkscape:window-maximized="1" + inkscape:current-layer="layer1" /><svg:defs + id="defs4"><svg:linearGradient + id="swatch7"><svg:stop + style="stop-color:#000000;stop-opacity:1;" + offset="0" + id="stop7" /></svg:linearGradient><svg:linearGradient + id="linearGradient3"><svg:stop + style="stop-color:#57479d;stop-opacity:1;" + offset="0.29306534" + id="stop3" /><svg:stop + style="stop-color:#5b1938;stop-opacity:1;" + offset="0.70603013" + id="stop4" /></svg:linearGradient><svg:linearGradient + id="linearGradient4292"><svg:stop + id="stop4294" + offset="0" + style="stop-color:#411f5d;stop-opacity:1" /><svg:stop + id="stop4296" + offset="1" + style="stop-color:#5b2a85;stop-opacity:1" /></svg:linearGradient><svg:linearGradient + id="linearGradient4284"><svg:stop + offset="0" + style="stop-color:#8381c5;stop-opacity:1" + id="stop4286" /><svg:stop + id="stop4290" + style="stop-color:#7e55b3;stop-opacity:0.99607843" + offset="0.56639391" /><svg:stop + offset="1" + style="stop-color:#a52ecb;stop-opacity:0.99215686" + id="stop4288" /></svg:linearGradient><svg:linearGradient + y2="300.73987" + x2="236.61363" + y1="-161.8512" + x1="-122.20192" + spreadMethod="pad" + gradientTransform="matrix(0.08192422,0,0,0.07764193,223.12164,515.26127)" + gradientUnits="userSpaceOnUse" + id="linearGradient4245" + xlink:href="#linearGradient4284" /><svg:linearGradient + y2="66.018341" + x2="173.94518" + y1="396.6066" + x1="447.80933" + gradientTransform="matrix(0.09251715,0,0,0.09251715,200.34291,492.03412)" + gradientUnits="userSpaceOnUse" + id="linearGradient4247" + xlink:href="#linearGradient4292" /><svg:linearGradient + xlink:href="#linearGradient3" + id="linearGradient4" + x1="49.641563" + y1="464.52335" + x2="493.93356" + y2="464.52335" + gradientUnits="userSpaceOnUse" + gradientTransform="matrix(0.41007792,0,0,0.75165459,154.96263,142.75359)" /><svg:clipPath + clipPathUnits="userSpaceOnUse" + id="clipPath22"><svg:path + style="display:inline;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke-width:0.5;paint-order:fill markers stroke" + d="m 211.75667,415.81018 c 0.0332,55.84305 -0.0664,111.74112 0.0498,167.5498 36.00972,-0.0332 72.07446,0.0664 108.0498,-0.0498 -0.0332,-55.84305 0.0664,-111.74112 -0.0498,-167.5498 -36.0097,0.0332 -72.0745,-0.0664 -108.0498,0.0498 z" + id="path23" /></svg:clipPath><svg:clipPath + clipPathUnits="userSpaceOnUse" + id="clipPath23"><svg:path + style="display:inline;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke-width:0.5;paint-order:fill markers stroke" + d="m 211.75667,415.81018 c 0.0332,55.84305 -0.0664,111.74112 0.0498,167.5498 36.00972,-0.0332 72.07446,0.0664 108.0498,-0.0498 -0.0332,-55.84305 0.0664,-111.74112 -0.0498,-167.5498 -36.0097,0.0332 -72.0745,-0.0664 -108.0498,0.0498 z" + id="path24" /></svg:clipPath><svg:clipPath + clipPathUnits="userSpaceOnUse" + id="clipPath24"><svg:path + style="display:inline;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke-width:0.5;paint-order:fill markers stroke" + d="m 211.75667,415.81018 c 0.0332,55.84305 -0.0664,111.74112 0.0498,167.5498 36.00972,-0.0332 72.07446,0.0664 108.0498,-0.0498 -0.0332,-55.84305 0.0664,-111.74112 -0.0498,-167.5498 -36.0097,0.0332 -72.0745,-0.0664 -108.0498,0.0498 z" + id="path25" /></svg:clipPath><svg:clipPath + clipPathUnits="userSpaceOnUse" + id="clipPath25"><svg:path + style="display:inline;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke-width:0.5;paint-order:fill markers stroke" + d="m 211.75667,415.81018 c 0.0332,55.84305 -0.0664,111.74112 0.0498,167.5498 36.00972,-0.0332 72.07446,0.0664 108.0498,-0.0498 -0.0332,-55.84305 0.0664,-111.74112 -0.0498,-167.5498 -36.0097,0.0332 -72.0745,-0.0664 -108.0498,0.0498 z" + id="path26" /></svg:clipPath></svg:defs><svg:metadata + id="metadata7"><rdf:RDF><cc:Work + rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><cc:license + rdf:resource="https://www.gnu.org/licenses/gpl-3.0.en.html#license-text" /></cc:Work></rdf:RDF></svg:metadata><svg:g + id="layer1" + style="display:inline" + clip-path="none" + transform="translate(-211.7483,-415.75201)"><svg:rect + style="display:inline;mix-blend-mode:normal;fill:url(#linearGradient4);stroke:none;stroke-width:1.66557;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + id="bg" + width="182.19432" + height="256.83994" + x="175.31953" + y="363.49475" + rx="7.9409237" + ry="5.7339058" + clip-path="url(#clipPath25)" /><svg:g + id="emacs_logo" + transform="matrix(2.1296393,0,0,2.1296393,-1401.8188,446.54059)" + style="display:inline"><svg:path + d="m 245.83076,515.88126 c 0,12.19324 -9.78462,22.07781 -21.85454,22.07781 -12.06993,0 -21.85455,-9.88457 -21.85455,-22.07781 0,-12.19324 9.78462,-22.07781 21.85455,-22.07781 12.06992,0 21.85454,9.88457 21.85454,22.07781 z" + id="path4235" + style="display:inline;opacity:1;fill:url(#linearGradient4245);fill-opacity:1;stroke:url(#linearGradient4247);stroke-width:1.25045;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + transform="translate(554.03605,-491.79739)" /><svg:path + d="m 770.50076,39.591616 c 0,0 1.85048,0.130907 4.23105,-0.0789 0.96407,-0.08497 4.62438,-0.444495 7.36096,-1.044646 0,0 3.33655,-0.714065 5.12157,-1.371877 1.86774,-0.688298 2.88409,-1.272472 3.34156,-2.100227 -0.0199,-0.169601 0.14085,-0.771036 -0.72047,-1.132302 -2.20206,-0.923624 -4.75594,-0.75656 -9.80942,-0.863704 -5.60411,-0.192554 -7.46837,-1.130598 -8.46146,-1.886099 -0.9523,-0.766424 -0.47344,-2.8868 3.60696,-4.75453 2.05541,-0.994592 10.11286,-2.830029 10.11286,-2.830 [...] + id="path4237" + style="display:inline;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" /></svg:g><svg:rect + style="color:#000000;display:inline;overflow:visible;visibility:visible;opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:3.1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none" + id="rect2291" + width="164.28812" + height="89.078255" + x="185.09084" + y="526.96027" + clip-path="url(#clipPath24)" /><svg:rect + y="369.00781" + x="182.95723" + height="70.006035" + width="164.28812" + id="rect3019" + style="color:#000000;display:inline;overflow:visible;visibility:visible;opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:3.03418;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none" + clip-path="url(#clipPath23)" /><svg:path + id="path1336" + style="display:inline;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:3.1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" + d="M -14.836285,231.54517 629.7647,233.1054 c 10.7279,0 19.36443,3.40225 19.36443,7.62837 l -7.1988,758.76805 c 0,4.22608 -8.63653,7.62838 -19.36443,7.62838 L -22.03509,1005.57 c -10.727891,0 -19.364425,-3.4023 -19.364425,-7.62841 l 7.198805,-758.76805 c 0,-4.22612 8.636534,-7.62837 19.364425,-7.62837 z M 213.18262,417.13562 H 318.3335 V 581.61408 H 213.18262 Z" + clip-path="url(#clipPath22)" /><svg:text + xml:space="preserve" + style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:20.1037px;line-height:125%;font-family:'Fira Sans';-inkscape-font-specification:'Fira Sans';text-align:center;writing-mode:lr-tb;text-anchor:middle;display:inline;overflow:visible;visibility:visible;opacity:1;fill:#8200d7;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.1162;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke [...] + x="236.00786" + y="488.54401" + id="text3021" + transform="scale(1.125978,0.888117)"><svg:tspan + id="tspan3027" + x="236.00786" + y="488.54401" + style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Fira Sans';-inkscape-font-specification:'Fira Sans'">WARNING</svg:tspan></svg:text><svg:g + id="flowRoot3029" + style="font-size:13.4385px;line-height:80.6311%;font-family:'Franklin Gothic Medium';text-align:center;text-anchor:middle" + transform="matrix(1.177743,0,0,1.057864,-46.79483,-29.65303)" + aria-label="This product may contain trace amounts of Elisp"><svg:path + d="m 234.31788,540.49605 h -1.73231 v -7.57228 h -2.38192 v -1.38453 h 6.49615 v 1.38453 h -2.38192 z m 8.76652,0 h -1.49608 v -4.33733 q 0,-0.70211 -0.30184,-0.98426 -0.29528,-0.28872 -0.69555,-0.28872 -0.63649,0 -1.06957,0.50525 -0.43308,0.50526 -0.43308,1.66669 v 3.43837 h -1.49608 v -8.95681 h 1.49608 v 3.49086 q 0.55775,-1.43047 1.95541,-1.43047 2.04071,0 2.04071,2.34255 z m 3.28745,-7.40167 h -1.49609 v -1.55514 h 1.49609 z m 0,7.40167 h -1.49609 v -6.62739 h 1.49609 z m 0 [...] + id="path14" /><svg:path + style="line-height:80.6311%" + d="M 265.96528,573.00295 H 260.145 v -8.95682 h 5.76123 v 1.33204 h -4.14704 v 2.42786 h 3.33338 v 1.29923 h -3.33338 v 2.50659 h 4.20609 z m 2.79532,0 h -1.49608 v -8.95682 h 1.49608 z m 3.28744,-7.40168 h -1.49608 v -1.55514 h 1.49608 z m 0,7.40168 h -1.49608 v -6.62739 h 1.49608 z m 0.99083,-1.52233 1.40422,-0.26904 q 0.32153,0.8071 1.41734,0.8071 1.3911,0 1.3911,-0.82022 0,-0.26247 -0.21654,-0.43308 -0.21654,-0.1706 -0.51182,-0.22966 l -1.20737,-0.22966 q -2.0079,-0.38714 -2 [...] + id="path15" /></svg:g></svg:g><script /><!-- Gnu Emacs Icon + Copyright (C) 2008-2017 Free Software Foundation, Inc. + + Author: Nicolas Petton <nico...@petton.fr> + + This file is part of GNU Emacs. + + GNU Emacs is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + GNU Emacs is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. + +--><!-- Created with Inkscape (http://www.inkscape.org/) --><script /></svg:svg> diff --git a/assets/gif1.gif b/assets/gif1.gif new file mode 100644 index 0000000000..be082bf8d5 Binary files /dev/null and b/assets/gif1.gif differ diff --git a/assets/gif2.gif b/assets/gif2.gif new file mode 100644 index 0000000000..20ca56c6cd Binary files /dev/null and b/assets/gif2.gif differ diff --git a/assets/gif3.gif b/assets/gif3.gif new file mode 100644 index 0000000000..148a0bdec7 Binary files /dev/null and b/assets/gif3.gif differ diff --git a/assets/screenshot1.png b/assets/screenshot1.png new file mode 100644 index 0000000000..0fcfd34f7a Binary files /dev/null and b/assets/screenshot1.png differ diff --git a/assets/screenshot2.png b/assets/screenshot2.png new file mode 100644 index 0000000000..9ccb826fa0 Binary files /dev/null and b/assets/screenshot2.png differ diff --git a/assets/screenshot3.png b/assets/screenshot3.png new file mode 100644 index 0000000000..7acfb9be2d Binary files /dev/null and b/assets/screenshot3.png differ diff --git a/assets/screenshot4.png b/assets/screenshot4.png new file mode 100644 index 0000000000..06a047af2d Binary files /dev/null and b/assets/screenshot4.png differ diff --git a/colorful-mode.el b/colorful-mode.el new file mode 100644 index 0000000000..a26f5710eb --- /dev/null +++ b/colorful-mode.el @@ -0,0 +1,337 @@ +;;; colorful-mode.el --- Preview any color in your buffer -*- lexical-binding: t; -*- + +;; Copyright (C) 2024 Elias G.B. Perez + +;; Author: Elias G.B. Perez <eg642...@gmail.com> +;; Keywords: faces +;; Version: 0.1.0 + +;; This file is not part of GNU Emacs. + +;; This program is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation, either version 3 of the License, or +;; (at your option) any later version. + +;; This program is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with this program. If not, see <https://www.gnu.org/licenses/>. + +;;; Commentary: +;; Minor mode that sets background color to color names, hex values +;; or rgb values (CSS) found in your current buffer in a friendly and +;; effective way based on rainbow-mode. + +;;; Code: + +;; Importing Libraries. +(require 'faces) +(require 'color) +(require 'rx) + +;; Buffer-local variables + +(defvar-local colorful-color-keywords + `((,(rx (seq (not (any "&")) + (group "#" (repeat 1 4 (= 3 (any "0-9A-Fa-f")))) + word-boundary)) + (1 (colorful-colorize-itself 1))) + (,(rx (seq bol + (group "#" (repeat 1 4 (= 3 (any "0-9A-Fa-f")))) + word-boundary)) + (0 (colorful-colorize-itself))) + (,(rx (seq (any "Rr") (any "Gg") (any "Bb") ":" + (repeat 1 4 (any "0-9A-Fa-f")) "/" + (repeat 1 4 (any "0-9A-Fa-f")) "/" + (repeat 1 4 (any "0-9A-Fa-f")))) + (0 (colorful-colorize-itself))) + (,(rx (seq (any "Rr") (any "Gg") (any "Bb") (any "Ii") ":" + (one-or-more (any "0-9" ".")) "/" + (one-or-more (any "0-9" ".")) "/" + (one-or-more (any "0-9" ".")))) + (0 (colorful-colorize-itself))) + (,(rx (seq (or (seq (any "Cc") (any "Ii") (any "Ee") + (or (seq (any "Xx") (any "Yy") (any "Zz")) + (seq (any "Uu") (any "Vv") (any "Yy")) + (seq (any "Xx") (any "Yy") (any "Yy")) + (seq (any "Ll") (any "Aa") (any "Bb")) + (seq (any "Ll") (any "Uu") (any "Vv")))) + (seq (any "Tt") (any "Ee") (any "Kk") (any "Hh") + (any "Vv") (any "Cc"))) + ":" + (opt (any "+-")) + (one-or-more (any "0-9" ".")) + (opt (any "Ee") + (opt (any "+-")) + (one-or-more (any "0-9"))) + "/" + (opt (any "+-")) + (one-or-more (any "0-9" ".")) + (opt (any "Ee") + (opt (any "+-")) + (one-or-more (any "0-9"))) + "/" + (opt (any "+-")) + (one-or-more (any "0-9" ".")) + (opt (any "Ee") + (opt (any "+-")) + (one-or-more (any "0-9"))))) + (0 (colorful-colorize-itself)))) + "Font-lock keywords to add for hexadecimal colors. +Must be a list containing regex strings.") + + +;; Customizable User options. + +(defgroup colorful-mode nil + "Preview hex colors values in current buffer.." + :tag "Colorful mode" + :group 'help) + +(defface colorful-base + '((t (:box (:line-width (1 . 1) :color "grey75" :style flat-button)))) + "Face used as base for highlight color names.") + +(defcustom colorful-allow-mouse-clicks t + "If non-nil, allow using mouse buttons for change color." + :type 'boolean) + +(defcustom colorful-use-prefix nil + "If non-nil, use prefix for preview color instead highlight them." + :type 'boolean) + +(defcustom colorful-prefix-string "●" + "Prefix symbol to be used according `colorful-use-prefix'." + :type 'string) + +(defcustom colorful-prefix-alignment 'left + "The position to put prefix string. +The value can be left or right." + :type '(choice (const :tag "Left" left) + (const :tag "Right" right))) + + +;; Functions + +(defun colorful--color-luminance (color) + "Calculate the relative luminance of COLOR string. +Return a value between 0 and 1." + (let* ((values (color-values color)) + (r (/ (nth 0 values) 256.0)) + (g (/ (nth 1 values) 256.0)) + (b (/ (nth 2 values) 256.0))) + ;; Return computed value + (/ (+ (* .2126 r) + (* .7152 g) + (* .0722 b) + 255)))) + +;; (defun colorful--hex-to-rgb (hex) +;; "Return HEX color as CSS rgb format." +;; ;; (query-replace) +;; ) + +(defun colorful--hex-to-name (hex) + "Return HEX as Emacs color name." + (let ((color (color-values hex)) + name) + (dolist (color-list color-name-rgb-alist) + (if (equal (cdr color-list) color) + (setq name (car color-list)))) + name)) + +(defun colorful--name-to-hex (name) + "Return Emacs color NAME as hex color format." + (let ((color (color-name-to-rgb name))) + (apply #'color-rgb-to-hex color))) + +(defun colorful--replace-region (beg end text) + "Delete region from BEG to END with TEXT." + (save-excursion + (delete-region beg end) + (insert text))) + +;;;###autoload +(defun colorful-change-color (&optional color beg end prompt) + "Change COLOR from BEG to END, opcionally use a PROMPT message text." + (interactive "*") + ;; COLOR BEG and END are only used as lexical values, + ;; not intended to be used externally. + (dolist (ov (overlays-at (point))) + (when (overlay-get ov 'colorful--overlay) + (setq beg (or beg (overlay-start ov)) + end (or end (overlay-end ov)) + color (or color (buffer-substring-no-properties beg end))))) + + (if-let* (beg + end + color + (prompt (or prompt + (format "Change %s to: " color))) + (choices '(("Hex value" . hex) + ;; ("RGB (CSS)" . rgb) + ("Emacs color name" . name))) + (choice (alist-get + (completing-read prompt choices nil t nil nil) + choices nil nil 'equal))) + (pcase choice ; Convert to... + ('hex + (if (not (string-prefix-p "#" color)) ; Ensure is not already a hex + (cond ((member color (defined-colors)) ; Name + (let ((rep (colorful--name-to-hex color))) + (colorful--replace-region beg end rep))) + ;; TODO: () ; rgb + ) + (colorful-change-color + color beg end + (format "%s is already a Hex value. Try again: " color)))) + ;; ('rgb (unless (string-prefix-p "rgb" color))) + ('name + (if (not (assoc color color-name-rgb-alist)) + (cond ((string-prefix-p "#" color) ; Hex + (let ((rep (colorful--hex-to-name color))) + (if rep + (colorful--replace-region beg end rep) + (message "No color name available.")))) + ;; ((string-prefix-p "rgb" color) ; CSS rgb + ;; (let ((rep (colorful--hex-to-name color))) + ;; (colorful--replace-region beg end rep))) + ) + (colorful-change-color + color beg end + (format "%s is already a color name value. Try again: " color))))) + (message "No color found at position."))) + +(defun colorful--delete-overlay (overlay &rest _) + "Helper function for delete OVERLAY." + (delete-overlay overlay)) + +(defun colorful--colorize-match (color &optional match) + "Return a matched (MATCH) string propertized with a face in BG and END range. +Propertize with background COLOR value. The foreground is computed using +`colorful--color-luminance', and is either white or black." + (let* ((match (or match 0)) + (start (match-beginning match)) + (end (match-end match)) + (ov (make-overlay start end nil t t))) + + ;; Define colorful overlay tag + (overlay-put ov 'colorful--overlay t) + + ;; NOTE: Using colorful prefix bugs background color, + ;; this is the way i found for fix this. + (when (and colorful-allow-mouse-clicks + (not colorful-use-prefix)) + (overlay-put ov 'mouse-face 'highlight) + (overlay-put ov 'keymap + (let ((map (make-sparse-keymap))) + (keymap-set map "<mouse-1>" #'colorful-change-color) + map))) + + ;; Delete overlays when they are modified. + ;; This refresh them with without using `jit-lock-register' or + ;; any hook. + (overlay-put ov 'evaporate t) + (overlay-put ov 'modification-hooks `(colorful--delete-overlay)) + (overlay-put ov 'insert-in-front-hooks `(colorful--delete-overlay)) + (overlay-put ov 'insert-behind-hooks `(colorful--delete-overlay)) + + (cond + (colorful-use-prefix + (overlay-put ov + (if (eq colorful-prefix-alignment 'left) + 'before-string + 'after-string) + (if colorful-allow-mouse-clicks + (propertize colorful-prefix-string + 'face `(:foreground ,color) + 'mouse-face 'highlight + 'keymap + (let ((map (make-sparse-keymap))) + (keymap-set map "<mouse-1>" #'colorful-change-color) + map)) + (propertize colorful-prefix-string + 'face `(:foreground ,color)))) + ;; NOTE: This fixs an error for invalid face when using prefix + (overlay-put ov 'face nil)) + (t + (overlay-put ov 'face + `((:foreground + ,(if (< 0.0026 (colorful--color-luminance color)) + "white" "black")) + (:background ,color) + (:inherit colorful-base))))))) + +(defun colorful-colorize-itself (&optional match) + "Helper function for Colorize MATCH with itself." + (let* ((match1 (or match 0)) + (string (match-string-no-properties match1))) + ;; Delete duplicates overlays found + (dolist (ov (overlays-in (match-beginning match1) (match-end match1))) + (if (overlay-get ov 'colorful--overlay) + (colorful--delete-overlay ov))) + (colorful--colorize-match string match))) + + +;; Extras color regex functions and variables. + +(defvar colorful-color-name-font-lock-keywords + `((,(regexp-opt (defined-colors) 'words) + (0 (colorful-colorize-itself)))) + "Font-lock keywords to add for `colorful-color-keywords'.") + +(defcustom colorful-extra-color-keywords-hook nil + "Hook used for add extra color keywords to `colorful-color-keywords'." + :group 'dashboard + :type 'hook) + +(defun colorful-add-color-names () + "Function for add Emacs color names to `colorful-color-keywords'. +This is intended to be used with `colorful-extra-color-keywords-hook'." + (dolist (colors colorful-color-name-font-lock-keywords) + (add-to-list 'colorful-color-keywords colors t))) + + +;; Minor mode definitions. + +(defun colorful--turn-on () + "Helper function for turn on `colorful-mode'." + (run-hooks 'colorful-extra-color-keywords-hook) + + (font-lock-add-keywords nil + colorful-color-keywords) + + ;; Refresh font-lock + (font-lock-flush)) + +(defun colorful--turn-off () + "Helper function for clear colorful overlays." + (font-lock-remove-keywords + nil `(,@colorful-color-keywords)) + (remove-overlays nil nil 'colorful--overlay t) + ;; Refresh font-lock + (font-lock-flush)) + +;;;###autoload +(define-minor-mode colorful-mode + "Preview color hexs in current buffer. +This will fontify colors strings like \"#aabbcc\" or \"blue\"." + :lighter nil + :group 'colorful-mode + (if colorful-mode + (colorful--turn-on) + (colorful--turn-off))) + +;;;###autoload +(define-globalized-minor-mode global-colorful-mode + colorful-mode colorful--turn-on + :predicate '(prog-mode text-mode) + :group 'corfu) + + +(provide 'colorful-mode) +;;; colorful-mode.el ends here