Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jakobferdinand/dotfiles

Configurations of all sorts of tools
https://github.com/jakobferdinand/dotfiles

Last synced: about 2 months ago
JSON representation

Configurations of all sorts of tools

Awesome Lists containing this project

README

        

# Dotfiles

Dotfiles are the configuration files for various tools and programs.
Most of them start with a `.` - that´s why they are called `dotfiles`.

## Usage

I use a **git bare repository** to manage my dotfiles.
I found the idea on [Derek Taylor´s Youtube Channel](https://www.youtube.com/watch?v=tBoLDpTWVOM&t=905s). His [GitLab](https://gitlab.com/dwt1/dotfiles) page is also a great resource for configuration ideas.

Clone the repository into a `dotfiles` folder.
```sh
git clone --bare https://github.com/JakobFerdinand/dotfiles.git $HOME/dotfiles
```

Checkout the the main branch.
```sh
git --git-dir=$HOME/dotfiles --work-tree=$HOME checkout
```

> [!TIP]
> If you are using Windows be sure to use Powershell Core.
> Follow the [instructions for Powershell](Documents/PowerShell/readme.md).

Prevent Git from showing all files.
```
config config status.showUntrackedFiles no
```

Now you have configured aliases for `zsh` and `powershell` and can work with the repository directly through the command `config`.
Example:
```sh
config commit -m "Updated readme.md"
```

## Zsh Configuration

For using all tools and options configured in the `zsh configuration` some tools are needed.

### Go
Go mainly is needed to install other tools.

**MacOS**
```bash
brew install go
```

### Chroma
[`Chroma`](https://github.com/alecthomas/chroma) is a general purpose syntax highlither.
It´s used by the `ccat` tool.
```go
go get -u github.com/alecthomas/chroma/cmd/chroma
```