Template:Pkg: Difference between revisions

Revision as of 21:38, 9 January 2024

Template Documentation for Pkg

This page is a template and should only be used as part of other articles. For more information, read Help:Template.

Please do not experiment with this template; you could ruin all pages using this template. If you want to edit this template, copy the text to Template:Sandbox, edit and test it there, and copy it back when it works.

Feel free to voice your opinion regarding this template.

An inline link to search for given packages in the Package Browser.

Usage

{{Pkg|package|branch=|repo=|arch=|maintainer=}}

package: The package name to search for.; Special characters in the package name will automatically be urlencoded. "*" and "?" can be used as wildcards.; This argument is required, if you're not using it, use the "*" wildcard.

branch=: The branch of alpine to search (e.g. "3.19" or "edge"), defaults to "edge" if unset.; Pass this parameter with no value (i.e. "branch=") to search all branches

repo=: The repository to search (main, community, or testing). If unspecified all repositories will be searched.

arch=: The architecture to search (x86_64, x86, aarch64, armhf, ppc64le, s390x, armv7, or risc64). Defaults to x86_64 if unset.; Pass this parameter with no value (i.e. "arch=") to search all arches.

maintainer=: Search for packages with a certain maintainer. (e.g. "None" to search for unmaintained packages) If unspecified packages from all maintainers will be searched

Examples

Search for gtk+2.0 under the edge branch on the x86_64 architecture:

{{Pkg|gtk+2.0}}

will produce: gtk+2.0

Search for all gtk packages under the edge branch on the x86_64 architecture:

{{Pkg|gtk*}}

will produce: gtk*

Search for ALSA-related packages under the 3.19 branch on the x86 (i.e. i686) architecture:

{{Pkg|*alsa*|branch=v3.19|arch=x86}}

will produce: *alsa*

@@ Line 1: / Line 1: @@
 <noinclude>{{Template}}
-An inline link to search for the given package in the Package Browser.
+An inline link to search for given packages in the Package Browser.
 === Usage ===
-<pre>{{Pkg|package}}</pre>
+<pre>{{Pkg|package|branch=|repo=|arch=|maintainer=}}</pre>
-Special characters in the package name will automatically be url-encoded. "*" can be used as a wildcard.
+{{define|package|The package name to search for.
+:Special characters in the package name will automatically be urlencoded. "*" and "?" can be used as wildcards.
+:This argument is required, if you're not using it, use the "*" wildcard.}}
+{{define|branch{{=}}|The branch of alpine to search (e.g. "3.19" or "edge"), defaults to "edge" if unset.
+:Pass this parameter with no value (i.e. "branch{{=}}") to search all branches}}
+{{define|repo{{=}}|The repository to search (main, community, or testing). If unspecified all repositories will be searched.}}
+{{define|arch{{=}}|The architecture to search (x86_64, x86, aarch64, armhf, ppc64le, s390x, armv7, or risc64). Defaults to x86_64 if unset.
+:Pass this parameter with no value (i.e. "arch{{=}}") to search all arches.}}
+{{define|maintainer{{=}}|Search for packages with a certain maintainer. (e.g. "None" to search for unmaintained packages) If unspecified packages from all maintainers will be searched}}
 === Examples ===
+Search for gtk+2.0 under the edge branch on the x86_64 architecture:
 <pre>{{Pkg|gtk+2.0}}</pre>
 will produce:
 {{Pkg|gtk+2.0}}
+Search for all gtk packages under the edge branch on the x86_64 architecture:
 <pre>{{Pkg|gtk*}}</pre>
 will produce:
 {{Pkg|gtk*}}
+Search for ALSA-related packages under the 3.19 branch on the x86 (i.e. i686) architecture:
+<pre>{{Pkg|*alsa*|branch=v3.19|arch=x86}}</pre>
+will produce:
+{{Pkg|*alsa*|branch=v3.19|arch=x86}}
-</noinclude><includeonly><span class="plainlinks" style="font-family: monospace, Courier;font-size:10pt;">[https://pkgs.alpinelinux.org/packages?name={{urlencode:{{{1}}}}}&branch=edge&repo=&arch=x86_64&maintainer= {{{1}}}]</span></includeonly>
+</noinclude><includeonly>{{#if:{{{1|}}} | <span class="plainlinks" style="font-family: monospace, Courier;font-size:10pt;">[https://pkgs.alpinelinux.org/packages?name={{urlencode:{{{1}}}}}&branch={{urlencode:{{ #if: {{{branch|}}} | {{{branch}}} | edge}}}}&repo={{urlencode:{{ #if: {{{repo|}}} | {{{repo}}}}}}}&arch={{urlencode:{{ #ifeq: {{{arch|+}}} | {{{arch|-}}} | {{{arch}}} | x86_64 }}}}&maintainer={{urlencode:{{ #if: {{{maintainer|}}} | {{{maintainer}}}}}}} {{{1}}}]</span> | <span class="error">First parameter cannot be undefined or empty in template: <b>Template:Pkg</b></span>}}</includeonly>