feat(nixos-manual): init

[husjon]

🎉 Theme for NixOS Manual (NixOS and nixpkgs) 🎉

NixOS Manual is the full documentation for both NixOS and nixpkgs.

💬 Additional Comments 💬

It was pretty straight forward to get most of the styling in place, some elements were a bit more stubborn but this was mainly with highlightjs.
The preview screenshot is of the main page without the table of contents (since that takes up about 2 pages, not very interesting).
All links are dictated by the users accent color.

🗒 Checklist 🗒

• I have read and followed Catppuccin's submission guidelines.
• I have made a new directory underneath /styles/<name-of-website> containing the contents of the /template directory.
  • I have ensured that the new directory is in lower-kebab-case.
  • I have followed the template and kept the preprocessor as LESS.
• I have made sure to update the
  userstyles.yml
  file with information about the new userstyle.
• I have included the following files:
  • catppuccin.user.css - all the CSS for the userstyle, based on the
    template.
  • preview.webp - composite image of all four individual flavor screenshots (taken with the default accent color of mauve) stitched together, generated via Catwalk.

[uncenter]

Based on the preview image you have provided, I can see that there are unthemed horizontal dividers (maybe <hr> elements).

[husjon]

Updated hr elements and highlight.js styling + preview image.

[husjon]

Hey @uncenter, just wanted to check if there was anything else needed regarding this PR. :)

[uncenter]

Nothing needed from your end at the moment, we have a bit of a backlog of init PRs that I need to review first. Hopefully I can do a more thorough review later this week, luckily this userstyle is relatively small so it won't take very long.

[isabelroses]

I'm noticing quite a lot of linter errors. Some of them should be fixable with deno task lint:fix.

[husjon]

Thanks @isabelroses, the linter was unfortunately not able to fix them itself, instead I did so manually.

The following two errors might be possible to mitigate (to some degree) in the future is the following:

styles/nixos-manual/catppuccin.user.css:2
1│ /* ==UserStyle==
2│ @name nixos-manual Catppuccin
3│ @namespace github.com/catppuccin/userstyles/styles/nixos-manual
 ╰─► error UserCSS metadata property `@name` should be "NixOS Manual Catppuccin" but is "nixos-manual Catppuccin"

styles/nixos-manual/catppuccin.user.css:8
7│ @supportURL https://github.com/catppuccin/userstyles/issues?q=is%3Aopen+is%3Aissue+label%3Anixos-manual
8│ @description Soothing pastel theme for nixos-manual
9│ @author Catppuccin
 ╰─► error UserCSS metadata property `@description` should be "Soothing pastel theme for NixOS Manual" but is "Soothing pastel theme for nixos-manual"

In the template both of these use the <port-name> placeholder which is also used for the URLs, in my case I read these as "Use nixos-manual (aka lowercase kebab-case)" :)

[isabelroses]

Thanks @isabelroses, the linter was unfortunately not able to fix them itself, instead I did so manually.

The following two errors might be possible to mitigate (to some degree) in the future is the following:

styles/nixos-manual/catppuccin.user.css:2
1│ /* ==UserStyle==
2│ @name nixos-manual Catppuccin
3│ @namespace github.com/catppuccin/userstyles/styles/nixos-manual
 ╰─► error UserCSS metadata property `@name` should be "NixOS Manual Catppuccin" but is "nixos-manual Catppuccin"

styles/nixos-manual/catppuccin.user.css:8
7│ @supportURL [https://github.com/catppuccin/userstyles/issues?q=is%3Aopen+is%3Aissue+label%3Anixos-manual](https://github.com/catppuccin/userstyles/issues?q=sort%3Aupdated-desc+is%3Aopen+is%3Aissue+label%3Anixos-manual)
8│ @description Soothing pastel theme for nixos-manual
9│ @author Catppuccin
 ╰─► error UserCSS metadata property `@description` should be "Soothing pastel theme for NixOS Manual" but is "Soothing pastel theme for nixos-manual"

In the template both of these use the <port-name> placeholder which is also used for the URLs, in my case I read these as "Use nixos-manual (aka lowercase kebab-case)" :)

Thanks for your feedback. ❤️

[husjon]

Thanks for the review @uncenter, everything should now be corrected including the preview image.

[uncenter]

You can also add this snippet to theme examples https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-fetchers-fetchzip-examples:

      div.example details[open] {
          border-color: @surface1 !important;
      }

[isabelroses]

The PR #1461 has yet to reach main but its best we add the % to save some duplicated effort.

I also didn't add % to anything that @uncenter's suggestions would have covered, since they already added them where appropriate.

[uncenter]

Looks nice! However in userstyles we try to avoid changing the layout, padding, etc - anything that isn't color related. Feel free to use that part of the snippet as a separate userstyle on your own, or you could even contribute that CSS to the manual generator upstream.

[husjon]

Alright, make sense.
I've removed it from this PR.

[isabelroses]

Thanks for your work on the PR. ❤️

Shortly after this is merged you will be invited to the userstyles maintainers team, This will allow you the ability to merge PRs for your userstyle.

[husjon]

Awesome and thank you.