diff options
author | Joris Roovers <joris.roovers@gmail.com> | 2023-05-09 10:16:20 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-05-09 10:16:20 +0200 |
commit | e4c19887bad9e2dedcfc31b9e318486e162f9300 (patch) | |
tree | 45ed7f4617cdbd4b98dd53cc65c17899223dfe43 /docs/installation.md | |
parent | 2a77afd845832c1a00a65e210f9339344dd6f114 (diff) |
Material for Mkdocs (#489)
- Switches mkdocs theme from read-the-docs to Material for Mkdocs
- Review and rewrite of all documentation pages
Diffstat (limited to 'docs/installation.md')
-rw-r--r-- | docs/installation.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/docs/installation.md b/docs/installation.md new file mode 100644 index 0000000..edfba53 --- /dev/null +++ b/docs/installation.md @@ -0,0 +1,60 @@ +## Fully supported + +### Pip (recommended) +```{.sh .copy} +pip install gitlint +``` + +By default, gitlint is installed with pinned dependencies. +To install gitlint with looser dependency requirements, only install gitlint-core: +```{.sh .copy} +pip install gitlint-core +``` +??? "Uninstalling gitlint" + To fully uninstall gitlint, you need to remove both `gitlint` and `gitlint-core`: + ```{.sh .copy} + pip uninstall gitlint gitlint-core + ``` + +### Docker +There is a fully maintained and supported [docker image for gitlint](https://hub.docker.com/r/jorisroovers/gitlint). +```{.sh .copy} +docker run --ulimit nofile=1024 -v $(pwd):/repo jorisroovers/gitlint # (1) +``` + +1. `--ulimit` is required to work around a limitation in Docker. + Details: see issue [#129](https://github.com/jorisroovers/gitlint/issues/129) + +## Community Maintained Packages +These packages are not officially maintained by gitlint. For the latest and fully supported version, always use `pip`. + +#### Brew +```{.sh .copy} +brew install gitlint +``` +#### MacPorts + +```{.sh .copy} +port install gitlint +``` + +#### Ubuntu +```{.sh .copy} +apt-get install gitlint +``` + +#### All available packages +[![Packaging status](https://repology.org/badge/vertical-allrepos/gitlint.svg)](https://repology.org/project/gitlint/versions) + +## Shell completion + +```sh +# Bash: add to ~/.bashrc +eval "$(_GITLINT_COMPLETE=bash_source gitlint)" + +# Zsh: add to ~/.zshrc +eval "$(_GITLINT_COMPLETE=zsh_source gitlint)" + +# Fish: add to ~/.config/fish/completions/foo-bar.fish +eval (env _GITLINT_COMPLETE=fish_source gitlint) +```
\ No newline at end of file |