View source for Help:HowTo EoM

[[Category:Encyclopedia of Mathematics basic information]]
[[Category:Encyclopedia of Mathematics quick introductions]]

== Editing including $\rm \TeX$ code ==
EoM pages can be edited like any 
[http://en.wikipedia.org/wiki/Help:Contents/Editing_Wikipedia Wikipedia page].

Moreover, EoM is enhanced by
[http://www.mediawiki.org/wiki/Extension:MathJax MathJax].
Therefore, one can encode mathematics using arbitrary
[http://en.wikibooks.org/wiki/LaTeX $\rm \TeX$ or $\rm \LaTeX$ code].

That is, you type 
<code><nowiki>$e^{2\pi i} = 1$ </nowiki></code>
in order to get
$e^{2\pi i} = 1$.
[[Help:Fancy_diagram | Here is an even more convincing Example]].


And [http://www.mediawiki.org/wiki/Extension:MathJax#Usage this is some example] demonstrating various things: 
* How to define $\rm \TeX$ macros, in order to save you keystrokes, 
* how to use standard $\rm \LaTeX$ constructs, and 
* how to encode automatic equation numbering and referencing them.


Certain $\rm \TeX$ macros are predefined by MathJax, [[User:Ulf Rehmann/Predefined TeX Macros | see this page]].

For editing one can use the text area, which is opened in the browser
after clicking on the "edit" button of an EoM page. However, since
most texts are long, it is highly recommended to use an external
editor. 

EoM allows to use add-ons in order to use external editors
(like 
[https://addons.mozilla.org/de/firefox/addon/its-all-text/ "It's all text"] 
for firefox and [https://chrome.google.com/webstore/detail/ljobjlafonikaiipfkggjbhkghgicgoh "Edit with emacs"] for chrome and chromium). This software can be
installed in several browsers. If installed, below the wiki edit area
there appears a small blue button, and clicking on that button pops up your
favored editor window with the whole content of the text area, ready
for editing. 

'''Beware:''' In your preferences, under "Editing", please don't mark "Show edit toolbar (requires JavaScript)", otherwise the blue button may not occur.

See
[http://en.wikipedia.org/wiki/Wikipedia:Text_editor_support#Use_It.27s_All_Text.21_to_invoke_an_external_editor here] for further explanations.

Comments on various other editors can be found
[http://en.wikipedia.org/wiki/Wikipedia:Text_editor_support here].

== Re-encoding of old pages ==

'''Important:''' Old EoM pages have their formulas not encoded in $\rm \TeX$ but in [http://en.wikipedia.org/wiki/Portable_Network_Graphics png] images.

Example for both encodings of the same page: $\qquad$ [[Tamagawa_number | $\rm\TeX$ encoded]] 
$\qquad$ 
[http://www.encyclopediaofmath.org/index.php?title=Tamagawa_number&oldid=13490 png encoded]

To see all the pages already converted into $\rm\TeX$ look into this
[[:Category:TeX done]]. You can look at their encoding via the "edit"
button.


'''One of the initial tasks for those pages is it to transcribe them into
$\rm \TeX$.'''

In the png-encoded pages there are two types of encodings:

* &lt;img align=    ...   file.png ... /&gt;       
* &lt;table class= ...   file.png ... &lt;/table&gt;

These entries have to be removed and replaced by appropriate $\rm\TeX$
code, the first type represents inline code, i.e., $\rm\TeX$ representation
within single <nowiki>\$</nowiki> signs, the second type represents "displayed"
$\rm\TeX$ code within double <nowiki>\$\$</nowiki> signs.

== Assisting tool for $\rm \TeX$ re-encoding using Emacs ==

For the GNU Emacs editor, [[Help:Emacs_eom_macros| here is a tool which
helps with this task]]. 

If the macro is installed and the wiki text file for an old EoM page
with png images is displayed in some Emacs buffer, then one keystroke
(Ctrl-. = control key and .-key) removes all the png encodings (as
described above) and replaces them by <code>$_$</code> (resp.
\$\$_\$\$), prompting the user to fill in the appropriate
$\rm\TeX$ code into the 
[http://www.gnu.org/s/libtool/manual/emacs/Minibuffer.html#Minibuffer minibuffer of Emacs]. 

After ending the $\rm\TeX$ code input with the
<nowiki>Enter</nowiki>-key Emacs will insert that code into the wiki
text file, jumping to the next instance and prompting the user again,
etc.

The macro has re-entry capabilities: If input is interrupted, it can be
called again, and it will continue with the next string
\$_\$ (resp. \$\$_\$\$).

So within an interruption, the formulas can be filled directly into
the text file, if convenient.

However, it is better to 
[http://www.gnu.org/s/libtool/manual/emacs/Minibuffer-Edit.html#Minibuffer-Edit edit via the minibuffer],
since the history capabilities of the minibuffer can very often be
used to recall some former input (with the up- and down-keys), modify
that slightly if necessary and insert again.

<!--
== Assisting tool for $\rm \TeX$ re-encoding using TeXShop (OS X, 10.9) ==
-->
{{:TeX_re-encoding_with_TeXShop}}

== Mathematical subject classification and categorization, MR and Zbl links ==

Here are the templates for [[Help:MSC_Templates | MSC, MR, Zbl]].
Usage is easy: See the code (="Edit" button) of one of the pages in [[:Category:TeX done]]. Most of them have the MSC encoding in their very first line.

MS Classification will automatically categorize the page. See 
[[Talk:EoM:This_project#Categories| here for the EoM categories]] as actually set up.

MR and Zbl links should be added to references.