NixOS Wiki: Difference between revisions

Vater (talk | contribs)
(much more) pure mediawiki (pure table foo (no "useless" special templates are needed))
Ardenet (talk | contribs)
mNo edit summary
 
(40 intermediate revisions by 16 users not shown)
Line 1: Line 1:
<languages/>
<span style="height: 4px;"></span>
__NOTOC__
__NOTOC__
{|
<!-- NOTE: Please don't change the layout/categorizing without first coordinating with the other editors. -->
|- style="vertical-align:top;"
<!-- NOTE: Feel free to add/edit content though! -->
|
<!-- NOTE: This page is affected by special CSS rules that alter the brightness of images in dark mode.
{| class="wikitable" style="width:100%;"
    Please do not add images here unless you understand the rules in MediaWiki:Common.css and have
|-
    tested how this page looks in both light and dark mode. -->
! style="text-align:left;" |
<!-- NOTE: Removing those notes and/or disregarding this is not only rude, but should be considered defacement. -->
= [[{{ns:6}}:home-clarifications.png]] Getting started =
<div class="row home-panes">
|-
    <div class="col-md-7">
|
{{home:box|get-started|icon=clarifications|2=<translate>Getting started</translate>|3=<translate>
<!--T:14-->
This is the official NixOS Wiki.
This is the official NixOS Wiki.
It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.
It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.


NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.
<!--T:2-->
NixOS is a [https://kernel.org/ Linux] operating system based on the Nix package manager and the Nixpkgs package repository.


<!--T:3-->
Newcomers to NixOS are encouraged to read the [[Nix Ecosystem|Nix Core Ecosystem]] overview article to get a comprehensive orientation. For more specific introductions, see:
Newcomers to NixOS are encouraged to read the [[Nix Ecosystem|Nix Core Ecosystem]] overview article to get a comprehensive orientation. For more specific introductions, see:
* [[NixOS]]
* [[Overview_of_the_NixOS_Linux_distribution|NixOS]]
* [[Nix package manager]]
* [[Nix package manager]]
* [[Nixpkgs]] package repository
* [[Nixpkgs|Nixpkgs package repository]]
* [[Overview of the Nix Language |Nix Language]]
* [[Overview of the Nix Language |Nix Language]]
If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [https://nix.dev nix.dev].
If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [https://nix.dev nix.dev].


A lot of people use [[Home manager]] for managing the contents of their home directory, many use [[Flakes]] instead of the NixOS bi-annually release channels. Both add complexity and you may not even need them. Begin with NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with NixOS and comprehend their significance.
<!--T:4-->
|-
Many great additional tools exist in the Nix ecosystem, such as:
|}
 
{| class="wikitable" style="width:100%;"
<!--T:12-->
|-
* [[Home Manager|Home Manager]], a system for managing user profile & home directory contents
! style="text-align:left;" |
* [[Flakes|Nix Flakes]], an experimental feature for managing dependencies of Nix projects
= [[{{ns:6}}:home-cloud.png]] Setting up NixOS =
 
|-
<!--T:13-->
|
These add complexity and may be confusing at first, and you may even decide that you don't need them.
<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
Start with plain Nix/NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with Nix/NixOS and comprehend their significance.
</translate>}}
 
{{home:box|hosting|icon=cloud|2=<translate>Setting up NixOS</translate>|3=<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
<translate>
<!--T:5-->
* On desktop, with [[NixOS as a desktop]]
* On desktop, with [[NixOS as a desktop]]
* On ARM, with [[NixOS on ARM]]
* On ARM, with [[NixOS on ARM]]
* In the cloud, with [[NixOS friendly hosters]]
* In the cloud, with [[NixOS friendly hosters]]
|-
</translate>}}
|}
 
{| class="wikitable" style="width:100%;"
{{home:box|doctopics|icon=manual|2=<translate>Documentation topics</translate>|3=<translate>
|-
<!--T:6-->
! style="text-align:left;" |
= [[{{ns:6}}:home-manual.png]] Documentation topics =
|-
|
First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.
First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.


<!--T:7-->
Primary reference material:
Primary reference material:
* [https://nixos.org/nixos/manual/ NixOS manual]
* [https://nixos.org/nixos/manual/ NixOS manual]
Line 50: Line 57:
* [https://nixos.org/hydra/manual/ Hydra manual]
* [https://nixos.org/hydra/manual/ Hydra manual]


<!--T:8-->
Major page categories:
Major page categories:
* [[:{{ns:14}}:Software|Software]]
* [[:{{ns:14}}:Software|Software]]
* [[:{{ns:14}}:Hardware|Hardware]]
* [[:{{ns:14}}:Hardware|Hardware]]
* [[:{{ns:14}}:Desktop|Desktop]]
* [[:{{ns:14}}:Desktop|Desktop]] - how to setup PCs
* [[:{{ns:14}}:Server|Server]]
* [[:{{ns:14}}:Server|Server]] - how to setup servers
* [[:{{ns:14}}:Community|Community]] - people, communication, work on NixOS


<!--T:9-->
See also:
See also:
* [[FAQ]]
* [[FAQ]]
* [[Nix vs. Linux Standard Base]]
* [[Nix vs. Linux Standard Base]]
* [[Terms and Definitions in Nix Project]]
* [[Terms and Definitions in Nix Project]]
* [[Cheatsheet|Cheatsheet / Comparison between Ubuntu and NixOS]]
* [[Cheatsheet]]
|-
* [[Ubuntu vs. NixOS|Comparison between Ubuntu and NixOS]]
|}
</translate>}}
{| class="wikitable" style="width:100%;"
 
|-
{{home:box|wikipages|<translate>Special pages</translate>|3=<ul>
! style="text-align:left;" |
<li><span class="plainlinks"><translate><!--T:10--> [{{fullurl:Special:SpecialPages}} Overview of special pages]</translate></span></li>
= [[{{ns:6}}:home-wikipages.png]] Special pages =
<li><span class="plainlinks"><translate>[{{fullurl:Special:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]</translate></span></li>
|-
<li><translate>[[Special:Categories|All categories of {{SERVERNAME}}]]</translate></li>
|
<li><translate>[{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</translate></li>
* [{{fullurl:{{ns:-1}}:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]
</ul>}}
* [[{{ns:-1}}:Categories|All categories of {{SERVERNAME}}]]</li>
    </div>
* [[{{ns:-1}}:RecentChanges|Recent changes of {{SERVERNAME}}]]</li>
    <div class="col-md-5">
* [{{fullurl:{{ns:-1}}:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]
 
|-
{{home:box|get-in-touch|icon=dialog-hi|2=<translate>Get in touch</translate>|3=<translate><b>With the community</b>
|}
|
{| class="wikitable" style="width:100%;"
|-
! style="text-align:left;" |
= [[{{ns:6}}:home-dialog-hi.png]] Get in touch =
|-
|
* [https://nixos.org/ Official NixOS website]
* [https://nixos.org/ Official NixOS website]
* [https://nixos.org/community/#governance-teams Official Teams]
* [[Nix Community|Community overview]]
* [[Nix Community|Community overview]]
* [[Get In Touch|Chats and forums]]
* [[Get In Touch|Chats and forums]]
* [[Support|Get support]]
* [[Support|Get support]]
* Wiki
** Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
** EMail [mailto:wiki@nixos.org wiki@nixos.org] for contacting wiki.nixos.org regarding any wiki operational topics or requests
** [[Contributing to the wiki]]
* [[Get In Touch#Events|Events]]
* [[Get In Touch#Events|Events]]
|-
 
|}
<!--T:11-->
{| class="wikitable" style="width:100%;"
<b>About the Wiki</b>
|-
* Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
! style="text-align:left;" |
* Email [mailto:wiki@nixos.org wiki@nixos.org] for contacting wiki.nixos.org regarding any wiki operational topics or requests
== [[{{ns:6}}:home-news.png]] News ==
* [[Contributing|Contribute to wiki and NixOS]]
|-
* [[Manual of Style]]
|
</translate>}}
{{{{ns:4}}:News}}
 
|-
{{home:box|news|2=<translate>News</translate>|3=<translate>{{NixOS_Wiki:News}}
|
[[NixOS_Wiki:News{{!}}... all news articles &rarr;]]
[[{{ns:4}}:News|… all news articles &rarr;]]
</translate>}}
|-
    </div>
|}
</div>
|-
|}