[DOCS] Keep index.md to 80 char lines and a couple of minor edits
This commit is contained in:
parent
36b3950d7d
commit
3f5e83d0e9
1 changed files with 63 additions and 30 deletions
93
doc/index.md
93
doc/index.md
|
@ -31,26 +31,45 @@ You can support the development of Prelude via
|
||||||
|
|
||||||
Here are some of the essential 3rd party packages that Prelude adds to Emacs:
|
Here are some of the essential 3rd party packages that Prelude adds to Emacs:
|
||||||
|
|
||||||
* [ace-window](https://github.com/abo-abo/ace-window) (effective navigation between multiple windows)
|
* [ace-window](https://github.com/abo-abo/ace-window)
|
||||||
* [avy](https://github.com/abo-abo/avy) (effective navigation)
|
(effective navigation between multiple windows)
|
||||||
* [crux](https://github.com/bbatsov/crux) (lots of useful editing commands)
|
* [avy](https://github.com/abo-abo/avy)
|
||||||
* [diff-hl](https://github.com/dgutov/diff-hl) (shows colorful diff markers in the gutter when you're editing files under version control)
|
(effective navigation)
|
||||||
|
* [crux](https://github.com/bbatsov/crux)
|
||||||
|
(lots of useful editing commands)
|
||||||
|
* [diff-hl](https://github.com/dgutov/diff-hl)
|
||||||
|
(shows colorful diff markers in the gutter when you're editing files
|
||||||
|
under version control)
|
||||||
* [easy-kill](https://github.com/leoliu/easy-kill)
|
* [easy-kill](https://github.com/leoliu/easy-kill)
|
||||||
* [editorconfig-mode](https://github.com/editorconfig/editorconfig-emacs) (teaches Emacs to respect [.editorconfig](https://editorconfig.org/))
|
* [editorconfig-mode](https://github.com/editorconfig/editorconfig-emacs)
|
||||||
|
(teaches Emacs to respect [.editorconfig](https://editorconfig.org/))
|
||||||
* [expand-region](https://github.com/magnars/expand-region.el)
|
* [expand-region](https://github.com/magnars/expand-region.el)
|
||||||
* [flycheck](https://www.flycheck.org/) (modern integration with many lint tools)
|
* [flycheck](https://www.flycheck.org/)
|
||||||
* [guru-mode](https://github.com/bbatsov/guru-mode) (an Emacs guru that helps you learn basic Emacs keybindings)
|
(modern integration with many lint tools)
|
||||||
* [projectile](https://github.com/bbatsov/projectile) (powerful project navigation/interaction package)
|
* [guru-mode](https://github.com/bbatsov/guru-mode)
|
||||||
* [magit](https://magit.vc/) (the best git client in the known universe)
|
(an Emacs guru that helps you learn basic Emacs keybindings)
|
||||||
* [git-timemachine](https://gitlab.com/pidu/git-timemachine) (navigate quickly through different versions of one file)
|
* [projectile](https://github.com/bbatsov/projectile)
|
||||||
* `nlinum` (line numbers in your buffers)
|
(powerful project navigation/interaction package)
|
||||||
* [smartparens](https://github.com/Fuco1/smartparens) (powerful package for dealing with expressions and matched delimiters in programming languages)
|
* [magit](https://magit.vc/)
|
||||||
* [super-save](https://github.com/bbatsov/super-save) (auto-save buffers when moving around)
|
(the best git client in the known universe)
|
||||||
* [which-key](https://github.com/justbur/emacs-which-key) (shows you possible keybindings when you type a partial keybinding)
|
* [git-timemachine](https://gitlab.com/pidu/git-timemachine)
|
||||||
* [zenburn-theme](https://github.com/bbatsov/zenburn-emacs) (Prelude's default color theme)
|
(navigate quickly through different versions of one file)
|
||||||
* [undo-tree](https://elpa.gnu.org/packages/undo-tree.html) (A powerful way to navigate your editing history)
|
* `nlinum`
|
||||||
|
(line numbers in your buffers)
|
||||||
|
* [smartparens](https://github.com/Fuco1/smartparens)
|
||||||
|
(powerful package for dealing with expressions and matched
|
||||||
|
delimiters in programming languages)
|
||||||
|
* [super-save](https://github.com/bbatsov/super-save)
|
||||||
|
(auto-save buffers when moving around)
|
||||||
|
* [which-key](https://github.com/justbur/emacs-which-key)
|
||||||
|
(shows you possible keybindings when you type a partial keybinding)
|
||||||
|
* [zenburn-theme](https://github.com/bbatsov/zenburn-emacs)
|
||||||
|
(Prelude's default color theme)
|
||||||
|
* [undo-tree](https://elpa.gnu.org/packages/undo-tree.html)
|
||||||
|
(A powerful way to navigate your editing history)
|
||||||
|
|
||||||
On top of this Prelude bundles a bunch of smaller packages and makes many more packages available via optional modules.
|
On top of this Prelude bundles a bunch of smaller packages and makes
|
||||||
|
many more packages available via optional modules.
|
||||||
|
|
||||||
## Programming Languages Support
|
## Programming Languages Support
|
||||||
|
|
||||||
|
@ -88,7 +107,9 @@ The following programming languages have enhanced support in Prelude:
|
||||||
- XML
|
- XML
|
||||||
- YAML
|
- YAML
|
||||||
|
|
||||||
On top of this - basic support for many other programming languages will be auto-installed when needed (e.g. the first time you open a source file for some language).
|
On top of this - basic support for many other programming languages
|
||||||
|
will be auto-installed when needed (e.g. the first time you open a
|
||||||
|
source file for some language).
|
||||||
|
|
||||||
## Philosophy
|
## Philosophy
|
||||||
|
|
||||||
|
@ -99,21 +120,33 @@ Prelude's philosophy is quite simple:
|
||||||
* stable
|
* stable
|
||||||
* a foundation for you to build upon, as opposed to some end-user product
|
* a foundation for you to build upon, as opposed to some end-user product
|
||||||
|
|
||||||
This means that it intentionally doesn't pack all the bells and whistles that it could.
|
This means that it intentionally doesn't pack all the bells and
|
||||||
Prelude aims to enhance the classic Emacs experience without deviating a lot from it - e.g.
|
whistles that it could. Prelude aims to enhance the classic Emacs
|
||||||
it would never enable something like `evil-mode` (vim keybindings) by default and so on.
|
experience without deviating a lot from it - e.g. it would never
|
||||||
|
enable something like `evil-mode` (vim keybindings) by default and so
|
||||||
|
on.
|
||||||
|
|
||||||
All the third-party packages that it bundles are carefully vetted and are known to be of
|
All the third-party packages that it bundles are carefully vetted and
|
||||||
good quality and to have reliable maintainers. That generally means that Prelude's unlikely
|
are known to be of good quality and to have reliable maintainers. That
|
||||||
to immediate adopt some shiny new package, that has established tried and true alternatives.
|
generally means that Prelude's unlikely to immediately adopt some
|
||||||
|
shiny new package, that has established tried and true alternatives.
|
||||||
|
|
||||||
In practice this translates to the following:
|
In practice this translates to the following:
|
||||||
|
|
||||||
* Prelude is less opinionated than distros like Spacemacs and Doom Emacs (meaning it's closer to the standard Emacs experience)
|
* Prelude is less opinionated than distros like Spacemacs and Doom
|
||||||
|
Emacs (meaning it's closer to the standard Emacs experience)
|
||||||
* Prelude installs relatively few additional packages by default
|
* Prelude installs relatively few additional packages by default
|
||||||
* Most modules in Prelude are opt-in instead of opt-out (you'll notice the default config enables only a handful of modules)
|
* Most modules in Prelude are opt-in instead of opt-out (you'll notice
|
||||||
* Most modules (e.g. modules for programming languages) are pretty short and feature setup only for essential packages (in some cases that be just the major mode for the language in question)
|
the default config enables only a handful of modules)
|
||||||
* You don't really need to track Prelude's upstream - you're encouraged to just fork it and use it as the basis for your own configuration.
|
* Most modules (for example, modules for programming languages) are
|
||||||
|
pretty short and feature setup only for essential packages (in some
|
||||||
|
cases that would be just the major mode for the language in
|
||||||
|
question)
|
||||||
|
* You don't really need to track Prelude's upstream - you're
|
||||||
|
encouraged to just fork it and use it as the basis for your own
|
||||||
|
configuration.
|
||||||
|
|
||||||
Remember that the ultimate goal of every Emacs user is to create an Emacs setup that reflects their own experience, needs, goals and ideas. Just like Lisp,
|
Remember that the ultimate goal of every Emacs user is to create an
|
||||||
Emacs is nothing but a raw building material for the perfect editing experience.
|
Emacs setup that reflects their own experience, needs, goals and
|
||||||
|
ideas. Just like Lisp, Emacs is nothing but a raw building material
|
||||||
|
for the perfect editing experience.
|
||||||
|
|
Loading…
Reference in a new issue