The Azimuth Project
FAQ

Frequently Asked Questions

This FAQ is borrowed from the analogous page on the n&nLab, so it needs to be massively adjusted. Nonetheless it should still be slightly useful. See also HowTo.

Instiki features and “features”

How do I put math inside HTML?

By default, the itex syntax $...$ is disabled inside raw HTML. However, you can re-enable it by giving the HTML parameter markdown="1". Thus

<table markdown="1"><tr><td>I can has $m^a_t \hbar$!!</td></tr></table>

produces

I can has $(m^a)_t \hbar$!!

However, for tables you can also use the PHP Markdown Extra syntax inside which $...$ works without a problem.

My math doesn’t look like math

One of the notable ways in which itex differs from latex is that in itex’s math mode, a string of letters without spaces in between is interpreted as a single identifier. This has the advantage that you can invent new identifiers without needing to use \operatorname or \DeclareMathOperator, but it means that when you don’t want a string of letters interpreted that way you need to put spaces in between. For example, $sin(x)$ produces sin(x)sin(x) which is probably what you want, but $h=gf$ produces h=gfh=gf, whereas you probably wanted to write $h=g f$ to get h=gfh=g f. On the other hand, you can (and, for the sake of the LaTeX output, probably should) use $\sin(x)$, etc.

Lists are acting strangely.

There are several bugs (or “edge cases”) in the handling of lists by Maruku (the formatting filter used by Instiki). These include:

My LaTeX produces gobbledygook in iTeX and vice versa.

iTeX is not LaTeX. iTeX is a pure converter whereas LaTeX is a mixture of a converter and renderer (technically, latex is the rules for converting the input into pure TeX which is then rendered by tex, but since the conversion is also handled by tex, it can cheat and use information about the rendered output to reinterpret the input). Therefore getting the two to do exactly the same is never going to happen.

On the other hand, the aim is to keep iTeX as close as possible to standard LaTeX whilst keeping in mind that iTeX produces MathML. Their similarity can make the differences all the more jarring. Here is a list of the differences that we know about together with suggested work-arounds.

  • Numbers are one thing. The syntax $10^10$ produces 10 1010^10 in iTeX but 10 1010^{1}0 in LaTeX. The safe syntax is to always use braces: $10^{10}$ is consistent.

  • Numbers include punctuation. Periods and commas within numbers are numbers. This is so that $1,000,000.00$ (or $1.000.000,00$ if you are European) renders correctly as 1,000,000.001,000,000.00 and not 1,000,000.00{1},{000},{000}.{00}. When combined with the previous difference, this means that $t^3,2$ renders as t 3,2t^3,2 instead of t 3,2t^{3},2. Either use braces or spaces.

  • Operator names. Since iTeX does not have macro support, extending the list of operator names would be difficult except for the fact that neighbouring strings of letters get combined into an operator name. Thus $cos$ produces coscos. However, in LaTeX this produces cosc o s. Where the operator name is a standard LaTeX one, such as \cos, the backslash can be added so $\cos$ renders correctly in both cases. Where the operator name is not a standard LaTeX one, say Poly, the safe syntax is to use \operatorname; thus $\operatorname{Poly}$ renders correctly as Poly\operatorname{Poly} in both situations. If you don't want an operator name, then use spaces; thus $c o s$ produces cosc o s.

  • Whitespace in embedded text. In LaTeX $x \text{ and } y$ renders as xandyx\;\text{and}\;y but in iTeX it renders as x and yx\text{ and }y. This is because MathML says that fore and aft whitespace on mtext elements should be swallowed. The safe syntax is $x\;\text{and}\;y$.

  • Two-character relations. In LaTeX, two neighbouring relation symbols are combined into one relation symbol. Thus $y := f(x)$ becomes y:=f(x)y \mathrel{:=} f(x), while $y = -f(x)$ becomes y=f(x)y = -f(x) because a minus sign is a unary operator instead of a binary relation. Since MathML doesn't know the difference between unary operators and binary relations, it is inconvenient for iTeX to do this, so $y := f(x)$ comes out as y:=f(x)y := f(x) instead. The safe syntax is $y \mathrel{:=} f(x)$, which produces y:=f(x)y \mathrel{:=} f(x). However, in many cases, there is a combined command that you can use. In this case, $y \coloneqq f(x)$ produces yf(x)y \coloneqq f(x). This method is better when available; even in LaTeX, it will adjust the vertical positioning a bit to look nice.

  • Non-ascii characters. iTeX is designed only to parse the mathematical sections of any page and so it assumes that any strange characters will be generated via iTeX commands such as \infty instead of being directly input as ∞. iTeX actually takes an extreme view on this and will not parse mathematics if it includes non-ascii characters. In ordinary mathematics this should not be a problem since one should use the iTeX commands themselves to produce such characters. Where it can be a problem is in \text commands embedded in mathematics because these are still parsed by iTeX even though it does nothing with them. Thus \text{∞} is not a legal construct and will simply produce \text{∞}. Since iTeX does not allow nesting, the construction \text{$\infty$} will not work. There are two possibilities:

    1. Break the \text command: \text{in~}\infty{-categories} produces incategories\text{in}\;\infty{-categories} (note the forced space, simple whitespace there will not work).
    2. Use numbered entities: \text{in &#8734;-categories produces in ∞-categories\text{in &#8734;-categories}. Named entities will not work here as they get converted to unicode internally before being sent to the iTeX parser.

itex is a pain, why do you guys use MathML?

Many web sites “support” LaTeX by running it through a script which converts LaTeX equations to image files for display. While this produces acceptable results for many users, it is not true “support” for mathematics. Images can sometimes be hard to see, and the user cannot easily resize them or change their color or font, nor can software easily read them aloud to a blind user. In contrast, MathML is a markup language, like HTML, specifically designed to carry information not only about the display of mathematics, but its content and meaning. A suitable client application can resize MathML along with the rest of the page, change its color or font, or even read it aloud, making MathML a much more accessible way to display mathematics. See, for instance, this comment.

I want to help out with the software, what can I do?

See this discussion.

HTML, XML, etc.

How do I get accented characters?

You can use HTML/XML/SGML character entity references. If the character you want has a mnemonic HTML name, like &eacute; for é, you can use that. Otherwise, you can use an SGML numerical code, like &#x34AB; for 㒫, that corresponds directly to Unicode. To look up the numbers for SGML characters, try the Unicode Character Names Index. Toby? has a complete list of HTML and XML character entity references (or try the Unicode Databank pages listed below) with individual pages where you can check browser compliance (originally for when you couldn't take even things like &harr; for granted, but even now &lrm; and &thinsp; may be lacking). While you can use this technique for mathematical symbols too, it's best to do those in iTeX as explained above.

Azimuth Project Specifics

Why did my page get redirected?

Did you read the Naming Conventions section on the HowTo?

Where do I ask a question?

If about a specific writing service page then put it on that page in a query block:

+-- {: .query}
How do I prove the Riemannian Hypothesis?
=--

If about the Azimuth Project then try the Azimuth Forum.

I want to help, but writing math on a wiki is scary; what can I do?

There are numerous ways you can help out and get acquainted with the community even if you don’t (yet) feel comfortable writing math publically on a wiki.

  1. You can do lab elf duty, such as correcting typos and spelling errors, fixing links, creating links, creating redirects (there are many pages that still need redirects created for alternate and plural forms of the title), organizing pages, and so on.

  2. You can ask questions (see previous question), and join discussions, at the nForum, and comment at the nCafe.

  3. You can try writing small additions to existing pages, for instance a paragraph or two that helps explain something that puzzled you initially. If you aren’t entirely positive that what you wrote was correct, when you announce your edit at Latest Changes on the nForum, you can mention that you’re unsure and someone will usually reassure you or give a correction.

  4. If you don't sign your edits, then they are attributed to the AnonymousCoward?. We prefer that you sign your edits, but anonymous help is better than none at all, so that option is available to you.

How can I get a personal section of the Azimuth Project?

It’s possible, but we haven’t figured out such things yet.

I got “Access denied” when editing a page.

The Azimuth Project has a spam filter that checks your IP against a blacklist. The blacklists used are maintained by spamcop.net and spamhaus.org. IPs are added to these lists if they are detected doing things usually associated with computers infected with viruses. There are amoxicilina instructions on the webpages for finding out if your IP has been added to these lists and what to do to remove your IP from them. Three things to point our are:

  1. The Azimuth Project cannot remove your IP from the list, you have to do that yourself.
  2. The Azimuth Project is not going to remove its spam protection.
  3. If you got your IP dynamically (e.g. using some wireless providers) it is entirely possible that it is not your computer that was behaving badly but a previous one using the same IP. A quick workaround is to disconnect from the network and try reconnecting (sometimes you have to wait a bit before reconnecting to get a new IP). Of course, you should ensure that your virus software is up to date.

I got “Internal application error” when doing something.

Sometimes something doesn’t work quite right with the software and it bails out. If you think that you were doing something that should work, please log the error message at the Azimuth Forum. The more information that you log, the easier it is for us to debug. Useful information is: your IP, the time and date, and the URL that you were trying to access.

There is actually more information contained in the HTML source of the error message (“view source”): some errors can be down to malformed input when editing a page and that can help you fix it yourself.

category: meta