diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/ite |
Initial commit
Diffstat (limited to 'support/ite')
37 files changed, 2565 insertions, 0 deletions
diff --git a/support/ite/FAQ.html b/support/ite/FAQ.html new file mode 100644 index 0000000000..788d0e2083 --- /dev/null +++ b/support/ite/FAQ.html @@ -0,0 +1,775 @@ +<html> +<body> +<pre> +QUESTION: + +Return-Path: <ijtrotts@ucdavis.edu> +Sender: ijtrotts@ucdavis.edu +Date: Mon, 22 Jun 1998 20:07:09 -0700 +Subject: iTe bug + +Hello! I just ran the iTe demo and found what appears to +be a bug. After xemacs and ghostscript came up the cursor +started to change numbers in the document but the ghostscript +window remained blank for the entire demo. Do you know why +this happened? + +thanks, +Issac + +-- +Issac Trotts +mailto:trotts@cs.ucdavis.edu +homepage: http://graphics.cs.ucdavis.edu/~trotts + + +ANSWER: + +Hello, + +I had a bug with these symptoms once, and I fixed it on all platforms +listed in the manual. Today I discovered that the demo does not run +with Emacs, but I fixed it. You are probably using XEmacs. The demo +is a hard exercise for the Emacs-family, which is not really intended +for these kind of animations. If the example works via (see manual) + + > latex example.tex + > xemacs -load ite.el + +then iTe runs on your platform. If the example does not run, please let +me know. Otherwise, the demo isn't working for some strange emacs-internal +reason. But then it's just a demo. + +Wolfgang + + + +QUESTION: + +Thanks for your advice about iTe. I'll give that a try. In the +meantime, is there any way to use iTe without XEmacs? +I like to use vi to conserve memory. + +ANSWER: + +Of course you can use Emacs, which is somewhat smaller. +iTe is mainly written in emacs-lisp, so vi will definitely +not do. + +Wolfgang + + +QUESTION: +Manuel Hölß wrote: + +Dear Mr. Kühn. + A few days ago I bekame a hint on your iTe. I think it's a great Idea +and it +makes it very easy to create and maniplulate Graphics in TeX. + I first had it running on a DEC-Workstation without problems but on my +linux-PC +(SuSE -Linux, Kernel 2.0.34, xemacx 20.4, devips 5.58, gv 4.03) it +behaved a little strange: + +The blue box indicating the frame of the iteblock-environment and the +motion of the objects +in the gs-window have the double size, they should have. +The result of this is, that when a object is placed correctly in the +gs-window, the Numbers +in the argument change only half of the distance teh object was moved. +So rcompiling the tex-file +results in on output, where all the objects are moved back half the +distance they were moved. +Perhaps you have an Idea, where this problem may come from ? I'd be glad +if you could tell me. + +An other point I wanted to mention is that there is an easy possibility +to work around one restriction +given in sect 13 of the manual. It's the point, that an iteblock may not +appere in includet files. +Just setting a symbolic link allows to use an iteblock in included +files: +> ln -s <masterfile>.dvi <inputfile>.dvi +Perhaps it's not a very elegant way to solve the problem, but it works. + + +ANSWER + +Hallo, + +Die neuste Version (1.1) von iTe ist jetzt fertig. Bitte teilen Sie mir mit, ob der Fehler behoben ist. + +Die von Ihnen vorgeschlagene Moeglichkeit, iteblock Umgebungen in +include files zu ermoeglichen, funktioniert so nicht. Die naechste +Version von iTe (nicht bis Anfang Oktober) wird aber Master und Slave- +files unterstuetzen. + +Wolfgang + + +QUESTION + +Jan Vroonhof wrote: + +Wow! nice idea, it is certainly cool. + +However I found a bug/have a few remarks. + +(iTe 1.0, XEmacs 21.0preX-mule or XEmacs 20.4-nomule) + +1. First the bug + +start XEmacs, load ite.el +C-x C-f example.tex +M-x ite +C-x o to switch to ite message buffer window. +C-x b *scratch* to hide the message buffer +C-x o to switch back to example.tex window +h + +gives + Wrong type argument: windowp, nil + + +Suggested solution: The problem lies in the ite-message + +(defun ite-message (s) + (save-excursion + (let ((w (selected-window))) + (setq ite-message-buffer (get-buffer-create "iTe Message")) + (select-window (get-buffer-window ite-message-buffer)) +;(set-buffer ite-message-buffer) + (goto-char (point-max)) + (insert s) + (end-of-buffer) + (select-window w)))) + +when ite-message-buffer is not displayed in any window +get-buffer-widnow gives nil, which makes select-window barf. +You probably just want some thing like + +(switch-to-buffer-other-window (get-buffer-create "iTe Message"))). + +The more standard way would be to use (with-output-to-temp-buffer + +(defun ite-message (s) + (with-output-to-temp-buffer "iTe Message" + (princ s))) + +2. ite.el contains a few things that are generaly considered to be bad + taste, like messing with debug-on-error, or this.... + + (if (equal (nth 2 command-line-args) "ite.el") (ite)) + +3. Just as suggestion. Since all the magic seems to lie in the in place + editing of the dvips output, may I put on the whish list + a. Make ite a minor mode such that ite can use all the AucTeX magic to + handle multifile document etc. + b. Do a away with all the temp files and have Emacs pipe from dvips + and into gs. + +Keep up the good work. Don't let my criticims get to you, they are +meant to be constructive. + +I have to go we have a power cut off soon, + + +Jan + +ANSWER + +Hello, + +thank you for your remarks concerning iTe. + +Remark 1: +%start XEmacs, load ite.el +%C-x C-f example.tex +%M-x ite +%C-x o to switch to ite message buffer window. +%C-x b *scratch* to hide the message buffer +%C-x o to switch back to example.tex window +%h +% +%gives +% Wrong type argument: windowp, nil +% +%Suggested solution: The problem lies in the ite-message +% +%(defun ite-message (s) +% : +% :) +% +%when ite-message-buffer is not displayed in any window +%get-buffer-widnow gives nil, which makes select-window barf. +%You probably just want some thing like +% +%(switch-to-buffer-other-window (get-buffer-create "iTe Message"))). +% +%The more standard way would be to use (with-output-to-temp-buffer + +The problem is that I want that the message window always scrolls to the +end of the buffer. This is not the case by simply defining. The bug is +fixed in the current version 1.1. + +%(defun ite-message (s) +% (with-output-to-temp-buffer "iTe Message" +% (princ s))) + +Remark 2: +% ite.el contains a few things that are generaly considered to be bad +% taste, like messing with debug-on-error, or this.... +% +% (if (equal (nth 2 command-line-args) "ite.el") (ite)) + +I admit this is pretty ugly. It is only needed for the demo, but +I couldn't find a way around it. debug-on-error is only switch on +by users who know what they are doing anyway. + +Remark 3: +% Just as suggestion. Since all the magic seems to lie in the in place +% editing of the dvips output, may I put on the whish list +% a. Make ite a minor mode such that ite can use all the AucTeX magic to +% handle multifile document etc. +% b. Do a away with all the temp files and have Emacs pipe from dvips +% and into gs. + +For a) I agree. iTe will handle mulifiles from version 1.2 on(not +before beginning of October). For b), I tried it but it turned out to +be very, very slow to pipe huge junks of PostScript from Emacs to +gs. I don't know where the bottleneck occurs. Therefore I implemented +a file interface instead of pipes. However, it is possible to do away +with all the temp files using some PostSript hacks, given the time. + + +Wolfgang + + +QUESTION: + +Nicolas FRANCOIS (nicolas.francois@hol.fr) wrote: + +It happens that on zin95, launching the command + +gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts example.ps + +works fine to preview the file. + +But when I write + +(defvar ite-gs-command "gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts " +Message 2/33 From Nicolas FRANCOIS Sep 2, 98 03:20:26 am +0200 + + +Return-Path: <nfrancoi@hol.fr> +X-Sender: nfrancoi@pop.hol.fr (Unverified) +Date: Wed, 02 Sep 1998 03:20:26 +0200 +Subject: progresses + +It happens that on zin95, launching the command + +gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts example.ps + +works fine to preview the file. + +But when I write + +(defvar ite-gs-command "gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts " + "Shell command to invoke ghostscript.") + +and carefully add + + (setq ite-process + (start-process-shell-command "ite" + ite-message-buffer ite-gs-command ite-name-ps)) + ----------- + +to the ite function, I manage to launch gs, but it doesn't seem to notice +the option -I because it returns : 'gs can't find gs_init.ps', which happen +to reside in c:\gstools\gs5.03 ! + +The command line works from the shell (in 'execute' menu, I mean), but not +from within NTemacs ! Funny, isn't it ? + +Well, if you manage to find a solution, you will be authorized to add 'PC +zin95 + NTemacs + dvips + gswin32' on your hardware compatibility list ! + +Oh, I downloaded the version 1.11, but don't know the magic formula to +install it ! looks like a Linux installation process !? (unfortunately, my +fucking machine refuses to print on my fucking Zin-specific Laser printer +under Linux :-(=) ). + +So I'm still using version 1.00 (is that so ?). + +Hope to read you soon. Sorry for poor english, in France you have rarely +the occasion to practice english. + + +ANSWER: + +Hello, + +iTe Version 1.1 is available since yesterday evening. However, +I uploaded a incomplete version 1.1 already on monday, which you might +have downloaded. So please load the correct version and install it +with the configure script (real easy) after unpacking. If the +configure script doesn't work on your machine, simply replace +the following line in 'ite.in' + +(defvar ite-load-path "." + "Directory from which iTe is loaded. This variable is set by the configure script.") + +by the line + +(defvar ite-load-path "iTeDirectory" + "Directory from which iTe is loaded. This variable is set by the configure script.") + +where iTeDirectory is the ABSOLUTE path of the directory in which iTe +resides, for example + +(defvar ite-load-path "/home/myname/ite" + "Directory from which iTe is loaded. This variable is set by the configure script.") +Then rename 'ite.in' to 'ite.el'. + + +Now set in 'ite.el' + +(defvar ite-gs-command + "gs - -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts") + +and RESTART Emacs. If you tried exactly this before and it didn't +work, then you have to tell me what went wrong. Also, please don't use +gsview. Gsview is a previewer and not a PostScript interpreter like +gs. The latter is needed. + +I am happy to make this work for you, + +Wolfgang + +QUESTION + + +ANSWER + +Hello, + +Please put the "-" to the end, i.e. + +(defvar ite-gs-command "gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts -") + +Quote use.txt of gs distribution: + + - + This is not really a switch. It indicates to Ghostscript + that the standard input is coming from a file or a pipe. + Ghostscript reads from stdin until reaching end-of-file, + executing it like any other file, and then continues + -------- + processing the command line. At the end of the command + line, Ghostscript exits rather than going into its + interactive mode. + +I don't know if the (not) doubling of "\" is the cause, but it might well be. + +You might also try + +(defvar ite-gs-command "set GS_LIB c:\gstools\gs5.03;c:\gstools\gs5.03\fonts; gswin32 -") + +if all fails. Please keep me posted. + + +Wolfgang + +ANSWER +Andrew Innes wrote: +Message 1/39 From Andrew Innes Sep 3, 98 10:53:32 am +0100 + +Return-Path: <andrewi@harlequin.co.uk> +Date: Thu, 3 Sep 1998 10:53:32 +0100 (BST) +To: nfrancoi@hol.fr +Subject: Re: strange behaviour with process + +On Thu, 03 Sep 1998 04:08:31 +0200, Nicolas FRANCOIS <nfrancoi@hol.fr> said: +>(defvar ite-gs-command "gswin32 - -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts" + +You need to double the \'s when writing a lisp string. + +AndrewI + +QUESTION + +Nicolas FRANCOIS wrote + +Ok, now I can launch ghostscript (I have added the missing \ and put the +option - at the end of the command line). + +The remaining problem is the following : the graphic window is empty ! I +have tried to change the location of the example.ps file, and this is what +I have discovered : + +- if I launch the command from the 'execute menu' : + gswin32 -Ic:\gstools\gs5.03;c:\gstools\gs5.03\fonts example.ps + with the example.ps file in \gstools\gs5.03, it works. + +- if I launch the same command with the example.ps file in /temp, gs shows +a blank result (until there, no problem). + +- the attempts to execute ite result in an other blank window. + +Well, the problem seems to be that gs doesn't see the file, in a way or an +other. + +What can I do more ? + +Note : I have tried ite.el under Linux, it works fine, but my Alt key +doesn't work (I have a french keyboard, and the ESC key isn't the right key +for certain functions). Someone works on both platforms ? + +ANSWER + +Hello, + +Ok, suppose you have set + +(defvar ite-gs-command + "gswin32 -Ic:\\gstools\\gs5.03;c:\\gstools\\gs5.03\\fonts -") + +and iTe, at one point, executes + +(start-process-shell-command "ite" ite-message-buffer ite-gs-command) + +At this point, you should see an empty gs window, because no command +or command line option was issued to load and run a ps file. + +At some other point, iTe issues a + + (ite-select-page 0) + +which should display the first page in the gs window. This is done by +the commands ite-write, which writes the page to a temporary file in /tmp, +and ite-run-close, which sends the command to gs to run this file. + +If the window stays empty, please set + + (defvar ite-debug-level 1) + +and restart Emacs. You will then see some diagnostic output which tells +you the reason why the file couldn't load. + +On problem could be that you don't have a /tmp directory on your machine. +In this case, replace /tmp by /temp, or whatever. + + +Concerning the ALT key: The ESC definitely doesn't work. +Fortunately, you don't need the ALT key much. What I suggest is +the following: +Go to the *scratch* buffer and type in + + (if (fboundp 'events-to-keys) + (events-to-keys (read-key-sequence "")) + (read-key-sequence ""))C-j + +followed by and "ALT uparrow". Here C-j is "Control j". + +The result will be something like + + [M-up] +or + [(meta up)] + +Now replace [(meta up)] in the line + +(define-key ite-mode-map [(meta up)] + (function (lambda () (interactive) (ite-move 0 1))))) + +by whatever you got. Voila, you rebound the key "ALT uparrow". + +Unfortunately (for the unresolved problem, not for me) I will now +leave for vacation for 3 weeks (to France). I will check back with you +on my return. + +Have a nice time + +Wolfgang + + +QUESTION + +Sender: hoover@dmehpi-f.epfl.ch +Date: Mon, 19 Oct 1998 12:58:00 +0200 + +Hi. I'm not sure if this is a iTe bug or an emacs bug, but I thought +you might be interested. + +I have the following LaTeX hooks. + +(add-hook 'latex-mode-hook 'outline-minor-mode) +(add-hook 'latex-mode-hook 'font-lock-mode) + +When I run iTe, the menus that +correspond to outline mode disappear. When I quit iTe, they don't +come back. + +Thanks for iTe. Great program! + +Dave Hoover. + + +ANSWER + +Hello, + +Thank you for reporting this to me. There is indeed a problem. A +quick fix is to replace the line + +(add-hook 'latex-mode-hook 'outline-minor-mode) + +by + +(add-hook 'latex-mode-hook '(lambda () (interactive) +(outline-minor-mode t))) + +With this change the outline menue will not disappear. However, all +text will "show" after quitting iTe. I will try to fix this in the +next version (1.2) of iTe. + +Wolfgang Kuehn + +QUESTION + +From: David Welton <davidw@gate.cks.com> +Subject: iTe license +Mime-Version: 1.0 +Content-Type: text/plain; charset=us-ascii +X-Mailer: Mutt 0.91.2 +Content-Length: 1400 +Status: RO + +Hi, I found your iTe program to be very nice, just what I was looking +for. Being a Debian GNU/Linux maintainer, I thought about making a +Debian package for it, so that more people could use it. I noticed +the license is very non-free, though: + + All files in this distribution are copyrighted. You are allowed to + freely copy and use these files for non-commercial use only. Do not + redistribute a version which is incomplete or is changed in any way. + The author makes no representations about the suitability of this + software for any purpose. It is provided as is without expressed or + implied warranty. + +I'm curious if you have plans to change any of these terms, or might +be convinced that there are good reasons to? For instance, you say +'non-commercial use only', yet you don't have prices for those who +might wish to purchase it. If you were interested in making it so +that more people could use and participate in improvement of this +software, you might consider using an 'Open Source' +(www.opensource.org), or Free license. If you are worried that people +will distribute incomplete, or modified versions that reflect poorly +on your work, you could put something that says that "modified +versions must use a name other than 'iTe'", for example. + +Anyway, I thank you for your time, +-- +David Welton http://www.efn.org/~davidw + + Debian GNU/Linux - www.debian.org + + +ANSWER + +Hello, + +The copyright of versions 1.0 and 1.1 was chosen that strict because +at the time I didn't know where the project would go. Meanwhile it +became clear that a) iTe is much appreciated by many TeX users, and +that b) I will not be able to maintain iTe indefinitely. + +Version 1.2, which is completely rewritten and significantly +extended, will therefore be covered under one of BSD/GPL/OSS/... +licenses. It is due next week. + +Wolfgang Kuehn + + + +QUESTION + +From: Bruce Foster <bef@nwu.edu> +Subject: iTe 1.1 Problem with make-temp-name in lisp program +Content-Length: 1759 +Status: RO + +I am trying to install iTe for a general UNIX user situation. I have about +25 machines, all sharing a common file system. Multiple users per machine, +as well as multiple machines. + +In reviewing the configuration program, I discovered that the ite.el lisp +program defines a variable named make-temp-name as /tmp/ite. I _assume_ +that this means that a file or directory with that name will be created. + +That approach is fine for a single-user UNIX system, but it fails if two +people try to use iTe at the same time on the same system. It might fail if +the SAME person tries to use iTe from two sessions at the same time. + +It would be best to use a unique file name for this variable. And it would +be a good idea to point out this situation at configuration, because many +systems do not want files created in /tmp by applications programs -- other +filesystems should be used instead. + +I don't know enough about emacs and elisp to know how to fix this problem. +The problem is serious enough to prevent me from installing iTe. So I'm +calling your attention to it. + +Another configuration question. A path is altered to point to the directory +that ite is configured from. There also seems to be a reference to the file +ite_init.ps. Does that file have to be in the same directory that ite.el +resides in? + +I would really like to make iTe available from the emacs site-lisp +directory. If so, what other files have to be put in the same directory? + +Thanks for your assistance! + +Bruce Foster + + +ANSWER + +Hello, + + +>> In reviewing the configuration program, I discovered that the +>> ite.el lisp program defines a variable named make-temp-name as +>> /tmp/ite. I _assume_ that this means that a file or directory with +>> that name will be created. + +There is no problem to run iTe on multi-user platforms. Even a single +user can run several copies of iTe processes, provide each iTe runs +from within a different (X)Emacs session. You assume wrongly that +make-temp-name is a variable, where in fact it is a function. Given +an input string ("/tmp/ite" for example), it returns a unique file or +directory name starting with, but not equal to, this string. The +ELisp manual says + + - Function: make-temp-name STRING + This function generates a string that can be used as a unique + name. The name starts with STRING, and ends with a number that is + different in each XEmacs process. + + (make-temp-name "/tmp/foo") + => "/tmp/foo021304" + + To prevent conflicts among different libraries running in the same + XEmacs, each Lisp program that uses `make-temp-name' should have + its own STRING. The number added to the end of the name + distinguishes between the same application running in different + XEmacs processes. + + +What (X)Emacs does is to append an id to the string that is derived +from the process id of the currently running (X)Emacs process. + +>> many systems do not want files created in /tmp by applications +>> programs -- other filesystems should be used instead. + +The next version of iTe (1.2) will first try to create temporary files +in the directory pointed to by the environment variable TMPDIR, then +in '/usr/tmp', then in '/tmp', and then in '.' if all fails. Would +this be working in your setting? A workaround for version 1.1 would +be to replace the line + + (setq s (make-temp-name "/tmp/ite")) + +in ite.el by + + (setq s (make-temp-name "/usr/tmp/ite")) + +for example. + +>> Another configuration question. A path is altered to point to the +>> directory that ite is configured from. There also seems to be a +>> reference to the file ite_init.ps. Does that file have to be in the +>> same directory that ite.el resides in? + +No. Right now the only file that needs to be in 'ite-load-path' is +'ite_init.ps'. The best way to install iTe globally is as follows: + +a) Put 'ite.el' to your site lisp directory, for example +'/usr/local/share/emacs/site-lisp' and append the 'load-path' variable +if necessary. + +b) Put 'ite_init.ps' to '/usr/local/share/emacs/etc/ite' and set +'ite-load-path' to this directory. + +c) Put 'ite*.tex' files at a place where TeX will find it, for example +to '/usr/local/share/teTeX-0.4pl8/texmf/tex/generic/ite' if you are +using teTeX, or set your TEXINPUTS environment variable accordingly. + +All other files in the distribution are not essential. You may put +them to '/usr/local/share/ite', for example. + +Thank you for your contribution, + +Wolfgang Kuehn + + +QUESTION + +j.w.kluwer@filosofi.uio.no (Johan W. Kl|wer) +Subject: iTe suggestion + +Dear Mr. Kühn, + +I just had the pleasure of putting your iTe package to work on a real +problem, with great success. I really like the concept you have used +in iTe---an elegant use of already available resources! + +Now, in the particular case I had to deal with, I did have a problem: +iTe would never stop parsing the postscript file on top of which the +LaTeX material was supposed to go. I tried making tea and looking out +the window, editing the EPS file, nothing worked. The way out for me +turned out to be this: Generate a bitmap from the EPS, substitute that +bibmap into the text for the iTe run, then put the EPS back into the text. + +It seems to me that EPS comes in many qualities, and problems are in +my experience to be expected. The bitmap approach, however, can hardly +fail. Perhaps this simple workaround should be mentioned in the +manual? + +All the best, + +ANSWER + + +Hello, + +Yes, an eps document may fool iTe, and especially the longer ones. +The next version of iTe handles eps files differently, and your +problem will probably dissolve. Your approach with the bitmap is +correct. You can even assist from with your LaTeX code by saying + +\DeclareGraphicsExtensions{.b.eps,.eps} + +and then say + +\includegraphics{foo}. + +If the, presumably bit-mapped, file 'foo.b.eps' exists, it is +included. Otherwise the original 'foo.eps'. This way it is also +possible to include huge eps files inside 'iteblock' environments and +still achieve respond times suitable for interactive use. + +Before printing the file, don't forget +to disable this feature, i.e., by + +%\DeclareGraphicsExtensions{.b.eps,.eps} + +Thank you for your contribution, + +Wolfgang Kuehn + + +PS: Could you send me this 'wicked' eps file? +</pre> +</body> +</html>
\ No newline at end of file diff --git a/support/ite/bindings.html b/support/ite/bindings.html new file mode 100644 index 0000000000..a9482de2c9 --- /dev/null +++ b/support/ite/bindings.html @@ -0,0 +1,115 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>Default Key-Bindings</TITLE> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY > + <div> + <B>Next:</B> <A HREF="winmanager.html">Taming the Window</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="largefiles.html">Large eps-Files</A> + </div> + + <H1>Default Key-Bindings</H1> + + <P> + The following table lists the <EM>default</EM> key binding. The actual + key bindings on your system could be different due to <a href="installation.html#customization">customization</a>. + </P> + + <TABLE align="center" CELLPADDING=3 BORDER="1" style="text-align:center"> + <TR><th>KEY</th> + <th>BINDING</th> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Navigational keys</TD> + </TR> + <TR><TD>space</TD> + <TD>select next page with objects</TD> + </TR> + <TR><TD>b</TD> + <TD>select previous page with objects</TD> + </TR> + <TR><TD>n</TD> + <TD>select next object</TD> + </TR> + <TR><TD>p</TD> + <TD>select previous object</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Object manipulation keys first binding</TD> + </TR> + <TR><TD>up-arrow</TD> + <TD>move selected object up</TD> + </TR> + <TR><TD>down-arrow</TD> + <TD>move selected object down</TD> + </TR> + <TR><TD>left-arrow</TD> + <TD>move selected object left</TD> + </TR> + <TR><TD>right-arrow</TD> + <TD>move selected object right</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Object manipulation keys second binding</TD> + </TR> + <TR><TD>up-arrow</TD> + <TD>magnify selected object</TD> + </TR> + <TR><TD>down-arrow</TD> + <TD>shrink selected object</TD> + </TR> + <TR><TD>left-arrow</TD> + <TD>rotate counterclockwise</TD> + </TR> + <TR><TD>right-arrow</TD> + <TD>rotate clockwise</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Toggle keys</TD> + </TR> + <TR><TD>t</TD> + <TD>toggle between first and second binding</TD> + </TR> + <TR><TD>o</TD> + <TD>toggle bounding box only on/off</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Modifiers for object manipulation keys</TD> + </TR> + <TR><TD>Ctrl</TD> + <TD>manipulate in smaller steps</TD> + </TR> + <TR><TD>Alt</TD> + <TD>manipulate in tiny steps</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Zooming</TD> + </TR> + <TR><TD>Z</TD> + <TD>no zoom, not centered</TD> + </TR> + <TR><TD>z</TD> + <TD>no zoom but center</TD> + </TR> + <TR><TD>Ctrl z</TD> + <TD>zoom in on current object</TD> + </TR> + <TR><TD>Alt z</TD> + <TD>zoom in even more</TD> + </TR> + <TR><TD COLSPAN=2 style="background-color:#fff0ff">Miscellaneous</TD> + </TR> + <TR><TD>r</TD> + <TD>redisplay page (refresh)</TD> + </TR> + <TR><TD>q</TD> + <TD>quit</TD> + </TR> + </TABLE> + + <P> + The zoom key 'z' may take a numerical prefix. This number divided by 10 + is then the zoom factor. For example, the key sequence 'M-30z' will zoom in + on the current object by a factor of 3. + </p> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Mar 27 2005</div> +</BODY> +</HTML> diff --git a/support/ite/bugs.html b/support/ite/bugs.html new file mode 100644 index 0000000000..115cb87852 --- /dev/null +++ b/support/ite/bugs.html @@ -0,0 +1,248 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>Bugs and Feedback</TITLE> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <LINK REL="STYLESHEET" HREF="manual.css"> + <style type="text/css"> + pre.code { font-family:Helvetica; padding-left:1cm; } + </style> + </HEAD> + <BODY> + <p> + <B>Next:</B> <A HREF="news.html">What is new</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="error_messages.html">Error Messages</A> + </p> + + <H1>Bugs and Feedback</H1> + + <h3>Reporting bugs</h3> + <p> + Before you report a bug to me at <a href="mailto:wolfgang@decatur.de">wolfgang@decatur.de</a>, + please download the newest version of <span class=ite>iTe</span> and check if the bug persists. + Note that there may be a <a href="http://www.decatur.de/ite">most recent (beta) release</a>, including bug reports and workarounds. + </p> + <p> + Also check the following <B>bug list</B>. If you do report a bug, please provide the following, if possible: + </p> + <UL> + <LI>Version of <span class=ite>iTe</span>: + <LI>Version of <TT>Emacs</TT> or <TT>XEmacs</TT>: + <LI>Version of <TT>dvips</TT>: + <LI>Version of <TT>gs</TT>: + <LI>Version of <TT>perl</TT>: + <LI>Does the demo run? + <LI>Concise description of bug: + <LI>Any idea how the bug may be fixed: + </UL> + + <h3>Bug list for iTe 3_0</h3> + <dl> + <dt>BUG</dt> + <dd>Latex style <tt>import.sty</tt> is incompatible with iTe.</dd> + <dt>FIX</dt> + <dd>Install Version 3_1 or in file <tt>tex/ite.sty</tt>, replace the line + <pre> + \def\ite@input#1{\message{ITEKEYOPEN}\iteinput#1\message{ITEKEYCLOSE}} + </pre> + by the line + <pre> + \def\ite@input#1{\message{ITEKEYOPEN}\iteinput{#1}\message{ITEKEYCLOSE}} + </pre> + </dd> + </dl> + + <h3>Bug list for iTe 2_20</h3> + <dl> + <dt>BUG</dt> + <dd>Newer versions of Gnu Emacs (probably >21.2) break iTe's menubar. + </dd> + <dt>FIX</dt> + <dd>Install Version 3_0 + </dd> + <dt>BUG</dt> + <dd>Newer versions of dvips(k) (probably >5.90) will produce invalid PostScript code. + </dd> + <dt>FIX</dt> + <dd>Install Version 3_0 or in file <tt>ite.ps</tt>, insert the line + <pre> + TeXDict begin + </pre> + before the line + <pre> + ITEDict begin + </pre> + </dd> + </dl> + + <h3>Bug list for iTe 2_15</h3> + <dl> + <dt>BUG</dt> + <dd>On recent Linux installations, no ghostscript window appears after iTe is invoked. + </dd> + <dt>FIX</dt> + <dd>Install Version 2_20 or in file ite.el, replace the line<br> + <pre class=code> + (defcustom ite-gs-command "gs -c /iTeInit == flush -" + </pre> + by the line<br> + <pre class=code> + (defcustom ite-gs-command "gs -sDEVICE=x11 -c /iTeInit == flush -" + </pre> + Thanks to Heribert Weigert. + </dd></dl> + + <h3>Bug list for iTe 2_1 (June 2000)</h3> + <dl> + <dt>BUG</dt> + <dd>iTe either fails to start up or displays initial pages + which do not contain iTe blocks.</dd> + <dt>FIX</dt> + <dd>Install Version 2_15 or in file ite.pl, replace the line<br> + <pre class=code>until ( $. >= @pages[0]->{BEGINLINE} ) {</pre> + by the line<br> + <pre class=code>until ( /%%Page:/ ) {</pre> + </dd></dl> + + <h3>Bug list for iTe 2_01 (December 1999)</h3> + <dl> + <dt>BUG</dt> + <dd>On some window managers, an error is signaled if + the iTe online help is accepted on startup.</dd> + <dt >FIX</dt> + <dd>Do not accept. You can invoke the online help later + by typing ´h´ or using the iTe menu.</dd> + </dl> + + <h3>Bug list for iTe 2_0 (November 1999)</h3> + <dl> + <dt>BUG</dt> + <dd>The <tt>\include</tt> macro does not work.</dd> + <dt>FIX</dt> + <dd>Replace the following line in ite_tex or ite.sty + <pre class=code> +\def\include#1{\message{ITEKEYOPEN}\iteinclude#1\message{ITEKEYCLOSE}} + </pre> + by + <pre class=code> +\def\include#1{\message{ITEKEYOPEN}\iteinclude{#1}\message{ITEKEYCLOSE}} + </pre></dd> + + <dt>BUG</dt> + <dd>The Makefile is broken.</dd> + <dt>FIX</dt> + <dd>Replace the following line in the Makefile + <pre class=code> +-e "s|iTeDocPath|$(srcdir)/doc" \ + </pre> + by + <pre class=code> +-e "s|iTeDocPath|$(srcdir)/doc|" \ + </pre></dd> + </dl> + + <h3>Bug list for iTe 1_4 (May 1999)</h3> + + <dl><dt>BUG</dt> + <dd>Unbalanced parenthesis in the (La)TeX log-file throws iTe + into an endless loop.</dd> + <dt>FIX</dt> + <dd>Install iTe 2_0.</dd> + </dl> + + <dl><dt>BUG</dt> + <dd>Using the <tt>seminar</tt> package, iTe gets the scaling + wrong in some cases. + </dd> + <dt>FIX</dt> + <dd>Install iTe 2_0.</dd> + </dl> + + <h3>Bug list for iTe 1_3 (April 1999)</h3> + + <dl><dt>BUG</dt> + <dd>In <tt>test-basic.tex</tt>, the iTe package should be + loaded without the <tt>[graphics]</tt> option. + </dd> + <dt>FIX</dt> + <dd>Remove the option.</dd> + </dl> + + <dl><dt>BUG</dt> + <dd>For Plain TeX only: iTe does not work + correctly if <tt>\magnification</tt> values different from 1000 + are used. + </dd> + <dt>FIX</dt> + <dd>There is no work-around.</dd> + </dl> + + <h3>Bug list for iTe 1_2 (Feb 1999)</h3> + + <dl><dt>BUG</dt> + <dd> Perl script does not handle big (>ite-ps-limit bytes) iTe objects + (reported by Torben Hoffmann). + </dd> + <dt>FIX</dt> + <dd> In <code>/ite/rsc/ite.pl</code>, replace the line + <pre class=code>print $fh "\n($FN) run\n";</pre> + by + <pre class=code>print PAGE "\n($FN) run\n";</pre></dd> + </dl> + + <dl><dt>BUG</dt> + <dd><code>make install</code> cannot handle relative path names + for <code>texdir</code> and <code>lispdir</code>. + </dd> + <dt>FIX</dt> + <dd>Use absolute path names.</dd> + </dl> + + <dl><dt>BUG</dt> + <dd>iTe fails to parse the (La)TeX log file correctly when + <code>\tracingmacros</code> is set. + </dd> + <dt>FIX</dt> + <dd>Don't use <code>\tracingmacros</code> when running iTe.</dd> + </dl> + + + <h3>Bug list for iTe 1_1 (Aug 1998)</h3> + + <dl><dt>BUG</dt> + <dd>iTe scrambles macros in the TeX source that + start with <code>\ite</code> and do not continue with an 'm', such + as <code>\iterate</code>.</dd> + <dt>FIX</dt> <dd>Replace the single + occurrence of <code>[^m]</code> in ite.el by <code>[^a-zA-Z]</code>.</dd> + </dl> + + <dl><dt>BUG</dt> + <dd>Pages are displayed but + immediately erased (GhostScript version 5_50).</dd> + <dt>FIX</dt> + <dd>Replace all two occurences in 'ite.el' of <code>copypage</code> by + <code>flushpage</code>. + </dd> </dl> + + <dl><dt>BUG</dt> + <dd>Minor modes are switched off by iTe.</dd> + <dt>FIX</dt> <dd>Invoke minor modes + with the optional argument 't'. For example + <pre class=code> + (add-hook 'latex-mode-hook '(lambda () (interactive) + (outline-minor-mode t))) + </pre> + instead of + <pre class=code> + (add-hook 'latex-mode-hook 'outline-minor-mode) + </pre> + </dd> + </dl> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on May 17 2005</div> + + </BODY> +</HTML> + diff --git a/support/ite/description.html b/support/ite/description.html new file mode 100644 index 0000000000..2566e795ed --- /dev/null +++ b/support/ite/description.html @@ -0,0 +1,38 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>Description</TITLE> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + +<B> Next:</B> <A HREF="distribution.html">Distribution</A> +<B> Up:</B> <A HREF="manual.html">iTe</A> + +<H1>Description</H1> + +<P> +<span class=ite>iTe</span> is an easy to use, interactive authoring tool for +L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X and T<SMALL>E</SMALL>X documents. +<p> +With <span class=ite>iTe</span>, it is possible to select arbitrary +display fragments such as figures, equations, labels, captions, +etc. These fragments can then be freely moved, rotated and scaled. +Because <span class=ite>iTe</span> is written in <EM>Emacs-lisp</EM>, it integrates nicely in +the editing process. +<p> +<span class=ite>iTe</span> is not a WYSIWYG front end for L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X, and +<span class=ite>iTe</span> does not change the way you use L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X +to typeset 95% of your text. But it will help you to manage the remaining 5% fast with a +high quality result. To the user, <span class=ite>iTe</span> is an easy to use and +effective tool which is a lot of fun. + +<P> +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Saturday, 31 August 2002 +</FONT> +</contact-stamp> +</BODY> +</HTML> diff --git a/support/ite/devguide.tex b/support/ite/devguide.tex new file mode 100644 index 0000000000..ae8916a9d8 --- /dev/null +++ b/support/ite/devguide.tex @@ -0,0 +1,93 @@ +% File `devguide.tex' is the Developers Guide for iTe. +% This guide is incomplete to the point of uselessness. +% +% Copyright (C) 1999 by Wolfgang Kuehn + +\documentclass{article} + +\newcommand{\iTe}{\textbf{\large iTe}} + +\begin{document} + +\begin{titlepage} +\begin{center}{\Large +\iTe, the interactive \TeX\ editor\\[6pt] +Developer's Guide Version 1.2\\[24pt] +Wolfgang K\"uhn\\[6pt] +February 1999} +\end{center} +\end{titlepage} + + +\section{Zooming} +Zooming is one of the trickier features of \iTe. Any (affine) +transformation matrix $T$ in PostScript can be written as +\[ +T(x, y) = T_L (x, y)+ T_t, +\] +where $T_L$ is a $2\times 2$ matrix and $T_t$ is a translation vector. +Internally, $T$ is stored as a $6$-array +\[ +T=[T_L(1,1)\ T_L(1,2)\ T_L(2,1)\ T_L(2,2)\ T_t(1)\ T_t(2)]. +\] +Any point $(x, y)$ in user space is mapped to a point in device space +$(\tilde x, \tilde y)$ by a serie of 3 transformations: +\[ +RZT(x, y)=(\tilde x, \tilde y). +\] +Here $R$ is the current transformation matrix before a page is +started, i.e., before \emph{bop} is issued. The transformation $RT$ is +the current transformation matrix after \emph{bop} has been issued +with a current zoom matrix $Z$ equals the idendity. The component +$Z_L$ of the zoom matrix $Z$ is given by the user supplied zoom factor +$f$, +\[ +Z_L=[f\ 0\ 0\ f]. +\] +The transformation $Z$ is issued via a $\emph{Z concat}$ immediately +before a page is started. + +Now suppose the user wants to zoom with a new zoom factor $f^n$. +We need to find a new zoom matrix $Z^n$ +\[ +Z^n=[f^n\ 0\ 0\ f^n\ Z^n_t(1)\ Z^n_t(2)] +\] +with unknown translation vector $Z^n_t$ such that +\[ +RZ^nT(x, y)=(\tilde x_c, \tilde y_c). +\] +Here $(\tilde x_c, \tilde y_c)$ is the center of the device and +$(x,y)$ the current point (location of current object) in user space. +Therefore +\[ +Z^n_t=R^{-1}(\tilde x_c, \tilde y_c)-Z^n_L T(x,y) + =-Z^n_L Z^{-1}R^{-1}(\tilde x, \tilde y) + +R^{-1}(\tilde x_c, \tilde y_c). +\] +For given zoom matrix $Z$ the devices coordinates $(\tilde x, \tilde y)$ of +all objects on the page have to be computed via a \emph{currentpoint transform}. +These coordinates are then stored in the array \emph{pointinfo}. + +Note that $R^{-1}(\tilde x_c, \tilde y_c)$ is the center of the initial +PostScript user space, +\[ +R^{-1}(\tilde x_c, \tilde y_c) = (\textrm{\emph{DEVICEWIDTH}}/2, + \textrm{\emph{DEVICEHEIGHT}}/2). +\] +For A4 paper size, the default, \emph{DEVICEWIDTH}=596 and \emph{DEVICEHEIGHT}=842. +The construction of $Z^n$ is now accomplished with the following code: +\begin{verbatim} + /Z + [ + f^n 0 0 f^n % define Z^n_L + % push (\tilde x, \tilde y) on stack + pointinfo object-number 2 mul 2 getinterval aload pop + R itransform Z itransform + [ + -f^n 0 0 -f^n DEVICEWIDTH DEVICEHEIGHT + ] transform + % now the translation vector Z^n_t is on top of the stack + ] def % complete definition of Z +\end{verbatim} + +\end{document}
\ No newline at end of file diff --git a/support/ite/distribution.html b/support/ite/distribution.html new file mode 100644 index 0000000000..5c5471f455 --- /dev/null +++ b/support/ite/distribution.html @@ -0,0 +1,100 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> +<HEAD> +<TITLE>Distribution</TITLE> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> + <BODY > + <div> + <B>Next:</B> <A HREF="general.html">How iTe works</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="installation.html">Installation</A> + </div> + + <H1>Distribution</H1> + + <H2>Copyright</H2> + + <P> + <span class=ite>iTe</span> is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as + published by the Free Software Foundation; either version 2 + of the License, or (at your option) any later version. + + <span class=ite>iTe</span> is distributed in the hope that it will be useful, but + + </p> + + <div style="padding:0.5cm"> + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See + the GNU General Public License for more details. + </div> + + <p> + You should have received a copy of the GNU General Public + License along with this program; if not, write to the + Free Software Foundation, Inc., 59 Temple Place, Suite 330, + Boston, MA 02111-1307, USA. + </p> + + <H2><a name="requirements">System Requirements</a></H2> + + <p> + Because <span class=ite>iTe</span> is written in the four interpreted languages + <EM>Emacs-lisp</EM>, <EM>PostScript</EM>, T<SMALL>E</SMALL>X and <EM>Perl</EM>, it is platform independent. + All of the following required tools are preinstalled on many Unix systems, but are also available as binaries + for both Unix and MS-Windows: + </p> + <UL> + <LI>A T<SMALL>E</SMALL>X installation. + Go to <a href="http://www.ctan.org">CTAN</a> to get binaries and sources; + <LI><TT>Emacs</TT> or <TT>XEmacs</TT> version 19 and higher; + <LI><TT>dvips</TT>, the dvi to ps translator by <a href="http://www.radicaleye.com">www.radicaleye.com</a>. + This software normally comes with the T<SMALL>E</SMALL>X installation; + <LI><TT>gs</TT> aka <a href="http://www.ghostscript.com/">GhostScript</a>, + the postscript interpreter by Aladdin Enterprises; + <li>Perl. Go to <a href="http://www.cpan.org">CPAN</a> to get binaries and sources. + </UL> + + <H2>Compatibility</H2> + + <p> + <span class=ite>iTe</span> was successfully tested on the following platforms: + </p> + + <table border="1" cellpadding="10" align="center"> + <TR ALIGN="CENTER"> + <th>Operating System</th> + <th>Editor</TD> + <th>dvips(k)</th> + <th>GhostScript</th> + <th>Perl</th> + </TR> + <TR ALIGN="CENTER"> + <TD>Suse Linux 9.2</TD> + <TD>XEmacs 21.4<br/> + GNU Emacs 21.3.1 + </TD> + <TD>5.92</TD> + <TD>7.07.1</TD> + <TD>5.8.5</TD> + </TR> + <TR ALIGN="CENTER"> + <TD>MS Windows 98/XP</TD> + <TD>XEmacs 21.4</TD> + <TD>5.86</TD> + <TD>7.04</TD> + <TD>5.6 (IndigoPerl)</TD> + </TR> + </table> + + + <p> + Previous versions of <span class=ite>iTe</span> were successfully tested on <tt>mips-sgi-irix</tt> and <tt>sparc-sun-solaris</tt>. + </p> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Mar 27 2005</div> + </BODY> +</HTML> diff --git a/support/ite/error_messages.html b/support/ite/error_messages.html new file mode 100644 index 0000000000..1bf80e8273 --- /dev/null +++ b/support/ite/error_messages.html @@ -0,0 +1,111 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<HTML>
+<HEAD>
+<TITLE>Error Messages</TITLE>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
+<LINK REL="STYLESHEET" HREF="manual.css">
+</HEAD>
+<BODY >
+
+<B>Next:</B> <A HREF="bugs.html">Bugs and Feedback</A>
+<B>Up:</B> <A HREF="manual.html">iTe</A>
+<B>Previous:</B> <A HREF="gallery.html">Gallery</A>
+
+ <H1>Error Messages</H1>
+
+ <h2>PostScript Error</h2>
+
+ The generated PostScript is corrupt. To solve this
+ problem, do the following:
+ <ul>
+ <li>Generate PostScript code directly using 'dvips'
+ with the [dvi] option on.
+ <li>Preview the code using 'ghostview' or 'gs'.
+ <li>If the error persists, the problem is very likely
+ not related to iTe. Check your '\special'
+ directives or macros which produce '\special', such
+ as PS-Tricks macros.
+ <li>If there is no PostScript error, the version of
+ 'dvips' may be inconsistent with the version of iTe.
+ <li>Get the newest version of iTe.
+ <li>If your version of 'dvips' is older than 5.58,
+ then get a newer version.
+ <li>If 'dvips' is of a current release, then you found an iTe bug and should file a bug report.
+ </ul>
+
+ <h2>Cannot find all iTe objects</h2>
+
+ While parsing the (La)TeX source code, not all active iTe objects were found. The most
+ likely reason for this is an inadequate use of the '\ite' directive.
+ <ul>
+ <li>Do not include naked (not contained in an iteblock
+ environment) '\ite' directives from other files via '\input' or
+ '\include'.
+ <li>Do not rebind the '\ite' macro.
+ </ul>
+
+ <h2>Spurious iTe object in (La)TeX source</h2>
+
+ While parsing the (La)TeX source, iTe has mistaken
+ an inactive iTe object for an active iTe object.
+ <p>
+ The reasons could be
+ <ul>
+ <li>You have loaded the iTe package using the 'dvi'
+ or 'graphics' option, for example with
+ '\usepackage[dvi]{ite}'. In this case, all objects
+ are inactive, which is not what you want. Don't use
+ these options when running iTe.
+ <li>You have used some weird TeX construct, for example
+ '\string\ite', for which iTe's parser is too dumb to
+ see that the '\ite' directive is not expanded.
+ </ul>
+
+ <h2>Argument syntax error</h2>
+
+ Arguments to an '\ITE' directive is
+ corrupt. A correct syntax should look like
+ <pre>\ITE(123 123 1.3 -10)</pre>
+ for example.
+
+ <h2>DVI file outdated</h2>
+
+ The dvi-file does not exist or is older than the (La)TeX source file. Please
+ recompile the source before using iTe again.
+
+ <h2>Buffer modified</h2>
+
+ The buffer with the (La)TeX source was modified
+ but not saved. Please save and recompile the source.
+
+ <h2>Generating PostScript failed</h2>
+
+ iTe was not able to translate the DVI-file into a PostScript file.
+ Please see the log-buffer for more details.
+ <p>
+ The reasons for failure could be one of
+ <ul>
+ <li>'dvips' could not be executed, i.e., is not in your search path.
+ <li>'perl' could not be executed, i.e., is not in your search path.
+ <li>Versions of files in the iTe distribution are inconsistent.
+ 'ite.el', 'ite.pl', 'ite.sty' and 'ite.ps' must all be of the
+ same version.
+ <li>iTe was unable to read the (La)TeX log-file.
+ <li>You did not load the iTe-package at all. Insert
+ 'usepackage{ite}' in the header of the (La)TeX source.
+ <li>There are no iTe blocks, and thus no active ite objects,
+ in the (La)TeX source.
+ </ul>
+
+<contact-stamp><hr><FONT SIZE=-1>
+Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on
+27 December 2002
+</FONT>
+</contact-stamp>
+</BODY>
+</HTML>
+
+
+
+
+
diff --git a/support/ite/example.html b/support/ite/example.html new file mode 100644 index 0000000000..b2edac62f5 --- /dev/null +++ b/support/ite/example.html @@ -0,0 +1,50 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>Real World Example</TITLE> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + +<B> Next:</B> <A HREF="gallery.html">Gallery</A> +<B> Up:</B> <A HREF="manual.html">iTe</A> +<B> Previous:</B> <A HREF="winmanager.html">Taming the Window</A> + +<H1>Real World Example</H1> + +<P> +<TABLE CELLPADDING=3 WIDTH="100%"> +<TR><TD ALIGN="LEFT"> +<PRE> +\documentclass{article} +\usepackage{graphics} +\usepackage{ite} + +\begin{document} + +\begin{iteblock}(5cm,5cm) +\ite\includegraphics{sc.eps} +\ite\grabber{5} +\ite$\sin x$ +\ite\grabber{5} +\ite$\cos x$ +\ite\grabber{5} +\ite$(\frac1{\sqrt2}, + \frac1{\sqrt2})$ +\end{iteblock} + +\end{document} +</PRE> +</TD> +<TD ALIGN="LEFT"><img src="images/sc.gif" alt="Image"></TD> +</TR> +</TABLE> +<P> +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Sunday, 21 November 1999 +</FONT> +</contact-stamp> +</BODY> +</HTML> diff --git a/support/ite/gallery.html b/support/ite/gallery.html new file mode 100644 index 0000000000..be11891f05 --- /dev/null +++ b/support/ite/gallery.html @@ -0,0 +1,25 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>Gallery</TITLE> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + +<B> Next:</B> <A HREF="error_messages.html">Error Messages</A> +<B> Up:</B> <A HREF="manual.html">iTe</A> +<B> Previous:</B> <A HREF="example.html">Real World Example</A> + +<H1>Gallery</H1> + +<P> +<img src="images/gallery.gif" alt="Image"> + +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Sunday, 28 May 2000 +</FONT> +</contact-stamp> +</BODY> +</HTML> diff --git a/support/ite/general.html b/support/ite/general.html new file mode 100644 index 0000000000..1835057690 --- /dev/null +++ b/support/ite/general.html @@ -0,0 +1,63 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>How iTe works</TITLE> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + +<B> Next:</B> <A HREF="invocation.html">Invocation</A> +<B> Up:</B> <A HREF="manual.html">iTe</A> +<B> Previous:</B> <A HREF="installation.html">Installation</A> + +<H1>How <span class=ite>iTe</span> works</H1> + +<P> +The following L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X2<SUB>e</SUB> code is a minimal working example. + +<P> +<PRE> + \documentclass{article} + \usepackage{ite} + \begin{document} + + \begin{iteblock}(5cm,5cm) + \ite Hello + \ite World + \end{iteblock} + + \end{document} +</PRE> +<P> +It defines two <EM>active</EM> <span class=ite>iTe</span> objects (`Hello' and `World'). +Upon starting <span class=ite>iTe</span>, active objects can be manipulated interactively. +The possible operations are translation, rotation and scaling. The +origin for these operations is the lower left corner of the box +defined by the <TT>iteblock</TT> environment. For an active object, <span class=ite>iTe</span> +establishes a one-to-one relationship between its L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X source code +and the corresponding PostScript code fragment. All operations are +then simultaniously recorded in both the L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X source and in the GhostScript window. For example, if the `Hello' is translated, +rotated by 90 degrees and scaled by a factor of 2, then the +corresponding L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X source will look like this: + +<P> +<PRE> + \ITE(50 70 90 2) Hello +</PRE> +<P> +Sometimes, you might be pressed to define <span class=ite>iTe</span> objects inside macros +or saved boxes. If this is the case, many PostScript code fragments +may correspond to one L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X source object. Here you have to use +<EM>passive</EM> objects. The use of active objects inside macros and +saved boxes is <B>not</B> checked and will utterly confuse <span class=ite>iTe</span>. +Passive objecst behave like active objects, but cannot be manipulated +interactively. See the definition of the <TT>itebind</TT> <A +HREF="latex.html">latex environment</a> on how to generate passive objects. + +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Saturday, 10 June 2000 +</FONT> +</contact-stamp> +</BODY> +</HTML> diff --git a/support/ite/homedir.html b/support/ite/homedir.html new file mode 100644 index 0000000000..bbfde0f57a --- /dev/null +++ b/support/ite/homedir.html @@ -0,0 +1,22 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> + <head> + <title>Initialization File</title> + <LINK REL="STYLESHEET" HREF="manual.css"> + </head> + + <body> + <h1>Initialization File for XEmacs</h1> + <p> + If you paste the line + </p> + <pre> + (dired (expand-file-name user-init-directory)) + </pre> + <p> + in Emacs' *scratch* buffer and type <tt>C-xC-e</tt> at the end of this line, XEmacs will lead you directly to the + location of the initialization file. For <tt>Gnu-Emacs</tt>, the above will not work. + </p> + + </body> +</html> diff --git a/support/ite/images/80-60-20.gif b/support/ite/images/80-60-20.gif Binary files differnew file mode 100644 index 0000000000..16a35ab3d0 --- /dev/null +++ b/support/ite/images/80-60-20.gif diff --git a/support/ite/images/beam.gif b/support/ite/images/beam.gif Binary files differnew file mode 100644 index 0000000000..89cdb46824 --- /dev/null +++ b/support/ite/images/beam.gif diff --git a/support/ite/images/card.gif b/support/ite/images/card.gif Binary files differnew file mode 100644 index 0000000000..66c188e532 --- /dev/null +++ b/support/ite/images/card.gif diff --git a/support/ite/images/dgram.gif b/support/ite/images/dgram.gif Binary files differnew file mode 100644 index 0000000000..5d03eebfd2 --- /dev/null +++ b/support/ite/images/dgram.gif diff --git a/support/ite/images/down.gif b/support/ite/images/down.gif Binary files differnew file mode 100644 index 0000000000..e8a00daa45 --- /dev/null +++ b/support/ite/images/down.gif diff --git a/support/ite/images/gallery.gif b/support/ite/images/gallery.gif Binary files differnew file mode 100644 index 0000000000..ad9cb9315b --- /dev/null +++ b/support/ite/images/gallery.gif diff --git a/support/ite/images/house.gif b/support/ite/images/house.gif Binary files differnew file mode 100644 index 0000000000..cdcdc0654f --- /dev/null +++ b/support/ite/images/house.gif diff --git a/support/ite/images/ite140a.gif b/support/ite/images/ite140a.gif Binary files differnew file mode 100644 index 0000000000..5feca09006 --- /dev/null +++ b/support/ite/images/ite140a.gif diff --git a/support/ite/images/left.gif b/support/ite/images/left.gif Binary files differnew file mode 100644 index 0000000000..2d9069fd73 --- /dev/null +++ b/support/ite/images/left.gif diff --git a/support/ite/images/logo.gif b/support/ite/images/logo.gif Binary files differnew file mode 100644 index 0000000000..a3c4e0ab47 --- /dev/null +++ b/support/ite/images/logo.gif diff --git a/support/ite/images/logo_opaque.gif b/support/ite/images/logo_opaque.gif Binary files differnew file mode 100644 index 0000000000..a63181e5af --- /dev/null +++ b/support/ite/images/logo_opaque.gif diff --git a/support/ite/images/right.gif b/support/ite/images/right.gif Binary files differnew file mode 100644 index 0000000000..2bb24fd8d6 --- /dev/null +++ b/support/ite/images/right.gif diff --git a/support/ite/images/sc.gif b/support/ite/images/sc.gif Binary files differnew file mode 100644 index 0000000000..329f3500f0 --- /dev/null +++ b/support/ite/images/sc.gif diff --git a/support/ite/images/sc_opaque.gif b/support/ite/images/sc_opaque.gif Binary files differnew file mode 100644 index 0000000000..cf69477daa --- /dev/null +++ b/support/ite/images/sc_opaque.gif diff --git a/support/ite/images/up.gif b/support/ite/images/up.gif Binary files differnew file mode 100644 index 0000000000..7d3a0ade86 --- /dev/null +++ b/support/ite/images/up.gif diff --git a/support/ite/index.html b/support/ite/index.html new file mode 100644 index 0000000000..c37f8ff64c --- /dev/null +++ b/support/ite/index.html @@ -0,0 +1,148 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> + <HTML> + <HEAD> + + <META name="description" content="iTe, TeX authoring tool"> + <META name="author" content="Wolfgang Kühn"> + <META name="keywords" content="iTe, TeX, interactive, Emacs"> + <LINK REL="STYLESHEET" HREF="manual.css"> + + <TITLE>iTe, the interactive TeX editor</TITLE> + </HEAD> + <BODY> + + + <table border="0" cellpadding="5" width="90%"> + <tr> + <td> + <table> + <tr> + <td class="menu"> + <A HREF="index.html">Home</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="gallery.html">Gallery of examples</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="manual.html">Online manual</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="installation.html#download">Download iTe</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="news.html">What is new</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="bugs.html">Bug list</a> + </td> + </tr> + </table> + <td align=center> + <table style="font-size:x-large"> + <tr> + <td><img src="images/logo.gif" alt="iTe"></td> + <td>Version 3_1 (June 24 2005)</td> + </tr> + <tr> + <td colspan="2" align=right> + the <span style="font-weight:bolder">I</span>nteractive <span style="font-weight:bolder">T</span>ex <span style="font-weight:bolder">E</span>ditor + </td> + </tr> + </table> + </td> + </tr> + </table> + + + <p> + <b><BIG>Description</BIG></b> <span class="ite">iTe</span> is an + easy to use, interactive authoring tool for + L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X and + T<SMALL>E</SMALL>X documents. With <span class=ite>iTe</span>, it is + possible to select arbitrary display fragments such as figures, + equations, labels, captions, etc. These fragments can then be + freely moved, rotated and scaled. Existing tools are either + awkward to use (for example cryptic + L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X extensions), or + they produce results of poor quality (font of captions does not + match L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X font, for + example). To the user, <span class=ite>iTe</span> is an easy to use + and effective tool which is a lot of fun. + + </p> + <p> + <img src="images/sc.gif" style="float:right"> + <b><BIG>Example</BIG></b> Using <span class=ite>iTe</span>, it + took my then five year old daughter only a few minutes to typeset + the simple example to the right. + + </p> + <p> + <b><BIG>How does it work</BIG></b> The user actions + (translation, scaling and rotation) are simultaneously recorded + in the L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X source + file <strong>and</strong> displayed on the screen by an + asynchronous <EM>ghostscript</EM> process. What you see on the + screen is exactly what you get if the source is recompiled and + printed. + </p> + <p> + <b><BIG>How to use it</BIG></b> Because + <span class=ite>iTe</span> is written in <EM>Emacs-lisp</EM>, it + integrates nicely in the editing process. Just call it during a + normal (X)Emacs session as many times as you want. Note however, + that <span class=ite>iTe</span> is not a WYSIWYG front end for + L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X, and + <span class=ite>iTe</span> does not change the way you use + L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X to typeset 95% of + your text. But it will help you to manage the remaining 5% fast + with a high quality result. + </p> + <p> + <b><BIG>Platform</BIG></b> <span class=ite>iTe</span> should run on + every <EM>Unix</EM> and <EM>MS Windows</EM> platform meeting the + <a href="distribution.html#requirements">requirements</a>. + </p> + + <p> + <b><big>(La)TeX related recources</big></b> + </p> + <ul> + <li><a href="http://www.tug.org">TUG</a>, the TeX Users Group. TUG + provides an organization for those who have an interest in systems + for text typesetting and font design, and are users of TeX and + Metafont. + </li> + <li><a href="http://www.ctan.org">CTAN</a>, the Comprehensive TeX + Archive Network. CTAN is a set of fully-mirrored ftp sites providing + the most complete, up-to-date TeX-related software possible. + </li> + <li><a href="http://sunsite.auc.dk/auctex">AUC TeX</a>, an extensible + package that supports writing and formatting TeX files for most + variants of GNU Emacs. AUC TeX is a nice package, and I suggest using + it in conjunction with <span class=ite>iTe</span>. + </li> + <li><a href="http://www.tug.org/tetex">teTeX</a>, a complete TeX + distribution for UNIX compatible systems. You will probably have + teTeX installed on your system. Consider to get it otherwise. + </li> + <li><a href="http://www.lyx.org">LyX</a>, a WYSIWYM style + document processor using LaTeX. <span class=ite>iTe</span> will not run under LyX, + and LyX does not provide the functionality of <span class=ite>iTe</span>. + </li> + </ul> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Apr 4 2005</div> +</BODY> +</HTML> + diff --git a/support/ite/installation.html b/support/ite/installation.html new file mode 100644 index 0000000000..6eba1bad68 --- /dev/null +++ b/support/ite/installation.html @@ -0,0 +1,118 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>Installation and Customization</TITLE> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY> + <div> + <B>Next:</B> <A HREF="general.html">How iTe works</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="description.html">Description</A> + </div> + + <H1>Installation</H1> + + <h2><a name="download">1. Download</a></h2> + + <p> + Download and extract <a href="ite_3_1.zip">ite_3_1.zip</a> (build on June 24 2005, about 100kb) + using your favorite packageing tool. The archive will be extracted into the directory <tt>'./ite'</tt>. + Maintainer of the <span class=ite>iTe</span> distribution need to download + <a href="ite_3_1_src.zip">ite_3_1_src.zip</a> (build on June 24 2005, about 100kb) instead. + </p> + <p> + Note that there may be a <a href="http://www.decatur.de/ite">more recent (beta) release</a>, including bug reports and workarounds. + </p> + + <h2>2. Dependencies</h2> + + <p> + If necessary, install all <a href="distribution.html#requirements">required tools</a> on your system. + </p> + + <h2>3. Lisp Includes</h2> + + <p> + You must point <tt>Emacs</tt> to some resources required by <span class=ite>iTe</span>. This is done in + the initialization file <tt>.emacs</tt> for <tt>Gnu-Emacs</tt> or <tt>.xemacs/init.el</tt> for <tt>XEmacs</tt>, + which are both located in your <a href="homedir.html">home directory</a>. + To this initialization file, merge the following lines and edit <tt>ite-load-path</tt>: + </p> + <pre> + +;; The path to the ite-lisp library. +(setq ite-load-path "~/ite/lib/ite.el") + +;; Preload iTe +(autoload 'ite ite-load-path "Start the interactive TeX editor" t) + </pre> + + <h2><a name="customization">4. Customization</a></h2> + + <p> + Normally it is not required to customize <span class=ite>iTe</span>. Customization allows you to control + </p> + <UL> + <LI>the appearance; + <LI><A HREF="bindings.html">the key bindings</A>; + <LI>internal limits; + <LI>the commands to invoke <em>perl</em>, <EM>dvips</EM> and <EM>gs</EM>. + </UL> + + <P> + To customize <span class=ite>iTe</span>, you have to edit the configuration + file <tt>ite.conf</tt> in the <span class=ite>iTe</span> installation directory. + </p> + + <p> + <b>For the expert user</b>: You can have any list of configuration files in any location. To achieve this, set + the variable <tt>ite-config-files</tt> to this list, for example + </p> + <pre> +;; List of configuration files for iTe. +(setq ite-config-files (list "~/ite/ite.conf" "~/ite/private.conf")) + </pre> + <p> + The default behaviour is to read the file <tt>ite.conf</tt> in the <span class=ite>iTe</span> + installation directory. + </p> + + + <h2>5. Testing</h2> + + <p> + At this stage you can test the installation: + </p> + <ol> + <li>Go to the <tt>tex</tt> directory; + </li> + <li>Execute the <tt>compile</tt> script to compile all L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X-files; + </li> + <li>Open one of the L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X-files with (X)Emacs and + <a href="invocation.html">invoke</a> <span class=ite>iTe</span>. + </li> + </ol> + + <h2>6. (L<SUP><SMALL>A</SMALL></SUP>)T<SMALL>E</SMALL>X Includes</h2> + + <p> + The T<SMALL>E</SMALL>X installation will have to find the files <tt>ite.tex</tt> and <tt>ite.sty</tt> + in iTe's <tt>tex</tt>-directory. + We recommend that you copy these files to a directory which is already searched by TeX. This could be + <tt>/usr/share/doc/.TeX</tt> or <tt>~/.TeX</tt> on a Unix platform. The environment variable + <tt>TEXINPUTS</tt> lists all directories that are searched. + </p> + <p> + Alternatively, but not recommended, you can make TeX search in an additional location, such as + in the installation directory of <span class=ite>iTe</span>. To do so, you will have to modify the + <tt>TEXINPUTS</tt> environment variable or use a tool provided by the TeX distribution of your + choice. For example, if you are using MiKTeX, you can use its <em>Options</em>-tool to add the library. + Select the <em>Roots</em> tab and add the path to the iTe-distribution to the list of + TEXMF root directories. Then refresh the file name database and exit the utility. + </p> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on May 17 2005</div> + </BODY> +</HTML> diff --git a/support/ite/invocation.html b/support/ite/invocation.html new file mode 100644 index 0000000000..4f2808ff37 --- /dev/null +++ b/support/ite/invocation.html @@ -0,0 +1,69 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> + +<HTML> + <HEAD> + <TITLE>Invocation</TITLE> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY > + + <B> Next:</B> <A HREF="latex.html">L<SUP>A</SUP>TEX Commands</A> + <B> Up:</B> <A HREF="manual.html">iTe</A> + <B> Previous:</B> <A HREF="general.html">How iTe works</A> + + <H1>Invocation</H1> + + <P> + + <H2>Invoking (X)Emacs commands</H2> + + <P> + If you are not an (X)Emacs beginner, please skip this section. + + <P> + To run an (X)Emacs command by name, start with `M-x', then type the + command name, and finish with RET. `M-x' uses the minibuffer to read + the command name. RET exits the minibuffer and runs the command. We + refer to this process as `M-x cmd', where `cmd' is the command name. + To produce `M-x' (the Meta-x key), you have to press the Meta-key + (ALT key) and the x-key simultaneously. As an alternative, you can + also press the ESC-key, followed by the x-key. + + <P> + + <H2>Starting <span class=ite>iTe</span></H2> + + <P> + To start <span class=ite>iTe</span>, visit a (La)TeX file which contains active objects (see + previous section) and compile it. Then run `M-x ite' to start <span class=ite>iTe</span>. + Note that only one <span class=ite>iTe</span>-process can run in the same (X)Emacs process + at a time. If `M-x ite' is invoked recursively, the previous + <span class=ite>iTe</span>-process is killed automatically. + + <P> + + <H2><span class=ite>iTe</span> is running</H2> + <p> + After start up, the curser jumps to the closest active object. All <tt>\ITE</tt> + directives are highlighted. + <p> + A new GhostScript window appears. On a MS-Windows platform, this window may be iconified, so + you have to open it. + + <H2>Controlling <B>iTe</B></H2> + + <P> + The focus must be on the (X)Emacs window. + You can use the middle mouse button to select any other object. Once an object + is selected, use the <span class=ite>iTe</span> <A HREF="bindings.html">key bindings</A> + to manipulate the object. There are also control keys that let you + navigate in your source code or let you do other tasks such as + zooming. + + <P> + <contact-stamp><hr><FONT SIZE=-1> Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on + Saturday, 10 June 2000 + </FONT> + </contact-stamp> + </BODY> +</HTML> diff --git a/support/ite/largefiles.html b/support/ite/largefiles.html new file mode 100644 index 0000000000..08801bf1b5 --- /dev/null +++ b/support/ite/largefiles.html @@ -0,0 +1,42 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>Large eps-Files</TITLE> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY > + <div> + <B>Next:</B> <A HREF="bindings.html">Default Key-Bindings</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="plaintex.html">Plain TEX</A> + </div> + + <H1>Large <EM>eps</EM>-Files</H1> + + <P> + <span class=ite>iTe</span> tries to deal with large, included <em>eps</em>-files gracefully. Files bigger than 200kb + (this is the default for the variable <TT>eps-limit</TT> and can be + <A HREF="installation.html#customization">customized</A>) are only displayed by their + bounding box. You can toggle between bounding box and full display using + <A HREF="bindings.html">a bound key</A>. + </p> + + <P> + Alternatively, you can create low resolution <EM>eps</EM>-files + and include these instead. For example, if <TT>figure.eps</TT> is huge, + and <TT>figure.s.eps</TT> is its low resolution pendant, then you could + use + </P> + <PRE> + \DeclareGraphicsExtensions{.s.eps,.eps} + \includegraphics{figure} + </PRE> + <P> + while using <span class=ite>iTe</span> interactively, but uncommenting the first line for + printing. + </p> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Mar 27 2005</div> +</BODY> +</HTML> + diff --git a/support/ite/latex.html b/support/ite/latex.html new file mode 100644 index 0000000000..c26d9337a3 --- /dev/null +++ b/support/ite/latex.html @@ -0,0 +1,136 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>LATEX Commands</TITLE> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + + <B> Next:</B> <A HREF="plaintex.html">Plain TEX</A> + <B> Up:</B> <A HREF="manual.html">iTe</A> + <B> Previous:</B> <A HREF="invocation.html">Invocation</A> + + <H1>L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X Commands</H1> + + <pre class="command">\usepackage[graphics|dvi]{ite}</pre> + + Load the <span class=ite>iTe</span> package. Do not use <code>`\input ite.tex'</code> unless + your format is <A HREF="plaintex.html">Plain T<SMALL>E</SMALL>X</a>. + + <p> + Example: + <PRE> + \usepackage{ite}</PRE> + + The <TT>ite</TT> package can have one of the two following options: + <DL> + <DT><STRONG>graphics</STRONG> + <DD>This will use the rotation and scaling operations of + the <TT>graphics</TT> or <TT>graphicx</TT> package. One of these packages + is required. The <EM>dvi</EM> code produced is more device independent + than without this option. + <DT><STRONG>dvi.tex</STRONG> + <DD>Does not produce any device dependent code. + No rotation and no scaling takes place. + </DL>Do not use these options for interactive use of <span class=ite>iTe</span>. + + + <pre class="command">\usepackage{trig}</pre> + + You have to load the <TT>trig</TT> package whenever you do not give + dimensional arguments to an <TT>iteblock</TT> environment, see below. + + <pre class="command">\begin{iteblock}(x_dimen,y_dimen) + ... +\end{iteblock}</pre> + + The <TT>iteblock</TT> environment creates a box with the specified + dimensions (optional) and serves as a container for <code>\ite</code> + statements. + + <p> + Example: + <PRE> + \begin{iteblock}(\textwidth,5.0cm) + \ite Hallo + \end{iteblock}</PRE> + <P> + The <TT>iteblock</TT> environment can contain any number of <code>\ite</code> + statements. If the optional dimensional arguments are not given, the + box will be the bounding box for all contained <code>\ite</code> objects. + With the optional arguments, the box is framed for convenience. The + use of nested, unrestricted <TT>iteblock</TT> environments is not + allowed, see the definition of the <TT>itebind</TT> environment. + + <pre class="command">\ite ... </pre> + + Defines <span class=ite>iTe</span> object. + <p> + Example: + <PRE> + \ite $cos x$ + \ite \begin{minipage}Hello\\ World\end{minipage}</PRE> + <P> + Whatever you can put inside an <code>\mbox</code> you can also put after an + <code>\ite</code> statement. However, only restricted <TT>iteblock</TT> + environments are allowed. <span class=ite>iTe</span> will expand each <code>\ite</code> statement + to <code>\ITE(x y a s)</code>, where <I>x</I> and <I>y</I> is the translation in units + of <code>\ITEunit</code>, <I>a</I> is the angle of rotation, and <I>s</I> is the + scaling factor of the object. You should not change these numbers + manually. + + <pre class="command">\setlength{\ITEunit}{dimension}</pre> + + The smallest unit an <span class=ite>iTe</span> object can be translated in either direction. + <P> + Example: + <PRE> + \setlength{\ITEunit}{0.1pt}</PRE> + The default is 0.5pt or approximately 0.35mm. You should change the + value of <code>\ITEunit</code> only if a higher resolution is required. With + the default, the two 'X' characters in the example + <PRE> +\ITE(0 0 0 1)X +\ITE(200 0 0 1)X</PRE> + are 100pt apart. After <code>\setlength{\ITEunit}{1mm}</code>, the distance would be + 200mm. + + <pre class="command">\begin{itebind} + ... +\end{itebind}</pre> + + The <TT>itebind</TT> environment <EM>deactivates</EM> all enclosed <span class=ite>iTe</span> + objects. You have to use it inside macros, saved boxes, and recursive + <TT>iteblock</TT> environments. + <P> + Example: + + <TABLE CELLPADDING=3 WIDTH="100%"> + <TR><TD ALIGN="LEFT"> + <PRE style="font-size:x-small"> +\newsavebox{\housebox} +\sbox{\housebox}{\begin{itebind} +\begin{iteblock}(0cm,0cm) +\ITE(0 0 0 1)\framebox(20,20){} +\ITE(7 0 0 0.482)\framebox(10,20){} +\ITE(19 66 -50 1)\rule{20pt}{1pt} +\ITE(-4 35 50 1)\rule{20pt}{1pt} +\end{iteblock} +\end{itebind}} + +\begin{iteblock}(3cm,3cm) +\ITE(87 95 5 1.728)\usebox{\housebox} +\ITE(230 103 -5 2.589)\usebox{\housebox} +\end{iteblock}</PRE> + </TD> + <TD ALIGN="LEFT"><img src="images/house.gif" alt="Image"></TD> + </TR> + </TABLE> + <P> + <contact-stamp><hr><FONT SIZE=-1> + Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on + Saturday, 10 June 2000 + </FONT> + </contact-stamp> + </BODY> +</HTML> diff --git a/support/ite/manual.css b/support/ite/manual.css new file mode 100644 index 0000000000..beaf9ad6e4 --- /dev/null +++ b/support/ite/manual.css @@ -0,0 +1,15 @@ +p { } + +body { background-color:#fffff0; } + +span.ite { font-weight:bold } + +pre { background-color:#fff0ff; } + +.command { + font-size:large; + background-color:#f0ffff; border-bottom-style:solid; border-left-style:solid; + border-width:1pt; margin-top:24pt; +} + +td.menu { background-color:lightblue; } diff --git a/support/ite/manual.html b/support/ite/manual.html new file mode 100644 index 0000000000..c18f696701 --- /dev/null +++ b/support/ite/manual.html @@ -0,0 +1,90 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>iTe, the interactive TeX editor</TITLE> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY > + + <table border="0" cellpadding="5" width="90%"> + <tr> + <td> + <table> + <tr> + <td class="menu"> + <A HREF="index.html">Home</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="gallery.html">Gallery of examples</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="manual.html">Online manual</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="installation.html#download">Download iTe</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="news.html">What is new</a> + </td> + </tr> + <tr> + <td class="menu"> + <A HREF="bugs.html">Bug list</a> + </td> + </tr> + </table> + <td align=center> + <table style="font-size:x-large"> + <tr> + <td><img src="images/logo.gif" alt="iTe"></td> + <td>Version 3_1 (June 24 2005)</td> + </tr> + <tr> + <td colspan="2" align=right> + the <span style="font-weight:bolder">I</span>nteractive <span style="font-weight:bolder">T</span>ex <span style="font-weight:bolder">E</span>ditor + </td> + </tr> + </table> + </td> + </tr> + </table> + + <table align="center" cellpadding=30><tr><td> + <ul> + <LI><A HREF="description.html">Description</A> + <LI><A HREF="distribution.html">Distribution</A> + <LI><A HREF="installation.html">Installation</A> + <LI><A HREF="general.html">How iTe works</A> + <LI><A HREF="invocation.html">Invocation</A> + <LI><A HREF="latex.html">L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X Commands</A> + <LI><A HREF="plaintex.html">Plain T<SMALL>E</SMALL>X</A> + <LI><A HREF="largefiles.html">Large <EM>eps</EM>-Files</A> + </ul> + </td> + <td> + <ul> + <LI><A HREF="bindings.html">Default Key-Bindings</A> + <LI><A HREF="winmanager.html">Taming the Window Manager</A> + <LI><A HREF="example.html">Real World Example</A> + <LI><A HREF="gallery.html">Gallery</A> + <LI><A HREF="error_messages.html">Error Messages</A> + <LI><A HREF="bugs.html">Bugs and Feedback</A> + <LI><A HREF="news.html">What is new</A> + <LI><A HREF="outlook.html">Outlook</A> + </ul> + </td> + </tr> + </table> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Apr 4 2005</div> + </BODY> +</HTML> diff --git a/support/ite/news.html b/support/ite/news.html new file mode 100644 index 0000000000..de0da84b90 --- /dev/null +++ b/support/ite/news.html @@ -0,0 +1,185 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> + <html> + <HEAD> + <META name="author" content="Wolfgang Kühn"> + <META NAME="date" content="Saturday, 31 August 2002"> + <LINK REL="STYLESHEET" HREF="manual.css"> + <title>What's new in iTe</title> + </HEAD> + + <body> + <p> + <B>Next:</B> <A HREF="outlook.html">Outlook</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="bugs.html">Bugs and Feedback</A> + </p> + + <h1>What is new</h1> + + <h3>Version 3_1</h3> + <ul> + <li> + The distribution has been tuned for <tt>Linux</tt>; + </li> + <li> + The complete source code is now available for download; + </li> + <li> + The script to build the distribution is now based on <a href="http://ant.apache.org/index.html">Apache Ant</a> and + is therefore platform independend; + </li> + <li> + The <a href="bugs.html">bugs</a> in Version 3_0 are fixed. + </li> + </ul> + + <h3>Version 3_0</h3> + <ul> + <li>iTe will now also run on MS Windows platforms. + </li> + <li>A major code review took place. + </li> + <li>iTe does not use it's own HTML-browser anymore.</li> + <li>The <a href="bugs.html">bugs</a> in Version 2_20 are fixed. + </li> + </ul> + + <h3>Version 2_20</h3> + <ul> + <li>The <a href="bugs.html">bug</a> in Version 2_15 is fixed. + </li> + </ul> + + <h3>Version 2_15</h3> + <ul> + <li>The <a href="bugs.html">bug</a> in the short-lived Version 2_1 is fixed. + </li> + <li>The test suite is now integrated in the online help and can also + be accessed before installation using <code>make check</code>. + </li> + <li>The <span class=ite>iTe</span> web pages got a face lift. + </li> + </ul> + + <h3>Version 2_1</h3> + <p> + The perl module of iTe got an overhaul. It now handles included eps files + which do not conform to the PostScript file description format (for example files generated by Matlab). + </p> + + <h3>Version 2_01</h3> + <p> + This minor release fixes two <a href="bugs.html">bugs</a>. + </p> + + <h3>Version 2_0</h3> + <ul> + <li>All known <a href="bugs.html">bugs</a> are fixed. + </li> + <li>iTe is now much more user friendly. The package does include a help browser. + </li> + </ul> + + <h3>Version 1_3</h3> + <ul> + <li> + Known bugs are fixed. + </li> + <li> + The local html-documentation is now accessed via + <tt>doc/htmlmanual/index.html</tt>. + </li> + <li> + There is a new tokenlist <tt>\everyite</tt>. Use it to insert tokens + in every <tt>iteblock</tt> environment. Very useful to fix the size + of the font, for example with + <tt>\everyite={\fontsize{10}{12pt}\selectfont}</tt>. + </li> + </ul> + + <h3>Version 1_2</h3> + + <p> + The code is completely rewritten, cleaner, and better documented. + </p> + + <h3>Major impovements</h3> + + <ul> + <li> + iTe teams up with AucTeX to process multiple files via a master file. + </li> + <li> + iTe is not a minor mode anymore, but instead operates directly on + objects with the help of text properties. Objects can be selected + with the mouse. + </li> + <li> + Handles even huge included eps-files. If the size of an + eps-file exceeds a certain threshold, the user has the option + to only display a bounding box. + </li> + <li> + The dimensional argument (xdim,ydim) of the <em>iteblock</em> + environment is now optional. If omitted, the block + automatically adapts its size to include all of its objects. + </li> + <li> + The parsing of the PostScript code is now done with Perl, + not by (X)Emacs anymore. This improves speed and requires less + memory. + </li> + </ul> + + <p></p> + + <h3>Incompatibilities</h3> + + <ul> + <li> For LaTeX, iTe is now loaded via <tt>\usepackage{ite}</tt>, + and <b>not</b> via <tt>\input ite</tt>. + </li> + <li> The + <tt>\grabber</tt> was impoved so that it now rotates about the + center of the circle. This will cause small offsets for the old + grabber. + </li> + </ul> + + <h3>Version 1_1</h3> + + <ul> + <li> + Zooming now works also for scaled documents, for example documents + which contain + <pre> +\special{!userdict begin /bop-hook{0.5 0.5 scale} def end} + </pre> + Very useful for oversized paper sizes like posters. + </li> + <li> + iTe block environments can now occur inside scaled boxes, for example + <pre> +\scalebox{0.5}{% +\begin{iteblock}(\textwidth,8cm) +\ite\includegraphics{sc.eps} +\ite$\sin x$ +\end{iteblock}} + </pre> + Note that <em>\scalebox</em> is defined in the <em>graphics</em> package. + </li> + <li> + Bug due to incorrect scaling (thanks to Manuel Hölß). + <li> + Bug involving killed message window fixed (thanks to Jan Vroonhof). + </li> + </ul> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Apr 4 2005</div> + + </body> + </html> + + + + diff --git a/support/ite/outlook.html b/support/ite/outlook.html new file mode 100644 index 0000000000..d1b701cd4d --- /dev/null +++ b/support/ite/outlook.html @@ -0,0 +1,30 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>Outlook</TITLE> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + +<B> Up:</B> <A HREF="manual.html">iTe</A> +<B> Previous:</B> <A HREF="news.html">What is new</A> + +<H1>Outlook</H1> + +<P> +The author does not plan to add any new features to <span class=ite>iTe</span>, but +new releases will appear as bugs are fixed. Unfortunately, the code base of <span class=ite>iTe</span> +is not very well documented. However, one of the most tricky features of <span class=ite>iTe</span> +is documented in <a href="devguide.tex">devguide.tex</a>. +</P> + +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Saturday, 31 August 2002 +</FONT> +</contact-stamp> +</BODY> +</HTML> + + + diff --git a/support/ite/plaintex.html b/support/ite/plaintex.html new file mode 100644 index 0000000000..0fe8057610 --- /dev/null +++ b/support/ite/plaintex.html @@ -0,0 +1,44 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<HTML> +<HEAD> +<TITLE>Plain TEX</TITLE> +<LINK REL="STYLESHEET" HREF="manual.css"> +</HEAD> +<BODY > + + <B> Next:</B> <A HREF="largefiles.html">Large eps-Files</A> + <B> Up:</B> <A HREF="manual.html">iTe</A> + <B> Previous:</B> <A HREF="latex.html"> L<SUP>A</SUP>TEX Commands</A> + + <H1>Plain T<SMALL>E</SMALL>X</H1> + + <P> + If plain T<SMALL>E</SMALL>X is used, the commands in the previous section have to + be replaced by the equivalent commands in this chapter. + +<pre class="command">\input ite.tex</pre> + +The <TT>graphics</TT> and <TT>dvi</TT> options are not supported. + +<pre class="command">\input trig.tex</pre> + +Note that `trig.tex' may not be installed on your system. + +<pre class="command">\beginiteblock(x_dimen,y_dimen) + ... +\enditeblock</pre> + +<pre class="command">\ITEunit=dimension</pre> + +<pre class="command">\beginitebind + ... +\enditebind</pre> + +<P> +<contact-stamp><hr><FONT SIZE=-1> +Last modified by <A HREF="http://www.decatur.de/wolfgang">Wolfgang Kühn</a> on +Saturday, 10 June 2000 +</FONT> +</contact-stamp> +</BODY> +</HTML> diff --git a/support/ite/winmanager.html b/support/ite/winmanager.html new file mode 100644 index 0000000000..0b93c0855b --- /dev/null +++ b/support/ite/winmanager.html @@ -0,0 +1,48 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<HTML> + <HEAD> + <TITLE>Taming the Window Manager</TITLE> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <LINK REL="STYLESHEET" HREF="manual.css"> + </HEAD> + <BODY > + <div> + <B>Next:</B> <A HREF="example.html">Real World Example</A> + <B>Up:</B> <A HREF="manual.html">iTe</A> + <B>Previous:</B> <A HREF="bindings.html">Default Key-Bindings</A> + </div> + + <H1>Taming the Window Manager (Unix only)</H1> + + <P> + Sometimes the Unix window manager is too attentive and catches key events + before they get to <TT>(X)Emacs</TT>, notably the `ALT arrow' keys. You + either rebind those keys through <a href="installation.html#customization">customization</a>, + or you have to edit the resource file of the window manager to suppress this behavior. + For example, if you use the <EM>fvwm</EM> window manager, then add/edit the + following lines to/in your '.fvwmrc' file: + </P> + <PRE> +# press arrow + control anywhere, and scroll by 1 page +Key Left R C Scroll -100 0 +Key Right R C Scroll +100 +0 +Key Up R C Scroll +0 -100 +Key Down R C Scroll +0 +100 + +# press arrow + meta key, and scroll by 1/10 of a page +Key Left R M Scroll -10 +0 +Key Right R M Scroll +10 +0 +Key Up R M Scroll +0 -10 +Key Down R M Scroll +0 +10 + </PRE> + + <P> + A different problem occurs if your X11 system requires the + specification of width and height as options to ghostscript. If the + default size of the ghostscript window is wrong on your system, please + add the option '-g550x720' to the <tt>gs-command</tt> configuration variable. + </p> + + <div id='TIMESTAMP' style='font-size:small'><hr/>Last modified by <A HREF='http://www.decatur.de/wolfgang'>Wolfgang Kühn</a> on Mar 27 2005</div> + </BODY> +</HTML> |