yatex
view docs/qanda.eng @ 58:3a7c0c2bf16d
Official support for AMS-LaTeX, HTML, xdvi -remote, Netscape
| author | yuuji |
|---|---|
| date | Thu, 01 Feb 1996 18:55:47 +0000 |
| parents | 18f4939986e6 |
| children | 48ac97a6b6ce |
line source
1 %%
2 %% Q and A on YaTeX
3 %%
4 %% C-u C-x $ shows only questions. C-x $ shows all.
5 %%
7 [Installation]
8 ==============
9 *Installing the manual
11 Copy yatexe to the info directory where your Emacs is installed,
12 and add the next line to the dir file of the same directory.
14 * YaTeX: (yatexj). Yet Another tex-mode for Emacs. (Japanese).
16 (After that, M-x info [RET] m yatex [RET] will give you Wild
17 Bird's manual. Hitting ? will show how to use info)
19 *I ain't got the privilege to write in the Info directory...
21 Get yourself made root. If you can't, have them install Mule2
22 and add
24 (setq Info-default-directory-list
25 (cons "YOUR INFO DIRECTORY"
26 Info-default-directory-list))
28 to your ~/.emacs. Now your personal files will be added to the
29 menu when you invoke info. By the way, Mule1 will not release
30 memories, so processes will pile up and be heavier on the system
31 compared to Mule2. Nemacs has already become obsolete by the
32 developers, so no further comments for usage of Nemacs. Get
33 yourself Mule2 with flying colors :-)
35 *Emacs can't find the help file.
37 The help file is set to be placed in $EMACS/etc/ for Nemacs,
38 Mule1 and $EMACS/site-lisp/ for Mule2. If you don't have the
39 privilege to put them in a public location, copy it to your home
40 directory and set YaTeX-help-file to that file name.
42 *I can't read info on Nemacs
44 The info file was formatted on Mule, so it can't be read
45 correctly on Nemacs (or Demacs based on Nemacs) because the
46 internal Japanese processing is different. Read it on Mule.
47 Use the Emacs-Lisp package in texinfo-3.1.tar.gz to format the
48 Texinfo file.
51 [Operations]
52 ============
53 *I accidentally learned in a wrong LaTeX command.
55 There should be a line with the wrong command in the .yatexrc
56 file in your home or current directory. Erase or fix that line,
57 and save the results with C-x C-s, then kill buffer with C-x k.
58 Once you make sure the current buffer is your LaTeX source, type
59 M-x YaTeX-reload-dictionary.
61 *I can't comment out the region.
63 Probably the point is on a line withe \begin{} or \end{}. Go up
64 or down a line and do C-c >.
66 *I was asked for a parent file when typesetting, and answered the wrong file.
68 Re-read the child file with C-x C-v RET or re-type the parent
69 file with C-u C-c ^.
71 *The typeset buffer is not shown when I get a typeset buffer on Demacs.
73 This happens on Demacs 1.2.0, when the child process returns an
74 error level of 1 or more. If you are calling jlatex from a
75 batch file, call a dummy command that always returns errorlevel
76 0 at the end.
78 *How can I enter "\underline{\makebox[4em][l]{x y}{\tt z}}" more easily?
80 Recursive completion can be used for inputting arguments in the
81 mini-buffer of a section type completion. Following is an
82 example showing the command in question.
84 PROMPT KEYs ENTERED
85 C-c s und SPC RET
86 \underline{???}: C-c s makeb SPC RET
87 Width: 4em RET
88 makebox position (`lr'): - l RET
89 \makebox{???}: x y RET
90 \underline{???}: \makebox[4em][l]{x y} C-c l tt RET
91 \underline{???}: \makebox[4em][l]{x y}{\tt } z RET
93 *How can I kill \footnote{} from \footnote{HOGE}
95 Put the point to \footnote and do C-c k. This will kill the
96 \footnote{}. If you want to kill the whole thing including
97 HOGE, do C-u C-c k.
99 *I want to make HONYARA into a footnote.
101 Mark HONYARA and do C-c S footnote RET. (S in uppercase)
103 *I want to make the verbatim environment I have now into verbatim*.
105 Do C-c c on the line with \begin{verbatim} or \end{verbatim}.
107 *I want to enclose a region with \verb.
109 \verb isn't a maketitle-type, so there aren't any quick commands.
110 But you can use C-c $ to do the same thing.
111 v v
112 WHAT YOU NEED to make \verb
113 \verbWHAT YOU NEED to make \verb (insert \verb)
114 ^(C-@) (mark W)
115 \verbWHAT YOU NEED to make \verb
116 ^C-c $ (move point to end enclose with $)
117 \verb$WHAT YOU NEED$ to make \verb (done!)
119 *I want to have commands defined on a upper level file to be read in
120 when doing a typeset-region on a child file.
122 When you are editing child files broken into sections and some
123 macros to be used are defined in upper level files, you'll need
124 them to do typeset-region. The macros needed will be copied to
125 the temporary file if you add %#REQUIRE to the end of the
126 macro's definition.
128 Say you had a grand-child file
129 +-- main.tex --+ +---- sub.tex ----+ +-- subsub.tex --+
130 | : | |%#jlatex main | |%#jlatex main |
131 |\include{sub} | |\include{macros} | |..... |
132 | : |<-| : |<-|%#BEGIN |
133 | : | | : | |TEXT YOU WANT |
134 | : | +-----------------+ |TYPESET IS |
135 +--------------+ ^ |HERE |
136 +-- macros.tex ---+ |%#END |
137 |\def\foo{bar} | |: |
138 |\def\hoge{hero} | +----------------+
139 +-----------------+
141 In this case you change the \include{macros} line in sub.tex to
143 \include{macros} %#REQUIRE
145 and add to subsub.tex
147 %#REQUIRE \include{macros}
149 If %#REQUIRE is at the top of the line, the following will be
150 copied to the temporary file. So, macros.tex will be included
151 only once whether you are typesetting all the files, or doing a
152 typeset-region on sub.tex or subsub.tex.
154 *I want to reuse ARGUMENTS I used in the last \foo{ARGUMENTS}
156 Use the gmhist package. YaTeX works fine with gmhist. When you
157 are asked \foo{???}: in the mini-buffer, hitting M-p (ESC p)
158 will get you a history of what you have inputted in reverse.
159 M-n will go forward in the history. This input history can be
160 used for begin-type completion, section-type completion, evoking
161 the previewer, and print out commands.
163 gmhist can be found at many Emacs-Lisp archive sights. For
164 example, ftp.ae.keio.ac.jp:pub/emacs-lisp/util/gmhist.tar.gz
166 Note that Emacs-19(Mule2) doesn't need gmhist for the feature of
167 minibuffer history.
169 *ref<->label jump doesn't work.
171 C-c g will start a forward search of ref/label. C-u C-c g will
172 start a backward search. If you want to continue searching for
173 \ref, hit C-s (C-r) twice and use the repeated search feature of
174 the incremental search. If the point to jump is in another
175 file, that file must be already opened. YaTeX-display-hierarchy
176 (C-c d) can be used to open all files at once.
178 *I get a % at the end of the line when I do a fill-paragraph or auto-fill.
180 NTT-jTeX will add an unnecessary space in the print out image if
181 the japanese paragraph is written with an indent. To avoid
182 this, you need to put a % at the end of the line. YaTeX will
183 automatically put a % so you can input indented text for
184 NTT-jTeX. But there may be a bug in the routine so please
185 report if you find any %s otherwise than at the end of a line.
187 *Isn't the indentation too deep in itemize environments?
189 Think so too? An alias Mr. K thought this was better and he
190 feels an ultimate ecstacy with hitting the TAB to indent a line.
191 Wasn't my idea! (still have a bit of a grudge) If you also
192 think it's too deep, hit TAB at the end of the line with
193 \begin{itemize} within the environment. Now it's too shallow?
194 Umm... time for me to take a break.
196 *Is it possible to include personal template file template.tex handily?
198 Try Emacs-19's standard package `autoinsert.el' please. Or its
199 upper compatible package auto-insert-tkld might also be good.
200 You can get auto-insert-tkld via anonymous ftp
201 ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/
202 ftp://archive.cis.ohio-state.edu/pub/gnu/elisp-archive/
204 [About Emacs-19/Mule2]
205 ======================
206 *Equations are too dark to read when I use hilit19.
208 The default coloring of hilit19.el is too dark. Try putting the
209 next code in ~/.emacs or yatexhks.el.
211 (if (and (featurep 'hilit19) (eq hilit-background-mode 'dark))
212 (hilit-translate
213 string 'mediumspringgreen
214 formula 'khaki
215 label 'yellow-underlined))
217 *Can't I use font-lock?
219 The document says, "pattern must be specified within a line".
220 So it seems you can't chose a pattern like from \begin to \end
221 that laps more than one line. But on the other hand, multiple
222 line comments in C seems to work fine... So what's the real
223 story? Anybody know the answer? If so, teach me, or try
224 sending a fan letter to our font-lock investigator-in-depress
225 Taguchi (tagu@ae.keio.ac.jp)
227 *It's sooo slow when I click YaTeX on the menu bar.
229 I don't know why. Probably a problem with Emacs-19. You'll
230 just have to bear with it. It won't be so slow the second time.
231 Anyway, you probably won't use the menu at all, do you?
233 *Is there any way of displaying `\it' strings in the italic font?
235 First, you should find the available italic font on your
236 system. In, *scratch* buffer,
237 (set-face-font 'italic "-*-*-medium-i-*--*-*-*-*-*-*-*-*")
238 or
239 (set-face-font 'italic "-*-*-medium-o-*--*-*-*-*-*-*-*-*")
240 and C-j (It takes very very long time!!).
241 If you get `No matches found', no way. (;_;)/~
242 If you get some font name,
243 "-adobe-courier-medium-i-normal--12-120-75-75-m-0-iso8859-1"
244 for example, write
245 (set-face-font 'italic
246 "-adobe-courier-medium-i-normal--12-120-75-75-m-0-iso8859-1")
247 in your `yatexhks.el'.
249 [Customization]
250 ===============
251 *I don't use C-c b i much, so it would be better if I can start
252 completion after hitting C-c b.
254 Put (setq YaTeX-no-begend-shortcut t) in your ~/.emacs.
256 *An open parenthesis always get entered in pairs.
258 This should be better, once you get used to it. If you still
259 don't like it, turn on modify-mode using C-c w m. Setting
260 YaTeX-close-paren-always to nil will give this feature from the
261 start.
263 *Funny things happen when I hit ;.
265 YaTeX think you are in math mode and evokes math-mode-image
266 completion. If you are writing a equation that TeX will not
267 give an error and YaTeX mistakes what mode you are in, report it
268 back to the author. For mistaken judgements or if you want to
269 enter a literal ;, hit ; twice. C-u ; to use ; as a
270 image-completion prefix.
272 *I want YaTeX to enter the option arguments for a newenvironment.
274 Read yatexadd.doc. If that's not enough, read yatexgen.doc and
275 try M-x YaTeX-generate.
277 *I first defined \foo as a macro taking 3 arguments. Later I changed it
278 to take 4 arguments, but the section-type completion will ask me for
279 only 3 arguments.
281 Use C-u 4 C-c s and tell it will take 4 arguments. You can
282 change the number of arguments anytime you want.
284 *I made a argument-type addin function, but can't do completion after
285 the first two arguments.
287 If you made a addin function like \foo{x}{y}{z} that takes 3
288 arguments, then you need to learn in the dictionary that \foo
289 will take 3 arguments. This can be done by C-u 3 C-c s foo.
290 You only need to do it once.
292 *My addin functions are overwritten by yatexadd.
294 Formally, all private functions were written in your own
295 yatexadd.el. Now, all private functions are put in yatexhks.el.
296 yatexhks.el will be read in at the end of YaTeX's
297 initialization, so you can overwrite definitions in yatexadd.el.
299 *Can I make intelligent newline work for my `mylist' environment?
301 Yes. See the section `Intelligent newline' in the info manual.
302 But if you want the same as the intelligent newline for itemize
303 environment which inserts simply `\item', the following code is
304 efficient.
306 (fset 'YaTeX-intelligent-newline-mylist
307 'YaTeX-intelligent-newline-itemize)
309 [ETC]
310 =====
311 *Mailing lists?
313 A question, so an answer. The mailing list for YaTeX (Wild
314 Bird) and it's implementation to Vz, Raicho (by KATSURAGAWA,
315 Naoki; katsura@prc.tsukuba.ac.jp) is "fj Wild Bird Society".
316 Send a mail like
318 To: yatex-control@jaist.ac.jp
319 Subject: append
320 -----
321 Hi! See any birds fly by?
323 and you're in. The text will be used as your profile. (you can
324 change it later) Once you're in, you'll get a reply with lists
325 of commands used in the mailing list. Join along and help
326 adding new feathers to Wild Bird. BTW, if you haven't guessed
327 it yet, yes, this mailing list is in Japanese. But give us a
328 try anyway. You're always welcome.
330 *How to get the up-to-date information on YaTeX?
332 If you can access WWW, try to see;
333 http://www.comp.ae.keio.ac.jp/~yuuji/yatex/
334 And if you trace the link of `yatex-current', you can get the
335 really latest version of YaTeX. Since it collects the elisps in
336 the author's source directory, what you'll get may contain some
337 errors. The author cannot respond to your query about
338 yatex-current.
340 *Help, help HELP!!
342 Ways of getting answers in fastest order.
344 *Look for someone near you who knows what's he/she's doing.
345 *Post a question to the mailing list.
346 *Send mail to yuuji@ae.keio.ac.jp
348 take a pick.
350 *Picking a question in this file with C-u C-x $ and hitting C-x $ takes
351 me to a weird world.
353 You too? Try marking the question before C-x $ and to C-x C-x
354 to take you back to it. (Mule2 doesn't seem to have the same
355 problem)
358 Local Variables:
359 mode: indented-text
360 fill-column: 72
361 fill-prefix: " "
362 End: