Difference between revisions of "WikEmacs:Guidelines"

From WikEmacs
Jump to navigation Jump to search
(Undo revision 962 by GregLucas (talk))
Line 1: Line 1:
 
Start with http://meta.wikimedia.org/wiki/Help:Wikitext_examples if you are new to MediaWiki markup.
 
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:
 +
# Goto [[WikEmacs:Scratch Buffer]]
 +
# Add this <nowiki>[[Test Page]]</nowiki> and save the scratch buffer.
 +
# Click on the new Wiki link to create a blank page and insert <nowiki>{{NewPage|Test Page}}</nowiki>
 +
# Save the test page.
 +
# Now you have a basic template which you can expand upon. Add content to the new page as you please.
 +
 +
[[test page 1]]
  
 
== General ==
 
== General ==

Revision as of 04:38, 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:

  1. Goto WikEmacs:Scratch Buffer
  2. Add this [[Test Page]] and save the scratch buffer.
  3. Click on the new Wiki link to create a blank page and insert {{NewPage|Test Page}}
  4. Save the test page.
  5. Now you have a basic template which you can expand upon. Add content to the new page as you please.

test page 1

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
M-x apropos
{{Command|apropos}}
search-forward
{{Function|search-forward}}
auto-mode-alist
{{Variable|auto-mode-alist}}
[C-x C-c]
{{Keys|C-x C-c}}
[C-x C-f] (find-file) ||
{{KeyBinding|C-x C-f|find-file}}
Major Modes (`(info "(emacs) Major Modes")')
{{Manual|emacs|Major-Modes|Major Modes}}

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.