Difference between revisions of "Prelude"

From WikEmacs
Jump to: navigation, search
(anh em may cung voi xem nha)
(Basic setup)
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
New xrumer mod here. New xrumer mod here. New xrumer mod here. New xrumer mod here. New xrumer mod here. New xrumer mod here. New xrumer mod here. New xrumer mod here.
+
{{Package
 +
|name=Emacs Prelude
 +
|description=Advanced Emacs config
 +
|author=[[User:Bozhidar|Bozhidar Batsov]]
 +
|maintainer=[[User:Bozhidar|Bozhidar Batsov]]
 +
|source=https://github.com/bbatsov/prelude
 +
}}
 +
 
 +
'''Prelude''' has the goal to ease the initial Emacs setup process and to provide you with a much more powerful and productive experience than that you get out of the box. By using Emacs Prelude you're basically getting a "Get me out of the Prelude, I just want to use Emacs" card.
 +
 
 +
Emacs Prelude is compatible ONLY with GNU Emacs 24.
 +
 
 +
= Basic setup =
 +
 
 +
Assuming you're using an Unix-like OS (*BSD, GNU/Linux, OS X, Solaris, etc), you already have Emacs 24 installed, as well as git & curl you can skip the whole manual and just type in your favorite shell the following command:
 +
 
 +
<syntaxhighlight lang="bash">
 +
# curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh
 +
# You really should not be running commands from an anonymously editable wiki
 +
</syntaxhighlight>
 +
 
 +
You can now power up your Emacs, sit back and enjoy Prelude.
 +
 
 +
= Helpful keybindings =
 +
 
 +
; {{Keys|C-c f}}
 +
: Find a recently accessed file.
 +
 
 +
; {{Keys|C-c r}}
 +
: Rename file and buffer.
 +
 
 +
<!------------------------------------------------------------------------->
 +
= Common Customization =
 +
<!-- Customization common to all platforms goes here -->
 +
 
 +
You can tweak Prelude's config by adding '''.el''' files under the
 +
'''personal''' directory.  All files ending in ".el" will be read automatically when emacs starts up.
 +
 
 +
== Re-enable the arrow keys ==
 +
 
 +
Arrow keys for navigation are turned off by default.  This is to get people to use the preferred Emacs defaults. To re-enable them, add the following to a file in your personal directory:
 +
 
 +
<syntaxhighlight lang="lisp">
 +
(defun disable-guru-mode ()
 +
  (guru-mode -1)
 +
)
 +
(add-hook 'prelude-prog-mode-hook 'disable-guru-mode t)
 +
</syntaxhighlight>
 +
 
 +
== Turn off whitespace mode ==
 +
 
 +
Prelude adds a lot of functionality from whitespace mode, including line-ending markers, highlighting of long-lines, space visualization.  If you find these distracting, add the following to a file in your personal directory:
 +
 
 +
<syntaxhighlight lang="lisp">
 +
(add-hook 'prog-mode-hook 'prelude-turn-off-whitespace t)
 +
</syntaxhighlight>
 +
 
 +
== Change the default theme  ==
 +
 
 +
Emacs Prelude uses the Zenburn theme by default, but you can easily
 +
change this:
 +
 
 +
<syntaxhighlight lang="lisp">
 +
(load-theme 'solarized-dark t)
 +
</syntaxhighlight>
 +
 
 +
<!------------------------------------------------------------------------->
 +
 
 +
= [[GNU/Linux]] =
 +
<!-- Customization/Notes specific to GNU/Linux goes here -->
 +
 
 +
 
 +
<!------------------------------------------------------------------------->
 +
 
 +
= [[OS X]] =
 +
<!-- Customization/Notes specific to OS X goes here -->
 +
 
 +
 
 +
<!------------------------------------------------------------------------->
 +
 
 +
= [[Windows]] =
 +
<!-- Customization/Notes specific to Windows goes here -->
 +
Note: on Windows 7 (Enterprise),
 +
 
 +
ln -s <prelude-directory> ~/emacs.d
 +
 
 +
did not work. But copying the content of prelude directory to .emacs.d worked as expected.
 +
 
 +
Note: it also expects git to be on the system paths defined in PATH. I used git from Cygwin. It worked.
 +
 
 +
= See Also =
 +
[[Emacs Starter Kit]]
 +
 
 +
 
 +
<!------------------------------------------------------------------------->
 +
 
 +
= Project Pages =
 +
* [http://batsov.com/prelude Project Page]
 +
* [http://github.com/bbatsov/prelude GitHub]
 +
* [http://github.com/bbatsov/prelude-modules Add-ons for Prelude]
 +
 
 +
<!------------------------------------------------------------------------->
 +
 
 +
= Tutorial Pages =
 +
 
 +
<!------------------------------------------------------------------------->
 +
<!-- Add categories based on user-level (beginner etc), user-role (programming, emacs contributor etc), platform (windows, linux etc) or work flow (text editing, document authoring etc)  -->
 +
 
 +
[[Category:Beginner]][[Category:Starter Kit]]

Revision as of 06:09, 12 March 2013

Emacs Prelude
Description Advanced Emacs config
Author Bozhidar Batsov
Maintainer Bozhidar Batsov
Source https://github.com/bbatsov/prelude

Prelude has the goal to ease the initial Emacs setup process and to provide you with a much more powerful and productive experience than that you get out of the box. By using Emacs Prelude you're basically getting a "Get me out of the Prelude, I just want to use Emacs" card.

Emacs Prelude is compatible ONLY with GNU Emacs 24.

Basic setup

Assuming you're using an Unix-like OS (*BSD, GNU/Linux, OS X, Solaris, etc), you already have Emacs 24 installed, as well as git & curl you can skip the whole manual and just type in your favorite shell the following command:

# curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh
# You really should not be running commands from an anonymously editable wiki

You can now power up your Emacs, sit back and enjoy Prelude.

Helpful keybindings

[C-c f]
Find a recently accessed file.
[C-c r]
Rename file and buffer.

Common Customization

You can tweak Prelude's config by adding .el files under the personal directory. All files ending in ".el" will be read automatically when emacs starts up.

Re-enable the arrow keys

Arrow keys for navigation are turned off by default. This is to get people to use the preferred Emacs defaults. To re-enable them, add the following to a file in your personal directory:

(defun disable-guru-mode ()
  (guru-mode -1)
)
(add-hook 'prelude-prog-mode-hook 'disable-guru-mode t)

Turn off whitespace mode

Prelude adds a lot of functionality from whitespace mode, including line-ending markers, highlighting of long-lines, space visualization. If you find these distracting, add the following to a file in your personal directory:

(add-hook 'prog-mode-hook 'prelude-turn-off-whitespace t)

Change the default theme

Emacs Prelude uses the Zenburn theme by default, but you can easily change this:

(load-theme 'solarized-dark t)


GNU/Linux

OS X

Windows

Note: on Windows 7 (Enterprise),

ln -s <prelude-directory> ~/emacs.d

did not work. But copying the content of prelude directory to .emacs.d worked as expected.

Note: it also expects git to be on the system paths defined in PATH. I used git from Cygwin. It worked.

See Also

Emacs Starter Kit


Project Pages


Tutorial Pages