Template:Pkg: Difference between revisions

Latest revision as of 19:07, 28 May 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.

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>
-<!-- Note: This template will search for package in the official repos. Thus, if package-foo and package-bar exist, all matching variations will be listed. -->
+{{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.}}
+{{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}}
-Special characters in the package name are automatically encoded in the URL.
+=== Examples ===
+Search for gtk+2.0 under the edge branch on the x86_64 architecture:
-=== Example ===
 <pre>{{Pkg|gtk+2.0}}</pre>
 will produce:
 {{Pkg|gtk+2.0}}
-</noinclude><includeonly><span class="plainlinks" style="font-family: monospace, Courier;font-size:10pt;">[http://alpinelinux.org/apk/main/x86/{{urlencode:{{{1}}}}} {{{1}}}]</span></includeonly>
+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>{{#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>