In questo repository ho caricato i miei “dot file” per uso personale … ma se a qualcuno possono interessare ovviamente sono a disposizione!
- Installazione FZF
- Installare l'help tradotto in italiano
- Come installare il mio .vimrc
- Scorciatoie a tastiera personalizzate
- Personalizzazione per il Markdown
- Plugin installati in Vim
- Vim-which-key
- Fugitive: plugin per GIT
- Tmux.conf
- Colori usati: Terminale (iTerm2), Tmux e Vim
- Personalizzazione terminale: Zshrc
Fuzzy Finder è un sistema di ricerca fuzzy (basta digitare alcune lettere per ricercare un documento od una cartella) per il terminale. Con un’apposita plugin per Vim è poi possibile implementarlo anche in Vim stesso.
Per installare FZF digitate:
brew install fzf
è inoltre opportuno lanciare il seguente script di configurazione così da avere tutta una serie di funzioni aggiuntive e di scorciatoie a tastiera nel terminale.
$(brew --prefix)/opt/fzf/install
Ho intenzione di ampliare (man mano che imparo ad utilizzare meglio FZF) questa parte ma trovate un’ottima guida (da cui sto attingendo a man bassa) qui.
Per disinstallare lo script:
$(brew --prefix)/opt/fzf/uninstall
Andare alla pagina web che trovate qui.
Scegliere la versione dell'help corrispondente alla propria versione di Vim.
Per sapere quale versione di Vim si ha instsallato digitare a Terminale il seguente comando:
vim --version
Copiare l'URL del file itx e digitare a terminale:
wget http://www.pluto.it/sites/default/files/ildp/traduzioni/vimhelp-it/vim82/vimhelp82-it-itx.tar.gz
Verrà scaricato nella cartella in cui siete il file TAR vimhelp82-it-itx.tar.gz il nome ovviamente cambia in base alla versione di Vim scaricata dell'help.
Estraete quindi i file contenuti nel TAR digitando:
tar -xvzf vimhelp82-it-itx.tar.gz
Troverete quindi una sotto directory denominata itx, entratici dentro con il comando cd itx e poi digitate il seguente comando:
cp * /usr/share/vim/vim82/doc
Per sapere in quale cartella andare a copiare i file entrate in Vim e digitate:
:echo $MYVIMRUNTIME
Comparirà a video un percorso copiatelo ed aggiungeteci il postfisso /doc.
La cartella che ho indicato nell'esempio è quella tipica delle versioni Unix per Vim 8.2.
Ci siamo quasi …
Ora digitate il comando per cambiare diritti ai file, abitualmente dall'utente con cui siete loggati a root.
sudo chown root:root /usr/share/vim/vim82/doc/*
Se tutto va bene ora potrete avere l'help in italiano digitando :h @it o, se usate il mio .vimrc in autmatico perché ho inserito il comando set helplang=it,en che abilita l'help in italiano (quando è disponibile, non tutto è stato tradotto) o quello inglese se non è disponibile la traduzione in italiano.
Aprire il terminale e digitare il seguente comando:
curl -L 'https://raw.githubusercontent.com/avvocati-e-mac/dot/master/.vimrc' > .vimrc
Nota bene: Questo comando scarica nella vostra home o cartella in cui state lavorando il file .vimrc. Questo file non sarà più sincronizzato in alcun modo con questo repository. È quindi solo una copia.
Andare nella home con il seguente comando:
cd ~
Poi clonare il repository con il comando
git clone https://github.com/avvocati-e-mac/dot.git
Creare nella home un link simbolico ai files di configurazione vari contenuti all'interno della cartella /dot con i seguenti comandi:
ln -sfn ~/dot/.vimrc .vimrc
ln -sfn ~/dot/.zshrc .zshrc
ln -sfn ~/dot/.tmux.conf .tmux.conf
Fatto ciò c'è da entrare nella cartella dot ed impostare le credenziali locali come utente git.
cd dot
git config user.name "your-user-name"
git config user.email "your-email-addr"
Tra le virgolette fa inserito il nome che apparirà nella storia dei commit e l'email collegata.
Attualmente occorre creare la cartella dove sono contenuti i file di swap di Vim (dove vengono salvate le versioni del file che si sta modificando mentre si eseguono le modifiche e prima di aver salvato) e i salvataggi per gli undo tra differenti sessioni.
Da terminale digitare:
cd ~
mkdir .vim/swp
mkdir .vim/undodir
Ho aggiunto uno script introduttivo per cui non dovrebbe esserci la necessità di installare il gestore dei plugin …
È un esperimento, non l'ho ancora testato ma copiato da un altro utente Fonte, quindi per ora lascio anche la parte di guida all’installazione.
In Vim Unix (Linux e macOS) digitare a terminale il seguente comando
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
A questo punto, in Vim, digitare:
: PlugInstall
Si aprirà una finestra che mostrerà lo stato di installazione del plugin
Per visualizzare in Vim le scorciatoie personalizzate che ho creato digitare:
:map <leader>
Ho fatto alcune modifiche perchè non mi piace come viene evidenziata la sintassi del markdown …
In particolare ho impostato nel .vimrc che non venga nascosta se non si sta editando la specifica riga il markup del markdown.
set conceallevel=0
Ho disinstallato (commentandoli) i plug-in per pandoc / markdown ed aggiunto una scociatoia a tastiera per attivare l’evidenziazione del markdown … allo stato non ho capito perché non si attiva autonomamente come dovrebbe.
La scociatoia è leader+n, inizio ad avere poche combinazioni libere.
Ho aggiunto una notevole quantità di plug-in, molti li devo ancora testare.
Comandi di base per generare, modificare e cancellare l'indice (TOC: table of contents)
:GenerateMarkdownTOC # Genera un nuovo indice
Permette di vedere le scorciatorie a tastiera e personalizzarne alcune.
Fugitive è il primo plug-in Vim per Git. O forse è il primo plugin Git per Vim? Ad ogni modo, è "così fantastico, dovrebbe essere illegale". Ecco perché si chiama Fugitive (fuggitivo in italiano).
Comandi di base:
:Gitè l’equivalente di digitareGita terminale. Si può abbreviare con il semplice comando:Gche consiglio di usare per velocizzare la digitazione.:Git added il nome del / dei file da allestire / organizzare (staged) per il commit, se si deve allestire solo il file su cui si sta lavorando è possibile usare semplicemente il comando:Gwrite.:Git commitseguito da-me le virgolette all'interno del quale indicare il testo del commit serve per eseguire il commit delle modifiche allestite / organizzate (staged).:Git pushper inviare il commit al server Git (remoto, tipo online come GitHub o interno alla rete):Gbrowseapre il documento su cui si sta lavorando nel browser su GitHub o altri repository online.
Link per maggiori informazioni, alternativamente è possibile digitare il comando :help fugitive.
È necessario installare FZF con Hombrew, per macOS, o con un altro gestore di pacchetti con Linux.
La prima volta premere CTRL+B e poi I (maiuscolo come Installa)
Siccome macOS Catalina è passato a ZSH come shell da terminale ho deciso di utilizzare come mia shell per tutti i miei dispositivi ZSH.
Ho installato per rendermi la vita più semplice Oh my ZSH.
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
Ho attivato anche vari plugin (in via sperimentale per ora).
Alcuni sono già installati tramite lo script di Oh my ZSH ma altri vanni installati appositamente.
Zsh-autosuggestion copiando nel terminale:
git clone https://github.com/zsh-users/zsh-autosuggestions.git $ZSH_CUSTOM/plugins/zsh-autosuggestions
e zsh-syntax-highlighting copiando nel terminale:
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git $ZSH_CUSTOM/plugins/zsh-syntax-highlighting
Questa soluzione funziona ma non mi soddisfa molto … tuttavia ho provato ad installare con Hombrew i due plugin ma lo script di Oh my ZSH non rileva i plugin anche se li ho inseriti nella cartella dei plugin con un link simbolico.
NOTA BENE: visto che sono dei cloni di repository bisogna ricordarsi ogni tanto di aggiornarli con un git pull.
Siccome mi piace avere un Terminale “carino” ho anche installato Powerlevel10k.
È configurabile utilizzando il comando p10k.
Per installarlo ci sono 2 modi:
1. Seguire queste istruzioni manuali
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>! ~/.zshrc
2. Se siete su Mac, utilizzare l’installazione attraverso Homebrew che trovate qui.
Sempre per Vim ho installato attraverso Homeebrew i NerdFonts. Nella sostanza sono fonts pensati per il Terminale ed aggiuncono dei caratteri speciali che in Airline permetto di creare una barra accattivante.
Di seguito il comando che trovate al link precedente.
brew tap homebrew/cask-fonts
brew cask install font-hack-nerd-font
Se siete su altre piattaforme rispesto a macOS qui trovate la pagina del progetto con anche [la guida all’installazione dei fonts](brew tap homebrew/cask-fonts brew cask install font-hack-nerd-font).