Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Zi Packages #65

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
137 changes: 118 additions & 19 deletions ecosystem/packages/02_packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,12 @@ keywords:

<!-- @format -->

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

For all the available packages use [GitHub search][22].

<div className="apitable" align="center">

| Package Name | Description |
| :----------------------: | ------------------------------------------------------------------------------------------------ |
| [any-node][1] | The any Node module(s) locally in a newly created plugin directory. |
Expand All @@ -36,11 +40,13 @@ For all the available packages use [GitHub search][22].
| [nb][19] | Bookmarking, and archiving with linking, tagging, search, Git syncing, Pandoc conversion, + more |
| [zsh-bin][20] | Package of statically-linked, hermetic, relocatable - romkatv/zsh-bin |

</div>

## Package profiles

### The dircolors-material color scheme

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -65,35 +71,50 @@ For all the available packages use [GitHub search][22].
</tr>
</tbody>
</table>
</h3>
</div>

<Tabs>
<TabItem value="default" label="Default">

Download the default profile.

```shell
zi pack for dircolors-material
```

</TabItem>
<TabItem value="no-zsh-completion" label="No completion">

Download the "no-zsh-completion" profile.

```shell
zi pack"no-zsh-completion" for dircolors-material
```

</TabItem>
<TabItem value="no-color-swap" label="No color swap">

Download the "no-color-swaps" profile.

```shell
zi pack"no-color-swaps" for dircolors-material
```

</TabItem>
<TabItem value="minimal" label="Minimal">

Download the minimal profile without altering the original theme.

```shell
zi pack"minimal" for dircolors-material
```

</TabItem>
</Tabs>

### The Firefox Developer Edition

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -118,23 +139,32 @@ zi pack"minimal" for dircolors-material
</tr>
</tbody>
</table>
</h3>
</div>

<Tabs>
<TabItem value="default" label="Default">

Download the firefox-dev latest binary.

```shell
zi pack for firefox-dev
```

</TabItem>
<TabItem value="bin-gem-node" label="Annex">

Download the firefox-dev latest binary with use of the [bin-gem-node][] annex.

```shell
zi pack"bgn" for firefox-dev
```

</TabItem>
</Tabs>

### The fzf command-line fuzzy finder

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -159,26 +189,38 @@ zi pack"bgn" for firefox-dev
</tr>
</tbody>
</table>
</h3>
</div>

Download the package with the default ice list.
<Tabs>
<TabItem value="default" label="Default">

Download the package with the default profile.

```shell
zi pack for fzf
```

Download the package with the default ice list + key bindings.
</TabItem>
<TabItem value="key-bindings" label="Key bindings">

Download the package with the default profile + key bindings.

```shell
zi pack"default+keys" for fzf
```

</TabItem>
<TabItem value="bin-gem-node" label="Annex">

Download the package with the [bin-gem-node][] annex.

```shell
zi pack"bgn" for fzf
```

</TabItem>
<TabItem value="bin-gem-node+key-bindings" label="Annex + key bindings">

Download the package with the [bin-gem-node][] annex-utilizing ice list + setting up the key bindings.

> The "+keys" variants are available for each profile.
Expand All @@ -187,27 +229,39 @@ Download the package with the [bin-gem-node][] annex-utilizing ice list + settin
zi pack"bgn+keys" for fzf
```

</TabItem>
<TabItem value="bin-gem-node+git" label="Annex + git">

Download with the [bin-gem-node][] annex from GitHub repository.

```shell
zi pack"bgn" git for fzf
```

</TabItem>
<TabItem value="binary" label="Binary">

Download the binary from the Github releases.

```shell
zi pack"binary" for fzf
```

</TabItem>
<TabItem value="bin-gem-node+binary" label="Annex + binary">

Download the binary from the GitHub releases and install using [bin-gem-node][] + shims.

```shell
zi pack"bgn-binary" for fzf
```

</TabItem>
</Tabs>

### The LS_COLORS color scheme

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -230,29 +284,41 @@ zi pack"bgn-binary" for fzf
</tr>
</tbody>
</table>
</h3>
</div>

<Tabs>
<TabItem value="default" label="Default">

Download the default profile.

```shell
zi pack for ls_colors
```

</TabItem>
<TabItem value="no-zsh-completion" label="No completion">

Download the "no-zsh-completion" profile.

```shell
zi pack"no-zsh-completion" for ls_colors
```

</TabItem>
<TabItem value="no-dir-color-swap" label="No color swap">

Download the "no-dir-color-swap" profile.

```shell
zi pack"no-dir-color-swap" for ls_colors
```

</TabItem>
</Tabs>

### The Python virtual environment manager (pyenv)

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -277,29 +343,41 @@ zi pack"no-dir-color-swap" for ls_colors
</tr>
</tbody>
</table>
</h3>
</div>

<Tabs>
<TabItem value="default" label="Default">

Download the tarball with the default ice list.

```shell
zi pack for pyenv
```

</TabItem>
<TabItem value="bin-gem-node" label="Annex">

Download the binary from the Github releases with the [bin-gem-node][] annex.

```shell
zi pack"bgn" for pyenv
```

</TabItem>
<TabItem value="bin-gem-node+git" label="Annex + git">

Download with the [bin-gem-node][] annex from GitHub repository.

```shell
zi pack"bgn" git for pyenv
```

</TabItem>
</Tabs>

### The Zsh mirror of zsh-users

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -324,14 +402,20 @@ zi pack"bgn" git for pyenv
</tr>
</tbody>
</table>
</h3>
</div>

<Tabs>
<TabItem value="default" label="Default">

Install the newest Zsh.

```shell
zi pack for zsh
```

</TabItem>
<TabItem value="specific-version" label="Specific version">

Install prefered Zsh version.

```shell
Expand All @@ -347,9 +431,12 @@ zi pack"5.2.4" for zsh
zi pack"5.1.1" for zsh
```

</TabItem>
</Tabs>

### Statically-linked, hermetic, relocatable Zsh

<h3 align="center">
<div className="apitable" align="center">
<table>
<tbody>
<tr>
Expand All @@ -374,26 +461,38 @@ zi pack"5.1.1" for zsh
</tr>
</tbody>
</table>
</h3>
</div>

<b>Requires sudo</b> to install Zsh to /usr/local and will attempt to register it as a login shell.
<Tabs>
<TabItem value="default" label="Default">

Requires **root** access to install Zsh at `/usr/local` and will attempt to register it as a login shell.

```shell
zi pack for zsh-bin
```

Does not require <b>root</b>, install using [bin-gem-node][] + shims.
</TabItem>
<TabItem value="bin-gem-node" label="Annex">

Does not require **root** access, when install using [bin-gem-node][] to set shims.

```shell
zi pack"bgn" for zsh-bin
```

Does not require <b>root</b>, will install to ~/.local.
</TabItem>
<TabItem value="rootless" label="Rootless">

Does not require **root** access, will install to `~/.local`.

```shell
zi pack"rootless" for zsh-bin
```

</TabItem>
</Tabs>

<!-- end-of-file -->
<!-- links -->

Expand Down