···11+---
22+home: true
33+title: Home
44+55+actions:
66+ - text: Get Started
77+ link: /guide/installing.html
88+ type: primary
99+1010+ - text: Visit at GitHub
1111+ link: https://github.com/vic/nix-versions
1212+ type: secondary
1313+1414+features:
1515+ - title: Works for everyone, at any level.
1616+ details: |
1717+ <br/>
1818+ <ul><li>As a friendly CLI to explore available versions.</li>
1919+ <li>As a tools version manager and development shell.</li>
2020+ <li>As a flake generator for pinned-version packages.</li>
2121+ - title: Combine latest and dependable, stable versions.
2222+ details: |
2323+ <br/>
2424+ Keep your compilers and tooling at <em>known, stable releases</em> that work with your current code.<br/><br/>
2525+ And use the most recent version for other nixpkgs.
2626+ - title: Plays well with existing tools.
2727+ details: |
2828+ <br/>
2929+ Friendly with <code>nix shell</code>, <code>direnv</code> and advanced nix environments like <code>devenv</code> and <code>devshell</code>.<br/><br/>
3030+ Usable as an <code>input</code> for any Flake and with <code>fetchurl</code> for non-flakes.
3131+ - title: Powered by nix but requires <small>no-nix-wizardy™</small>
3232+ details: |
3333+ <br/>
3434+ All the advantages of Nix without much effort.
3535+ Reproducibility, security checksums, sandboxed builds, caching,
3636+ remote building.
3737+ <br/>
3838+ <br/>
3939+ Re-use your existing <code>.ruby-version</code>, <code>.node-version</code> project files.
4040+4141+footer: Kindly hosted by <a href="https://alwaysdata.com">AlwaysData</a> | Made with <3 by <a href="https://x.com/oeiuwq">@oeiuwq</a> and <a href="https://github.com/vic/nix-versions/graphs/contributors">contributors</a>.
4242+---
4343+4444+<br/>
4545+<br/>
4646+4747+# Try it now.
4848+<br/>
4949+5050+###### As a command line utility
5151+```
5252+nix run github:vic/nix-versions -- 'emacs@~27 || ~29' --all
5353+```
5454+5555+###### As a flake generator webservice.
5656+5757+```
5858+nix develop 'https://nix-versions.alwaysdata.net/flake.zip/cowsay@latest/go@1.24.x' --output-lock-file /dev/null
5959+```
6060+6161+same as `nix-versions --flake cowsay@latest > flake.nix`, but the webservice can be use as input on your own `flake.nix` or `devenv.yaml`
+46
docs/get-started.md
···11+# Get Started
22+33+This is a normal page, which contains VuePress basics.
44+55+## Pages
66+77+You can add markdown files in your vuepress directory, every markdown file will be converted to a page in your site.
88+99+See [routing][] for more details.
1010+1111+## Content
1212+1313+Every markdown file [will be rendered to HTML, then converted to a Vue SFC][content].
1414+1515+VuePress support basic markdown syntax and [some extensions][synatex-extensions], you can also [use Vue features][vue-feature] in it.
1616+1717+## Configuration
1818+1919+VuePress use a `.vuepress/config.js`(or .ts) file as [site configuration][config], you can use it to config your site.
2020+2121+For [client side configuration][client-config], you can create `.vuepress/client.js`(or .ts).
2222+2323+Meanwhile, you can also add configuration per page with [frontmatter][].
2424+2525+## Layouts and customization
2626+2727+Here are common configuration controlling layout of `@vuepress/theme-default`:
2828+2929+- [navbar][]
3030+- [sidebar][]
3131+3232+Check [default theme docs][default-theme] for full reference.
3333+3434+You can [add extra style][style] with `.vuepress/styles/index.scss` file.
3535+3636+[routing]: https://vuejs.press/guide/page.html#routing
3737+[content]: https://vuejs.press/guide/page.html#content
3838+[synatex-extensions]: https://vuejs.press/guide/markdown.html#syntax-extensions
3939+[vue-feature]: https://vuejs.press/guide/markdown.html#using-vue-in-markdown
4040+[config]: https://vuejs.press/guide/configuration.html#client-config-file
4141+[client-config]: https://vuejs.press/guide/configuration.html#client-config-file
4242+[frontmatter]: https://vuejs.press/guide/page.html#frontmatter
4343+[navbar]: https://vuejs.press/reference/default-theme/config.html#navbar
4444+[sidebar]: https://vuejs.press/reference/default-theme/config.html#sidebar
4545+[default-theme]: https://vuejs.press/reference/default-theme/
4646+[style]: https://vuejs.press/reference/default-theme/styles.html#style-file
+1-5
docs/guide/installing.md
···11-______________________________________________________________________
22-33-## title: Installing the nix-versions command. outline: 1 layout: doc prev: false next: text: Listing package versions link: '/listing-versions'
44-55-# All you need is Nix \<3
11+# All you need is Nix
6273Since you will be installing packages from the [nixpkgs repository](https://github.com/nixos/nixpkgs),
84the only requirement is to have the `nix` command on your system.
-66
docs/index.md
···11----
22-# https://vitepress.dev/reference/default-theme-home-page
33-layout: home
44-55-hero:
66- name: "<code>$ nix-versions</code>"
77- text: '<small>Install pkgs@any version.</small>'
88- tagline: |
99- Any version of <code>>200_000</code> nixpkgs at your disposal.
1010- actions:
1111- - theme: brand
1212- text: Get Started
1313- link: /guide/installing
1414- - theme: alt
1515- text: View on GitHub
1616- link: https://github.com/vic/nix-versions
1717-1818-features:
1919- - title: Works for everyone, at any level.
2020- details: |
2121- <br/>
2222- As a friendly CLI to explore available versions.<br/>
2323- As a zero nix-knowledge tools version manager.<br/>
2424- As a flake generator for pinned-version pkgs.
2525- - title: Combine bleeding-edge and dependable, stable tools.
2626- details: |
2727- Use compilers and tooling in known, stable releases that work(tm) with your code.<br/>
2828- And the most recent version for other nixpkgs.
2929- - title: Integrates with flakes and nix modules.
3030- details: |
3131- <br />
3232- Focuses on giving you access to packages versions and lets other
3333- tools shine on their own.<br/>
3434- Friendly with NixOS, devenv and devshell.
3535- - title: No-brainer development environment.
3636- details: |
3737- Combine with <code>direnv</code> and <code>nix shell</code> and get a devshell
3838- that can read your existing <code>.ruby-version</code>, <code>.node-version</code>, etc files.
3939- - title: Secure and reproducible environments.
4040- details: |
4141- Powered by Nix. All packages and their dependencies get hashed.
4242- Gone are the days of same versions but different bytes.
4343- - title: Part of a bigger self.
4444- details: |
4545- nix-versions is part of the Ntv suite.
4646- With a mission of providing tools that can attract more people to
4747- the amazing Nix ecosystem.
4848----
4949-<br/>
5050-<br/>
5151-5252-# Try it now.
5353-<br/>
5454-5555-###### As a command line utility
5656-```
5757-nix run github:vic/nix-versions -- 'emacs@~27 || ~29' --all
5858-```
5959-6060-###### As a flake generator webservice.
6161-6262-```
6363-nix develop 'https://nix-versions.alwaysdata.net/flake.zip/cowsay@latest/go@1.24.x' --output-lock-file /dev/null
6464-```
6565-6666-same as `nix-versions --flake cowsay@latest > flake.nix'`, but the webservice can be use as input on your own flakes!.
-85
docs/markdown-examples.md
···11-# Markdown Extension Examples
22-33-This page demonstrates some of the built-in markdown extensions provided by VitePress.
44-55-## Syntax Highlighting
66-77-VitePress provides Syntax Highlighting powered by [Shiki](https://github.com/shikijs/shiki), with additional features like line-highlighting:
88-99-**Input**
1010-1111-````md
1212-```js{4}
1313-export default {
1414- data () {
1515- return {
1616- msg: 'Highlighted!'
1717- }
1818- }
1919-}
2020-```
2121-````
2222-2323-**Output**
2424-2525-```js{4}
2626-export default {
2727- data () {
2828- return {
2929- msg: 'Highlighted!'
3030- }
3131- }
3232-}
3333-```
3434-3535-## Custom Containers
3636-3737-**Input**
3838-3939-```md
4040-::: info
4141-This is an info box.
4242-:::
4343-4444-::: tip
4545-This is a tip.
4646-:::
4747-4848-::: warning
4949-This is a warning.
5050-:::
5151-5252-::: danger
5353-This is a dangerous warning.
5454-:::
5555-5656-::: details
5757-This is a details block.
5858-:::
5959-```
6060-6161-**Output**
6262-6363-::: info
6464-This is an info box.
6565-:::
6666-6767-::: tip
6868-This is a tip.
6969-:::
7070-7171-::: warning
7272-This is a warning.
7373-:::
7474-7575-::: danger
7676-This is a dangerous warning.
7777-:::
7878-7979-::: details
8080-This is a details block.
8181-:::
8282-8383-## More
8484-8585-Check out the documentation for the [full list of markdown extensions](https://vitepress.dev/guide/markdown).