Template:Sandbox: Difference between revisions

Revision as of 17:37, 28 May 2024

Template Documentation for Sandbox

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}}
-== Template Documentation ==
+An inline link to search for given packages in the Package Browser.
-Link to [http://bugs.alpinelinux.org/ Alpine Issues].
-== Example ==
+=== Usage ===
-<pre>{{Issue|279}}</pre>
+<pre>{{Pkg|package|branch=|repo=|arch=|maintainer=}}</pre>
+{{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:
-{{Issue|279}}
+{{Pkg|gtk*}}
-The issue's description can be included as an optional second argument.
+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">[https://gitlab.alpinelinux.org/alpine/aports/-/issues/{{{1}}} #{{{1}}}{{#if: {{{2|}}} |. {{{2}}}}}]</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>