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