Difference between revisions of "WikEmacs:Guidelines"
Jump to navigation
Jump to search
| Line 29: | Line 29: | ||
!What you type | !What you type | ||
|- | |- | ||
| − | | {{ | + | | {{Manual|emacs|Major-Modes|Major Modes}} || <pre>{{Manual|emacs|Major-Modes|Major Modes}}</pre> |
|- | |- | ||
| − | |||
|- | |- | ||
| − | | {{ | + | | {{CommandKeys|C-x C-f|find-file}} || <pre>{{CommandKeys|C-x C-f|find-file}}</pre> |
|- | |- | ||
| {{Keys|C-x C-c}} || <pre>{{Keys|C-x C-c}}</pre> | | {{Keys|C-x C-c}} || <pre>{{Keys|C-x C-c}}</pre> | ||
|- | |- | ||
| − | | {{ | + | | {{Command|find-file}} || <pre>{{Command|find-file}}</pre> |
| + | |- | ||
|- | |- | ||
| − | | {{ | + | |{{CustomizeVariable|c-default-style}}||<pre>{{CustomizeVariable|c-default-style}}</pre> |
| + | |- | ||
| + | |{{CustomizeGroup|C}}||<pre>{{CustomizeGroup|C}}</pre> | ||
| + | |- | ||
| + | |- | ||
| + | | {{Function|search-forward}} || <pre>{{Function|search-forward}}</pre> | ||
| + | |- | ||
| + | | {{Variable|auto-mode-alist}} || <pre>{{Variable|auto-mode-alist}}</pre> | ||
|- | |- | ||
|} | |} | ||
Revision as of 05:04, 28 March 2012
Start with http://meta.wikimedia.org/wiki/Help:Wikitext_examples if you are new to MediaWiki markup.
Creating new pages
To create a new page, do this:
- Visit Template:NewPage and copy the text area to clipboard. Feel free to modify the template.
- Goto WikEmacs:Scratch Buffer
- Add this [[Test Page]] and save the scratch buffer.
- Click on the new Wiki link to create a blank page and paste the contents of clipboard there.
- Save the newly created page.
- Now you have a basic template which you can expand upon. Add content to the new page as you please.
General
- Articles should be geared toward the current and development versions of Emacs, 23 and 24 at time of writing. References to older Emacs releases should generally be avoided.
- Articles should not reproduce documentation already available from another source. Many packages and extensions are well-documented on their own project sites; and Emacs itself includes extensive documentation. Link to official documentation where possible.
- Comments and questions belong on the Discussion pages, not in articles themselves. Always sign your comments using ~~~~. This expands to your username (if logged in) and adds a timestamp. Unsigned comments make the discussion hard to follow.
- Extensions and packages will not be hosted here. If you are looking for a place to host your extension try GitHub or one of the other many hosting / source control platforms out there!
Templates
There are templates defined for referencing variables, function, command, keys, manual etc. Use them for uniform experience. See Special:UncategorizedTemplates.
Some examples:
| What it looks like | What you type |
|---|---|
| Major Modes (`(info "(emacs) Major Modes")') | {{Manual|emacs|Major-Modes|Major Modes}}
|
| [C-x C-f] (or M-x find-file) | {{CommandKeys|C-x C-f|find-file}}
|
| [C-x C-c] | {{Keys|C-x C-c}}
|
| M-x find-file | {{Command|find-file}}
|
| M-x customize-variable RET c-default-style | {{CustomizeVariable|c-default-style}}
|
| M-x customize-group RET C RET | {{CustomizeGroup|C}}
|
| search-forward | {{Function|search-forward}}
|
| auto-mode-alist | {{Variable|auto-mode-alist}}
|
Categories
There are special categories defined for Operating system, Emacs releases, Programming languages etc. Use these when possible or introduce new ones as required. See Special:Categories.