diff --git a/index.html b/index.html index 7da86570..c758e85b 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. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
3. Writing Home Manager Modules
3.1. Option Types
4. Contributing
4.1. Getting started
4.2. Guidelines
4.2.1. Maintain backward compatibility
4.2.2. Keep forward compatibility in mind
4.2.3. Add only valuable options
4.2.4. Add relevant tests
4.2.5. Add relevant documentation
4.2.6. Add yourself as a module maintainer
4.2.7. Format your code
4.2.8. Format your commit messages
4.2.9. Format your news entries
4.2.10. Use conditional modules and news
4.2.11. Mind the license
4.3. Commits
4.4. Code Style
4.5. News
4.6. Tests
5. Frequently Asked Questions (FAQ)
5.1. Why is there a collision error when switching generation?
5.2. Why are the session variables not set?
5.3. How to set up a configuration for multiple users/machines?
5.4. Why do I get an error message about ca.desrt.dconf?
5.5. How do I install packages from Nixpkgs unstable?
5.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 22.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.11
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.05
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.09
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.03
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 18.09

Preface

+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. Using Home Manager
2.1. Configuration Example
2.2. Rollbacks
2.3. Keeping your ~ safe from harm
2.4. Graphical services
3. Writing Home Manager Modules
3.1. Option Types
4. Contributing
4.1. Getting started
4.2. Guidelines
4.2.1. Maintain backward compatibility
4.2.2. Keep forward compatibility in mind
4.2.3. Add only valuable options
4.2.4. Add relevant tests
4.2.5. Add relevant documentation
4.2.6. Add yourself as a module maintainer
4.2.7. Format your code
4.2.8. Format your commit messages
4.2.9. Format your news entries
4.2.10. Use conditional modules and news
4.2.11. Mind the license
4.3. Commits
4.4. Code Style
4.5. News
4.6. Tests
5. Frequently Asked Questions (FAQ)
5.1. Why is there a collision error when switching generation?
5.2. Why are the session variables not set?
5.3. How to set up a configuration for multiple users/machines?
5.4. Why do I get an error message about ca.desrt.dconf?
5.5. How do I install packages from Nixpkgs unstable?
5.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 22.05
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.11
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 21.05
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.09
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 20.03
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.09
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 19.03
E.7.1. Highlights
E.7.2. State Version Changes
E.8. Release 18.09

Preface

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

diff --git a/options.html b/options.html index c19bd9be..70249285 100644 --- a/options.html +++ b/options.html @@ -6142,7 +6142,7 @@ manually set any options not listed above.

programs.vscode.enable

Whether to enable Visual Studio Code.

Type: boolean

Default: false

Example: true

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.vscode.package

Version of Visual Studio Code to install. -

Type: package

Default: (build of vscode-1.63.0)

Example: pkgs.vscodium

Declared by:

+

Type: package

Default: (build of vscode-1.63.1)

Example: pkgs.vscodium

Declared by:

<home-manager/modules/programs/vscode.nix>
programs.vscode.extensions

The extensions Visual Studio Code should be started with. These will override but not delete manually installed ones. @@ -6213,12 +6213,12 @@ overlay or set this option. Example overlay configuration: <home-manager/modules/programs/waybar.nix>

programs.waybar.settings

Configuration for Waybar, see https://github.com/Alexays/Waybar/wiki/Configuration for supported values. -

Type: list of JSON values

Default: +

Type: list of JSON values or attribute set of JSON values

Default: [ ] -

Example:

[
-  {
+    

Example:

{
+  mainBar = {
     layer = "top";
     position = "top";
     height = 30;
@@ -6243,74 +6243,10 @@ for supported values.
         '';
       };
     };
-  }
-]
-

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.gtk-layer-shell

Option to disable the use of gtk-layer-shell for popups.

Type: null or boolean

Default: null

Example: false

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.height

Height to be used by the bar if possible. Leave blank for a dynamic value.

Type: null or unsigned integer, meaning >=0

Default: null

Example: 5

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.layer

Decide if the bar is displayed in front ("top") -of the windows or behind ("bottom"). -

Type: null or one of "top", "bottom"

Default: null

Example: "top"

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.margin

Margins value using the CSS format without units.

Type: null or string

Default: null

Example: "20 5"

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.margin-bottom

Margin value without unit.

Type: null or signed integer

Default: null

Example: 10

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.margin-left

Margin value without unit.

Type: null or signed integer

Default: null

Example: 10

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.margin-right

Margin value without unit.

Type: null or signed integer

Default: null

Example: 10

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.margin-top

Margin value without unit.

Type: null or signed integer

Default: null

Example: 10

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.modules

Modules configuration.

Type: JSON value

Default: - { - - } -

Example:

{
-  "sway/window" = {
-    max-length = 50;
-  };
-  "clock" = {
-    format-alt = "{:%a, %d. %b  %H:%M}";
   };
 }
 

Declared by:

<home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.modules-center

Modules that will be displayed in the center.

Type: list of strings

Default: - [ - - ] -

Example:

[ "sway/window" ]
-

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.modules-left

Modules that will be displayed on the left.

Type: list of strings

Default: - [ - - ] -

Example:

[ "sway/workspaces" "sway/mode" "wlr/taskbar" ]
-

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.modules-right

Modules that will be displayed on the right.

Type: list of strings

Default: - [ - - ] -

Example:

[ "mpd" "custom/mymodule#with-css-id" "temperature" ]
-

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.name

Optional name added as a CSS class, for styling multiple waybars.

Type: null or string

Default: null

Example: "waybar-1"

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.output

Specifies on which screen this bar will be displayed. -Exclamation mark(!) can be used to exclude specific output. -

Type: null or string or list of strings

Default: null

Example:

[ "DP-1" "!DP-2" "!DP-3" ]
-

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.position

Bar position relative to the output.

Type: null or one of "top", "bottom", "left", "right"

Default: null

Example: "right"

Declared by:

- <home-manager/modules/programs/waybar.nix> -
programs.waybar.settings.*.width

Width to be used by the bar if possible. Leave blank for a dynamic value.

Type: null or unsigned integer, meaning >=0

Default: null

Example: 5

Declared by:

- <home-manager/modules/programs/waybar.nix>
programs.waybar.style

CSS style of the bar.

See https://github.com/Alexays/Waybar/wiki/Configuration diff --git a/tools.html b/tools.html index c1794178..9c5fdac4 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 | @@ -82,7 +82,7 @@ | --verbose } - ]

Description

+ ]

Description

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

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

-

Options

+

Options

The tool accepts the options

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

Activates verbose output. -

Files

+

Files

$XDG_DATA_HOME/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