Como instalar o eev no Emacs (2021)

O eev é o que eu uso pra "automatizar quase tudo" -
por exemplo, com esse tipo de "anotações executáveis" daqui.
Ele funciona melhor no Linux, mas dá pra aprender o básico
no Windows começando pelas instruções deste vídeo.
Eu fiz este vídeo pra uma oficina (que não funcionou).

Se você for usar o eev no Windows dê uma olhada no eev-wconfig:
página principal,
links pros três vídeos,
legendas pro vídeo em inglês,
índice do vídeo em inglês.

Update (jan/2024): eu pus uma versão melhorada das instruções de instalação aqui.

As instruções longas pra instalar uma versão recente do Emacs no Windows são: google por "emacs 29 for windows"; você vai cair neste diretório. Leia o arquivo README-windows-binaries; ele vai te dizer pra instalar um arquivo com nome como "emacs-$VERSION-installer.exe". Clique no "Last modified" daqui pra mudar pra "sorted by last modified"; você vai chegar nesta outra listagem desse mesmo diretório, agora ordenada por data - repare que agora a URL termina com "?C=M;O=A". Procure o arquivo mais recente com nome como "emacs-$VERSION-installer.exe" - o que está mais próximo do final da página. Em 2023apr25 o mais recente era este aqui: emacs-29/emacs-29.0.60-5e1953-installer.exe. Siga as instruções dele. Depois de instalá-lo talvez você precise criar um atalho pro arquivo runemacs.exe.

00:00
00:02 Oi! Eu tô fazendo uma série de vídeos
00:05 curtos sobre uma oficina de Software
00:07 Livre que eu vou dar amanhã, que
00:09 na verdade é uma oficina de Emacs e eev
00:12 principalmente para usuários de Windows...
00:14 e esse é o vídeo mais básico de todos,
00:16 que é sobre como instalar o eev no Emacs.

00:18 Então, eu vou supor que vocês já
00:21 instalaram o Emacs mas que vocês não
00:23 sabem absolutamente nada sobre como usar
00:25 ele, e eu vou explicar como instalar o eev
00:29 e vou explicar algumas coisas muito
00:30 básicas.

00:32 Deixa eu dar uma dica de terminologia...
00:36 o Emacs usa muito uma notação que é a
00:38 seguinte: C maiúsculo, tracinho, nome de
00:40 uma tecla. Por exemplo, C maiúsculo,
00:42 tracinho, x minúsculo... isso sempre quer
00:46 dizer control-tecla. Então, por exemplo
00:48 isso aqui, C-x, quer dizer control-x.
00:55 E ele também usa essa notação daqui,
00:59 M maiúsculo, tracinho, nome de uma tecla,
01:02 que quer alt-tecla. Então, por exemplo,
01:06 M-x quer dizer alt-x,
01:12 e a pronúncia é meta-tecla
01:17 por motivos históricos... o Emacs é da
01:20 década de 80, e ele foi desenvolvido em
01:22 computadores que não tinham a tecla alt,
01:24 mas tinham a tecla meta, e aí num certo
01:26 sentido a tecla meta "virou" a tecla alt
01:30 à medida que os teclados foram mudando.

01:34 Então tá. Deixa eu mostrar como instalar o eev.

01:37 Deixa eu só fazer uma coisa misteriosa
01:41 aqui... não prestem atenção, tá?
01:45 Ah, peraí, fiz besteira! Não era isso
01:48 que eu queria... deixa eu fechar isso.
01:51 Pronto.

01:59 Então, no Windows vocês vão fazer uma
02:01 coisa totalmente diferente disso... vocês
02:03 devem ter um ícone para abrir o Emacs,
02:06 e quando você iniciarem o Emacs
02:13 ele vai mostrar uma tela de
02:15 inicialização que diz "Welcome to
02:17 GNU Emacs", não sei quê... talvez ele tenha
02:19 um desenho super estilizado de uma cara de
02:22 um gnu, talvez não...
02:24 e aqui... ops -
02:28 aqui a gente vai fazer o seguinte:
02:31 a gente vai bater M-x, que é alt-x,
02:35 e o nome de um comando. Reparem que
02:38 o M-x abriu um prompt aqui
02:40 embaixo. Ele aqui tá indicando que você
02:43 já bateu o M-x e ele tá esperando o
02:45 resto do comando. E agora a gente vai
02:47 bater: list, traço, packages,
02:50 e a gente vai dar enter...
02:53 ele vai levar alguns segundos, repara que
02:55 aqui diz "Package menu: Loading", e depois
02:58 de alguns segundos o "Loading" desaparece,
03:00 e aqui vocês vão ter que localizar o eev.

03:03 Aqui o nome dos pacotes tá em ordem
03:06 alfabética mas tá em vários blocos. Então
03:08 aqui tem o primeiro bloco que vai até "z",
03:10 que tá em ordem alfabética, depois um
03:12 segundo bloco, que começa em "a", e
03:14 também tá em ordem alfabética. Vocês vão
03:17 ter que procurar onde tá o eev...
03:27 Cadê? cadê?
03:30 Dava para ir também com C-s...
03:37 desculpa, não, desculpa, C-s é algo
03:40 avançado que eu não quero explicar agora!
03:42 Mas dava para usar PgUp e PgDn também.

03:44 Então: o eev tá aqui, e aí ou a gente leva
03:48 o cursor aqui e dá enter,
03:51 ou a gente clica aqui.
03:56 Quando a gente faz o Emacs vai abrir
03:58 uma outra janela falando sobre o
04:01 pacote eev, e diz que ele está
04:03 disponível e pode ser instalado, e se
04:06 vocês ou clicam aqui ou levam o cursor
04:09 até aqui e dão enter,
04:11 o Emacs perguntas se você realmente
04:14 quer instalar pacote eev, aí a gente dá
04:16 "y", leva uns segundos...
04:21 e aí repara que é aqui muda, e ele diz
04:24 que o eev tá instalado.

04:26 E aqui tem uma descrição do eev na
04:30 qual só uma coisa importa para gente
04:31 agora, que é o seguinte...
04:33 que é que para rodar o tutorial do eev
04:36 a gente tem que bater M-x eev-beginner.

04:40 Então deixa eu fazer o seguinte. Eu vou
04:43 fechar essas janelas daqui usando esse botão
04:45 X daqui...
04:48 ele às vezes muda de lugar, tá?... ele tava
04:51 à esquerda, depois ele andou para a direita...
04:54 e agora vou abrir o tutorial. Então vou
04:56 bater M-x, que é alt-x, lembrem...
05:01 eev, traço, beginner...
05:05 e aí quando eu der Enter
05:08 vai ter esse indicador aqui avisando que
05:11 agora o eev tá carregado, e ele vai
05:14 entrar nesse tutorial daqui.

05:16 Vocês podem conferir que esse é o
05:21 tutorial "find-eev-quick-intro" aqui por
05:23 essa barra daqui, que a gente chama de
05:25 "modeline"...

05:27 e agora deixa eu só explicar quais são as
05:30 duas teclas mais básicas de navegação,
05:32 e o resto eu vou explicar
05:34 em outros tutoriais.

05:37 Então: a primeira tecla é o M-e, alt-e.
05:42 O que o M-e faz é o seguinte: ele vai
05:45 até o final da linha,
05:46 como se eu tivesse ido até aqui... se eu
05:49 bater M-e aqui ele primeiro leva o cursor
05:51 até aqui, e depois ele executa a expressão
05:54 que tá antes do cursor. Repare
05:57 que o Emacs tá
05:59 colorindo esses parêntese de uma
06:02 determinada forma - com uma cor feia, mas
06:04 que a gente pode reconfigurar ela depois -
06:07 e isso aqui indica que a expressão
06:09 antes do cursor é essa daqui. Então se eu
06:14 bater alt-e essa expressão vai ser
06:16 executada, e essa aqui aparentemente
06:17 não faz nada, tá... na verdade o que ela faz
06:20 é que ela recria esse tutorial de novo, no
06:24 sentido que se você fizer um bocado de
06:26 besteira aqui, tipo se você deletar
06:27 um pedação dele, se você vier aqui e executar
06:31 essa expressão de novo o tutorial vai
06:33 ser recriado.

06:37 Então: o M-e é muito importante e às
06:41 vezes ele vai ser usado como hiperlinks,
06:42 no sentido de que se a gente executa
06:46 essas coisas daqui ele nos leva para
06:48 tutoriais importantes.

06:50 A segunda a tecla mais importante é o
06:53 M-j. Esse "j"
06:54 é de "jump", e ela vai nos permitir
06:57 pular para vários lugares importantes. Se
07:00 eu bater M-j
07:02 o Emacs vai mostrar uma tela - repara que
07:07 aqui ele diz "*(find-eejumps)*" -
07:09 e ela tem essa parte de cima, que vai
07:13 ser importantíssima pra iniciantes,
07:15 e essa parte aqui, que tem que ser
07:17 totalmente ignorada por iniciantes, tá,
07:20 porque a de cima é beginner-friendly, e
07:22 a de baixo é beginner-unfriendly. E aí essa
07:26 parte de cima tem vários links importantes.

07:29 Esse primeiro faz a mesma coisa que eu
07:32 tava mostrando antes - ele recria essa tela
07:36 daqui...
07:37 então por exemplo se eu fizer uma
07:41 bagunça aqui e eu executar isso daqui de
07:43 novo ele recria isso do jeito anterior...
07:47 e esses links aqui são links muito
07:50 importante, pra tutoriais...
07:52 esses dois aqui vão explicar como é que
07:55 o M-j funciona em detalhes...
08:00 Mas agora eu só quero mostrar esse daqui, que
08:03 é um outro tutorial, que não é esse tutorial
08:06 básico, que é o find-eev-quick-intro...

08:09 o segundo tutorial mais básico é o
08:12 find-emacs-keys-intro, que é um tutorial que
08:17 não é um tutorial de verdade, é só uma lista
08:19 de teclas. Então se eu executar essa linha
08:23 daqui o Emacs
08:26 abre esse tutorial falso que é uma lista de
08:29 teclas, e praticamente todas as
08:31 linhas tem um hiperlink depois...
08:34 aqui tem as três téclas mais
08:36 importantes, que são M-e, M-j e M-k,
08:40 e quase todas elas têm links logo depois
08:44 que vão para documentação sobre aquilo.

08:50 E um pouquinho mais embaixo nesse
08:52 tutorial a gente vai ter teclas
08:54 importantes do Emacs, incluindo explicações
08:56 a respeito delas, e...

09:03 caramba, era isso que eu queria mostrar, tá...
09:05 a partir daqui vocês conseguem seguir
09:08 esses links aqui, por exemplo esse,
09:10 é aí vocês vão para um pedaço do
09:13 manual do Emacs...
09:15 repara que aqui ele diz que a gente
09:17 tá no modo "info"...
09:20 na verdade a gente tá olhando o manual do
09:24 Emacs escrito em modo "info", e a gente
09:26 tá numa seção dele chamada "Minibuffer".

09:29 Então: vocês vão ter que aprender a
09:32 usar o M-j,
09:35 que é ótimo pra quando a gente tá perdido,
09:37 basta a gente voltar pra ele e ele vai
09:39 nos dar links importantíssimos, o M-e
09:41 para seguir expressões que são
09:43 hyperlinks, e aí vocês vão conseguir ir pra
09:46 vários tutoriais importantes. O tutorial mais
09:49 importante é esse daqui: find-eev-quick-intro

09:52 e aqui tem uma dica importíssima:
09:55 se eu bater M-5 M-j eu
09:59 volto para esse tutorial - M-5 M-j
10:02 corresponde a seguir esse link daqui.

10:08 E M-5 M-j pode ser apertado
10:11 desse jeito: você deixa o "meta"
10:13 apertado - o alt apertado - e aí bate "5j",
10:17 e aí você solta o alt. Então se eu bater
10:20 alt- 5j eu vou pra o tutorial
10:24 principal, que é o find-eev-quick-intro,
10:28 e na oficina a gente vai seguir ele
10:31 até pelo menos a seção 5.2.

10:34 Tem só mais uma coisa que eu quero
10:39 mostrar nesse tutorial muito básico, que é o
10:41 seguinte. A gente vai
10:45 criar um arquivo de anotações e a gente vai
10:47 botar todas as nossas anotações lá. No
10:49 início a gente vai botar as anotações num
10:51 arquivo só...
10:52 dá para botar em vários, mas isso é um
10:55 assunto um pouco mais avançado, então
10:56 enquanto vocês tiverem com bem poucas
10:58 anotações é melhor colocar todas num
11:00 arquivo só. E esse arquivo é o arquivo TODO,
11:04 e aí essa linha daqui dá a dica de que
11:07 se vocês apertarem alt-1j
11:11 vocês vão pro arquivo TODO -
11:14 repara que aqui apareceu o nome dele.

11:17 Se eu apertar alt-21j
11:23 isso aqui vai mostrar o TODO na
11:26 janela da direita - aqui tão as minhas
11:29 anotações, deixa eu fingir que isso aqui
11:30 são as minhas anotações... e aqui tem o
11:33 lugar onde eu estava antes.

11:35 E se eu apertar M-31j
11:40 acontece a mesma coisa, só que o
11:44 cursor vai pra janela da direita... tá,
11:46 então experimentem um pouquinho com isso,
11:49 as coisas mais básicas são essas, e
11:52 vocês vão colocar as anotações de vocês
11:54 no arquivo TODO.

11:56 Bom, então é isso, deixa eu só repetir...
11:58 as teclas mais básicas são M-e,
12:02 M-j e M-k, e vocês não precisam
12:04 decorar isso, só precisam decorar M-j e M-e,
12:09 e se vocês forem para esse tutorial
12:12 daqui,
12:13 que é um tutorial sobre teclas, ele já
12:17 vai começar dando links muito bons sobre
12:19 o que cada tecla dessas faz.

12:23 Tá? Então esse é o básico muito básico,
12:26 e além disso tem esses botões daqui que
12:29 vão fazer coisas úteis...
12:31 tudo que eles fazem pode ser feito
12:33 através de teclas, mas imagino que como
12:36 vocês são iniciantes vocês vão preferir
12:37 os botões por enquanto. E aí pra sair do
12:40 Emacs vocês vão pra esse menu daqui
12:43 tem um monte de opções
12:46 importantes, cada uma delas, com
12:49 à direita uma explicação de que teclas
12:52 você pode usar para fazer aquilo. E vamos
12:55 sair do Emacs com "quit"...

12:58 Como eu não fiz nenhuma anotação importante
13:01 eu vou descartar esse TODO. Repara que
13:05 ele tá me perguntando se eu quero salvar
13:07 o TODO, e eu vou dizer que não quero.
13:11 Então eu saí do Emacs, e deixa eu só lembrar
13:14 vocês que se eu entrar no Emacs de novo
13:17 ele não vai estar com o eev ativado, tá...

13:20 então se vocês apertarem alt-e, alt-j,
13:23 não sei quê, ele não vai fazer o que a gente
13:26 quer...
13:28 por exemplo, alt-e vai pra a linha seguinte,
13:32 o alt-j eu não lembro que faz, e a gente vai ter
13:38 que fazer o seguinte: toda vez que a gente
13:40 entrar no Emacs - até a gente aprender um
13:43 outro jeito de lidar com isso - a gente vai
13:45 ter que bater M-x eev-beginner,
13:53 e aí ele vai abrir um tutorial. Tá?

13:56 E lembrem que cada linha dessas aqui é
14:01 um hiperlink que vocês podem seguir com
14:03 M-e, e se você seguirem esse daqui
14:09 vocês vão pra lista de teclas. E só
14:13 uma curiosidade... se vocês seguirem esse
14:15 daqui, find-eev-intro, vocês vão pra
14:18 um outro tutorial falso que é uma
14:20 lista de coisas... ele é uma lista de
14:22 tutoriais.

14:23 Tá, então é isso por enquanto,
14:27 esse vídeo era só para falar dessas
14:30 coisas muito básicas
14:32 que como instalar o eev, como o rodar o
14:36 M-x eev-beginner, e essas teclas muito
14:39 básicas de navegação.

14:41 E aí vocês já podem passear um pouquinho
14:44 pela documentação,
14:45 pelas explicações, pelos tutoriais, pelos
14:48 exercícios dos tutoriais, e depois a
14:51 gente vai ver coisas mais avançadas.

14:53 Então é isso - fim do tutorial muito
14:56 básico. Deixa eu parar a gravação dele aqui.