Help:Template: Difference between revisions

From NixOS Wiki
m Add words
fix urls for kde hig
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The wiki provides templates for common tasks.
<!--
NOTE: Do not link to META templates.
-->The wiki provides templates for common tasks.


Those templates can range from simple to complex, being almost invisible to the end-user to provide a complete harmonized template between articles.
Those templates can range from simple to complex, being almost invisible to the end-user to provide a complete harmonized template between articles.
Line 6: Line 8:


== Available templates==
== Available templates==
These templates are meant to be used across the whole wiki.
There are other section-specific templates, and templates for internal use available too.


=== Article status ===
=== Article status ===
Line 15: Line 21:
* [[Template:merge|<nowiki>{{merge}}</nowiki>]] for when a a page or a section may need to be merged into another.
* [[Template:merge|<nowiki>{{merge}}</nowiki>]] for when a a page or a section may need to be merged into another.
* [[Template:disambiguation|<nowiki>{{disambiguation}}</nowiki>]] for when a page name is ambiguous, to link to another.
* [[Template:disambiguation|<nowiki>{{disambiguation}}</nowiki>]] for when a page name is ambiguous, to link to another.
* [[Template:low quality|<nowiki>{{low quality}}</nowiki>]] for when a page or a section is of low quality.


=== Note templates ===
=== Note templates ===
Line 54: Line 61:
* [[Template:bc|<nowiki>{{bc}}</nowiki>]] for a '''block''' of '''code'''.
* [[Template:bc|<nowiki>{{bc}}</nowiki>]] for a '''block''' of '''code'''.


==== Links ====
=== Nix, Nixpkgs and NixOS ===
 
These helpers link to specific project parts.
 
==== Nix ====
 
* [[Template:nix:option|<nowiki>{{nix:option}}</nowiki>]] links to a given '''Nix''' option documentation.
* [[Template:Nix Manual|<nowiki>{{Nix Manual}}</nowiki>]] links to the '''Nix''' manual (with optional chapter and version).
 
==== Nixpkgs ====
 
* [[Template:Nixpkgs Link|<nowiki>{{Nixpkgs Link}}</nowiki>]] links to a given Nixpkgs file (with optional revision).
* [[Template:Nixpkgs Manual|<nowiki>{{Nixpkgs Manual}}</nowiki>]] links to the Nixpkgs manual (with optional chapter and version).
 
==== NixOS ====
 
* [[Template:nixos:package|<nowiki>{{nixos:package}}</nowiki>]] links to a given NixOS package search result.
* [[Template:nixos:option|<nowiki>{{nixos:option}}</nowiki>]] links to a given NixOS option search result.
* [[Template:NixOS Manual|<nowiki>{{NixOS Manual}}</nowiki>]] links to the NixOS manual (with optional chapter and version).
 
==== Other links ====


* [[Template:issue|<nowiki>{{issue}}</nowiki>]] to link to a Nixpkgs issue.
* [[Template:issue|<nowiki>{{issue}}</nowiki>]] to link to a Nixpkgs issue.
Line 69: Line 96:
== Visual Guidelines ==
== Visual Guidelines ==


The icons used are from [https://community.kde.org/KDE_Visual_Design_Group/HIG/IconDesign Breeze, the default icon set of KDE].
The icons used are from [https://develop.kde.org/hig/icons Breeze, the default icon set of KDE].


Since the icons from Breeze are used, the [https://community.kde.org/KDE_Visual_Design_Group/HIG/Color colours from HIG], which is the ''Breeze Color Palette'' are used.  
Since the icons from Breeze are used, the [https://develop.kde.org/hig/status_changes/#color colours from HIG], which is the ''Breeze Color Palette'' are used.  


Sometimes, there isn't an icon in the Breeze theme that can be used for the purpose. In this case, alternative free and open source icons can be used. Once a stand-in is used, someone with the necessary skills can create the needed icon in the breeze style.
Sometimes, there isn't an icon in the Breeze theme that can be used for the purpose. In this case, alternative free and open source icons can be used. Once a stand-in is used, someone with the necessary skills can create the needed icon in the breeze style.
Line 78: Line 105:


* [https://wiki.nixos.org/wiki/Special:AllPages?from=&to=&namespace=10 List of all templates]
* [https://wiki.nixos.org/wiki/Special:AllPages?from=&to=&namespace=10 List of all templates]
[[Category:Contributions]]

Latest revision as of 18:39, 14 September 2024

The wiki provides templates for common tasks.

Those templates can range from simple to complex, being almost invisible to the end-user to provide a complete harmonized template between articles.

In addition to the visual aspect, using some templates will automatically file and categorize articles in ways indispensable to the end-users.

Available templates

These templates are meant to be used across the whole wiki.

There are other section-specific templates, and templates for internal use available too.

Article status

These templates should be added to either the top of a page, or the top of a section, when needed.

Note templates

These templates are purposefully intrusive, and serve as a visual landmark to an important note.

These templates should be used sparingly, but are useful as they are less intrusive.

Prefab tips

Common repeated tips in template form.

  • {{evaluate}} reminder to evaluate a NixOS configuration with nixos-rebuild.
  • {{unfree}} a note that a package is unfree, with a link for more help.

Formatting

Misc. prefabs

  • {{app}} for a card with details about an application.
  • {{man}} to refer to a man page (and section).

Code and commands

  • {{commands}} for a list of commands.
  • {{file}} for a formatted code block with a filename header.
  • Prefer the SyntaxHighlight extension with e.g. <syntaxhighlight lang="nix"></syntaxhighlight> otherwise.

These are more raw implementation blocks. They are not recommended for broad use.

Nix, Nixpkgs and NixOS

These helpers link to specific project parts.

Nix

Nixpkgs

NixOS

Other links

Page construction

Templates helping in building pages with common forms.

Visual Guidelines

The icons used are from Breeze, the default icon set of KDE.

Since the icons from Breeze are used, the colours from HIG, which is the Breeze Color Palette are used.

Sometimes, there isn't an icon in the Breeze theme that can be used for the purpose. In this case, alternative free and open source icons can be used. Once a stand-in is used, someone with the necessary skills can create the needed icon in the breeze style.

See also