Comprehensive TeX Archive Network
Cover Upload Browse Search

Direc­tory tex-archive/macros/latex/contrib/ionumbers


(This is a copy of the LaTeX code of the documentation's abstract.)

\textsf{ionumbers} stands for `input/output numbers'.

This package restyles numbers in math mode. If a number in the input file
is written, e.g., as |$3,231.44$| as commonly used in English texts, this
package is able to restyle it to be output as `$3\,231{,}44$' as commonly
used in German texts (and vice versa). This may be very useful, if you have
a large table and want to include it in texts with different output
conventions without the need of changing the table.

Furthermore this package can automatically group digits left to the decimal
separator (\emph{thousands}) and right to the decimal separator
(\emph{thousandths}) without the need of specifing commas (English) or
points (German) as separators. E.g., the input |$1234.567890$| can be
output as `$1\,234.\,567\,890$'.  By default, thousands/thousandths are
grouped in triplets, but the grouping length is configurable, which is
useful for numerical data.

Finally, an |e| starts the exponent of the number. For example, |$21e6$|
may be output as `$26\times10\,^{6}$'.

See `ionumbers.pdf' for detailed information on usage.


If you do not want to use any pre-build `ionumber.sty' and `ionumber.pdf'
files, you will have to choose one of the following two ways for building them.
Otherwise you can skip this section.

1) Building with make

Running `make' will create the LaTeX package, the documentation and the test
  $ make

2) Building manually

a) Generation of package (.sty file):

Run `ionumbers.ins' through LaTeX:
  $ pdflatex -interaction=nonstopmode ionumbers.ins

b) Generation of documentation:

Run `ionumbers.dtx' through LaTeX:
  $ pdflatex -interaction=nonstopmode ionumbers.dtx

Then create the index and change history:
  $ makeindex -s -o ionumbers.ind ionumbers.idx
  $ makeindex -s -o ionumbers.gls ionumbers.glo

Finally, run `ionumbers.dtx' three time through LaTeX:
  $ pdflatex -interaction=nonstopmode ionumbers.dtx
  $ pdflatex -interaction=nonstopmode ionumbers.dtx
  $ pdflatex -interaction=nonstopmode ionumbers.dtx

Optionally you can compile the test file:
  $ pdflatex -interaction=nonstopmode ionumbers_test.tex
  $ pdflatex -interaction=nonstopmode ionumbers_text.tex
  $ pdflatex -interaction=nonstopmode ionumbers_text.tex


1) Installing with make

To install the package into a TDS (= TeX directory structure; typically its base
directory is named `texmf' or something similar), run the following command:
  $ make DESTDIR=<your TDS> install

Note: `$(DESTDIR)' defaults to `$(HOME)/.texmf'.

2) Installing manually

In principle, you will only habe to copy the file `ionumbers.sty' into a
directory, where LaTeX can find it.  If you copy it into a TDS (TeX directory
structure), you will most probably have to run the following command afterwards:
  $ mktexlsr <your TDS>


Copyright 2007--2009,2011 Christian Schneider <software(at)chschneider(dot)eu>

idea and parts of this package based on: ziffer.sty v2.1
Copyright Martin Vaeth <>

ion@addto@macro: identical to l@addto@macro from koma-script
                 bundle v2.9t
Copyright 1994-2004 Markus Kohm and Frank Neukam

Thanks to Martin Vaeth and Markus Kohm for permitting to use their
code in this package. Please do not bother Martin, Markus, or Frank
with questions or bugs concering this package!

This file is part of ionumbers.

ionumbers is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3 as
published by the Free Software Foundation, not any later version.

ionumbers is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with ionumbers.  If not, see <>.



Name Size Date Notes
COPYING 35147 2008-10-27 01:22
Makefile 2265 2012-08-16 01:04
README 4247 2011-06-12 23:38
ionumbers.dtx 58784 2014-04-06 23:46
ionumbers.ins 3094 2008-11-02 19:55
ionumbers.pdf 359743 2014-04-15 07:07
ionumbers_test.pdf 111026 2014-04-15 07:07
ionumbers_test.tex 21253 2011-06-09 18:32

Down­load the con­tents of this pack­age in one zip archive (485.5k).

ion­um­bers – Restyle num­bers in maths mode

ion­um­bers’ stands for ‘in­put/out­put num­bers’.

The pack­age restyles num­bers in maths mode. If a num­ber in the in­put file is writ­ten, e.g., as $3,231.44$ as com­monly used in English texts, the pack­age is able to restyle it to be out­put as $3\,231{,}44$ as com­monly used in Ger­man texts (and vice versa). This may be use­ful, for ex­am­ple, if you have a large ta­ble and want to in­clude it in texts with dif­fer­ent out­put con­ven­tions with­out the need to change the ta­ble.

The pack­age can also au­to­mat­i­cally group dig­its left of the dec­i­mal sep­a­ra­tor (thou­sands) and right of the dec­i­mal sep­a­ra­tor (thou­sandths) in triplets with­out the need of specif­ing com­mas (English) or points (Ger­man) as sep­a­ra­tors. E.g., the in­put $1234.567890$ can be out­put as $1\,234.\,567\,890$.

Fi­nally, an e starts the ex­po­nent of the num­ber. For ex­am­ple, $21e6$ may be out­put as $26\times10\,^{6}$.

Pack­age De­tailsion­um­bers
Ver­sion0.3.3 2014-04-06
Li­censeGNU Gen­eral Public Li­cense
Copy­right2007-2009,2011,2012,2014 Chris­tian Sch­nei­der
Main­tainerChris­tian Sch­nei­der
Con­tained inTeXlive as ion­um­bers
MikTeX as ion­um­bers
Topics for­mat­ting num­bers, etc
Guest Book Sitemap Contact