UniWiki:Manual of Style/Mathematics
UniWiki allows adding equations using [math]\LaTeX[/math] markup by using SimpleMathJax. Just place the expression in between <math></math> and it will be rendered.
You will be expected to learn to use Latex from other sources. This page contains only some useful information and formatting guidelines for use on this wiki.
For more in depth reading you can read the Wikipedia:Manual of Style/Mathematics. But do note that UniWiki uses different math extension than Wikipedia.
Style
Style guidelines for math vary by location and field. Don't worry about them too much. Being consistent, unambiguous and readable is more important than strictly following guidelines.
If you have time you can read these two:
- (pdf) Typesetting mathematics for science and technology according to ISO 31/XI.
- (pdf) On the use of italic and roman fonts for symbols in scientific text
Some of the main points are listed below:
- Variables and letters that represent values should be in italic.
- Multiletter and text variables are not exactly proper thing to do but they are fine in our wiki. Generally speaking use roman letters for them.
- Text should be in roman.
- Mathematical constants should be in roman. But this is often broken (for example [math]e[/math] and [math]\pi[/math]).
- Physical constants should be italic.
- Subscripts and superscripts that represent quantities should be italic. Otherwise they should be roman. For example [math] V_{\rm max}[/math] (max is roman) but [math] V_{n+1}[/math] (n is italic).
- Mathematical operators and special functions are in roman. Usually this happens automatically. For example
\sin. If the special function doens't work with that then use\operatorname{}.- Some operators will require manually setting. For example [math] \frac{ \mathrm{d} x }{ \mathrm{d} t} [/math].
- Single letter functions you define are italic. For example [math] f(x) [/math].
- Multi letter named functions are in roman. For example [math] \mathrm{func}(x) [/math].
- Units are in roman and separated from numbers by an unbreakable thin space
\,. Example: [math] g = 9.81 \,{\rm m/s^2} [/math] - Do not use "*" symbol for multiplication. Use
\timesinsted. Example: [math] 3 \times 2 = 6 [/math] - Equations on their own line should be indented with single ":".
Useful [math]\LaTeX[/math] knowledge
By default the math will be in inline mode. This is good for mixing math into text. For equations that are not among text you will usually want to use display mode. This will allow the equations to gain more height.
To use display mode just add \displaystyle at the beginning of the expression.
Example:
- [math] \sum_{k=1}^n a_k [/math]
\sum_{k=1}^n a_k
- [math] \displaystyle\sum_{k=1}^n a_k [/math]
\displaystyle\sum_{k=1}^n a_k
Some expressions apply to the whole equation. The affected area can be limited by surrounding it with curly bracets.
Examples:
- [math] \color{red} a = c [/math]
\color{red} a = c
- [math] { \color{red} a } = c [/math]
{ \color{red} a } = c
To write roman text instead of italic text you can use either \text{} or \rm depending on your exact needs.
\text{} will only apply to the text within curly brackets. Additionally it will make spaces visible.
\rm will change the whole equation into roman text. This will not change how spaces are removed. The area of effect can be limited by placing the expression oin curly bracets.
Examples:
- [math] \text{This thing} = x + y [/math]
\text{This thing} = x + y
- [math] \rm vel = spd + d[/math]
\rm vel = spd + dir
Normally spaces will be removed from the equation when it is rendered. Use plenty of spaces to make the latex code easier to read. If you want to keep spaces you can use the \text{} as shown above. If you just want to insert spaces into the equation you can use \ for normal space and \, for thin space.
Examples:
- [math] abb \ b\ b\ b [/math]
abb \ b\ b\ b
- [math] abb \,b\,b\,b [/math]
abb \,b\,b\,b
If you want to change the size of text in equation you can use \large, \Large or \LARGE to make it bigger. This is most useful with nested exponents and fractions. The affected area can be limited by surrounding it with curly brackets.
Example:
- [math] a^{\frac{b}{c} } [/math]
a^{\frac{b}{c} }
- [math] a^{\Large \frac{b}{c} } [/math]
a^{\Large \frac{b}{c} }
Long equations can be written on multiple lines and they will be rendered as one continuous equation. This is good for long equations that would be hard to edit otherwise.
Example:
- [math] a+a+a+a+a+a+a+a+a+a+a+a+a+a+a + b+b+b+b+b+b++b+b+b+b+b++b+b+b+b+b [/math]
<math> a+a+a+a+a+a+a+a+a+a+a+a+a+a+a+
b+b+b+b+b+b++b+b+b+b+b++b+b+b+b+b </math>
