Le site arthur.bebou.netlib.re - retour accueil
git clone git://bebou.netlib.re/arthur.bebou
Log | Files | Refs |
index.sh (5102B)
1 #! page
2 title: slides.vim, des slides dans votre terminal
3 author: Arthur Pons
4 description: slides.vim est un plugin vim permettant de rapidement et facilement créer des slides dans vim
5 publication: 2023-12-24
6 sectionmd: main
7
8
9 slides.vim est un plugin vim permettant de rapidement et facilement créer des
10 slides dans vim. Le rendu est en texte uniquement mais il est possible
11 d'exécuter des commandes arbitraires au passage des slides de façon à ouvrir
12 une image par exemple.
13
14 Pour des démos voir [cette présentation de Marc
15 Chantreux](https://podv2.unistra.fr/video/52277-techdays-14-open-barre-marc-chantreux/),
16 [celle-ci de
17 moi](https://podv2.unistra.fr/video/52211-techdays-14-fabriquons-un-systeme-de-gestion-de-playlist-sobre-et-interoperable-arthur-pons/)
18 et pour des exemples de sources le dépôt github ou [ces sources d'une
19 présentation](git://katzele.netlib.re/prez-staffdataweek-20231012) que j'ai
20 faite à des bibliothécaires.
21
22 Le dépôt se trouve [ici] et est assez bien documenté. Veuillez vous y référer
23 pour en savoir plus. Je vais en traduire les parties que je trouve essentielles
24 dans cet article.
25
26 ## Installation
27
28 Il faut d'abord installer le contenu du plugin hébergé sur [ce dépôt github]
29 dans un dossier dans votre `~/.vim/pack`, par exemple :
30
31 mkdir ~/.vim/pack/slides.vim/start
32 git clone -C !$ https://github.com/eiro/slides.vim.git
33
34 Si vous voulez en savoir plus sur les plugin, lire `:help packs`.
35
36 Il vous faut ensuite ajouter `filetype plugin on` dans votre `.vimrc` pour
37 activer les plugins sur certaines extensions de fichiers. En l'occurence
38 ici pour activer le plugin à l'ouverture de fichiers `*.slides` par défaut.
39
40 ## Utilisation
41
42 ### Les bases
43
44 Pour aller au plus simple, une fois un fichier `.slides` d'ouvert vous pouvez
45 entrer en mode insertion et faire `("` pour ajouter un titre de slide. Le plugin
46 détectera automatiquement que c'est un titre et le stylera. Si vous mettez du
47 contenu juste en dessous et ouvrez une seconde slide vous verrez que la
48 première a automatiquement été masquée. Pour passer d'une slide à l'autre vous
49 pouvez utiliser les touches "page up" et "page down" généralement situées
50 proche des flèches du clavier.
51
52 Puisqu'il est souvent préférable de voir votre fichier texte plus d'une slide à
53 la fois pour l'éditer vous pouvez lancer la commande `:set fen!` pour toutes les
54 déplier. Refaire la même commande vous fera repasser en mode "présentation".
55
56 A partir de là mettez votre terminal en plein écran, zoomé le et hop c'est
57 parti pour votre présentation !
58
59 ### Mise en avant et exécution de commande
60
61 Si vous entourez un mot d'un espace insécable[^1] le mot sera mis en rouge.
62
63 Puisque vous êtes dans vim si vous voulez exécuter une commande lors de la
64 presentation vous pouvez simplement l'écrire dans une slide, sélectionner le
65 texte et le filtrer avec `:mouvement!filtre`. Par exemple pour une commande
66 shell tenant sur une ligne : `:.!sh`.
67
68 Si vous voulez quelque peu masquer une commande et qu'elle s'exécute
69 automatiquement au passage de la slide pour, par exemple, afficher un
70 graphique, vous pouvez commencer une slide avec `('` au lieu de `("`. Cela
71 ajoutera le bon caractère mais vous mettra en mode insertion juste avant. Si
72 vous écrivez une commande avant - mettons `feh graph.png` - et le titre après le
73 caractère spécial, la commande sera masquée et automatiquement évaluée à
74 l'ouverture de la slide.
75
76 Voilà, vous avez les bases et un peu plus pour faire de jolies présentations :)
77
78 ## Personnalisation
79
80 ### Modifier les extensions considérées comme des slides
81
82 Dans les plugins vim ce qui détermine les extensions de fichier concernées se
83 trouve dans le dossier `ftdetect`. Dans ce dossier se trouve un fichier
84 `slides.vim` dans lequel on trouve la ligne
85
86 au BufNewFile,BufRead *.slides setf slides
87
88 Pour changer l'extension il suffit de modifier `*.slides` en `*.prez` par exemple.
89
90 ### Ajouter/Modifier des raccourcis clavier
91
92 Si vous n'aimez pas les raccourcis fournis (comme `("`) vous pouvez les modifier
93 dans le fichier `ftplugin/slides.vim`. Vous verrez des lignes type
94
95 inoremap <buffer> (' <space>›<c-o>i
96
97 Modifier `('` changera la combinaison de touche à faire en mode insertion
98 pour insérer ce qui suit. Modifier ce suit modifiera évidemment ce qui
99 est insérer.
100
101 Pour modifier ce qui permet de passer d'une slide à l'autre il faut modifier
102 `<PageUp>` et `<PageDown>` des lignes :
103
104 nnoremap <buffer> <PageUp> zkzt
105 nnoremap <buffer> <PageDown> zkzt:Hook<cr>
106
107 ### Modifier les commandes pour se mettre initialement en mode présentation
108
109 Par défaut ce qui suit est exécuté pour créer un mode "présentation" le plus
110 sobre possible :
111
112 setlocal noshowmode noruler noshowcmd nolist nonu
113
114 sauf que personnellement j'ai aussi `rnu` d'activé. J'entrais
115 donc en mode présentation avec les numéros relatifs à gauche de
116 la console. J'ai ajouté `nornu` à la fin.
117
118 [ici]: https://github.com/eiro/slides.vim.git
119 [ce dépôt github]: https://github.com/eiro/slides.vim.git
120 [^1]: généralement en faisant alt+espace