{"id":25242669,"url":"https://github.com/boinkor-net/nix-dash-docsets","last_synced_at":"2025-07-09T22:33:48.901Z","repository":{"id":275320330,"uuid":"925707508","full_name":"boinkor-net/nix-dash-docsets","owner":"boinkor-net","description":"Dash/Zeal docsets for the Nix Cinematic Universe","archived":false,"fork":false,"pushed_at":"2025-06-15T19:36:02.000Z","size":69,"stargazers_count":9,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-15T21:09:51.975Z","etag":null,"topics":["dash","documentation","flakes","nix","nix-flakes"],"latest_commit_sha":null,"homepage":"https://boinkor-net.github.io/nix-dash-docsets/","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boinkor-net.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-01T14:51:26.000Z","updated_at":"2025-06-10T11:44:06.000Z","dependencies_parsed_at":"2025-02-01T17:29:45.272Z","dependency_job_id":"0bf5f3a8-40b0-42a8-a637-0dbd31fa8200","html_url":"https://github.com/boinkor-net/nix-dash-docsets","commit_stats":null,"previous_names":["boinkor-net/nix-dash-docsets"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/boinkor-net/nix-dash-docsets","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boinkor-net%2Fnix-dash-docsets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boinkor-net%2Fnix-dash-docsets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boinkor-net%2Fnix-dash-docsets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boinkor-net%2Fnix-dash-docsets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boinkor-net","download_url":"https://codeload.github.com/boinkor-net/nix-dash-docsets/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boinkor-net%2Fnix-dash-docsets/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264504611,"owners_count":23618830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dash","documentation","flakes","nix","nix-flakes"],"created_at":"2025-02-11T23:58:28.951Z","updated_at":"2025-07-09T22:33:48.889Z","avatar_url":"https://github.com/boinkor-net.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dash / Zeal Docsets for nix/nixpkgs/NixOS/nix-darwin\n\n[Dash on macOS](https://kapeli.com/dash) and [Zeal on linux/windows](https://zealdocs.org/) are two highly excellent offline documentation browser/navigation tools. They have very quick keyword search and ... they work offline!\n\nHowever, they lack docsets for the nix cinematic universe, which this repo aims to mitigate.\n\nThe flake in this repo contains a package per docset for:\n\n- nix, the commandline tool and language\n- nixpkgs, the package collection and standard environment for building more packages\n- NixOS, the linux system based on nixpkgs\n- nix-darwin, the darwin configuration manager based on nixpkgs\n- home-manager, the home directory manager based on nixpkgs\n\nAll of them (except for NixOS, which requires linux platforms) are portable and can be built anywhere. I would suggest deploying them on a linux machine with a static file server serving the .tgz and .xml files.\n\n# Usage\n\n## Doc feeds for the latest version of nixpkgs/nix-darwin/etc\n\nThe docsets get built daily and deployed to Github Pages, see the [nix dash docsets overview](https://boinkor-net.github.io/nix-dash-docsets/).\n\n## Using it in your system configuration flake\n\nIn a nix flake, you'll generate the feeds, which are exposed as a function on this flake's `legacyPackages` attribute:\n\n## `nix-dash-docsets.legacyPackages.${system}.mkNixDocsetFeed {baseURL, zealCompat}`\n\nParameters passed via attrset:\n\n- `baseURL` - The absolute base URL (http or https) serving the generated directory. Dash can not deal with relative URLs here, and it requires a http or https URL in its docset feeds.\n- `zealCompat` (default: `false`) - if set to true, generate feeds pointing to docset packages that can be imported by Zeal.\n\nThis function builds the available docsets on the platform identified by `system` and writes them to its output directory.\n\nOnce generated, you can add each of the following XML files as feeds in Dash's \"Main Docsets\" (under \"Downloads\") preferences, after clicking \"+\":\n\n- `{baseURL}/nix.xml`\n- `{baseURL}/nixos.xml`\n- `{baseURL}/nixpkgs.xml`\n- `{baseURL}/nix-darwin.xml`\n- `{baseURL}/home-manager.xml`\n\n## Status: Incomplete\n\nThis flake is by far not complete yet. Things I'd like to do (that work in my personal system config flake, which is of no benefit to you):\n\n- Add a `nixosModules.default` and `darwinModules.default` that allows configuring where the output packages go\n- Configure github actions to publish a static page of the generated docsets, with auto-updates.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboinkor-net%2Fnix-dash-docsets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboinkor-net%2Fnix-dash-docsets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboinkor-net%2Fnix-dash-docsets/lists"}