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