mdl

## How to get started on a new system

# How to get started on a new system

  - NOTE: double check all the install commands if something goes wrong, things may have changed upstream

  - NOTE: double check all the install commands if something goes wrong,
    things may have changed upstream

  sh <(curl -L https://nixos.org/nix/install) --darwin-use-unencrypted-nix-store-volume --daemon

  sh <(curl -L https://nixos.org/nix/install) \
      --darwin-use-unencrypted-nix-store-volume \
      --daemon

- [install nix-darwin](https://github.com/LnL7/nix-darwin#install "nix-darwin-install-instructions") if on macos

- [install nix-darwin](https://github.com/LnL7/nix-darwin#install "nix-darwin-install-instructions")
  if on macos

- [install home-manager](https://github.com/nix-community/home-manager#installation) follow the instructions at the link

- [install home-manager](https://github.com/nix-community/home-manager#installation)
  follow the instructions at the link

  - if on macos also follow the instructions for [integrating home-manager as a nix-darwin module](https://nix-community.github.io/home-manager/index.html#sec-install-nix-darwin-module "home-manager-nix-darwin-module")

  - if on macos also follow the instructions for integrating home-manager as a nix-darwin
    module [instructions](https://nix-community.github.io/home-manager/index.html#sec-install-nix-darwin-module)

  - modify `localhome/default.nix` according to the needs of the system (like choosing what to install and some PII info)

  - modify `localhome/default.nix` according to the needs of the system
    (like choosing what to install and some PII info)

- symlink `~/dotfiles/nixpkgs` to `~/.config/`

- create a symbolic link of `~/dotfiles/nixpkgs` to `~/.config/`

```shell
ln -fs ~/dotfiles/nixpkgs ~/.config/
```

  ```shell
  ln -fs ~/dotfiles/nixpkgs ~/.config/
  ```

  - if on macos  (only the first call to darwin-rebuild requires the darwin-config argument)

  - if on macos
    (only the first call to darwin-rebuild requires the darwin-config argument)

- finish installing emacs dependencies by starting emacs and running the following functions

- finish installing emacs dependencies by starting emacs and running the following
  functions

  - on macos: optionally allow emacs to "control your computer" in **Settings > Accessibility** to allow `emacs-everywhere` to work.

  - on macos: optionally allow emacs to "control your computer" in
    **Settings > Accessibility** to allow `emacs-everywhere` to work.

### Things to remember

## Things to remember

- to update to the latest packages run `nix-channel --update` before running `home-manager switch` or `darwin-rebuild`

- to update to the latest packages run `nix-channel --update`
  before running `home-manager switch` or `darwin-rebuild`

### TODO: for macos

## TODO: for macos

- emacsMacport does not have a gui launcher add one upstream or make a wrapper, right now you have to use `open -a ~/.nix-profile/Applications/Emacs.app` and start the server from within emacs, you can't do `emacs --daemon` that doesn't work (should fix that as well at somepoint)

- `pkgs.emacsMacport` does not have a gui launcher add one upstream or make a wrapper,
  right now you have to use `open -a ~/.nix-profile/Applications/Emacs.app` and
  start the server from within emacs, you can't do `emacs --daemon` that doesn't
  work (should fix that as well at some point)

### Notes

## Notes

#### zsh

### zsh

- if zsh start up is really slow, first try restarting computer, then try running zsh with `zsh -lvx`.

- if zsh start up is really slow, first try restarting computer, then try running
  zsh with `zsh -lvx`.

### Troubleshooting

## Troubleshooting

#### Start Over get rid of nix completely

### Start Over get rid of nix completely

- nix is now gone completely so you can follow the install instructions to start over

- nix is now gone completely so you can follow the install instructions to start
  over

#### After macos update / upgrade

### After macos update / upgrade

- tl;dr; these can sometimes replace the changes necessary in `/etc/zprofile` and `/etc/zshrc` meaning we need to intervene manually.

- tl;dr; these can sometimes replace the changes necessary in
  `/etc/zprofile` and `/etc/zshrc` meaning we need to intervene manually.

```sh

```shell

    - id: mdl-markdown-linter
      name: markdown-linter
      description: ruby gem to lint markdown files
      entry: mdl -g
      language: system
      types: [markdown]
      minimum_pre_commit_version: 1.14.2