desktop customization first draft, code block addons

Author: jaysa68

docs/user-docs/desktop-customization/index.md

@@ -17,62 +17,90 @@ To create a `.desktoprc` file, open a text editor of your choice and create a ne
 For example, here's how to do it with the Konsole terminal and Kate text editor:
 
 1. Press Ctrl+Alt+T
-2. Run `$ kate ~/remote/.desktoprc`
-3. 
+2. Run `kate ~/remote/.desktoprc`
+3. Paste the following line: `nix run home-manager -- switch --flake ~/remote/home-manager`
 4. Ctrl+S to save
 
+Now, after logging in, the computer will switch to the flake within that directory.
+
 ## Home Manager Flake
 
-Now, we're going to create a directory on `~/remote` that will set up NixOS
+We will first create a directory on `~/remote` that will set up NixOS
 Home Manager via a Nix Flake.
 
 `mkdir ~/remote/home-manager`
 
-`kate ~/remote/home-manager/flake.nix`
+Now, we will generate basic `flake.nix` and `home.nix` files in that directory we just made with the next command.
 
-Paste the following default configuration into the empty `flake.nix` file, replacing `USER` with your ocf username:
+`nix run home-manager/master -- init ~/remote/home-manager`
 
-```
-{
-  description = "Default OCF Home Manager Configuration"
-
-  inputs = {
-    # Specify the source of Home Manager and Nixpkgs.
-    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
-    home-manager = {
-      url = "github:nix-community/home-manager";
-      inputs.nixpkgs.follows = "nixpkgs";
-    };
+## Plasma Manager
+
+The default desktop environment on the OCF desktops is KDE Plasma. To make configuration management easier on KDE, we will use a home manager module called [plasma-manager](https://github.com/nix-community/plasma-manager).
+
+First, you'll want to add `plasma-manager` to your `flake.nix` file like so:
+
+``` nix title="flake.nix" hl_lines="7-11 15 26-29"
+inputs = {
+  nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
+  home-manager = {
+    url = "github:nix-community/home-manager";
+    inputs.nixpkgs.follows = "nixpkgs";
   };
+  plasma-manager = {
+    url = "github:nix-community/plasma-manager";
+    inputs.nixpkgs.follows = "nixpkgs";
+    inputs.home-manager.follows = "home-manager";
+  };
+};
 
-  outputs = { nixpkgs, home-manager, ...}:
+outputs =
+  inputs@{ nixpkgs, home-manager, plasma-manager, ... }:
   let
     system = "x86_64-linux";
     pkgs = nixpkgs.legacyPackages.${system};
   in
   {
-    homeConfigurations."USER" = home-manager.lib.homeManagerConfiguration {
+    homeConfigurations."YOURUSERNAME" = home-manager.lib.homeManagerConfiguration {
       inherit pkgs;
 
       # Specify your home configuration modules here, for example,
       # the path to your home.nix.
-      modules = [ ./home.nix ];
+      modules = [ 
+        plasma-manager.homeModules.plasma-manager
+        ./home.nix 
+      ];
 
       # Optionally use extraSpecialArgs
       # to pass through arguments to home.nix
     };
-    formatter.${system} = pkgs.nixpkgs-fmt;
   };
 }
 ```
 
-Now, we're going to create a basic `home.nix` file, where the majority of our customization will later take place.
+Then, re-apply the flake with `nix run home-manager -- switch --flake ~/remote/home-manager`. You should see some terminal output, with some lines about the new inputs getting successfully added! You can now begin customizing your desktop. Be sure to save the files you've changed and run that command each time you want to refresh your configuration.
+
+If you're having trouble understanding Nix syntax, check out the Nix documentation on [Names and Values](https://nix.dev/tutorials/nix-language.html#names-and-values).
+
+## System light/dark mode
 
-More resources:
+Insert the following in your `home.nix` file to change the system theme to dark:
 
-[Home Manager Manual - Nix Flakes](https://nix-community.github.io/home-manager/index.xhtml#ch-nix-flakes)
+``` nix title="home.nix"
+  programs.plasma = {
+    enable = true;
 
-## Debugging and monitoring:
+    workspace = {
+      lookAndFeel = "org.kde.breezedark.desktop";
+      iconTheme = "Papirus-Dark";
+  };
+```
+
+## Setting the wallpaper
+## Custom KDE cursor
+
+
+## Debugging and Monitoring
 
 You can look at the logs and outputs from your desktoprc by running `$ systemctl —user status desktoprc.service` or `$ journalctl —user desktoprc.service`.
 
@@ -81,4 +109,21 @@ You can look at the logs and outputs from your desktoprc by running `$ systemctl
 ## Sample Configs from OCF Staff
 - laksith: [.desktoprc](https://github.com/laksith19/ocf-desktoprc/), [home manager flake](https://github.com/laksith19/ocf-home-manager)
 
-- jaysa: [.desktoprc](), [home manager flake]()
+- jaysa: [.desktoprc](), [home manager flake]()o
+
+## Resources
+
+Searches:
+
+- [Nixpkgs Search](https://search.nixos.org/packages)
+- [NixOS Options Search](https://search.nixos.org/options?)
+- [Home Manager Option Search](https://home-manager-options.extranix.com/)
+
+Wikis:
+
+- [wiki.nixos.org](https://wiki.nixos.org/wiki/NixOS_Wiki)
+- [nixos.wiki](https://nixos.wiki/wiki/Main_Page)
+
+Relevant Reading:
+
+- [Home Manager Manual - Nix Flakes](https://nix-community.github.io/home-manager/index.xhtml#ch-nix-flakes)

mkdocs.yml

@@ -13,6 +13,7 @@ theme:
     - navigation.top
     - search.suggest
     - search.share
+    - content.code.copy
   font:
     text: Roboto
     code: Meslo
@@ -41,6 +42,13 @@ markdown_extensions:
   - toc:
       permalink: true
   - pymdownx.tilde
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
 plugins:
   - search
   - git-revision-date-localized: