vjousse / vim-for-humans-book Goto Github PK

View Code? Open in Web Editor NEW

131.0 7.0 20.0 23.25 MB

The vim for humans book

Home Page: https://vimebook.com

License: Other

Shell 1.33% TeX 91.16% Makefile 0.79% Python 5.82% Asymptote 0.44% sed 0.40% CSS 0.06%

latex vim ebook book

vim-for-humans-book's Introduction

Vim for humans

Website code available here: https://github.com/vjousse/vim-for-humans-website vimrc config examples available here: https://github.com/vjousse/vim-for-humans

Install

Be sure to create a symlink named 'vim-for-humans' in the project directory. This symlink should point to a directory where you've cloned code examples.

You will need some prerequisites to be able to compile the LaTeX source code:

A Tex distribution, TexLive for example.
Pygments, it's used for syntax highlighting using the mint LaTeX package.
Sphinx to generate the epub file.
kindlegen to generate the .mobi file.
sphinx-autobuild if you want to start a webserver with hot reload in rst/fr with make livehtml

Archlinux

yay -S python-sphinx python-pygments kindlegen

Use instructions from the official website for TeX Live

Compile

After the dependencies have been installed, run makedist.sh script to start compiling. If the compilation fails, be sure to check the content of the script and try running each command one after another.

Enjoy

Upon success outputs can be found in the dist/vimpourleshumains/ directory. Enjoy!

Tips & tricks

Generate rounded/shadowed image

Be sur to have ImageMagick installed and use the add-borders.sh script like these:

./add-borders.sh book-tex/graphics/vim-catpuccin-mocha.png

It will replace your book-tex/graphics/vim-catpuccin-mocha.png image with a rounded/shadowed one and save the original image to book-tex/graphics/vim-catpuccin-mocha-original.png.

Get kitty terminal window for screenshots with sway

With sway, be sure that your kitty window is floating. Then resize it and change kitty font size.

swaymsg -r resize set width 1200 px; swaymsg -r resize set height 1000 px; kitty @ set-font-size 14

Font used: FiraCode Nerd Font from Nerd Fonts.

vim-for-humans-book's People

Contributors

Stargazers

Watchers

vim-for-humans-book's Issues

Consider using Sphinx-SimplePDF for PDF rendering

https://sphinx-simplepdf.readthedocs.io/en/latest/

Add a up and down page about vim / neovim

See https://piaille.fr/@merwanat/112364820542118183

Use vim-plug instead of pathogen

vim-plug is Simple, Fast, Intuitive and do Parallel plugins downloading

check:
https://github.com/junegunn/vim-plug

Check fr version from scratch

Spanish translation

Hi, I would like to contribute in the translation to spanish, could you guide me how to proceed?

Update screenshots

Beautify them using something like
https://screenshot-beautifier.vercel.app/
https://screenzy.io/
https://screely.com/
https://screenshotr.app/
https://pika.style/

Vim + Solarized sur Windows WSL

Bonjour Vincent, je suis en train de lire votre ouvrage sur vim.

J'utilise Windows 10 + WSL2 + Ubuntu 20.04, ce qui me permet d'avoir une vraie console Linux dans Windows. C'est génial mais comme il n'y a pas d'interface graphique, forcément il vaut mieux connaître vim ;)

Je vous signale cependant qu'avec la configuration de .vimrc proposée dans votre ouvrage, on obtient un fond gris clair qui pose problème pour la lisibilité.

J'ai cherché un peu sur le net comment réparer cela, il semble qu'il faut régler le theme sur un mode 256 couleurs (si j'ai bien compris) :

let g:solarized_termcolors=256

Voici ce que j'obtiens avec cette option.

Cyril

Update english version

Should be updated to #21

bépo

Bonjour,

J'ai appris que tu utilisais le clavier bépo. Et c'est vrai que ça me semble difficile dans un premier temps d'apprendre à utiliser vim et de le configurer pour un clavier bépo.

Peux-tu me donner une configuration du .vimrc pour le clavier bépo et les quelques explications autour pour pouvoir l'utiliser.

Car c'est vrai que le déplacement avec le 'ctsr' est intéressant, mais en même temps je ne sais plus trop comment compenser ces lettres.

Une aide serait la bienvenue pour les bépoistes.

D'avance merci pour ton aide.
cED

Refactoring and basic IDE features

This book is great to begin the use of Vim. But for coders, it lacks a final part wich gives some clues about how to transform our Vim into a real IDE with refactoring facilites and automatic error correction.

I mean, yes what you have shown to us here is a great tool for quick text editing, but it's not suitable for all days programming like intelliji or Eclipse are.

Is it something doable ?