diff --git a/index.html b/index.html index f3e7e7026..94b6cf11f 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager - — reconfigure a user environment
E. Release Notes
E.1. Release 21.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 20.09
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.03
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 19.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 18.09

Preface

+Home Manager Manual

Home Manager Manual


Preface

This manual will eventually describes how to install, use, and extend Home Manager.

diff --git a/options.html b/options.html index ff2a58aac..daa2a33a7 100644 --- a/options.html +++ b/options.html @@ -9827,6 +9827,7 @@ man page for more examples. <home-manager/modules/services/polybar.nix>

services.polybar.config

Polybar configuration. Can be either path to a file, or set of attributes that will be used to create the final configuration. +See also services.polybar.settings for a more nix-friendly format.

Type: attribute set of attribute set of string or boolean or signed integer or list of stringsss or path convertible to it

Default: { @@ -9873,6 +9874,55 @@ Note, this script must start all bars in the background and then terminate. "polybar bar &"

Declared by:

<home-manager/modules/services/polybar.nix> +
services.polybar.settings

Polybar configuration. This takes a nix attrset and converts it to the +strange data format that polybar uses. +Each entry will be converted to a section in the output file. +Several things are treated specially: nested keys are converted +to dash-separated keys; the special text key is ignored as a nested key, +to allow mixing different levels of nesting; and lists are converted to +polybar's foo-0, foo-1, ... format. +

+For example: +

+"module/volume" = {
+  type = "internal/pulseaudio";
+  format.volume = "<ramp-volume> <label-volume>";
+  label.muted.text = "🔇";
+  label.muted.foreground = "#666";
+  ramp.volume = ["🔈" "🔉" "🔊"];
+  click.right = "pavucontrol &";
+}
+

+becomes: +

+[module/volume]
+type=internal/pulseaudio
+format-volume=<ramp-volume> <label-volume>
+label-muted=🔇
+label-muted-foreground=#666
+ramp-volume-0=🔈
+ramp-volume-1=🔉
+ramp-volume-2=🔊
+click-right=pavucontrol &
+

+

Type: attribute set of attribute sets

Default: + + { + + } + +

Example:

{
+  "module/volume" = {
+    type = "internal/pulseaudio";
+    format.volume = "<ramp-volume> <label-volume>";
+    label.muted.text = "🔇";
+    label.muted.foreground = "#666";
+    ramp.volume = ["🔈" "🔉" "🔊"];
+    click.right = "pavucontrol &";
+  };
+}
+

Declared by:

+ <home-manager/modules/services/polybar.nix>
services.pulseeffects.enable

Whether to enable Pulseeffects daemon.

Type: boolean

Default: false

Example: diff --git a/tools.html b/tools.html index 895008a7a..36920dd6c 100644 --- a/tools.html +++ b/tools.html @@ -1,6 +1,6 @@ -Appendix D. Tools

Appendix D. Tools

home-manager - — reconfigure a user environment

Name

home-manager +Appendix D. Tools

Appendix D. Tools

home-manager + — reconfigure a user environment

Name

home-manager — reconfigure a user environment

Synopsis

home-manager { build | @@ -72,7 +72,7 @@ | --verbose } - ]

Description

+ ]

Description

This command updates the user environment so that it corresponds to the configuration specified in ~/.config/nixpkgs/home.nix.

@@ -137,7 +137,7 @@ available for immediate garbage collection.

-

Options

+

Options

The tool accepts the options

-A attrPath @@ -226,15 +226,15 @@ --verbose

Activates verbose output. -

Files

+

Files

~/.local/share/home-manager/news-read-ids

Identifiers of news items that have been shown. Can be deleted to reset the read news indicator. -

Bugs

+

Bugs

Please report any bugs on the project issue tracker. -

See also

+

See also

home-configuration.nix(5)

\ No newline at end of file