Difference between revisions of "WikEmacs:Guidelines"

From WikEmacs
Jump to navigation Jump to search
m (→‎Templates: rename 'emacs wiki templates')
m (Note about QA)
Line 10: Line 10:
 
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or any other code hosting site.
 
* We cannot host code extensions and elisp packages here. Use [https://github.com GitHub] or any other code hosting site.
  
= Mediawiki Help =  
+
* {{Note| this is not a QA site, any question you have are better answered at {{StackOverflow|http://stackoverflow.com/questions/tagged/emacs}}. If have got answer to good question add your solution in appropriate page}}
 +
 
 +
== Mediawiki Help ==  
 
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]
 
* [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Help with Mediawiki markup]
  
= Creating new pages =
+
== Creating new pages ==
 
To create a new page, do this:
 
To create a new page, do this:
 
# 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.  
 
# 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.  
Line 22: Line 24:
 
# Now you have a basic template which you can expand upon. Add content to the new page as you please.
 
# Now you have a basic template which you can expand upon. Add content to the new page as you please.
  
= Templates =
+
== Templates ==
 
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc.  Use them for uniform experience.  See [[:Category:Templates]]. Each template page should describe how to use it. A few common examples:
 
There are templates defined for referencing ''variables'', ''function'', ''command'', ''keys'', ''manual'' etc.  Use them for uniform experience.  See [[:Category:Templates]]. Each template page should describe how to use it. A few common examples:
  
Line 52: Line 54:
 
|}
 
|}
  
= Categories =
+
== 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]].
 
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]].
  
 
[[Category:WikEmacs Contributor]]
 
[[Category:WikEmacs Contributor]]

Revision as of 07:49, 4 April 2012

How can we maintain and improve quality of this Wiki?

  • Stick to Emacs-24 and Emacs-23.
  • Keep things short and sweet. Mark things that should stand out in bold.
  • Use Active voice
  • Give tips. Document things that are difficult to find or share your wisdom.
  • Don't reproduce existing documentation. Instead link to them.
  • It's OK to write long tutorial Pages. Use Tutorial:Tutorial Namespace for it. Categorize them so it is easy to find.
  • If you are a regular blogger, donate your article to this Wiki.
  • Use Discussion page to discuss things. Don't put them in articles themselves. Always sign your comments using ~~~~.
  • We cannot host code extensions and elisp packages here. Use GitHub or any other code hosting site.
  • Note: this is not a QA site, any question you have are better answered at StackOverflow:{{{2}}}. If have got answer to good question add your solution in appropriate page

Mediawiki Help

Creating new pages

To create a new page, do this:

  1. Visit Template:NewPage and copy the text area to clipboard. Feel free to modify the template.
  2. Goto WikEmacs:Scratch Buffer
  3. Add this [[Test Page]] and save the scratch buffer.
  4. Click on the new Wiki link to create a blank page and paste the contents of clipboard there.
  5. Save the newly created page.
  6. Now you have a basic template which you can expand upon. Add content to the new page as you please.

Templates

There are templates defined for referencing variables, function, command, keys, manual etc. Use them for uniform experience. See Category:Templates. Each template page should describe how to use it. A few common 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}}
[C-x f]
{{Keys|C-x f|set-fill-column}}
M-x find-file
{{Command|find-file}}
M-x customize-variable RET c-default-style
{{CustomizeVariable|c-default-style}}
(global-set-key (kbd "C-c c") 'org-capture)
{{Snippet|(global-set-key (kbd "C-c c") 'org-capture)}}

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.