CAZypedia needs your help!
We have many unassigned pages in need of Authors and Responsible Curators. See a page that's out-of-date and just needs a touch-up? - You are also welcome to become a CAZypedian. Here's how.
Scientists at all career stages, including students, are welcome to contribute.
Learn more about CAZypedia's misson here and in this article.
Totally new to the CAZy classification? Read this first.

Difference between revisions of "Help:Editing"

From CAZypedia
Jump to navigation Jump to search
m
Line 1: Line 1:
 
== Use Firefox ==
 
== Use Firefox ==
CAZypedia works best using the [http://www.mozilla.com/ Firefox browser] with javascript turned on.  Get Firefox [http://www.mozilla.com/ here].
+
''CAZypedia'' works best using the [http://www.mozilla.com/ Firefox browser] with javascript turned on.  Get Firefox [http://www.mozilla.com/ here].
  
CAZypedia's advanced editor, wikEd, requires one of the following browsers with javascript enabled: [http://www.mozilla.com/firefox/ Firefox], [http://www.seamonkey-project.org/ SeaMonkey], [http://www.apple.com/safari/ Safari], or [http://www.google.com/chrome Google Chrome].
+
''CAZypedia's'' advanced editor, wikEd, requires one of the following browsers with <u>javascript enabled</u>: [http://www.mozilla.com/firefox/ Firefox], [http://www.seamonkey-project.org/ SeaMonkey], [http://www.apple.com/safari/ Safari], or [http://www.google.com/chrome Google Chrome].
  
  
== Preamble: CAZypedia and WYSIWYG editing ==
+
== Preamble: ''CAZypedia'' and WYSIWYG editing ==
The nature of the wiki format which forms the basis of [[CAZypedia]] ''does not'' lend itself very well to WYSIWYG (what you see is what you get) editing that most of us are used to.  Unlike word processing software, where what you type is immediately formatted on the screen and later appears on the printed page, wiki editing is a bit more like making a web page.  Text is typed in an unformatted form, which is later formatted on-the-fly according to specific formatting "tags" embedded in the text itself.
+
The nature of the wiki format which forms the basis of ''CAZypedia'' ''does not'' lend itself very well to WYSIWYG (what you see is what you get) editing that most of us are used to.  Unlike word processing software, where what you type is immediately formatted on the screen and later appears on the printed page, wiki editing is a bit more like making a web page.  Text is typed in an unformatted form, which is later formatted on-the-fly according to specific formatting "tags" embedded in the text itself.
  
The reasons wikis, and thus CAZypedia, use this less user-friendly way are mainly technical, having to do with using a web browser as an input tool and a remote web server as the data storage device.  People who are used to "markup" computer languages (like HTML) will have little trouble getting used to the wiki way of formatting text.  To ease the pain for everyone else, CAZypedia implements an ''almost'' WYSIWYG editor called [http://en.wikipedia.org/wiki/User:Cacycle/wikEd wikEd].  wikEd was develped to make life easier for Wikipedia contributors, and since CAZypedia runs the same wiki software ([http://www.mediawiki.org/ MediaWiki]), we can benefit from wikEd, too (see below).
+
The reasons wikis, and thus ''CAZypedia'', use this less user-friendly way are mainly technical, having to do with using a web browser as an input tool and a remote web server as the data storage device.  People who are used to "markup" computer languages (like HTML) will have little trouble getting used to the wiki way of formatting text.  To ease the pain for everyone else, ''CAZypedia'' implements an ''almost'' WYSIWYG editor called [http://en.wikipedia.org/wiki/User:Cacycle/wikEd wikEd].  wikEd was develped to make life easier for Wikipedia contributors, and since ''CAZypedia'' runs the same wiki software ([http://www.mediawiki.org/ MediaWiki]), we can benefit from wikEd, too (see below).
  
  
 
== Quick links for Mediawiki formatting ==
 
== Quick links for Mediawiki formatting ==
MediaWiki is the engine that drives CAZypedia.  These links provide an '''overview of the basic "markup" (formatting rules) that CAZypedia uses''':
+
MediaWiki is the engine that drives ''CAZypedia''.  These links provide an '''overview of the basic "markup" (formatting rules) that ''CAZypedia'' uses''':
  
 
* [http://meta.wikimedia.org/wiki/Help:Editing Basic editing & markup]
 
* [http://meta.wikimedia.org/wiki/Help:Editing Basic editing & markup]
Line 20: Line 20:
  
  
== Making life a bit easier: The wikEd editor in CAZypedia ==
+
== Making life a bit easier: The wikEd editor in ''CAZypedia'' ==
CAZypedia uses an advanced editor called wikEd, which greatly simplifies making and editing CAZypedia pages.  wikEd has a bunch of neat features, all of which you can read about on the [http://en.wikipedia.org/wiki/User:Cacycle/wikEd wikEd homepage].
+
''CAZypedia'' uses an advanced editor called wikEd, which greatly simplifies making and editing ''CAZypedia'' pages.  wikEd has a bunch of neat features, all of which you can read about on the [http://en.wikipedia.org/wiki/User:Cacycle/wikEd wikEd homepage].
  
  
For the average CAZypedia contributor, these are probably the most useful:
+
For the average ''CAZypedia'' contributor, these are probably the most useful:
 
* Click buttons to format text (bold, italic, etc.), like a word processor
 
* Click buttons to format text (bold, italic, etc.), like a word processor
 
* Find and replace
 
* Find and replace
Line 30: Line 30:
  
  
[http://en.wikipedia.org/wiki/User:Cacycle/wikEd_help The wikEd help page] contains a '''quick tutorial''' and some easy to follow  details on formatting buttons in wikEd.  It is  strongly recommended that you  browse this page before beginning work on CAZypedia.
+
[http://en.wikipedia.org/wiki/User:Cacycle/wikEd_help The wikEd help page] contains a '''quick tutorial''' and some easy to follow  details on formatting buttons in wikEd.  It is  strongly recommended that you  browse this page before beginning work on ''CAZypedia''.
  
  
'''Note:''' To use wikEd, you need to use one of the following browsers with ''javascript enabled'': [http://www.mozilla.com/firefox/ Firefox], [http://www.seamonkey-project.org/ SeaMonkey], [http://www.apple.com/safari/ Safari], or [http://www.google.com/chrome Google Chrome].  ''Microsoft Internet Explorer and Opera Browser currently don't work with wikEd''.  '''CAZypedia recommends using [http://www.mozilla.com/firefox/ Mozilla Firefox].'''
+
'''Note:''' To use wikEd, you need to use one of the following browsers with ''javascript enabled'': [http://www.mozilla.com/firefox/ Firefox], [http://www.seamonkey-project.org/ SeaMonkey], [http://www.apple.com/safari/ Safari], or [http://www.google.com/chrome Google Chrome].  ''Microsoft Internet Explorer and Opera Browser currently don't work with wikEd''.  '''''CAZypedia'' recommends [http://www.mozilla.com/firefox/ Mozilla Firefox].'''
  
  
'''Although wikEd is both quite good and quite powerful, ''patiently'' bear in mind that you will have to understand the MediaWiki markup to fix things when they don't look ''quite'' right.  Soon enough, editing pages in CAZypedia will become second nature.'''
+
'''Although wikEd is both quite good and quite powerful, ''patiently'' bear in mind that you will have to understand the MediaWiki markup to fix things when they don't look ''quite'' right.  Soon enough, editing pages in ''CAZypedia'' will become second nature.'''
  
  
 
== References to the literature ==
 
== References to the literature ==
Although wikEd can be used to copy-and-paste formatted text from a word processor like MS Word, it will not automatically fix literature references.  There are other special features to help with the addition of literature references to CAZypedia entries; for detailed instructions, please see the [[Help:References]] page.
+
Although wikEd can be used to copy-and-paste formatted text from a word processor like MS Word, it will not automatically fix literature references.  There are other special features to help with the addition of literature references to ''CAZypedia'' entries; for detailed instructions, please see the [[Help:References]] page.

Revision as of 05:15, 21 August 2009

Use Firefox

CAZypedia works best using the Firefox browser with javascript turned on. Get Firefox here.

CAZypedia's advanced editor, wikEd, requires one of the following browsers with javascript enabled: Firefox, SeaMonkey, Safari, or Google Chrome.


Preamble: CAZypedia and WYSIWYG editing

The nature of the wiki format which forms the basis of CAZypedia does not lend itself very well to WYSIWYG (what you see is what you get) editing that most of us are used to. Unlike word processing software, where what you type is immediately formatted on the screen and later appears on the printed page, wiki editing is a bit more like making a web page. Text is typed in an unformatted form, which is later formatted on-the-fly according to specific formatting "tags" embedded in the text itself.

The reasons wikis, and thus CAZypedia, use this less user-friendly way are mainly technical, having to do with using a web browser as an input tool and a remote web server as the data storage device. People who are used to "markup" computer languages (like HTML) will have little trouble getting used to the wiki way of formatting text. To ease the pain for everyone else, CAZypedia implements an almost WYSIWYG editor called wikEd. wikEd was develped to make life easier for Wikipedia contributors, and since CAZypedia runs the same wiki software (MediaWiki), we can benefit from wikEd, too (see below).


Quick links for Mediawiki formatting

MediaWiki is the engine that drives CAZypedia. These links provide an overview of the basic "markup" (formatting rules) that CAZypedia uses:


Making life a bit easier: The wikEd editor in CAZypedia

CAZypedia uses an advanced editor called wikEd, which greatly simplifies making and editing CAZypedia pages. wikEd has a bunch of neat features, all of which you can read about on the wikEd homepage.


For the average CAZypedia contributor, these are probably the most useful:

  • Click buttons to format text (bold, italic, etc.), like a word processor
  • Find and replace
  • Cut-and-paste and convert formatted text from e.g. Microsoft Word and web pages using the wikify button WikEd wikify.png.


The wikEd help page contains a quick tutorial and some easy to follow details on formatting buttons in wikEd. It is strongly recommended that you browse this page before beginning work on CAZypedia.


Note: To use wikEd, you need to use one of the following browsers with javascript enabled: Firefox, SeaMonkey, Safari, or Google Chrome. Microsoft Internet Explorer and Opera Browser currently don't work with wikEd. CAZypedia recommends Mozilla Firefox.


Although wikEd is both quite good and quite powerful, patiently bear in mind that you will have to understand the MediaWiki markup to fix things when they don't look quite right. Soon enough, editing pages in CAZypedia will become second nature.


References to the literature

Although wikEd can be used to copy-and-paste formatted text from a word processor like MS Word, it will not automatically fix literature references. There are other special features to help with the addition of literature references to CAZypedia entries; for detailed instructions, please see the Help:References page.