Help:Editing: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
No edit summary
imported>Scott
No edit summary
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page contains editing information specific to the Eigenvector Research Documentation Wiki. For information on working with the editor see the [http://en.wikipedia.org/wiki/User:Cacycle/wikEd_help wikEd_help page]
This page contains editing information specific to the Eigenvector Research Documentation Wiki.  


===Eigenvector Reference Manual Style Guide===
==Style Guide and Formatting==
There are several standards to help assure consistent formatting of Reference Manual pages in this Wiki.
* [[Reference Manual Style Guide]] - use to correctly format Reference Manual pages.
* [[Example Markup]] - a quick reference page for how to do common markup encoding.
* [[Reference Manual Template]] - template for new reference manual entries.
* [[cluster | Cluster Function Page]] is an example of a "well formed" reference manual page.
* [[Common Importing Problems]] - a "watch-out-for" list of common problems with our imported pages and how to fix them.
* [[Images and Screen-shots]] - guidelines for images and screen shots.


The following style rules should be followed for all new reference manual entries.
==Using the Editor==
For information on working with the editor see the [http://en.wikipedia.org/wiki/User:Cacycle/wikEd_help wikEd_help page]. Although we haven't explored all of the functionality of WikED, here are a couple of useful tips:


* Top-level segments get three =s  <nowiki>===Synopsis===</nowiki> These sections include:
===Enable WikEd===
**Purpose
To toggle between the standard editor and the enhanced wikEd editor press the button in the upper right-hand corner of the browser:
**Synopsis
**Description
**Examples
**Options
**Algorithm
**See Also


[[Image:WikedToggle.png|Opening WikED]]


* Some standard sub-topics can be used in Description. These sections are delineated with four =s <nowiki>====Inputs====</nowiki> and  include:
Note: WikED does not work with Safari yet.
**Inputs
**Optional Inputs
**Outputs
:Note: These sub-topics are ''always plural'', even if there is only one item in the list (e.g. one output)
 


* Matlab code can be provided using either:
This will enable/disable the the WikEd toolbar:
** Indenting (i.e. start line with a semicolon) - use for Synopsis section and for single lines of code in description
** Preformatted code using one of the methods below - use any time there are multiple lines of associated code shown together
*** start line with one or more space characters
*** wrap code in a &lt;pre&gt; &lt;/pre&gt; tag


[[Image:Wikedtoolbar.png|WikEd Toolbar ]]


* See Also section should list relevant similar functions and link to each function
Mousing over the button icons will show you the name of the button.
 
Use <pre>\n%\s*</pre> regular expression to replace comment characters in pasted code.
 
===Inserting an Image===
 
* Upload the image using [[Special:Upload | Upload file]] link from the '''toolbox''' area (lower left corner of web page).
* Go to the page where you want to insert the image and click the '''Image''' icon from the edit toolbar.
* Add the image file name to the link and the mouse-over text. Typically there's no need to adjust the size or add a thumb but the functionality is there if needed.
 
[[Image:Insertimage.png|Inserting Wiki Image]]
 
If you forget the file name you can look it up in a list of all images [[Special:Imagelist | here]].
 
===Inserting Tables===
 
Small tables can be inserted using the the Table button in the toolbar. Add formatting as needed, look [http://meta.wikimedia.org/wiki/Help:Table here] for more info about table formatting.
 
If the table you need is large and you don't want to type the information in, try using the [http://area23.brightbyte.de/csv2wp.php CSV Converter] utility. You paste CSV formatted text into it and get wiki formatted text out. There are several settings for adjusting the delimiter and other aspects of the data.
 
===Inserting Equations===
 
We have the software installed to render LaTeX equations. MathType 6 has the ability copy LaTeX straight into the clipboard buffer whereupon you can just copy the equation out of MathType and straight into your wiki page. The pasted text will be LaTeX. For example, the equation editor looks like this:
 
[[Image:MathTypeImage.png|MathType Editor]]
 
Copy the equation out of the equation editor and past it into the wiki editor it looks like this (depending on your settings, some MathTpye binary is also included):
 
<pre><math>h_{0}=1-\frac{2\Theta _{1}\Theta _{3}}{3\Theta _{2}^{2}}</math></pre>
 
And it is rendered like this (as an image):
 
<math>h_{0}=1-\frac{2\Theta _{1}\Theta _{3}}{3\Theta _{2}^{2}}</math>
 
There is a useful on-line tool for [http://www.codecogs.com/latex/eqneditor.php Creating LaTex Equations] if you don't have access to a suitable version of MathType.
 
 
TESTING, these should all render AFTER you make a small change:
 
<math>0</math>
 
<math>\partial{1-e^2}</math>
 
<math>\alpha</math>
 
<math>\sum{\partial^2 A}{\partial x^2}</math>
 
<math>\sqrt{1-e^2}</math>
 
<math>f\left( {{a}_{i}},\mathbf{x} \right)={{x}_{1}}\left[ {{x}_{4}}{{\operatorname{e}}^{\frac{-4\ln \left( 2 \right){{\left( {{a}_{i}}-{{x}_{2}} \right)}^{2}}}{x_{3}^{2}}}}+\left( 1-{{x}_{4}} \right)\left[ \frac{x_{3}^{2}}{{{\left( {{a}_{i}}-{{x}_{2}} \right)}^{2}}+x_{3}^{2}} \right] \right]</math>
 
===Other Information===
 
A useful (off-site) page for information on how to create and edit pages in this Wiki can be found on the [http://meta.wikimedia.org/wiki/Help:Editing WikiMedia web page] (Note: although that page talks about "signing" a page using tildes, we are not requiring that on these pages)
 
==Extentions==
Extensions add new features or enhance functionality of the Wiki. Currently we have have the following extensions installed and ready for use:
 
* [[Syntax Highlighting]] - allows syntax color-coding of code

Latest revision as of 09:45, 10 June 2014

This page contains editing information specific to the Eigenvector Research Documentation Wiki.

Style Guide and Formatting

There are several standards to help assure consistent formatting of Reference Manual pages in this Wiki.

Using the Editor

For information on working with the editor see the wikEd_help page. Although we haven't explored all of the functionality of WikED, here are a couple of useful tips:

Enable WikEd

To toggle between the standard editor and the enhanced wikEd editor press the button in the upper right-hand corner of the browser:

Opening WikED

Note: WikED does not work with Safari yet.

This will enable/disable the the WikEd toolbar:

WikEd Toolbar

Mousing over the button icons will show you the name of the button.

Use

\n%\s*

regular expression to replace comment characters in pasted code.

Inserting an Image

  • Upload the image using Upload file link from the toolbox area (lower left corner of web page).
  • Go to the page where you want to insert the image and click the Image icon from the edit toolbar.
  • Add the image file name to the link and the mouse-over text. Typically there's no need to adjust the size or add a thumb but the functionality is there if needed.

Inserting Wiki Image

If you forget the file name you can look it up in a list of all images here.

Inserting Tables

Small tables can be inserted using the the Table button in the toolbar. Add formatting as needed, look here for more info about table formatting.

If the table you need is large and you don't want to type the information in, try using the CSV Converter utility. You paste CSV formatted text into it and get wiki formatted text out. There are several settings for adjusting the delimiter and other aspects of the data.

Inserting Equations

We have the software installed to render LaTeX equations. MathType 6 has the ability copy LaTeX straight into the clipboard buffer whereupon you can just copy the equation out of MathType and straight into your wiki page. The pasted text will be LaTeX. For example, the equation editor looks like this:

MathType Editor

Copy the equation out of the equation editor and past it into the wiki editor it looks like this (depending on your settings, some MathTpye binary is also included):

<math>h_{0}=1-\frac{2\Theta _{1}\Theta _{3}}{3\Theta _{2}^{2}}</math>

And it is rendered like this (as an image):

There is a useful on-line tool for Creating LaTex Equations if you don't have access to a suitable version of MathType.


TESTING, these should all render AFTER you make a small change:

Other Information

A useful (off-site) page for information on how to create and edit pages in this Wiki can be found on the WikiMedia web page (Note: although that page talks about "signing" a page using tildes, we are not requiring that on these pages)

Extentions

Extensions add new features or enhance functionality of the Wiki. Currently we have have the following extensions installed and ready for use: