The konwerter is the software, that automatically numbers the chemical compounds in publication. It is worth to notice that it can number anything, so can be used not only in chemistry. Only what you need to use it, is the LaTeX and an eps file creator, that produces a proper eps files (see compatibility list). It supports 5 types of numbering:
Additionally, one can use also small letter indexes for example 1a, 1b, 1c. This letter indexes can be used for every type of numbers, and konwerter doesn't check if it has any sense or not. So the author can do anything even something like: Aa, aa, where A and a are numbers, and small a in both are indexes.
Of course all these numbers type can be used in one document at the same time. How to achieve that functionality you can find in the next sections.
Why have I made this program? Like people say necessity is the mother of invention. Not another it was with konwerter.
When I was writing my msc thesis, at the almost end of my work, I had to add one more picture at the beginning of the document. Because in chemistry (yes, I'm chemist) all compounds should have own numbers, I had to renumber all formulas on all pictures. That was hard work. After that I thought, why I did it myself, such a thing should a computer do. I started to look in the Internet for proper software, but I didn't find anything. So I decided to write it myself.
The konwerter is written using c++ programming language. I realise that it is not the best choice, for such software, but I wanted to learn more about this language, and that was a good method to do that. When I will find some free time, I will rewrite it in python, that is much more suitable for such purpose, but that is a future.
Konwerter works similar to the \label, and \ref LaTeX methods. So instead of giving number to every compound, you give them a labels. In the TeX file, you use also labels. After your publication is ready you run konwerter on the main LaTeX file, and you get a file, where all labels are changed into numbers, both in eps and latex files.
In the eps file, one should place labels in special way. At present it is ?et{labelname}. So instead of writing 5, you should write ?et{labelname}. After compilation with konwerter, the number will appear at the question mark position. One can ask why in so complicated way? The answer is because of historical meaning. In the first version of konwerter, I implemented that method, and at present I did't want to change it. Maybe in the next version I will allow customization, but at present only such a way is correct.
The label should be prepared in special way and should contain only letters belong to the English alphabet and numbers. The dot, comma, colon and semicolon are generally not allowed, because have same meaning for konwerter. Underline "_" should also not be used, because that will make problems for LaTeX. At the beginning of label there should appear an instruction that informs konwerter which numbering style should be used. There are 5 switches:
If such instruction is not there, then default numbering style is used. Because konwerter reads eps file line by line, it doesn't really know, what is the order of labels there. Thats why it should be informed about order. We do that by adding a semicolon at the end of label, and then number. The konwerter reads labels in eps file, put them to the queue, and then order them using numbers. So if there appear such two labels:
the konwerter simply knows, that label benzene, should have lower number than label toluene. It is not necessary, to use succeeding numbers, you can use every second, third, forth etc. It is even advisable to do that in this way, because in case of adding a new structure to the picture, it will not be necessary, to change all others labels.
In case that one would like to add letter indexes to the number, the dot is used. The letters indexes are not given automatically, the konwerter just copies them from the label. So if you create label like: benzene.a, benzene.b, benzene.c konwerter will replace label with proper number, and then copy the letter. Finally one will get 1a, 1b, 1c.
Because in LaTeX exists many methods for graphics including, you have to inform konwerter about eps files
in which there are labels. To do that you should place below command:
%?plik{file_name.eps}
That is a comment in the LaTeX file, and doesn't have any influence for it. When konwerter finds such a line
in LaTeX file, it knows that file_name.eps should be searched for labels.
Konwerter understands also LaTeX \input command, so you can have multi file source.
To call the labels in LaTeX file, one should make special command (look into your LaTeX documentation to find out how to do it). Default is \nrzw{}, but it can be changed (see, command line arguments). Konwerter doesn't really care what \nrzw command does. It only looks for it in the text. That allows you to insert numbers into final document in any formating.
The labels in LaTeX file, should be the same like in eps files, but without semicolon and number at the end. For example when in the eps file you placed ?et{benzene;1}, ?et{:Rbenzene;2}, ?et{:abenzene.a;3} labels, in the LaTeX file you call them like: \nrzw{benzene}, \nrzw{:Rbenzene}, \nrzw{:abenzene.a}. All these labels are different for konwerter and all will receive different numbers.
If you write big publication, sometimes it is necessary, to change numeration for a new chapter etc. Konwerter supports also such thing. To achieve that it is enough to place in LaTeX file such instructions:
If one of the above instruction will be found in LaTeX file, in all new labels above settings will be used. It does not have any influence for old labels.
When your publication is ready, that is time, to compile the tex file using konwerter program. Just type:
konwerter file.tex
After that you will be given file file.tex.auto.tex, in which all labels are already replaced with numbers, both
in LaTeX file and eps files. You should compile this file using latex command.
-ltn, --labels-to-numbers - change labels to numbers [-n]
-ntl, --numbers-to-labels - change numbers to labels (only in eps files)
-srf n, --start-roman-from n - start number with small roman numbers from n [-srf 1]
-sRf n, --start-Roman-from n - start number with capital roman numbers from n [-sRf 1]
-saf n, --start-arabic-from n - start number with arabic numbers from n [-saf 1]
-slf n, --start-letter-from n - start number with small letters from n [-slf 1]
-sLf n, --start-Letter-from n - start number with capital letters from n [-sLf 1]
-dns n, --default-numbering-style n - set default number style. Possible walues: r, R, a, l, L [-dns a]
-ln, --label-name - LaTeX command for numbers inserting [\nrzw]. There must be always 2 backslashes ie. -ln \\xyz
-l, --language - set language. There are 2 possible parameters: [pl] and en. Unknown parameter is handle as en
-is, --ignore-switches - ignore switches %--set-X-to
-if, --ignore-formating - use for all labels default number style
-v, --verbose - be verbose
-t, --test - run konwerter but without changing the files. This option is used to check if there exist unresolved labels.
-h, --help - short help
--version - print version number and exit
Type konwerter -h, to see all command line parameters with short description.
Here you can find informations which programs produces eps files, that my konwerter understands. In case you will find any new, please send me an information.