Help:Editing: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Scott
No edit summary
imported>Scott
No edit summary
 
(16 intermediate revisions by 2 users not shown)
Line 2: Line 2:


==Style Guide and Formatting==
==Style Guide and Formatting==
There are several standards we are developing to help assure consistent formatting of Reference Manual pages in this Wiki.  
There are several standards to help assure consistent formatting of Reference Manual pages in this Wiki.  
* The Eigenvector [[Reference Manual Style Guide]] should be used to correctly format Reference Manual pages.  
* [[Reference Manual Style Guide]] - use to correctly format Reference Manual pages.  
* The [[Example Markup]] page is a quick reference page for how to do common markup encoding.
* [[Example Markup]] - a quick reference page for how to do common markup encoding.
* You must use LaTex to enter mathematical equations. There is a useful on-line tool for [http://www.codecogs.com/components/equationeditor/equationeditor.php Creating LaTex Equations]
* [[Reference Manual Template]] - template for new reference manual entries.
* Also see the [[cluster | Cluster Function Page]] for an example of a "well formed" reference manual page.
* [[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.


==Using the Editor==
==Using the Editor==
Line 21: Line 23:


[[Image:Wikedtoolbar.png|WikEd Toolbar ]]
[[Image:Wikedtoolbar.png|WikEd Toolbar ]]
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===
===Inserting an Image===
Line 37: Line 43:


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.
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===
===Other Information===

Latest revision as of 08: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: