Template:Package
Documentation
This page is a template. It contains some standardized, often used text, which can be transcluded inside other pages. As this template is widely used in our wiki, it may be protected in which case only staff members can change it. Use the discussion page to propose enhancements or fixes, or to voice your opinion.
Use this template to link a package name to its listing at packages.gentoo.org in running text (or in a list).
This template should never be used inside of templates that simulate a command line interface, like {{Cmd}} and {{RootCmd}}, because the external-link icon (e.g. as with this link: "https://packages.gentoo.org", for those using a graphical browser) could confuse readers in that context. For the same resaon, it should also be avoided in templates that display special types of code, like {{FileBox}}, {{CodeBox}}, and {{KernelBox}}, except possibly in the "title" line.
To provide a link to package information in a right-floated box, use {{InfoBox package}}.
Parameters
To link a package name to its listing at packages.gentoo.org or a third-party repository
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Package name | 1 | Package name in the form category-subcategory/packagename
| String | required |
| URL to third-party repo | url | Third-party repository with a trailing slash at the end
| String | optional |
| Version number | version | Version number for the specified package
| String | optional |
| Slot value | slot | Slot value for the specified package
| String | optional |
The value of the required anonymous parameter must match the name of a package in the current Gentoo ebuild repository. The template does not check its input, it simply links to the provided name, so check that package names are valid. Valid package names can be determined by using for example the emerge search function on a running Gentoo system, or by searching packages.gentoo.org or browsing categories on packages.gentoo.org.
Usage
{{Package|cat-subcat/name}}
{{Package|cat-subcat/name|version=version}}
{{Package|cat-subcat/name|slot=slot}}
{{Package|cat-subcat/name|version=version|slot=slot}}
See the template's testcases:
Test cases
Correct
{{Package|sys-apps/portage}}
{{Package|app-office/obsidian|url=https://github.com/gentoo/guru/tree/master/}}
{{Package|sys-devel/gcc|version=13.2.1_p20240210}}
{{Package|sys-devel/gcc|slot=13}}
{{Package|sys-devel/gcc|version=13.2.1_p20240113-r1|slot=13}}
Incorrect
{{Package}}
1 parameter.1 parameter.
See also
The above documentation is transcluded from Template:Package/doc. (edit | history)
Editors can experiment in this template's sandbox (edit) and testcases (edit) pages.
Please add categories and interwikis to the /doc subpage. (See the subpages of this template.)