FAQ
How do I change the interface language?
By default yumete follows your system's locale: a Taiwan, Hong Kong or Macau locale gets traditional Chinese, any other Chinese locale gets simplified Chinese, and everything else gets English. To choose one yourself, set it in the config:
[editor]
language = "zh" # "auto" (default), "zh" traditional, "zhs" simplified, "en"
:language en switches for the current session without a restart, and
ye --lang=en does it for one run. See
Configuration.
Why do I get letters when I type, not Chinese?
The input method is off when yumete starts, so insert mode types letters. Type
:yume (or just :y) to turn it on; the first time, it loads the scheme's
code table. To have it on from the start:
[ime]
start = true
If it is on and you still get letters, it is in English ([ABC]). Tap Shift on
its own to switch between Chinese and English. Terminals that cannot report a lone
Shift (Apple's Terminal, for one) use C-^ instead; [editor] language_key
sets that key. See The input method.
yumete crashed. Where is my work?
While a file has unsaved changes, yumete keeps a recovery copy beside it, as a
hidden file: chapter.md gets .chapter.md.yumete.<number>. It is removed when you save
or quit normally. On macOS and Linux, closing the terminal window (SIGHUP)
or a SIGTERM writes every unsaved file's copy on the way out. After a crash,
open the file again and yumete asks whether to
recover the copy, throw it away, or leave it for later. :recover asks again.
Typing in an unnamed buffer is kept too, in the data directory, and comes back
the same way.
Recovering replaces the file's text in the buffer; nothing is saved until you
:w, and u undoes it. See Files, saving and changes.
Where is the config?
| What | Where |
|---|---|
| Your config | ~/.config/yumete/config.toml ($XDG_CONFIG_HOME/yumete/ if set; %APPDATA%\yumete\ on Windows) |
| A project's config | .yumete/config.toml in the project; its values override yours, key by key |
| Data, sessions, log | ~/.local/share/yumete/ ($XDG_DATA_HOME/yumete/ if set; %APPDATA%\yumete\ on Windows) |
:version shows the exact paths on your machine. :settings opens a panel of
every setting with a note on each, and :w there saves it. After editing a
file by hand, :reload-config applies it, and :check-config points out lines
it cannot read. See Configuration.
Some cells have an amber background. What is that?
A hidden character is next to them: a zero-width space, a soft hyphen, a byte-order mark, or a bidi control. A tinted space is a space that is not a plain one, such as a no-break space. Put the cursor on the tinted cell and the status line names the character. To turn this off:
[editor]
unicode_alarm = false
See Checks and counts.
How do I hide the count on the status line?
Set [editor] status_count = "off", or "all" to show it in code files too.
See Settings.
How do I make ye reopen yesterday's files?
ye -r reopens what was open last time in this project. Set
[editor] session = true to do it every time. See
Files, saving and changes.
Can I use vim keys?
Yes. Set [keys] preset = "vim". See Coming from vim.
What is not there yet?
- Reading marks (the circles and dots used in classical texts). They can be drawn in the margin, but there is no markup for them yet.
- Rotated Latin text in vertical layout. A terminal cannot rotate letters, so a long Latin run stacks letter by letter down the column. A few half-width characters, four by default, can sit side by side in one square (see Vertical layout), but not a sentence.
- Editor regions side by side, or more than two.
C-w ssplits the editor into two, one above the other, and that is all. See Windows and the sidebar.