WikEmacs - User contributions [en]

Unicode support

2012-04-01T10:40:29Z

115.241.77.242: /* Useful Keybindings */

= Useful Keybindings =

; {{CommandKeys|C-x 8 RET|ucs-insert}}
: Use this to input a unicode charcter without resorting to any of the [[Input methods]]. For example, to insert a [http://www.fileformat.info/info/unicode/char/2603/index.htm snowman] type {{Keys|C-x 8 RET SNOWMAN RET}} or type {{Keys|C-x 8 RET 2603 RET}}.

; {{CustomizeVariable|glyphless-char-display-control}}
: Control how characters that don't have glyphs are displayed. Typically glyphless characters are rendered as rectangular boxes with hex numbers inside them.
: (From ''NEWS'' file) - "Enhanced support for characters with no glyphs in available fonts. If a character has no glyphs in any of the available fonts, Emacs normally displays it either as a hexadecimal code in a box or as a thin 1-pixel space. In addition to these two methods, Emacs can display these characters as empty box, as an acronym, or not display them at all. To change how these characters are displayed, customize the variable `glyphless-char-display-control'."

Unicode support

2012-04-01T10:36:50Z

115.241.77.242: /* Useful Keybindings */

= Useful Keybindings =

; {{CommandKeys|C-x 8 RET|ucs-insert}}
: Use this to input a unicode charcter without resorting to any of the [[Input methods]]. For example, to insert a [http://www.fileformat.info/info/unicode/char/2603/index.htm snowman] type {{Keys|C-x 8 RET SNOWMAN RET}} or type {{Keys|C-x 8 RET 2603 RET}}.

You know those empty blocks for characters when no suitable font is found?

Well Emacs 24 will show the hex code in the block. From C-h n (news):

"Enhanced support for characters with no glyphs in available fonts.
If a character has no glyphs in any of the available fonts, Emacs
normally displays it either as a hexadecimal code in a box or as a
thin 1-pixel space. In addition to these two methods, Emacs can
display these characters as empty box, as an acronym, or not display
them at all. To change how these characters are displayed, customize
the variable `glyphless-char-display-control'."

Unicode support

2012-04-01T10:36:00Z

115.241.77.242:

= Useful Keybindings =

; {{CommandKeys|C-x 8 RET|ucs-insert}}
: Use this to input a unicode charcter without resorting to any of the [[Input methods]]. For example, to insert a [http://www.fileformat.info/info/unicode/char/2603/index.htm snowman] type {{CommandKeys|C-x 8 RET SNOWMAN RET}} or type {{CommandKeys|C-x 8 RET 2603 RET}}.

You know those empty blocks for characters when no suitable font is found?

Well Emacs 24 will show the hex code in the block. From C-h n (news):

"Enhanced support for characters with no glyphs in available fonts.
If a character has no glyphs in any of the available fonts, Emacs
normally displays it either as a hexadecimal code in a box or as a
thin 1-pixel space. In addition to these two methods, Emacs can
display these characters as empty box, as an acronym, or not display
them at all. To change how these characters are displayed, customize
the variable `glyphless-char-display-control'."

Unicode support

2012-04-01T10:31:11Z

115.241.77.242:

= Useful Keybindings =

; {{CommandKeys|ucs-insert}}
: Input a unicode charcter without resorting to any of the [[Input methods]]. For example, to insert a ''snowman'' type {{CommandKeys|C-x 8 RET SNOWMAN RET}}

You know those empty blocks for characters when no suitable font is found?

Well Emacs 24 will show the hex code in the block. From C-h n (news):

"Enhanced support for characters with no glyphs in available fonts.
If a character has no glyphs in any of the available fonts, Emacs
normally displays it either as a hexadecimal code in a box or as a
thin 1-pixel space. In addition to these two methods, Emacs can
display these characters as empty box, as an acronym, or not display
them at all. To change how these characters are displayed, customize
the variable `glyphless-char-display-control'."

Appearance

2012-04-01T10:22:49Z

115.241.77.242: /* Minimal Emacs */

== Minimal Emacs ==

[[:Category:Intermediate|Intermediate users]] might prefer to turn off or customize [[Toolbar]], [[Menubar]] and [[Scrollbar]]. This provides a distraction free environment and maximizes the screen area available for coding or text editing.

; {{CustomizeVariable|tool-bar-mode}}
: Turn off toolbar

; {{CustomizeVariable|menu-bar-mode}}
: Turn off menubar

; {{CustomizeVariable|menu-bar-mode}}
: Turn off scrollbar.

; {{CustomizeVariable|blink-cursor-mode}}
: Also see {{CustomizeGroup|Cursor}}

== Adding and changing key bindings ==

== CUA mode ==

== Line wrapping ==

== Region, selection, transient-mark-mode ==

== Themes ==

=== Basics ===

An Emacs theme is basically a set of [[Emacs Terminology#Faces | faces]]. Emacs has a predefined set of core faces for basic things like comments, keywords, etc and by modifying those you can significantly alter the appearance of Emacs. Many modes add faces of their own as well. Prior to Emacs 24 the most popular way to incorporate custom color themes into Emacs was the [http://www.emacswiki.org/emacs/ColorTheme color-theme package]. While it usually got the job done it had some problems that we won’t be discussing here and more importantly - it’s a third-party package, that’s not part of Emacs proper. Emacs 24 comes with a selection of built-in themes that you can choose from, so you’re no longer bound to the default theme (which many find quite ugly). To choose a new theme just do a <tt>M-x load-theme</tt> (tab completion is available for the names of the available themes). At this point you can give the command a try with the <tt>tango</tt> theme. If you like a theme so much that you’d want to use it all the time you can put in your Emacs configuration (<tt>.emacs</tt> or <tt>init.el</tt> for instance) like this:

<pre>(load-theme 'theme-name t)</pre>

If you’d like to return to the default-theme just do a <tt>M-x disable-theme</tt>.

=== Create Custom Themes ===

[http://batsov.com/articles/2011/08/19/a-peek-at-emacs24/ Emacs 24] finally introduced a new standard way of dealing with color themes (based on Emacs’s built-in [[Custom|customize]] facility). While it doesn’t have a proper name (as far as I know) it’s commonly referred to as the <tt>deftheme</tt> facility, since <tt>deftheme</tt> is the name of the macro you’d use to create such a theme. ( <tt>deftheme</tt> has actually been around since Emacs 23, but it was heavily improved in Emacs 24 )

How do you create a <tt>deftheme</tt> theme? Quite simply actually - just do a “M-x customize-create-theme”. You’ll be presented with an UI prompting you for a theme name, description and faces. After you save the theme a file called <tt>name-theme.el</tt> will be written on your filesystem. Here’s its skeleton:

<syntaxhighlight lang="lisp">
(deftheme demo
"Demo theme")

(custom-theme-set-faces
'demo
;;; list of custom faces
)

(provide-theme 'demo)
</syntaxhighlight>

There was also an online theme generator [http://elpa.gnu.org/themes/ here], but it seems to be down at the moment.

If dislike customize, you can just have a look at the source code of the built-in tango (or any other) theme and use it as a reference.

Once you’ve created the new theme you’ll have to drop it in a folder that’s on the <tt>custom-theme-load-path</tt>. I’d suggest the following:

<pre class="lisp">(add-to-list 'custom-theme-load-path "~/.emacs.d/themes")</pre>
If you’re an [https://github.com/bbatsov/emacs-prelude Emacs Prelude] user you’re already covered. This folder exists and is automatically added to <tt>custom-theme-load-path</tt> by Prelude, so all you have to do is drop there the themes you’d want to try out.

You may find the [http://julien.danjou.info/software/rainbow-mode rainbow-mode] useful when developing color themes. If fontifies strings that represent color codes according to those colors. The mode is known to be a great addition to css-mode, but I find it very helpful with color theme development as well. It’s also included (and enabled) in Prelude by default.

The Emacs package manager <tt>package.el</tt> (formerly known as ELPA) is gaining a lot of popularity lately and the community [http://marmalade-repo.org/ Marmalade] repository already houses a few Emacs 24 themes that you can install from there. If you’re developing a theme that you’d like to submit to Marmalade it’s imperative that the theme modifies the <tt>custom-theme-load-path</tt> in an <tt>autoload</tt> - otherwise it won’t be of much use. Add the following snippet (or something similar) before the <tt>provide-theme</tt> line if your custom theme:

<syntaxhighlight lang="lisp">
;;;###autoload
(when load-file-name
(add-to-list 'custom-theme-load-path
(file-name-as-directory (file-name-directory load-file-name))))
</syntaxhighlight>
I’d also advise you follow the proper naming convention <tt>name-theme.el</tt> so that it’s apparent that your theme is <tt>deftheme</tt> compatible.

Oh, and one more thing - porting themes from color-theme to deftheme is really simple (just have a look at the old and the new version of Zenburn in its repo), so you should really consider porting all the themes you maintain to <tt>deftheme</tt>.

=== Existing Color Themes ===

* Zenburn
* Solarized

[[Category:Beginner]][[Category:Customize Emacs]]

Appearance

2012-04-01T10:21:52Z

115.241.77.242:

== Minimal Emacs ==

[[:Category:Intermediate|Intermediate users]] might prefer to turn off or customize [[Toolbar]], [[Menubar]] and [[Scrollbar]].

; {{CustomizeVariable|tool-bar-mode}}
: Turn off toolbar

; {{CustomizeVariable|menu-bar-mode}}
: Turn off menubar

; {{CustomizeVariable|menu-bar-mode}}
: Turn off scrollbar.

; {{CustomizeVariable|blink-cursor-mode}}
: Also see {{CustomizeGroup|Cursor}}

== Adding and changing key bindings ==

== CUA mode ==

== Line wrapping ==

== Region, selection, transient-mark-mode ==

== Themes ==

=== Basics ===

An Emacs theme is basically a set of [[Emacs Terminology#Faces | faces]]. Emacs has a predefined set of core faces for basic things like comments, keywords, etc and by modifying those you can significantly alter the appearance of Emacs. Many modes add faces of their own as well. Prior to Emacs 24 the most popular way to incorporate custom color themes into Emacs was the [http://www.emacswiki.org/emacs/ColorTheme color-theme package]. While it usually got the job done it had some problems that we won’t be discussing here and more importantly - it’s a third-party package, that’s not part of Emacs proper. Emacs 24 comes with a selection of built-in themes that you can choose from, so you’re no longer bound to the default theme (which many find quite ugly). To choose a new theme just do a <tt>M-x load-theme</tt> (tab completion is available for the names of the available themes). At this point you can give the command a try with the <tt>tango</tt> theme. If you like a theme so much that you’d want to use it all the time you can put in your Emacs configuration (<tt>.emacs</tt> or <tt>init.el</tt> for instance) like this:

<pre>(load-theme 'theme-name t)</pre>

If you’d like to return to the default-theme just do a <tt>M-x disable-theme</tt>.

=== Create Custom Themes ===

[http://batsov.com/articles/2011/08/19/a-peek-at-emacs24/ Emacs 24] finally introduced a new standard way of dealing with color themes (based on Emacs’s built-in [[Custom|customize]] facility). While it doesn’t have a proper name (as far as I know) it’s commonly referred to as the <tt>deftheme</tt> facility, since <tt>deftheme</tt> is the name of the macro you’d use to create such a theme. ( <tt>deftheme</tt> has actually been around since Emacs 23, but it was heavily improved in Emacs 24 )

How do you create a <tt>deftheme</tt> theme? Quite simply actually - just do a “M-x customize-create-theme”. You’ll be presented with an UI prompting you for a theme name, description and faces. After you save the theme a file called <tt>name-theme.el</tt> will be written on your filesystem. Here’s its skeleton:

<syntaxhighlight lang="lisp">
(deftheme demo
"Demo theme")

(custom-theme-set-faces
'demo
;;; list of custom faces
)

(provide-theme 'demo)
</syntaxhighlight>

There was also an online theme generator [http://elpa.gnu.org/themes/ here], but it seems to be down at the moment.

If dislike customize, you can just have a look at the source code of the built-in tango (or any other) theme and use it as a reference.

Once you’ve created the new theme you’ll have to drop it in a folder that’s on the <tt>custom-theme-load-path</tt>. I’d suggest the following:

<pre class="lisp">(add-to-list 'custom-theme-load-path "~/.emacs.d/themes")</pre>
If you’re an [https://github.com/bbatsov/emacs-prelude Emacs Prelude] user you’re already covered. This folder exists and is automatically added to <tt>custom-theme-load-path</tt> by Prelude, so all you have to do is drop there the themes you’d want to try out.

You may find the [http://julien.danjou.info/software/rainbow-mode rainbow-mode] useful when developing color themes. If fontifies strings that represent color codes according to those colors. The mode is known to be a great addition to css-mode, but I find it very helpful with color theme development as well. It’s also included (and enabled) in Prelude by default.

The Emacs package manager <tt>package.el</tt> (formerly known as ELPA) is gaining a lot of popularity lately and the community [http://marmalade-repo.org/ Marmalade] repository already houses a few Emacs 24 themes that you can install from there. If you’re developing a theme that you’d like to submit to Marmalade it’s imperative that the theme modifies the <tt>custom-theme-load-path</tt> in an <tt>autoload</tt> - otherwise it won’t be of much use. Add the following snippet (or something similar) before the <tt>provide-theme</tt> line if your custom theme:

<syntaxhighlight lang="lisp">
;;;###autoload
(when load-file-name
(add-to-list 'custom-theme-load-path
(file-name-as-directory (file-name-directory load-file-name))))
</syntaxhighlight>
I’d also advise you follow the proper naming convention <tt>name-theme.el</tt> so that it’s apparent that your theme is <tt>deftheme</tt> compatible.

Oh, and one more thing - porting themes from color-theme to deftheme is really simple (just have a look at the old and the new version of Zenburn in its repo), so you should really consider porting all the themes you maintain to <tt>deftheme</tt>.

=== Existing Color Themes ===

* Zenburn
* Solarized

[[Category:Beginner]][[Category:Customize Emacs]]

Input methods

2012-04-01T10:05:06Z

115.241.77.242: /* Accented characters */

'''Input Methods''' allow you to enter characters that are not supported by your keyboard.

= Helpful keybindings =

; {{CommandKeys|C-x C-m C-\|set-input-method}}
: Switch to a new input method.

; {{CommandKeys|C-h C-\|describe-input-method}}
: Tells you how to enter a particular character for the current input mehtod.

; {{CommandKeys|C-\|toggle-input-method}}
: Switch to your default input method.

= TeX input method =

; {{Keys|C-x C-m C-\ TeX}}
: To type greek character λ, enter \lambda.

= Accented characters =

; {{Keys|C-x C-m C-\ latin-1-prefix RET}}
: Use this method to input accented characters. When you type `" u' you get `ü'. Another You method is to {{PrefixKeys|C-x 8}}.

= [[GNU/Linux]] =
= [[OS X]] =
= [[Windows]] =
= [[Emacs-24]] =
= [[Emacs-23]] =
= Recommended Reading =
= Project Pages =
= Tutorial Pages =

[[Category:Mule]]

Input methods

2012-04-01T10:04:42Z

115.241.77.242: /* TeX input method */

'''Input Methods''' allow you to enter characters that are not supported by your keyboard.

= Helpful keybindings =

; {{CommandKeys|C-x C-m C-\|set-input-method}}
: Switch to a new input method.

; {{CommandKeys|C-h C-\|describe-input-method}}
: Tells you how to enter a particular character for the current input mehtod.

; {{CommandKeys|C-\|toggle-input-method}}
: Switch to your default input method.

= TeX input method =

; {{Keys|C-x C-m C-\ TeX}}
: To type greek character λ, enter \lambda.

= Accented characters =

; {{CommandKeys|C-x C-m C-\ latin-1-prefix}}
: Use this method to input accented characters. When you type `" u' you get `ü'. Another You method is to {{PrefixKeys|C-x 8}}.

= [[GNU/Linux]] =
= [[OS X]] =
= [[Windows]] =
= [[Emacs-24]] =
= [[Emacs-23]] =
= Recommended Reading =
= Project Pages =
= Tutorial Pages =

[[Category:Mule]]

Input methods

2012-04-01T10:04:15Z

115.241.77.242: /* Helpful keybindings */

'''Input Methods''' allow you to enter characters that are not supported by your keyboard.

= Helpful keybindings =

; {{CommandKeys|C-x C-m C-\|set-input-method}}
: Switch to a new input method.

; {{CommandKeys|C-h C-\|describe-input-method}}
: Tells you how to enter a particular character for the current input mehtod.

; {{CommandKeys|C-\|toggle-input-method}}
: Switch to your default input method.

= TeX input method =

; {{CommandKeys|C-x C-m C-\ TeX}}
: To type greek character λ type \lambda.

= Accented characters =

; {{CommandKeys|C-x C-m C-\ latin-1-prefix}}
: Use this method to input accented characters. When you type `" u' you get `ü'. Another You method is to {{PrefixKeys|C-x 8}}.

= [[GNU/Linux]] =
= [[OS X]] =
= [[Windows]] =
= [[Emacs-24]] =
= [[Emacs-23]] =
= Recommended Reading =
= Project Pages =
= Tutorial Pages =

[[Category:Mule]]

Input methods

2012-04-01T10:03:18Z

115.241.77.242:

'''Input Methods''' allow you to enter characters that are not supported by your keyboard.

= Helpful keybindings =

; {{CommandKeys|C-x C-m C-\|set-input-method}}
: Switch to a new input method.

; {{CommandKeys|C-h C-\|describe-input-method}}
: Tells you how to enter a particular character for the current input mehtod.

; {{CommandKeys|C-\}}
: Switch to your default input method.

= TeX input method =

; {{CommandKeys|C-x C-m C-\ TeX}}
: To type greek character λ type \lambda.

= Accented characters =

; {{CommandKeys|C-x C-m C-\ latin-1-prefix}}
: Use this method to input accented characters. When you type `" u' you get `ü'. Another You method is to {{PrefixKeys|C-x 8}}.

= [[GNU/Linux]] =
= [[OS X]] =
= [[Windows]] =
= [[Emacs-24]] =
= [[Emacs-23]] =
= Recommended Reading =
= Project Pages =
= Tutorial Pages =

[[Category:Mule]]

Template:PrefixKeys

2012-04-01T09:46:29Z

115.241.77.242: Created page with "<includeonly><span title="{{{2|Try `{{{1}}} C-h' for more information.}}}" style="border-bottom:1px dotted">'''[{{{1}}}]'''</span></includeonly><noinclude> == Usage == Show a..."

<includeonly><span title="{{{2|Try `{{{1}}} C-h' for more information.}}}" style="border-bottom:1px dotted">'''[{{{1}}}]'''</span></includeonly><noinclude>

== Usage ==
Show a prefix key, with an optional tool tip for the associated functionality.

<pre>{{PrefixKeys|C-x 4}}</pre> will be rendered as: {{PrefixKeys|C-x 4}}

<pre>{{PrefixKeys|C-x r|Work with registers and bookmarks}}</pre> will be rendered as: {{Keys|C-x C-x|Work with registers and bookmarks}}

[[Category:Emacs Wiki Templates]]
</noinclude>

Input methods

2012-04-01T09:39:22Z

115.241.77.242:

Input Methods allow you to enter characters that are not supported by your keyboard.

* 'C-x C-m C-\' or `M-x set-input-method' or switch to a new input method.
* 'C-h C-\' or `C-h I' to describe the current input method.
* 'C-\' to toggle the input method on and off

Possibly the most convenient casual method for inputting unicode characters
is the TeXInputMethod, which permits you to enter Unicode characters by typing a
\ prefixed sequence reminiscent of TeX. For example, the greek character λ
may be entered by typing \lambda.

You can use `latin-1-prefix' to input accented characters. So that you can type `" u' to achieve `ü', for example. You can also {{PrefixKeys|C-x 8}} to input accented characters.

Another way is to use QuotedInsert with `C-q'.

To activate the input method for a specific mode put the following line in your config file:

(add-hook 'text-mode-hook 'toggle-input-method)

The input method is then automaticaly activated for files
which open in text mode.

To activate the input method on a per-buffer basis.
First put the following lines in the .emacs:

(set input-activate nil)
(add-hook 'find-file-hook
(lambda ()(if (eq input-activate t) (toggle-input-method))))

Then put the following line at the beginning of a file:

-*- input-activate: t -*-

The input method will be activated for this file as soon as it is loaded.

These are some additional input methods that do not come with Emacs:
* Georgian (a bit different than the one that comes with Emacs): Lisp:georgian.el
* Armenian: Lisp:armenian.el
* Neo-Akkadian Cuneiform: Lisp:akkadian.el
* Glagolitic: Lisp:glagolitic.el
* Coptic: Lisp:coptic.el

It's convenient for people who speak in korean or japanese or etc... to use only the internal emacs input method ([[mule]]) without scim, nabi, Microsoft IME, etc...

'''See Also:''' ChangingCursorDynamically to automatically change the TextCursor color when you are using an input method. This makes it easy to tell if an input method is in use.

[[Category:Mule]]

Input methods

2012-04-01T09:38:01Z

115.241.77.242: Created page with "Input Methods allow you to enter characters that are not supported by your keyboard. * 'C-x C-m C-\' or `M-x set-input-method' or switch to a new input method. * 'C-h C-\' or..."

Input Methods allow you to enter characters that are not supported by your keyboard.

* 'C-x C-m C-\' or `M-x set-input-method' or switch to a new input method.
* 'C-h C-\' or `C-h I' to describe the current input method.
* 'C-\' to toggle the input method on and off

Possibly the most convenient casual method for inputting unicode characters
is the TeXInputMethod, which permits you to enter Unicode characters by typing a
\ prefixed sequence reminiscent of TeX. For example, the greek character λ
may be entered by typing \lambda.

You can use `latin-1-prefix' to input accented characters. So that you can type `" u' to achieve `ü', for example. You can also {{Prefix|C-x 8}} to input accented characters.

Another way is to use QuotedInsert with `C-q'.

To activate the input method for a specific mode put the following line in your config file:

(add-hook 'text-mode-hook 'toggle-input-method)

The input method is then automaticaly activated for files
which open in text mode.

To activate the input method on a per-buffer basis.
First put the following lines in the .emacs:

(set input-activate nil)
(add-hook 'find-file-hook
(lambda ()(if (eq input-activate t) (toggle-input-method))))

Then put the following line at the beginning of a file:

-*- input-activate: t -*-

The input method will be activated for this file as soon as it is loaded.

These are some additional input methods that do not come with Emacs:
* Georgian (a bit different than the one that comes with Emacs): Lisp:georgian.el
* Armenian: Lisp:armenian.el
* Neo-Akkadian Cuneiform: Lisp:akkadian.el
* Glagolitic: Lisp:glagolitic.el
* Coptic: Lisp:coptic.el

It's convenient for people who speak in korean or japanese or etc... to use only the internal emacs input method ([[mule]]) without scim, nabi, Microsoft IME, etc...

'''See Also:''' ChangingCursorDynamically to automatically change the TextCursor color when you are using an input method. This makes it easy to tell if an input method is in use.

[[Category:Mule]]