# Bienvenue à Dotfiles v0.2.462
# Introduction
Les Dotfiles sont un ensemble de fichiers de configuration Bash pour macOS, Linux et Windows, que vous pouvez utiliser pour personnaliser votre shell et vos applications. Tous ces fichiers sont réunis dans un seul endroit, et prêts à l'emploi.
Les Dotfiles se trouvent dans votre répertoire personnel, ce qui vous permet de les garder sous contrôle de version, et vous pouvez les utiliser sur n'importe quel ordinateur, n'importe où.
Ils regroupent un ensemble de fichiers combinés en un seul répertoire lib
. Ils
offrent des alias très pratiques, des fonctions et quelques configurations
prêtes à l'emploi, conçus pour obtenir de meilleurs résultats avec votre shell.
Essayez-les dès maintenant, et faites-nous savoir ce que vous en pensez. Nous sommes toujours à la recherche de commentaires et de suggestions pour améliorer nos produits et services.
# Démarrage
Nous sommes ravis que vous ayez décidé d'essayer les Dotfiles, et nous sommes confiants que vous les trouverez utiles et uniques.
Nous vous proposons une série de méthodes d'installation pour vous aider à commencer. Nous vous recommandons de choisir celle qui correspond le mieux à vos besoins.
TIP
Avant de commencer votre installation, veuillez consulter les instructions ci-dessous pour vous assurer que vous répondez à toutes les exigences matérielles, logicielles et de système pour installer les Dotfiles sur votre ordinateur et sauvegarder tout fichier de configuration que vous pourriez avoir.
# 1️⃣ Configuration matérielle requise
Pour installer les Dotfiles, nous vous recommandons d'utiliser une version récente de macOS, Linux ou Windows pour de meilleures performances, sécurité et compatibilité.
# 2️⃣ Configuration logiciel requise
Les Dotfiles ont des dépendances logicielles qui doivent être installées avant de pouvoir les utiliser. Ces dépendances sont listées ci-dessous.
- Un interpréteur de commandes en ligne (Bash (opens new window) ou Zsh (opens new window)), pour exécuter les scripts de configuration et les fonctions.
- Git (opens new window) (2.0 ou plus), pour cloner le code source et mettre à jour les Dotfiles.
- Curl (opens new window) (7.0 ou plus) or Wget (opens new window) (1.0 ou plus), pour télécharger les fichiers de configuration depuis les scripts d'installation.
- Make (opens new window) (3.0 ou plus) ou PnPM (opens new window) (6.0 ou plus), pour installer les Dotfiles via Make ou PnPM.
- Tmux (opens new window) (2.0 ou plus), un outil vous permettant de manipuler plusieurs terminaux virtuels au sein d'une même fenêtre de terminal.
# 3️⃣ La Police de caractères recommandée
Nous recommandons également d'utiliser une police de caractères open source telle que JetBrains Mono (opens new window) pour une meilleure expérience sur votre terminal, IDE ou éditeur de texte.
Sur macOS, vous pouvez installer la police en exécutant la commande suivante dans votre terminal :
brew tap homebrew/cask-fonts && brew install --cask font-jetbrains-mono
Sur les distributions Linux basées sur Debian, vous pouvez installer la police en exécutant la commande suivante dans votre terminal :
sudo apt install fonts-jetbrains-mono
# Installation
# 1️⃣ Sauvegardez vos données
WARNING
Nous vous recommandons vivement de sauvegarder vos données. C'est toujours une bonne idée de faire une sauvegarde car il peut y avoir des situations dans lesquelles vous pourriez être amené à restaurer votre installation précédente.
Le programme d'installation des Dotfiles est conçu pour sauvegarder vos fichiers
de configuration existants, dans un répertoire de sauvegarde
$HOME/dotfiles_backup
.
La liste des fichiers de configuration sauvegardés est la suivante :
.alias
.bash_aliases
.bash_profile
.bash_prompt
.bashrc
.curlrc
.dir_colors
.exports
.functions
.gitattributes
.gitconfig
.gitignore
.gitmessage
.inputrc
.npmrc
.path
.profile
.tmux.conf
.vimrc
.wgetrc
.yarnrc
.zshenv
.zshrc
cacert.pem
# 2️⃣ Téléchargement
Vous pouvez télécharger la dernière version des Dotfiles (v0.2.462) en utilisant l'une des méthodes suivantes :
- Téléchargement manuel (opens new window) - Installez les Dotfiles en téléchargeant le fichier archive du code source,
- En utilisant PnPM (opens new window) - Installez les Dotfiles en utilisant PnPM
pnpm i @sebastienrousseau/dotfiles
, - En utilisant Npm (opens new window) - Installez les Dotfiles en utilisant Npm
npm install @sebastienrousseau/dotfiles
, - En utilisant Yarn (opens new window) - Installez les Dotfiles en utilisant Yarn
yarn add @sebastienrousseau/dotfiles
, - En utilisant Git (opens new window) - Clonez le dépôt Dotfiles depuis GitHub
git clone https://github.com/sebastienrousseau/dotfiles.git
.
# 3️⃣ Installation en utilisant Make
La manière la plus simple d'installer Dotfiles est d'utiliser la commande make
dans votre shell. Cela installera la dernière version des Dotfiles et
sauvegardera automatiquement tous les fichiers dotfiles dans un répertoire de
sauvegarde $HOME/dotfiles_backup
.
Allez dans le répertoire dotfiles-0.2.462
que vous avez téléchargé et exécutez
:
make build
Vous pouvez également vérifier les options du programme d'installation, en exécutant tout simplement :
make help
# 4️⃣ Installation avec Node.js
Si vous voulez installer Dotfiles en utilisant Node.js, allez dans le répertoire
dotfiles-0.2.462
et exécutez :
node .
# 5️⃣ Installation avec PnPM
Si vous voulez installer Dotfiles en utilisant PnPM, allez dans le répertoire
dotfiles-0.2.462
et exécutez :
pnpm run build
# 6️⃣ Après l'installation
Vérifier que les dotfiles sont bien installés dans le répertoire
$HOME/.dotfiles
. Pour compléter l'installation,redémarrer votre terminal.
Si l'installation est réussie, vous devriez voir la nouvelle interface Dotfiles dans votre shell.
# Contenu
Les Dotfiles contiennent des éléments de base qui sont utilisés pour configurer votre shell, et d'autres composants adaptés à la configuration de votre environnement.
Dans le dossier $HOME/.dotfiles
, vous trouverez les répertoires et fichiers
suivants :
.
└── lib
├── aliases
│ ├── default
│ │ └── default.aliases.sh
│ ├── gcloud
│ │ └── gcloud.aliases.sh
│ ├── git
│ │ └── git.aliases.sh
│ ├── heroku
│ │ └── heroku.aliases.sh
│ ├── jekyll
│ │ └── jekyll.aliases.sh
│ ├── pnpm
│ │ └── pnpm.aliases.sh
│ ├── subversion
│ │ └── subversion.aliases.sh
│ └── tmux
│ └── tmux.aliases.sh
├── configurations
│ ├── bash
│ │ └── bashrc
│ ├── curl
│ │ ├── cacert.pem
│ │ └── curlrc
│ ├── default
│ │ ├── color.sh
│ │ ├── constants.sh
│ │ ├── editor.sh
│ │ └── prompt.sh
│ ├── gem
│ │ └── gemrc
│ ├── input
│ │ └── inputrc
│ ├── jshint
│ │ └── jshintrc
│ ├── nano
│ │ └── nanorc
│ ├── profile
│ │ └── profile
│ ├── tmux
│ │ ├── default
│ │ ├── display
│ │ ├── linux
│ │ ├── navigation
│ │ ├── panes
│ │ ├── theme
│ │ ├── tmux
│ │ └── vi
│ ├── vim
│ │ └── vimrc
│ ├── wget
│ │ └── wgetrc
│ ├── zsh
│ │ └── zshrc
│ └── README.md
├── functions
│ ├── README.md
│ ├── cdls.sh
│ ├── curlheader.sh
│ ├── curltime.sh
│ ├── encode64.sh
│ ├── environment.sh
│ ├── extract.sh
│ ├── filehead.sh
│ ├── genpwd.sh
│ ├── goto.sh
│ ├── hidehiddenfiles.sh
│ ├── hostinfo.sh
│ ├── hstats.sh
│ ├── httpdebug.sh
│ ├── keygen.sh
│ ├── last.sh
│ ├── logout.sh
│ ├── lowercase.sh
│ ├── macos.sh
│ ├── matrix.sh
│ ├── mcd.sh
│ ├── mount_read_only.sh
│ ├── myproc.sh
│ ├── prependpath.sh
│ ├── ql.sh
│ ├── rd.sh
│ ├── remove_disk.sh
│ ├── ren.sh
│ ├── showhiddenfiles.sh
│ ├── size.sh
│ ├── stopwatch.sh
│ ├── uppercase.sh
│ ├── view-source.sh
│ ├── vscode.sh
│ ├── whoisport.sh
│ └── zipf.sh
├── paths
│ ├── ant
│ │ └── ant.paths.sh
│ ├── default
│ │ └── default.paths.sh
│ ├── homebrew
│ │ └── homebrew.paths.sh
│ ├── java
│ │ └── java.paths.sh
│ ├── maven
│ │ └── maven.paths.sh
│ ├── node
│ │ └── node.paths.sh
│ ├── nvm
│ │ └── nvm.paths.sh
│ ├── pnpm
│ │ └── pnpm.paths.sh
│ ├── python
│ │ └── python.paths.sh
│ ├── ruby
│ │ └── ruby.paths.sh
│ └── tmux
│ └── tmux.paths.sh
├── README.md
├── aliases.sh
├── configurations.sh
├── exit.sh
├── functions.sh
├── history.sh
└── paths.sh
36 directories, 86 files
# Les Publications
Les publications des Dotfiles sont disponibles sur GitHub (opens new window).
# Versionnage sémantique
Dans un souci de transparence de notre cycle de publication et dans le but de maintenir les Dotfiles suivent les principes de versionnage sémantique (opens new window).
# Liste des modifications
- Le Journal des modifications GitHub (opens new window) est utilisé pour suivre les différentes versions des Dotfiles et leurs changements.
# Code de conduite
Nous nous engageons à préserver et à favoriser une communauté diversifiée et accueillante. Vous pouvez lire notre Code de conduite (opens new window) pour en savoir plus.
# Nos valeurs
- Nous pensons que la perfection fait partie de tout.
- Notre passion va au-delà du code et s’intègre dans notre vie quotidienne.
- Nous cherchons toujours à fournir des solutions exceptionnelles et innovantes.
# Contribution
Merci d'utiliser Dotfiles ! Si vous aimez ce projet, n'hésitez pas à nous donner un coup de pouce en le notant sur GitHub (opens new window) ou en le partageant avec vos amis et collègues.
Il existe également d'autres façons de contribuer, comme :
- Soumettre des bogues et des demandes de fonctionnalités (opens new window), vous pouvez même nous aider à les résoudre et faire partie de la communauté.
- Vérifiez notre documentation (opens new window) et traductions pour nous aider à améliorer la qualité de notre contenu.
- Faire un don (opens new window) pour nous aider à continuer à améliorer le projet ou payer pour un café.
Veuillez lire attentivement nos guides de contribution (opens new window) pour de plus amples informations sur notre processus de développement et sur la façon de soumettre des demandes de fonctionnalités ou des rapports de bogues.
# Licence d'utilisation
Ce projet est soumis à la licence MIT (opens new window).
# Remerciements
Dotfiles (opens new window) est conçu par ces personnes et par un groupe de collaborateurs (opens new window) extraordinaires.
Sebastien Rousseau (opens new window) | Graham Colgate (opens new window) |