yatex

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