Jump to content

Template:Evaluate: Difference between revisions

From NixOS Wiki
Adds support for recommending the `boot` and `test` subcommands for `nixos-rebuild`. Does nothing if the editor doesn't specifically request the non-standard actions.
Malix (talk | contribs)
m update
 
(5 intermediate revisions by 2 users not shown)
Line 23: Line 23:
<pre>
<pre>
<nowiki>{{Evaluate|test}}</nowiki>
<nowiki>{{Evaluate|test}}</nowiki>
</pre>
Default <code>Evaluate</code> Box without <code>--sudo</code>:
<pre>
<nowiki>{{Evaluate|root=true}}</nowiki>
</pre>
Boot <code>Evaluate</code> Box without <code>--sudo</code>:
<pre>
<nowiki>{{Evaluate|boot|root=true}}</nowiki>
</pre>
Test <code>Evaluate</code> Box without <code>--sudo</code>:
<pre>
<nowiki>{{Evaluate|test|root=true}}</nowiki>
</pre>
</pre>


Line 34: Line 54:
Test <code>Evaluate</code> Box:
Test <code>Evaluate</code> Box:
{{Evaluate|test}}
{{Evaluate|test}}
Default <code>Evaluate</code> Box without <code>--sudo</code>:
{{Evaluate|root=true}}
Boot <code>Evaluate</code> Box without <code>--sudo</code>:
{{Evaluate|boot|root=true}}
Test <code>Evaluate</code> Box without <code>--sudo</code>:
{{Evaluate|test|root=true}}


</noinclude><includeonly>{{Tip
</noinclude><includeonly>{{Tip
|1=In order to '''affect''' your NixOS system by your nix-language-specific changes you must first '''evaluate''' it:{{Commands|$ nixos-rebuild {{{1|switch}}} --use-remote-sudo}}{{#ifeq: boot | {{{1}}} | Then, reboot:{{Commands|$ systemctl reboot}}}}{{#ifeq: test | {{{1}}} | '''Remember:''' any changes evaluated through <code>nixos-rebuild test</code> '''will not''' persist upon reboot.}}}}</includeonly>
|1=In order to affect your NixOS system by your nix-language-specific changes you must first '''evaluate''' it:{{Commands|{{#if: {{{root|}}}|#|$}} nixos-rebuild {{{1|switch}}} {{#if: {{{root|}}} ||--sudo}}}}{{#ifeq: boot | {{{1}}} | Then, reboot:{{Commands|{{#if: {{{root|}}}|<nowiki>#</nowiki>|$}} systemctl reboot}}}}{{#ifeq: test | {{{1}}} | '''Remember:''' any changes evaluated through <code>nixos-rebuild test</code> '''will not''' persist upon reboot.}}}}</includeonly>
<noinclude>
<templatedata>
{
"params": {
"1": {
"aliases": [
"type"
],
"type": "string",
"suggestedvalues": [
"boot",
"test"
]
},
"root": {
"type": "boolean",
"default": "false"
}
},
"paramOrder": [
"root",
"1"
],
"format": "inline"
}
</templatedata>
</noinclude>

Latest revision as of 22:03, 27 August 2025


About

This template is used to remind end-users that they need to rebuild for the changes to take effect. Optionally, you may define the action being suggested.

Usage

Default Evaluate Box:

{{Evaluate}}

Boot Evaluate Box:

{{Evaluate|boot}}


Test Evaluate Box:

{{Evaluate|test}}

Default Evaluate Box without --sudo:

{{Evaluate|root=true}}


Boot Evaluate Box without --sudo:

{{Evaluate|boot|root=true}}


Test Evaluate Box without --sudo:

{{Evaluate|test|root=true}}

Example

Default Evaluate Box:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
$ nixos-rebuild switch --sudo


Boot Evaluate Box:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
$ nixos-rebuild boot --sudo
Then, reboot:
$ systemctl reboot


Test Evaluate Box:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
$ nixos-rebuild test --sudo
Remember: any changes evaluated through nixos-rebuild test will not persist upon reboot.


Default Evaluate Box without --sudo:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
# nixos-rebuild switch


Boot Evaluate Box without --sudo:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
# nixos-rebuild boot
Then, reboot:
# systemctl reboot


Test Evaluate Box without --sudo:

🟆︎
Tip: In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:
# nixos-rebuild test
Remember: any changes evaluated through nixos-rebuild test will not persist upon reboot.



No description.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
rootroot

no description

Default
false
Booleanoptional
11 type

no description

Suggested values
boot test
Stringoptional