https://wikemacs.org/api.php?action=feedcontributions&user=Drothlis&feedformat=atomWikEmacs - User contributions [en]2024-03-19T10:55:59ZUser contributionsMediaWiki 1.35.14https://wikemacs.org/index.php?title=Tutorial&diff=2815Tutorial2012-05-04T17:07:14Z<p>Drothlis: Added link to my "How to learn Emacs" guide.</p>
<hr />
<div>== Tutorial for using Emacs ==<br />
<br />
The absolute mandatory way to begin learning Emacs to is to use the built-in tutorial.<br />
<br />
* You can {{Keys|C-h t}}, meaning hold the Control key and press 'h' at same time, then release them and press 't', which will launch the tutorial.<br />
<br />
[http://david.rothlis.net/emacs/howtolearn.html How to learn Emacs] is a guide that teaches Emacs using the built-in help and the elisp source code.<br />
<br />
== Tutorial for Emacs Lisp ==<br />
<br />
Emacs as [[lisp]] machine, most of its function is implement by [[Emacs lisp]], and you customize Emacs with [[elisp]]. Learning elisp, at least understand its syntax, can be very useful. there is a official tutorial for elisp.<br />
<br />
* you can (c-h i m Emacs Lisp Intro <enter>) to begin the tutorial.<br />
<br />
[[Category:Tutorial]]</div>Drothlishttps://wikemacs.org/index.php?title=Key_Bindings&diff=2814Key Bindings2012-05-04T16:57:00Z<p>Drothlis: "Super" is the Command ⌘ key on OS X</p>
<hr />
<div>In Emacs, almost any keystroke, optionally combined with one or more modifier keys, or any sequence of such keystrokes, can be "bound" to any [[command]].<br />
<br />
== Modifier keys naming convention ==<br />
<br />
{| class="wikitable"<br />
|-<br />
! Modifier key<br />
! Abbr.<br />
! Remarks<br />
! Example<br />
! Action<br />
|-<br />
| Alt<br />
| A<br />
| Relatively seldom used in Emacs, because Meta is often "logically" mapped to the "physical" <tt>Alt</tt> key.<br />
| A-x<br />
| Type "x" while holding down the (non-Meta) Alt key<br />
|-<br />
| Control<br />
| C<br />
| <br />
| C-x C-f<br />
| While holding down Ctrl, type first "x" then "f". (This runs the command <tt>find-file</tt>).<br />
|-<br />
| Hyper<br />
| h<br />
| Often not mapped to any key (by default).<br />
| h-x<br />
| Type "x" while holding down hyper<br />
|-<br />
| Meta<br />
| M<br />
| Often mapped to <tt>Alt</tt> on your keyboard<br />
| M-x find-file RET<br />
| Either:<br />
* type "x" while holding down Meta, or<br />
* type "Esc" then "x"<br />
(M-x activates the [[minibuffer]])<br />
<br />
Then type "find-file" in the minibuffer, then Return.<br />
|-<br />
| Shift<br />
| S<br />
| <br />
| S-x<br />
| Type "x" while holding down Shift<br />
|-<br />
| Super<br />
| s<br />
| Os OS X this is the Command ⌘ key.<br />
On other systems often not mapped to any key by default, or to <tt>Window</tt> or <tt>Menu</tt> if present<br />
| s-x<br />
| Type "x" while holding down super<br />
|-<br />
|}<br />
<br />
By convention, when multiple modifiers are specified, they go in alphabetical order: {{Keys|C-M-x}} not {{Keys|M-C-x}}.<br />
<br />
== Printable cheat sheet for popular modes ==<br />
Emacs ships with cheat sheets of common and useful key bindings.<br />
The {{File|pdf}} files are located in the {{Directory|refcards}} subdirectory of {{Variable|data-directory}}.<br />
<br />
== Change key bindings ==<br />
You can add, remove and change key bindings for any command. <br />
<br />
; {{Command|global-set-key}} or {{Command|local-set-key}}<br />
: Hit the key sequence you want to bind<br />
: Type the command to bind to that key sequence<br />
: Invoke {{Keys|C-x ESC ESC|repeat-complex-command}}. The output you see is the full lisp command which does the binding. You can copy this to your {{EmacsConfigFile}}.<br />
<br />
== External Links ==<br />
<br />
* [http://www.masteringemacs.org/articles/2011/02/08/mastering-key-bindings-emacs/ Mastering Keybindings in Emacs]<br />
<br />
[[Category:Customization]]<br />
[[Category:Key Concepts]]</div>Drothlishttps://wikemacs.org/index.php?title=WikEmacs:Guidelines&diff=2813WikEmacs:Guidelines2012-05-04T16:54:13Z<p>Drothlis: Fix table formatting</p>
<hr />
<div>'''How can we maintain and improve quality of this Wiki?'''<br />
* Stick to Emacs-24 and Emacs-23.<br />
* Keep things short and sweet. Mark things that should stand out in '''bold'''. <br />
* Use [http://en.wikipedia.org/wiki/Active_voice Active voice]<br />
* Give tips. Document things that are difficult to find or share your wisdom.<br />
* Don't reproduce existing documentation. Instead link to them.<br />
* It's OK to write long tutorial Pages. Use '''Tutorial:Tutorial Namespace''' for it. Assign categories for easily finding the tutorial.<br />
* If you are a regular blogger, consider donating your articles to this Wiki.<br />
* For discussions, use the '''Discussion page''' instead of posting to the article pages. Sign your comments using <nowiki>~~~~</nowiki>. <br />
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or similar code hosting site.<br />
* {{Note}} this is not a QA site. Emacs questions are better answered at [http://stackoverflow.com/questions/tagged/emacs Stackoverflow site]. However, if you have an answer to a good question or problem, add in the appropriate page.<br />
* '''Code snippets''' are most welcome. But comment about what precisely the snippet does. Document any limitations as well. <br />
<br />
== Mediawiki Help == <br />
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]<br />
<br />
== Creating new pages ==<br />
To create a new page, do this:<br />
# Visit [http://wikemacs.org/w/index.php?title=Template:NewPage&action=edit Template:NewPage] and copy the text area to clipboard. Feel free to modify the template. <br />
# Goto [[WikEmacs:Scratch Buffer]]<br />
# Add this <nowiki>[[Test Page]]</nowiki> and save the scratch buffer.<br />
# Click on the new Wiki link to create a blank page and paste the contents of clipboard there.<br />
# Save the newly created page.<br />
# Now you have a basic template which you can expand upon. Add content to the new page as you please.<br />
<br />
== Templates ==<br />
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc. Use them for uniformity. See [[:Category:Templates]]. Each template page should describe how to use that template. A few common examples:<br />
<br />
{| border="1" cellpadding="5" cellspacing="0" width="75%"<br />
|-<br />
!What it looks like<br />
!What you type<br />
|-<br />
| <h2>Headline text</h2><br />
| <pre>== Headline text ==</pre><br />
|-<br />
| {{Manual|emacs|Major-Modes|Major Modes}}<br />
| <pre>{{Manual|emacs|Major-Modes|Major Modes}}</pre><br />
|-<br />
| {{CommandKeys|C-x C-f|find-file}}<br />
| <pre>{{CommandKeys|C-x C-f|find-file}}</pre><br />
|-<br />
| {{Keys|C-x C-c}}<br />
| <pre>{{Keys|C-x C-c}}</pre><br />
|-<br />
| {{Keys|C-x f|set-fill-column}}<br />
| <pre>{{Keys|C-x f|set-fill-column}}</pre><br />
|-<br />
| {{Command|find-file}} <br />
| <pre>{{Command|find-file}}</pre> <br />
|-<br />
| {{CustomizeVariable|c-default-style}} <br />
| <pre>{{CustomizeVariable|c-default-style}}</pre><br />
|-<br />
| {{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}<br />
| <pre>{{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}</pre><br />
|}<br />
<br />
== Categories ==<br />
<br />
Special categories, such as ''Operating system'', ''Emacs releases'', ''Programming languages'', should be used to introduce new categories. See [[Special:Categories]].<br />
<br />
[[Category:WikEmacs Contributor]]</div>Drothlis