[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Interactive guide for new users
From: |
Gregory Heytings |
Subject: |
Re: Interactive guide for new users |
Date: |
Sat, 12 Sep 2020 09:31:06 +0000 |
User-agent: |
Alpine 2.22 (NEB 394 2020-01-19) |
Based on the feedback received so far, I reworked the proposal a bit.
The idea is to create an "initial greeting" that would be bundled with
Emacs, and would be executed the first time the first time Emacs is
launched (instead of the initial splash screen). It should be short (take
no more than three minutes to go through), and give the user (1) a way to
set some defaults according to their preferences, and (2) a short
introduction to the most important elements of Emacs.
The rationale behind this proposal is the discussion that started with
Ergus' mail a week ago. It is hard to synthetize what has been said, but
it seems to me that it boils down to two incompatible viewpoints: (1)
those who have been using Emacs for years do not want to change the
default settings too much, and (2) new Emacs users, who already know and
use other text editors (Visual Studio, Atom, ...), are puzzled with its
interface and find that it does not look "modern" enough. IOW, the only
purpose of this proposal is to do something to avoid the initial feeling
some users have that Emacs is an old thing that they will have difficulty
to adapt to their needs.
The initial greeting would have eight screens, which I detail here because
some on this list prefer not to view videos on Youtube:
SCREEN 1: Welcome! It seems that this is the first time you run Emacs,
would you like to customize its interface and have a short introduction?
This will not take you more than three minutes.
SCREEN 2: "Set the color theme", with a clickable list containing the
(currently) 16 built-in themes. A short code snippet above that list
illustrates how code is displayed with each of these themes. [It would be
nice to have a way to select a default font here, but I don't know if that
feasible.]
SCREEN 3: Basic keybindings. It introduces the "C-" and "M-" notations,
and the user can select between the default keybindings and cua-mode (with
some additional keybindings). This "enhanced cua-mode" would have: C-c =
copy, C-v = paste, C-x = cut, C-f = search, C-s = save, C-o = open file,
C-z = undo, C-y = redo. If the user selects the cua-mode bindings, he
gets a message: "We encourage to reconsider this choice after some time,
because the alternative keybindings conflict with many parts of Emacs and
make the experience worse in the long run."
SCREEN 4: Choose whether to set some common options that new users might
want (because they are common in other text editors). These are (the
order could be improved, and items could be added or removed):
1. display-line-numbers-mode
2. disable tool-bar-mode
3. disable scroll-bar-mode
4. column-number-mode
5. (setq cursor-type 'bar)
6. hl-line-mode
7. show-paren-mode
8. which-key-mode
9. column-number-mode
10. save-place-mode and desktop-save-mode
11. (setq uniquify-buffer-name-style 'forward uniquify-min-dir-content 1024)
12. tab-line-mode
13. (global-set-key (kbd "C-b") 'ibuffer) [if cua-mode has been chosen]
14. icomplete-mode (or fido-mode?)
15. (setq scroll-conservatively 101)
16. display-time-mode
17. (setq tool-bar-style 'image)
SCREEN 5: Short explanations about what the user sees: the minibuffer
(where commands are entered and error messages appear), the mode-line
(with the current editing modes between parentheses, the first one is the
major mode), with a mention that the user can have a description of these
modes and of their keybindings by typing "C-h m".
SCREEN 6: How to find help. Short explanation about C-h C-h, C-h m, C-h
p, C-h k / C-h w / C-h a, C-h l. Note on terminology: in the
documentation two words might be confusing, "frame" is what is generally
known as "window", and "window" is a portion of a frame when it is
splitted in two or more parts. [Also explain what a "buffer"?]
SCREEN 7: Elementary keybindings: explain what "C-x 1" and "C-g" do.
Give a few examples to give the new user a sense of what using
C-<something> and M-<something> is:
1. "M-f and M-b" (which have the same effect as M-<left> and M-<right>)
2. "C-a and C-e" (which have the same effect as <home> and <end>)
3. "M-%" and "C-M-%"
SCREEN 8: Thank you. Your choices have been saved in Emacs' configuration
file ~/.emacs.d/init.el (or ~/.emacs ?). You can use M-x customize at any
time to set additional configuration options. You can use M-x
initial-greeting at any time to go through this configuration again.
- Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have), (continued)
- Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have), Göktuğ Kayaalp, 2020/09/11
- Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have), Emanuel Berg, 2020/09/11
- Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have), Praharsh Suryadevara, 2020/09/11
- Re: Interactive guide for new users, Lars Ingebrigtsen, 2020/09/12
- Re: Interactive guide for new users, Göktuğ Kayaalp, 2020/09/12
- Re: Interactive guide for new users, Gregory Heytings, 2020/09/12
- Re: Interactive guide for new users, Göktuğ Kayaalp, 2020/09/12
- Re: Interactive guide for new users, Gregory Heytings, 2020/09/12
- Re: Interactive guide for new users, Juri Linkov, 2020/09/13
- Re: Interactive guide for new users (was: Re: Gather a list of confusions beginner tend to have), Yuan Fu, 2020/09/11
- Re: Interactive guide for new users,
Gregory Heytings <=
- Re: Interactive guide for new users, Eli Zaretskii, 2020/09/12
- Re: Interactive guide for new users, Gregory Heytings, 2020/09/12
- Re: Interactive guide for new users, Ergus, 2020/09/12
- Re: Interactive guide for new users, Eli Zaretskii, 2020/09/12
- Re: Interactive guide for new users, Dmitry Gutov, 2020/09/12
- Re: Interactive guide for new users, Gregory Heytings, 2020/09/12
- Re: Interactive guide for new users, Eli Zaretskii, 2020/09/12
- Re: Interactive guide for new users, Gregory Heytings, 2020/09/12
- Re: Interactive guide for new users, Eli Zaretskii, 2020/09/12
- Re: Interactive guide for new users, Ergus, 2020/09/12