aa4b6e6861
This will allow people using spacemacs-base to have finer control over what additional packages they install on top of base. The proposed split is as follows spacemacs-editing: - aggressive-indent - avy - bracketed-paste - clean-aindent-mode - eval-sexp-fu - expand-region - hexl - hungry-delete - iedit - lorem-ipsum - move-text - neotree - pcre2el - smartparens spacemacs-editing-visual-packages: - adaptive-wrap - auto-highlight-symbol - highlight-indentation - highlight-numbers - highlight-parentheses - hl-anything - indent-guide - linum-relative - rainbow-delimiters - volatile-highlights spacemacs-evil-packages: - evil-anzu - evil-args - evil-exchange - evil-iedit-state - evil-indent-plus - evil-jumper - evil-lisp-state - evil-mc - evil-nerd-commenter - evil-matchit - evil-numbers - evil-search-highlight-persist - evil-terminal-cursor-changer - evil-tutor - evil-unimpaired spacemacs-language-packages: - define-word - google-translate spacemacs-ui-packages: - ace-link - ace-window - buffer-move - centered-cursor - desktop - doc-view - flx-ido - info+ - open-junk-file - window-numbering spacemacs-ui-visual-packages: - fancy-battery - golden-ratio - leuven-theme - neotree - smooth-scrolling - spaceline - vi-tilde-fringe - zoom-frm
104 lines
3.8 KiB
Markdown
104 lines
3.8 KiB
Markdown
Paradox
|
|
=======
|
|
|
|
Project for modernizing Emacs' Package Menu. With package ratings,
|
|
usage statistics, customizability, and more.
|
|
|
|
Here are some visual comparisons:
|
|
|
|
#### Regular Package Menu ####
|
|
![Regular Package Menu](https://raw.github.com/Bruce-Connor/paradox/master/before.png)
|
|
|
|
#### Paradox ####
|
|
![Paradox Package Menu](https://raw.github.com/Bruce-Connor/paradox/master/after.png)
|
|
|
|
#### Paradox (multi-line) ####
|
|
![Paradox Package Menu](https://raw.github.com/Bruce-Connor/paradox/master/multi-line.png)
|
|
*These screenshots use smart-mode-line, but a similar effect is obtained with the regular mode-line.*
|
|
|
|
Usage
|
|
===
|
|
|
|
Paradox can be installed from Melpa with `M-x package-install RET
|
|
paradox`.
|
|
It can also be installed manually in the usual way, just be mindful of
|
|
the dependencies.
|
|
|
|
To use it, simply call `M-x paradox-list-packages` (instead of the
|
|
regular `list-packages`).
|
|
This will give you most features out of the box. If you want to be
|
|
able to star packages as well, just configure the
|
|
`paradox-github-token` variable then call `paradox-list-packages`
|
|
again.
|
|
|
|
If you'd like to stop using Paradox, you may call `paradox-disable`
|
|
and go back to using the regular `list-packages`.
|
|
|
|
## Current Features ##
|
|
|
|
### Several Improvements ###
|
|
|
|
Paradox implements many small improvements to the package menu
|
|
itself. They all work out of the box and are completely customizable!
|
|
*(Also, hit `h` to see all keys.)*
|
|
|
|
* Visit the package's homepage with `v` (or just use the provided buttons).
|
|
* View a list of recent commits with `l`.
|
|
* Use `paradox-require` instead of `require` to automatically install
|
|
absent packages.
|
|
* Shortcuts for package filtering:
|
|
* `f r` filters by regexp (`occur`);
|
|
* `f u` display only packages with upgrades;
|
|
* `f k` filters by keyword (emacs 24.4 only).
|
|
|
|
And some more...
|
|
* `hl-line-mode` enabled by default.
|
|
* Display useful information on the mode-line and cleanup a bunch of
|
|
useless stuff.
|
|
* **Customization!** Just call `M-x paradox-customize` to see what you can
|
|
do.
|
|
* Customize column widths.
|
|
* Customize faces (`paradox-star-face`,
|
|
`paradox-status-face-alist` and `paradox-archive-face`).
|
|
* Customize local variables.
|
|
|
|
|
|
### Package Ratings ###
|
|
|
|
Paradox also integrates with
|
|
**GitHub Stars**, which works as **rough** package rating system.
|
|
That is, Paradox package menu will:
|
|
|
|
1. Display the number of GitHub Stars each package has (assuming it's
|
|
in a github repo, of course);
|
|
2. Possibly automatically star packages you install, and unstar
|
|
packages you delete (you will be asked the first time whether you
|
|
want this);
|
|
3. Let you star and unstar packages by hitting the `s` key;
|
|
4. Let you star all packages you have installed with `M-x paradox-star-all-installed-packages`.
|
|
|
|
Item **1.** will work out of the box, the other items obviously
|
|
require a github account (Paradox will help you generate a token the
|
|
first time you call `paradox-list-packages`).
|
|
|
|
## Known Bugs ##
|
|
|
|
* On some cases there's an annoying gnutls error message after downloading the star counts `gnutls.c: [0] (Emacs) fatal error: The TLS connection was non-properly terminated.`.
|
|
If anyone knows how to fix it, I'm all ears.
|
|
|
|
## How Star Displaying Works ##
|
|
|
|
We generate a map of `Package Name -> Repository` from
|
|
[Melpa](https://github.com/milkypostman/melpa.git)'s `recipe`
|
|
directory, some repos may correspond to more than one package.
|
|
This map is used count the stars a given package has.
|
|
_This doesn't mean you need Melpa to see the star counts, the numbers
|
|
will be displayed regardless of what archives you use._
|
|
|
|
Currently, packages that are not hosted on GitHub are listed with a
|
|
blank star count, which is clearly different from 0-star packages
|
|
(which are displayed with a 0, obviously).
|
|
If you know of an alternative that could be used for these packages,
|
|
[open an issue](https://github.com/Bruce-Connor/paradox/issues/new)
|
|
here, I'd love to hear.
|