yatex

view docs/qanda.eng @ 60:9e08ed569d80

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