Template:Sandbox: Difference between revisions

From Alpine Linux
m (Lets try that again...)
m (Add some basic documentation)
Line 1: Line 1:
<noinclude>This is the sandbox template that anyone can edit to figure out how templates work or to test a new template before deplying it...</noinclude>
<noinclude>{{Template}}
<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 ===
=== Usage ===
<pre>{{Pkg|package}}</pre>
<pre>{{Pkg|package|name=|branch=|repo=|arch=|maintainer=}}</pre>


Special characters in the package name will automatically be url-encoded. "*" can be used as a wildcard.
{{define|package||}} or
{{define|name{{=}}|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 ===
=== Examples ===
Search for gtk+2.0 under the edge branch on the x86_64 architecture:
<pre>{{Pkg|gtk+2.0}}</pre>
<pre>{{Pkg|gtk+2.0}}</pre>
will produce:
will produce:
{{Pkg|gtk+2.0}}
{{Pkg|gtk+2.0}}


 
Search for all gtk packages under the edge branch on the x86_64 architecture:
<pre>{{Pkg|gtk*}}</pre>
<pre>{{Pkg|gtk*}}</pre>
will produce:
will produce:
{{Pkg|gtk*}}
{{Pkg|gtk*}}


Search for ALSA-related packages under the 3.19 branch on the x86 (i.e. i686) architecture:
<pre>{{Pkg|name=*alsa*|branch=v3.19|arch=x86}}</pre>
will produce:
{{Pkg|name=*alsa*|branch=v3.19|arch=x86}}


</noinclude><includeonly>{{#if:{{{1|}}}{{{name|}}} | <span class="plainlinks" style="font-family: monospace, Courier;font-size:10pt;">[https://pkgs.alpinelinux.org/packages?name={{urlencode:{{ #if: {{{name|}}} | {{{name}}} |{{{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}}}}}}} {{ #if: {{{name|}}} | {{{name}}} |{{{1}}}}}]</span> | <span class="error">First parameter cannot be undefined or empty in template: <b>Template:Pkg</b></span>}}</includeonly>
</noinclude><includeonly>{{#if:{{{1|}}}{{{name|}}} | <span class="plainlinks" style="font-family: monospace, Courier;font-size:10pt;">[https://pkgs.alpinelinux.org/packages?name={{urlencode:{{ #if: {{{name|}}} | {{{name}}} |{{{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}}}}}}} {{ #if: {{{name|}}} | {{{name}}} |{{{1}}}}}]</span> | <span class="error">First parameter cannot be undefined or empty in template: <b>Template:Pkg</b></span>}}</includeonly>

Revision as of 23:41, 28 December 2023

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|name=|branch=|repo=|arch=|maintainer=}}

package

or

name=
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|name=*alsa*|branch=v3.19|arch=x86}}

will produce: First parameter cannot be undefined or empty in template: Template:Pkg