Alpine Linux - User contributions [en]

Installation

2024-11-22T10:52:59Z

Dubiousjim: /* Alternate courses of action */ misspelling

[[Image:hdd_mount.png|left|link=]]
<br />

This page exists to provide a basic overview to get started. Before actually installing, it can help to skim through the [[Alpine_Linux:FAQ| Frequently Asked Questions (FAQ)]], as well as to refer to the official installation guide at [https://docs.alpinelinux.org/ docs.alpinelinux.org].

{{Tip|This is a wiki!
If something isn't correct, or is incomplete, you will have to figure it out, or ask for the correct solution in the [https://alpinelinux.org/community/ community].

And then carefully edit the wiki page.

Just as those before who did it for you.}}

== Minimal Hardware Requirements ==
{{Main|Requirements}}
* At least 128 MB of RAM. [A graphical desktop system may require up to 512 minimum.]. Note that an installation itself (from ISO) generally requires at least 320 MB during installation.
* At least 0-700 MB space on a writable storage device. [Only required in [[#System Disk Mode|"sys"]] or [[#Data Disk Mode|"data"]] mode installations. It is optional in [[#Diskless Mode|"diskless"]] mode, where it may be used to save newer data and configurations states of a running system.]
* A working internet connection is required to complete [[#System Disk Mode|"sys"]] mode installation.

{{Note| Most of the steps outlined on this page applies to all [[:Category:Architectures|Architectures]] supported by Alpine Linux. For more specific installation instructions, refer to their respective pages. Refer [[#Custom Installation Instructions|custom installation instructions]] for headless system, virtualization etc.}}

== Installation Overview ==

Alpine Linux can be installed and run in [[Setting_up_disks_manually#Alpine_Linux_modes|three modes]] i.e [[#Diskless_Mode|Diskless Mode]], [[#Data_Disk_Mode|Data Disk Mode]] and [[#System_Disk_Mode|System Disk Mode]]. The installation procedure for Alpine Linux '''requires basic understanding of the three modes''' explained in brief below:

==== Diskless Mode ====
{{Main|Diskless Mode}}
In Diskless mode the entire operating system with all applications are first loaded into RAM and then only run from there. This mode is extremely fast and can save on unnecessary disk spin-ups, power, and wear. Alpine Linux uses this method to boot the .iso installation images. The [[Alpine_setup_scripts#setup-alpine|<code>setup-alpine</code>]] script configures the installed system to continue to boot like this if "disk=none" is specified.

==== Data Disk Mode ====
{{Main|Data Disk Mode}}
In Data Disk mode also the operating system runs from system RAM, thus it enjoys the same accelerated operation speed as "diskless" mode. However, swap storage and the entire {{Path|/var}} directory tree get mounted from a persistent storage device. This mode is useful for having RAM accelerated servers with variable amounts of user-data that exceed the available RAM size.

==== System Disk Mode ====

System or '''sys''' Disk Mode is the traditional hard-disk install. Alpine Linux can be installed to an entire [[#setup-alpine based System Disk Install|'''hard disk''']] using <code>setup-alpine</code> script or to custom partitions using [[Setting_up_disks_manually|<code>setup-disk</code>]]. For further info, refer [[Setting_up_disks_manually|System Disk Mode]].

=== General course of action ===

It is really helpful for many use cases to [[#Preparing_for_the_installation|prepare]] and complete the [[#Installation_Step_Details|Installation]] until the [[#Base_configuration|base configuration]] step, then proceed with installation of the target system with any one of the various [[#Alternate courses of action|alternate]] courses of action.

=== Alternate courses of action ===

Examples of preparation options:
* Download some specific driver to configure the hardware, and/or install some software tool that may be missing in the live system by using the alpine package manager <code>[[Alpine_Package_Keeper|apk]]</code>.
* Do a [[Setting_up_disks_manually#Manual_partitioning|Manual partitioning]] of the harddisk that avoids overwrite of an entire disk.

Examples of such options:

* To install Alpine Linux on an '''entire hard disk''' with optional [[Alpine_setup_scripts#Environment_Variables|environment variables]], proceed to [[#setup-alpine_based_System_Disk_Install|setup-alpine based System Disk Install]].
* Use <code>[[Alpine_setup_scripts#setup-lbu|setup-lbu]]</code> to configure a "local backup" location and <code>[[Alpine_setup_scripts#setup-apkcache|setup-apkcache]]</code> to configure a local package cache storage location for the [[#Diskless Mode|diskless]] system and finally use <code>[[Alpine_local_backup|lbu commit]]</code> to then save the local configuration state.
* Use <code>[[Alpine_setup_scripts#setup-bootable|setup-bootable]]</code> to create a [[Create_a_Bootable_Device#Using_setup-bootable|customizable boot media]] for '''[[Installation#Diskless_Mode|diskless]]''' or '''[[Installation#Data_Disk_Mode|data]]''' disk-mode i.e a boot device with a writable filesystem.
* Use <code>[[Alpine_setup_scripts#setup-disk|setup-disk]]</code> to complete a [[Setting_up_disks_manually|traditional hard-disk installation]] on a partition or to [[Dualbooting|Dualboot]] or to configure [[Setting_up_disks_manually#RAID|RAID]], [[Setting_up_disks_manually#Encryption|encryption]] or [[Setting_up_disks_manually#LVM|LVM]] for both [[#Data Disk Mode|"data"]] disk and [[#System_Disk_Mode|"system"]] disk mode or to add a [[#Data Disk Mode|"data"]] mode partition.

There are many more [[Alpine_setup_scripts|setup-scripts]] available. All these tools may also be run later to adjust specific configurations. For example, to set up a graphical environment as covered under [[Installation#Post-Installation|Post-Installation]] below.

== Preparing for the installation ==

=== Downloading installation image ===

Download the [https://alpinelinux.org/downloads/ stable-release installation image-file] for the target computer's architecture with their corresponding <code>sha256</code> (checksum) and <code>GPG</code> (signature) files.

{{Note|Download <code>sha256</code> (checksum) and <code>GPG</code> (signature) files only from [https://alpinelinux.org/downloads/ official] site and not from mirrors.}}

Now you have three files of the following format..
<pre>
alpine-standard-*.iso
alpine-standard-*.iso.sha256
alpine-standard-*.iso.asc
</pre>
''alpine-standard-3.20.3-x86_64.iso'' is the '''3.20.3''' version '''Standard''' image file in '''iso''' format for '''x86_64''' architecture. Image file can also be '''gz''' for certain cases.

=== Verifying downloaded image ===

From Security point of view, verify the downloaded image file for both checksum and GPG signature before proceeding further. The three required utilities i.e <code>sha256</code>, <code>curl</code> and <code>gpg</code> or their equivalents are available in every operating system including Linux, windows, Mac and BSD derivaties.

{{Tip|Ensure that all the three downloaded files remain in the same folder. If not, adjust the commands accordingly.}}

The <code>sha256</code> checksum verifies the integrity of the downloaded image i.e no modifications occurred during download.
{{Cmd|sha256sum -c alpine-*.iso.'''sha256'''}}

The <code>GPG</code> signature verifies the link between the downloaded image to the individual who signed it. Signature verification involves two steps:

Step 1. Download and import the gpg signature from official website
{{Cmd|curl https://alpinelinux.org/keys/ncopa.asc | gpg --import ;}}

Step 2. Verify that the image signature matches with the one downloded in Step 1.
{{Cmd|gpg --verify alpine-*.iso.'''asc''' alpine-*.'''iso'''}}

=== Preparing installation media ===
{{Seealso|Burning ISOs}}

{{Note|These instructions are exclusively for x86_64 and x86. For ARM boards, see [[Alpine on ARM#Preparing installation media|Alpine on ARM]].}}

All data currently on the installation media will be '''lost''', when Alpine Linux installation image is written on it. Be extremely careful to correctly identify the device name for the installation media using the commands <code>lsblk</code> and <code>blkid</code>.

In Linux, <code>dd</code> command can write the downloaded image file to the installation media i.e target device.

{{Note|Modify the input file('''if''') and output file('''of''') according to the name and path to your image file and target device. Do not use partition numbers for the target device i.e use '''/dev/sdX''' instead of '''/dev/sdbXY.}}
{{Cmd|# dd if{{=}}alpine-standard-3.20.3-x86_64.iso of{{=}}/dev/sdX bs{{=}}4M status{{=}}progress; eject /dev/sdX}}

If your version of <code>dd</code> does not support the option "status=progress", remove it. The <code>eject</code> command removes the target device from the system and ensures the write cache is completely flushed.

In Windows, [https://rufus.ie/ Rufus] has been tested to create bootable USB flash drives and worked for Alpine Linux 3.12.x with the following settings:
* '''Partition scheme''': <code>MBR</code> '''Target system''': <code>BIOS or UEFI</code>
* '''File system''': <code>FAT32</code> '''Cluster size''': <code>4096 bytes (default)</code>

=== Verifying Installation media ===

After detaching and re-attaching the device, a bit-wise comparison can verify the data written to the device (instead of just data buffered in RAM). If the comparison terminates with an end-of-file error on the .iso file side, all the contents from the image have been written (and re-read) successfully:
<pre>
# cmp ~/Downloads/alpine-standard-3.20.3-x86_64.iso /dev/sdX
cmp: EOF on alpine-standard-3.20.3-x86_64.iso
</pre>

=== Booting Installation Media ===

Insert the [[#Preparing_installation_media|Installation media]] to a proper drive or port of the computer and turn the machine on, or restart it, if already running.
{{Note| To successfully boot and install Alpine Linux, disable [[Alpine_and_UEFI#How_to_boot_unsigned_code?|secure boot]] in the BIOS. Once Alpine Linux is installed, this can be [[UEFI_Secure_Boot|enabled]].}}
If the computer does not automatically boot from the desired device, one needs to bring up the boot menu and choose the media to boot from. Depending on the computer, the menu may be accessed by repeatedly pressing a key quickly when booting starts. Some computers require that you press the button ''before'' starting the computer and hold it down while the computer boots. Typical keys are: {{key|F9}}-{{key|F12}}, sometimes {{key|F7}} or {{key|F8}}. If these don't bring up the boot menu, it may be necessary to enter the BIOS configuration and adjust the boot settings, for which typical keys are: {{key|Del}} {{key|F1}} {{key|F2}} {{key|F6}} or {{key|Esc}}.

== Installation Step Details ==

=== Boot Process ===

The boot process of the alpine installation image first copies the entire operating system into the RAM memory, and then already starts a complete Alpine Linux system from there. It will initially only provide a basic command line environment that does not depend on reading from any (possibly slow) initial boot media, anymore.

Local log-in is possible as the user <code>root</code>. Initially, the '''root''' user has no password.

At the command prompt, an interactive script named [[Alpine_setup_scripts#setup-alpine|<code>setup-alpine</code>]] is available to configure and install Alpine Linux. The script can be customized by the optional [[Alpine_setup_scripts#Environment_Variables|environment variables]], in case of [[Installation#Data_Disk_Mode|'''"data"''']] or [[Installation#System_Disk_Mode|'''"sys"''']] mode. For e.g {{Codeline|<code>USE_EFI{{=}}1 BOOTSIZE{{=}}512 setup-alpine</code>}}, sets the disklabel type to gpt, creates 512MB '''/boot''' partition with '''vfat''' filesystem and uses <code>grub</code> as bootloader.

=== Base configuration ===

Launch the Alpine Linux Installation by running the [[Alpine_setup_scripts#setup-alpine|<code>setup-alpine</code>]] script :

{{Cmd|# setup-alpine}}

The question-and-answer dialog of <code>setup-alpine</code> takes care of the base configuration. It sets up a network connection to access Internet to configure the system to boot into one of three different Alpine Linux "disk" modes: [[Installation#Diskless_Mode|'''"diskless"'''(none)]], [[Installation#Data_Disk_Mode|'''"data"''']] or [[Installation#System_Disk_Mode|'''"sys"''']]. If you choose to edit any option, the relevant file is opened in [[BusyBox#vi| '''vi''']] for editing.

[[File:Installation-alpine-alpine-setup-3-setup-scripts.png|350px|thumb|right|Example <code>[[Alpine_setup_scripts#setup-alpine|setup-alpine]]</code> session]]

The <code>[[Alpine_setup_scripts#setup-alpine|setup-alpine]]</code> script offers the following configuration options:

# '''Keyboard Layout''' (Local keyboard language and usage mode, e.g. ''us'' and variant of ''us-nodeadkeys''.)
# '''Hostname''' (The name for the computer.)
# '''Network ''' (Setup network connection to access Internet.)
#* Available interfaces are: '''eth0''' '''wlan0'''.(List depends on your hardware.)
#* Which one do you want to initialize? (or '?' or 'done') [eth0] (Enter 'done' after configuring '''atleast''' one interface for Internet access.)
#* Do you want to do any manual network configuration? (y/n) [n] (Default uses "DHCP".)
# '''DNS Servers''' (If none of the interfaces configured in previous step uses dhcp, set DNS server. If unsure, leave DNS domain name blank and using <code>[https://quad9.net/ 9.9.9.9 2620:fe::fe]</code> for DNS is typically adequate.)
# '''Root password''' (the password used to login to the root account)
# '''Timezone''' (Optionally display times/dates in your local time zone)
# '''HTTP/FTP Proxy''' (Proxy server to use for accessing the web/ftp. Use "none" for direct connections to websites and FTP servers.)
# '''Mirror''' (From where to download packages. Choose the organization you trust giving your usage patterns to.)
# '''Setup a user''' (Setting up a regular user account)
# '''NTP''' (Network Time Protocol client used for keeping the system clock in sync with a time server. Package "chrony" is part of the default install image.)
# '''SSH''' (Secure SHell remote access server. "OpenSSH" is part of the default install image. Use "none" to disable remote login, e.g. on laptops.)
# In most cases, either one of following line(s) is displayed as follows:
#: '''No disks found.''' or ''' Available disks are: sda (128.0 GB JMicron Tech )'''
# '''Disk Mode''' ( A pre-setup of the "diskless" system or base configuration is completed by answering "none" when asked for the following questions.)
#* Which disk(s) would you like to use? (or '?' for help or 'none') '''none'''
#* Enter where to store configs (/media/ or 'none') '''none'''
#* The location of the package cache '''none'''

Base configuration is complete with the above step. Refer to the [[#Alternate courses of action|alternate courses of action]] to proceed further.

=== setup-alpine based System Disk Install ===

<code>setup-alpine</code> script based installation, needs an ''' entire hard disk(s)''' for Alpine Linux and uses a partitioning layout with (/)root partition, /boot partition and a swap partition, where [[Alpine_setup_scripts#Environment_Variables|environment variables]] determine filesystem, size of the boot partition and the bootloader used. If your use case matches the above, at the final step of [[#Base configuration|base configuration]], type the appropriate hard disk '''device name''' instead of '''none'''. If multiple disks are chosen, [[Alpine_setup_scripts#RAID|RAID]] is used.

* At the '''Disk Mode''' stage, '''sda''' or relevant disk(s) must be chosen in the below screen:
** Which disk(s) would you like to use? (or '?' for help or 'none') '''sda'''
** Confirmation for the chosen disk(s) appears. ''The following disk is selected:'' '''sda (128.0 GB JMicron Tech ).'''
{{Warning|Pay close attention to the disk name and size. If you enter '''sys''' in the next step, no further questions will be asked and data on the chosen disk(s) will be overwritten!. Enter {{key|Ctrl}}+{{key|c}} to abort the installation process. Proceed only if you are 100% sure.}}
* How would you like to use it? ('sys', 'data', 'lvm' or '?' for help) '''sys'''

If '''sys''' is chosen, the <code>setup-alpine</code> script will complete the traditional hard-disk installation of Alpine Linux on the chosen disk(s) without further questions. Once the installation is complete, you can skip the next steps and proceed to [[#Reboot|reboot]] the system to boot into the newly installed Alpine Linux and [[Installation#Post-Installation|configure]] further.

=== Custom partitioning ===

[[Setting_up_disks_manually#Manual_partitioning|Manual partitioning]] of the harddisk may be needed to prepare the harddisk for "sys" mode install using [[Setting_up_disks_manually|<code>setup-disk</code>]] and for storing the config file using [[Alpine_local_backup|<code>lbu commit</code>]] and package cache for [[Diskless Mode|Diskless]] and for /var mount for [[Data Disk Mode|Data disk]] mode installs. Refer [[Setting up disks manually|Setting up disks manually]] page for specific configurations related to [[Setting_up_disks_manually#RAID|RAID]], [[Setting_up_disks_manually#Encryption|encryption]], [[Setting_up_disks_manually#LVM|LVM]], etc...

=== Preparing for the first boot ===
If [[#System_Disk_Mode|System Disk Mode]] of installation was performed, ignore this section and proceed to [[#Reboot|reboot]].

If the new local system was configured to run in "diskless" or "data" mode, and you do not want keep booting from the initial (and possibly read-only) [[Installation#Preparing_installation_media|installation media]], create a [[Create_a_Bootable_Device|customizable boot device]]. Once everything is in place, save your customized configuration with {{ic|lbu commit}} before rebooting.

=== Reboot ===

First, remove the initial installation media from the boot drive, or detach it from the port it's connected to. The system may now be power-cycled or rebooted to confirm everything is working correctly. The relevant commands for this are {{ic|poweroff}} or {{ic|reboot}}. Login into the new system with the root account.

=== Completing the installation ===

The installation script installs only the base operating system. '''No''' applications e.g. web server, mail server, desktop environment, or web browsers are installed.

Please look at [[Installation#Post-Installation|Post-Installation]], for some common things to do after installation.

== Custom Installation Instructions ==


Custom-made headless apkovl can be done by first booting the install media on some computer with a display and keyboard attached, or in a virtual machine, and doing an intermediate "diskless" setup of just the boot media (more details below), i.e. using the offical <code>[[Alpine_setup_scripts#setup-alpine|setup-alpine]]</code> to configure the system's network, possibly for dhcp if needed, a ssh server, and a login user. Choosing "disks=none" for now, yet, configure to store configs on the boot media (if it is writable, otherwise on a separate storage media). And afterwards calling <code>[[Alpine_local_backup|lbu commit]]</code> to store the configs as local backup. Then your completed setup, including its securely created own private keys, will readily get (re)loaded on every subsequent (headless) boot from your custom-build <code><hostname>.apkovl.tar.gz</code> stored on the boot media (or on an auxilary media or server location, in case the boot media is read-only).


* [https://github.com/macmpi/alpine-linux-headless-bootstrap/ Bootstrap Alpine Linux on a headless system] using pre-built <code>apkovl</code> overlay file.
* [[Kernels]] ''(kernel selection, e.g. for VMs or RPi)''
* [[How to make a custom ISO image with mkimage]] ''(installation media with its own configuration)''
* [[Directly booting an ISO file]] ''(without flashing it to a disk or device)''
* [[Netboot Alpine Linux using iPXE]]
* [[:Category:Virtualization|Virtualization]]

Also see other [[:Category:Installation|Installation Category]] pages.

== Post-Installation ==

{{Tip|Alpine Linux packages stay close to the upstream design. Therefore, all upstream documentation about configuring a software package, as well as good configuration guides from other distributions that stay close to upstream, e.g. those in the [https://wiki.archlinux.org/ ArchWiki], or [https://wiki.gentoo.org/wiki/ Gentoo wiki] are to a large degree, also applicable to configuring the software on Alpine Linux, thus can be very useful.}}


=== Daily driver guide ===

{{:Daily driver guide}}

=== Other topics ===

Topics not strictly related to using Alpine Linux as desktop are listed below:


* [[Upgrading Alpine|Upgrade your OS]], when a new version is [https://www.alpinelinux.org/releases/ released].
* [[Tutorials_and_Howtos#Networking_2|Setting up Networking]] ''(including non-standard configurations)''
* [[OpenRC|Init System (OpenRC)]] ''(configure a service to automatically boot at next reboot)''
** [[Writing Init Scripts]]
** [[Multiple Instances of Services]]
* [[Hosting services on Alpine]] ''(links to several mail/web/ssh server setup pages)''

== See also ==
* [[Tutorials and Howtos]]
* [[Alpine_Linux:FAQ|FAQs]]
* [[Comparison with other distros]] ''(how common things are done on Alpine)''
* [[Alpine_Linux:Wiki_etiquette|Wiki etiquette]] ''(to collaborate on this documentation)''

[[Category:Installation]]

Create a Bootable Device

2024-11-22T10:39:19Z

Dubiousjim: /* Copying ISO/tarball contents to a USB stick */ Expanded instructions for copying from tarball

{{Note|These instructions are exclusively for x86_64 and x86. For ARM boards, see [[Alpine_on_ARM#Preparing_installation_media|Alpine on ARM]].}}

This page is about creating customizable boot devices for '''[[Installation#Diskless_Mode|diskless]]''' or '''[[Installation#Data_Disk_Mode|data]]''' disk-mode Alpine Linux using a writable filesystem i.e. not iso9660, so that local customizations like apkovl files and cached packages can be stored. It allows to also upgrade the kernel with its modules and firmware that is used to boot the system with the [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs|update-kernel]] script.

== Requirements ==

* An Alpine Linux [[Installation#Preparing_installation_media|Installation Media]], can be CD/DVD/USB.
* A customizable boot device that can be a USB-Stick/CompactFlash/SDCard etc., or harddisk partition for the '''[[Installation#Diskless_Mode|diskless]]''' or '''[[Installation#Data_Disk_Mode|data]]''' mode Alpine linux.

== Using setup-bootable ==

[[Alpine_setup_scripts#setup-bootable|setup-bootable]] script is the preferred method to create a directly customizable bootable device on a FAT32 filesystem. For other filesystems refer [[#Manually copying Alpine files|Manually copying Alpine files]].

# Complete the [[#Installation_Step_Details|Installation]] until the [[#Base_configuration|base configuration]] step by booting from an Alpine Linux [[Installation#Preparing_installation_media|Installation Media]]. Ensure that customizable boot device is already plugged in or installed. Install the necessary tools to prepare the customizable bootable device so that it doesn't have weird stuff that affects later:
#: {{Cmd|# apk add dosfstools wipefs util-linux}}
# Run <Code>lsblk</Code> to figure out what the disk to turn into your bootable device. Let's say it's /dev/sda for this example, change as needed:
#: {{Warning|The below step will nuke EVERYTHING on the disk /dev/sda. Do not proceed if you're unsure or if you have valuable data.}}
#: {{Cmd|# wipefs --all /dev/sda}}
# [[Setting_up_disks_manually#Creating_partitions|Create a partition]] sda1 with the desired size, set the type to win95 fat, and set the bootable flag on it. [[Setting_up_disks_manually#Formatting_partitions|Format]] the newly created partition. Alter the device name i.e{{Path|/dev/sda1}} as needed.
#: {{cmd|mkfs.vfat /dev/sda1}}
# Figure out where your install media files are mounted. if you run a {{ic|df}} command, you should see a read only mount for something like '''/media/cdrom''' or '''/media/usb''' or something else, depending on your environment. Let's use '''/media/cdrom''' for the install media files and '''/dev/sda1''' for the customizable boot device:
#: {{Cmd|# setup-bootable -v /media/cdrom /dev/sda1}}
# After that's done, remove [[Installation#Preparing_installation_media|Installation Media]] and [[Installation#Reboot|reboot]] the system.
# Once the system boots from the customizable boot device '''{{path|/dev/sda1}}''', login as root and run <code>setup-alpine</Code> once again to complete the [[#Installation_Step_Details|Installation]] until the [[#Base_configuration|base configuration]] step.
#: # setup-alpine
#: ...
#: Which disk(s) would you like to use? (or '?' for help or 'none') [none]
#: Enter where to store configs ('floppy', 'sda1', 'usb' or 'none') [sda1]:
#: Enter apk cache directory (or '?' or 'none') [/media/sda1/cache]:
# For the question on disk to use, select '''none'''.
# The script asks about storing configs. Choose the customizable boot device.('sda1' in this example).
# Then the script asks you for apk cache directory. Accept the default or type as follows i.e {{Path|/media/sda1/cache}}. Refer [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]] for more details.
# Always remember to run <Code>lbu ci</Code> to commit the above changes to disk.
#: {{Cmd|# lbu ci}}
# Test/verify by rebooting and seeing that your alpine setup is preserved in the customizable boot device.

== Manually copying Alpine files ==

If you do not want to use <Code>Setup-bootable</Code> script or need non-FAT32 partitions, you can manually create a customizable boot device by manually copying Alpine Linux Files and install the bootloader to make the device bootable.

=== Copying ISO/tarball contents to a USB stick ===

This method is written for copying files from an Alpine ISO file but also works for Alpine tarballs (.tar.gz files) with a one line tweak (see below).

# Install some prerequisites. (If you're not currently using Alpine Linux then you probably have these installed already, otherwise you'll have to figure out how to install them.)
#: {{Cmd|apk add dosfstools<BR>apk add syslinux}}
# Set the environment variable 'mydev' to the [https://en.wikipedia.org/wiki/Device_file device file] name of the USB stick that Alpine Linux is to be installed to:
#: {{Warning | BE SURE TO GET THIS RIGHT OR ELSE YOU COULD OVERWRITE THE WRONG DISK! }}
#: {{Note|If USB stick's device name ends in a digit, you might have to replace all instances of <code>${mydev}1</code> with <code>${mydev}p1</code> below.}}
#: {{Cmd|<nowiki>mydev=/dev/sdU</nowiki>}}
# Make sure that the target drive's existing partitions, if any, are not mounted:
#: {{Cmd|umount -q $mydev?}}
# Copy and paste the following as a single command to wipe the target drive, create an MBR partition table, and create a single FAT32 partition (you can ignore any "Partition #1 contains a vfat signature." warning message):
#: {{Cmd|<nowiki>fdisk -w always $mydev <<EOF
o
n
p
1
2048
-0
t
0c
a
w
EOF</nowiki>}}
# Format the new FAT32 partition with a FAT32 filesystem:
#: {{Cmd|<nowiki>mkdosfs -F32 ${mydev}1</nowiki>}}
# Copy the [https://wiki.syslinux.org/wiki/index.php?title=Mbr syslinux executable boot code] into the bootstrap code area of the MBR boot sector (if you're not currently using Alpine Linux you may need to adjust the path to syslinux's mbr.bin file):
#: {{Cmd|<nowiki>dd bs=440 count=1 conv=notrunc if=/usr/share/syslinux/mbr.bin of=$mydev</nowiki>}}
# Install the syslinux bootloader files onto the FAT32 filesystem. (Ignore the "Hidden (2048) does not match sectors (62)" messages - modern systems use the partition table. If you are getting "no previous syslinux boot sector found" error, try adding <code>--install</code> flag):
#: {{Cmd|syslinux ${mydev}1}}
# Copy the Alpine files to the FAT32 filesystem (to copy the contents of an Alpine {{Path|.tar.gz}} tarball instead, see next item):
#: {{Cmd|<nowiki>mydevname=$(basename $mydev)1
mkdir -p /media/$mydevname
mount -t vfat ${mydev}1 /media/$mydevname
cp -aT /media/cdrom /media/$mydevname # -T to copy hidden files
umount /media/$mydevname</nowiki>}}
# If you instead want to copy the contents of an Alpine {{Path|.tar.gz}} tarball, do this:
#: {{Cmd|<nowiki>mydevname=$(basename $mydev)1
mytarball=/path/to/alpine-tarball.tar.gz
mkdir -p /media/$mydevname
mount -t vfat ${mydev}1 /media/$mydevname
tar -p -s --atime-preserve --same-owner --one-top-level=/media/$mydevname -zxvf $mytarball
umount /media/$mydevname</nowiki>}}
# (''Optional'') Remove any .apkovl overlay files that were transferred as part of the copy process. Do this if you want an unmodified, vanilla install.
#: {{Cmd|<nowiki>mount -t vfat ${mydev}1 /media/$mydevname
rm /media/$mydevname/*.apkovl.tar.gz
umount /media/$mydevname</nowiki>}}

=== Finishing installation ===

After one has booted the previously created Alpine Linux bootable USB medium, one has to prepare USB stick to hold local customizations and run ''setup-alpine'' to finish the installation.

First let's find out where is our just booted USB media mounted, the location could vary.

# mount | grep /media
/dev/sdU1 on /media/sdU1 type vfat (rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=utf8,shortname=mixed,errors=remount-ro)

Create local directory on USB media to hold local APK cache (see [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]] for details).

# mount -o remount,rw /media/sdU1
# mkdir /media/sdU1/cache
# setup-apkcache /media/sdU1/cache
# ls -l /etc/apk/cache
lrwxrwxrwx 1 root root 17 Oct 19 13:16 /etc/apk/cache -> /media/sdU1/cache

Now run ''setup-alpine'' and proceed until a question about local disk selection - in ''diskless'' mode we won't use any disk (ie. our bootable media files is basically untouched) and we are going to use ''sdU1'' to hold our system customization.

# setup-alpine
...
Which disk(s) would you like to use? (or '?' for help or 'none') [none]
Enter where to store configs ('floppy', 'sdU1', 'usb' or 'none') [sdU1]:
Enter apk cache directory (or '?' or 'none') [/media/sdU1/cache]:

After the installer finished you can see how many created/modified files are detected and will be added to the backup:
# lbu status
# lbu status | wc -l
59
# lbu commit
# ls -l /media/sdU1/*apkovl.tar.gz
-rwxr-xr-x 1 root root 9591 Oct 19 15:23 /media/sdU1/foo.apkovl.tar.gz

Now all the customization are saved into the ''foo.apkovl.tar.gz'' compressed tarball on the USB stick itself.

== Troubleshooting ==

=== Wrong Device Name ===

If you cannot boot from the boot device and you see something like:
Mounting boot media failed.
initramfs emergency recovery shell launched. Type 'exit' to continue boot
then it is likely that the device name in {{Path|syslinux.cfg}} is wrong. You should replace the device name in this line:
append initrd=/boot/grsec.gz alpine_dev='''usbdisk''':vfat modules=loop,cramfs,sd-mod,usb-storage quiet
with the proper device name.
* For boot from USB, the device name should be 'usbdisk' (as shown above)
* For other options, you can run <code>cat /proc/partitions</code> to see the available disks (i.e. 'sda' or 'sdb')

===Non-FAT32 Filesystems ===

When the boot device is formatted with a filesystem other than those supported by default, the necessary initfs features need to be added to the modloop using <code>update-kernel</code>. See: [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs]]

Mount the boot device and edit the {{Path|syslinux.cfg}} file.

Then locate the "append" line, and change the <code>alpine_dev=</code> setting to match the used filesystem and add the filesystem's kernel module to the <code>modules=</code> list.

For example, change
append [...] alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet
to
append [...] alpine_dev=usbdisk:'''ext4''' modules=loop,cramfs,sd-mod,usb-storage''',ext4''' quiet
in the case of an ext4 formatted partition. (Or correspondingly for other filesystems, if they are supported by syslinux and the Alpine Linux kernel.)

=== Slow USB Devices ===

Specifying the 'waitusb=X' option at the end of the syslinux.cfg line might help with certain USB devices that take a bit longer to register. X stands for the amount of seconds kernel will wait before looking for the installation media.
append initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet '''waitusb=3'''

=== CF card readers ===

Some CF card readers have problems with the faster CF cards on the market. If you experience problems booting the CF card even after checking BIOS settings, you may need to use an older card.

Also, many CF card readers don't support DMA correctly, so you may need to add ''nodma'' to the ''append'' line of the syslinux.cfg file.

== See Also ==
* [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]]
* [[Alpine local backup]]
* [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs|update-kernel script]]

[[Category:Installation]][[Category:Diskless]]

Create a Bootable Device

2024-11-22T10:35:03Z

Dubiousjim: /* Using setup-bootable */ Formatting/rewording list

{{Note|These instructions are exclusively for x86_64 and x86. For ARM boards, see [[Alpine_on_ARM#Preparing_installation_media|Alpine on ARM]].}}

This page is about creating customizable boot devices for '''[[Installation#Diskless_Mode|diskless]]''' or '''[[Installation#Data_Disk_Mode|data]]''' disk-mode Alpine Linux using a writable filesystem i.e. not iso9660, so that local customizations like apkovl files and cached packages can be stored. It allows to also upgrade the kernel with its modules and firmware that is used to boot the system with the [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs|update-kernel]] script.

== Requirements ==

* An Alpine Linux [[Installation#Preparing_installation_media|Installation Media]], can be CD/DVD/USB.
* A customizable boot device that can be a USB-Stick/CompactFlash/SDCard etc., or harddisk partition for the '''[[Installation#Diskless_Mode|diskless]]''' or '''[[Installation#Data_Disk_Mode|data]]''' mode Alpine linux.

== Using setup-bootable ==

[[Alpine_setup_scripts#setup-bootable|setup-bootable]] script is the preferred method to create a directly customizable bootable device on a FAT32 filesystem. For other filesystems refer [[#Manually copying Alpine files|Manually copying Alpine files]].

# Complete the [[#Installation_Step_Details|Installation]] until the [[#Base_configuration|base configuration]] step by booting from an Alpine Linux [[Installation#Preparing_installation_media|Installation Media]]. Ensure that customizable boot device is already plugged in or installed. Install the necessary tools to prepare the customizable bootable device so that it doesn't have weird stuff that affects later:
#: {{Cmd|# apk add dosfstools wipefs util-linux}}
# Run <Code>lsblk</Code> to figure out what the disk to turn into your bootable device. Let's say it's /dev/sda for this example, change as needed:
#: {{Warning|The below step will nuke EVERYTHING on the disk /dev/sda. Do not proceed if you're unsure or if you have valuable data.}}
#: {{Cmd|# wipefs --all /dev/sda}}
# [[Setting_up_disks_manually#Creating_partitions|Create a partition]] sda1 with the desired size, set the type to win95 fat, and set the bootable flag on it. [[Setting_up_disks_manually#Formatting_partitions|Format]] the newly created partition. Alter the device name i.e{{Path|/dev/sda1}} as needed.
#: {{cmd|mkfs.vfat /dev/sda1}}
# Figure out where your install media files are mounted. if you run a {{ic|df}} command, you should see a read only mount for something like '''/media/cdrom''' or '''/media/usb''' or something else, depending on your environment. Let's use '''/media/cdrom''' for the install media files and '''/dev/sda1''' for the customizable boot device:
#: {{Cmd|# setup-bootable -v /media/cdrom /dev/sda1}}
# After that's done, remove [[Installation#Preparing_installation_media|Installation Media]] and [[Installation#Reboot|reboot]] the system.
# Once the system boots from the customizable boot device '''{{path|/dev/sda1}}''', login as root and run <code>setup-alpine</Code> once again to complete the [[#Installation_Step_Details|Installation]] until the [[#Base_configuration|base configuration]] step.
#: # setup-alpine
#: ...
#: Which disk(s) would you like to use? (or '?' for help or 'none') [none]
#: Enter where to store configs ('floppy', 'sda1', 'usb' or 'none') [sda1]:
#: Enter apk cache directory (or '?' or 'none') [/media/sda1/cache]:
# For the question on disk to use, select '''none'''.
# The script asks about storing configs. Choose the customizable boot device.('sda1' in this example).
# Then the script asks you for apk cache directory. Accept the default or type as follows i.e {{Path|/media/sda1/cache}}. Refer [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]] for more details.
# Always remember to run <Code>lbu ci</Code> to commit the above changes to disk.
#: {{Cmd|# lbu ci}}
# Test/verify by rebooting and seeing that your alpine setup is preserved in the customizable boot device.

== Manually copying Alpine files ==

If you do not want to use <Code>Setup-bootable</Code> script or need non-FAT32 partitions, you can manually create a customizable boot device by manually copying Alpine Linux Files and install the bootloader to make the device bootable.

=== Copying ISO/tarball contents to a USB stick ===

This method is written for copying files from an Alpine ISO file but also works for Alpine tarballs (.tar.gz files) with a one line tweak (see below).

# Install some prerequisites. (If you're not currently using Alpine Linux then you probably have these installed already, otherwise you'll have to figure out how to install them.)
#: {{Cmd|apk add dosfstools<BR>apk add syslinux}}
# Set the environment variable 'mydev' to the [https://en.wikipedia.org/wiki/Device_file device file] name of the USB stick that Alpine Linux is to be installed to:
#: {{Warning | BE SURE TO GET THIS RIGHT OR ELSE YOU COULD OVERWRITE THE WRONG DISK! }}
#: {{Note|If USB stick's device name ends in a digit, you might have to replace all instances of <code>${mydev}1</code> with <code>${mydev}p1</code> below.}}
#: {{Cmd|<nowiki>mydev=/dev/sdU</nowiki>}}
# Make sure that the target drive's existing partitions, if any, are not mounted:
#: {{Cmd|umount -q $mydev?}}
# Copy and paste the following as a single command to wipe the target drive, create an MBR partition table, and create a single FAT32 partition (you can ignore any "Partition #1 contains a vfat signature." warning message):
#: {{Cmd|<nowiki>fdisk -w always $mydev <<EOF
o
n
p
1
2048
-0
t
0c
a
w
EOF</nowiki>}}
# Format the new FAT32 partition with a FAT32 filesystem:
#: {{Cmd|<nowiki>mkdosfs -F32 ${mydev}1</nowiki>}}
# Copy the [https://wiki.syslinux.org/wiki/index.php?title=Mbr syslinux executable boot code] into the bootstrap code area of the MBR boot sector (if you're not currently using Alpine Linux you may need to adjust the path to syslinux's mbr.bin file):
#: {{Cmd|<nowiki>dd bs=440 count=1 conv=notrunc if=/usr/share/syslinux/mbr.bin of=$mydev</nowiki>}}
# Install the syslinux bootloader files onto the FAT32 filesystem. (Ignore the "Hidden (2048) does not match sectors (62)" messages - modern systems use the partition table. If you are getting "no previous syslinux boot sector found" error, try adding <code>--install</code> flag):
#: {{Cmd|syslinux ${mydev}1}}
# Copy the Alpine files to the FAT32 filesystem (to copy the contents of an Alpine {{Path|.tar.gz}} tarball instead of copying {{Path|/media/cdrom}}, set <code>$alpinetarball</code> to the path to the tarball and replace the 'cp' line with: <code>tar -p -s --atime-preserve --same-owner --one-top-level=/media/$mydevname -zxvf "$alpinetarball"</code>):
#: {{Cmd|<nowiki>mydevname=$(basename $mydev)1
mkdir -p /media/$mydevname
mount -t vfat ${mydev}1 /media/$mydevname
cp -aT /media/cdrom /media/$mydevname # -T to copy hidden files
umount /media/$mydevname</nowiki>}}
# (''Optional'') Remove any .apkovl overlay files that were transferred as part of the copy process. Do this if you want an unmodified, vanilla install.
#: {{Cmd|<nowiki>mount -t vfat ${mydev}1 /media/$mydevname
rm /media/$mydevname/*.apkovl.tar.gz
umount /media/$mydevname</nowiki>}}

=== Finishing installation ===

After one has booted the previously created Alpine Linux bootable USB medium, one has to prepare USB stick to hold local customizations and run ''setup-alpine'' to finish the installation.

First let's find out where is our just booted USB media mounted, the location could vary.

# mount | grep /media
/dev/sdU1 on /media/sdU1 type vfat (rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=utf8,shortname=mixed,errors=remount-ro)

Create local directory on USB media to hold local APK cache (see [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]] for details).

# mount -o remount,rw /media/sdU1
# mkdir /media/sdU1/cache
# setup-apkcache /media/sdU1/cache
# ls -l /etc/apk/cache
lrwxrwxrwx 1 root root 17 Oct 19 13:16 /etc/apk/cache -> /media/sdU1/cache

Now run ''setup-alpine'' and proceed until a question about local disk selection - in ''diskless'' mode we won't use any disk (ie. our bootable media files is basically untouched) and we are going to use ''sdU1'' to hold our system customization.

# setup-alpine
...
Which disk(s) would you like to use? (or '?' for help or 'none') [none]
Enter where to store configs ('floppy', 'sdU1', 'usb' or 'none') [sdU1]:
Enter apk cache directory (or '?' or 'none') [/media/sdU1/cache]:

After the installer finished you can see how many created/modified files are detected and will be added to the backup:
# lbu status
# lbu status | wc -l
59
# lbu commit
# ls -l /media/sdU1/*apkovl.tar.gz
-rwxr-xr-x 1 root root 9591 Oct 19 15:23 /media/sdU1/foo.apkovl.tar.gz

Now all the customization are saved into the ''foo.apkovl.tar.gz'' compressed tarball on the USB stick itself.

== Troubleshooting ==

=== Wrong Device Name ===

If you cannot boot from the boot device and you see something like:
Mounting boot media failed.
initramfs emergency recovery shell launched. Type 'exit' to continue boot
then it is likely that the device name in {{Path|syslinux.cfg}} is wrong. You should replace the device name in this line:
append initrd=/boot/grsec.gz alpine_dev='''usbdisk''':vfat modules=loop,cramfs,sd-mod,usb-storage quiet
with the proper device name.
* For boot from USB, the device name should be 'usbdisk' (as shown above)
* For other options, you can run <code>cat /proc/partitions</code> to see the available disks (i.e. 'sda' or 'sdb')

===Non-FAT32 Filesystems ===

When the boot device is formatted with a filesystem other than those supported by default, the necessary initfs features need to be added to the modloop using <code>update-kernel</code>. See: [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs]]

Mount the boot device and edit the {{Path|syslinux.cfg}} file.

Then locate the "append" line, and change the <code>alpine_dev=</code> setting to match the used filesystem and add the filesystem's kernel module to the <code>modules=</code> list.

For example, change
append [...] alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet
to
append [...] alpine_dev=usbdisk:'''ext4''' modules=loop,cramfs,sd-mod,usb-storage''',ext4''' quiet
in the case of an ext4 formatted partition. (Or correspondingly for other filesystems, if they are supported by syslinux and the Alpine Linux kernel.)

=== Slow USB Devices ===

Specifying the 'waitusb=X' option at the end of the syslinux.cfg line might help with certain USB devices that take a bit longer to register. X stands for the amount of seconds kernel will wait before looking for the installation media.
append initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet '''waitusb=3'''

=== CF card readers ===

Some CF card readers have problems with the faster CF cards on the market. If you experience problems booting the CF card even after checking BIOS settings, you may need to use an older card.

Also, many CF card readers don't support DMA correctly, so you may need to add ''nodma'' to the ''append'' line of the syslinux.cfg file.

== See Also ==
* [[Alpine_Linux_package_management#Local_Cache|APK Local Cache]]
* [[Alpine local backup]]
* [[Alpine_Linux_package_management#Upgrading_.22diskless.22_and_.22data.22_disk_mode_installs|update-kernel script]]

[[Category:Installation]][[Category:Diskless]]

Awk

2024-11-09T07:42:29Z

Dubiousjim: add some line breaks

{{DISPLAYTITLE:awk}}

This page compares BusyBox's implementation of awk (using [https://git.alpinelinux.org/cgit/aports/tree/main/busybox/busyboxconfig?id=v2.3.6 this] config file) with gawk (versions >= 3.1.8) and FreeBSD 9's nawk, which is based on [https://ia903404.us.archive.org/0/items/pdfy-MgN0H1joIoDVoIC7/The_AWK_Programming_Language.pdf Bell Labs/Brian Kernighan's 2007 version of awk].

It's not intended as a tutorial, but rather as a technical summary and list of "gotchas" (places where different implementations may behave in different or unexpected ways).

{{note|This summary was drawn up back when we were using uClibc. Some of the behavior of Alpine's version of BusyBox awk reported here may have changed with the switch to musl.}}

__TOC__

== Invoking awk ==

awk [-F char_or_regex] [-v var=value ...] [--] 'awk script...' [ ARGV[1] ... ARGV[ARGC-1] ]
awk [-F char_or_regex] [-v var=value ...] -f scriptfile ... [--] [ ARGV[1] ... ARGV[ARGC-1] ]

Gawk makes a third invocation pattern possible, which mixes <code>-f scriptfile</code> options with an <code>'awk script...'</code> on the command-line:

gawk [-F char_or_regex] [-v var=value ...] -f scriptfile ... -e 'awk script...' [--] [ ARGV[1] ... ARGV[ARGC-1] ]

[https://github.com/dubiousjim/awkenough Awkenough] is a small set of Awk utility routines and a C stub that makes it easier to write shell scripts with awk shebang lines. <span style="color:gray"> (I'll make an Alpine package for this soon.)</span> It also permits mixing <code>-f scriptfile</code> and command-line scripts, using the same <code>-e</code> option gawk provides. In both cases, the long-form option <code>--source</code> works the same as <code>-e</code>.

;Notes

* all implementations honor <code>\t</code> and so on in <code>-v FS=expr</code>. BusyBox ''doesn't'' honor <code>\t</code> in <code>-F expr</code>; perhaps this is a bug. You can use the <code>$'\t'</code> escapes of BusyBox ash to work around this.

* <code>nawk</code> and <code>gawk --traditional</code> (but not <code>gawk --posix</code>) interpret <code>-F t</code> as <code>-F '\t'</code>. This is a weird special-case preserved for historical compatibility.

* scriptfile can be <code>-</code> for stdin

* ARGVs can be of any form, but awk only knows how to ''automatically'' process arguments whose form is:
** <code>var=unquoted_value</code>: assignments will be made when the main loop reaches that ARGV
** <code>""</code>: will be skipped
** <code>filename</code>
** <code>-</code>: will use stdin
: If no files are processed (nor <code>-</code>), stdin will be processed after all command-line assignments.

* standalone scripts should look like this:
:{{Cat|foo.awk|
#!/usr/bin/awk -f
# will receive the script's ARGC, ARGV with ARGV[0]{{=}}awk
BEGIN { ... }
...
}}
:or like this:
:{{Cat|bar.awk|
#!/usr/bin/runawk -f /usr/share/awkenough/library.awk
...
}}

* gawk places any unrecognized short options that precede <code>--</code> into ARGV; other implementations (and <code>gawk --traditional</code>) fail/warn

* some gawk-only options:
** <code>--lint</code>: warns about nonportable constructs 
** <code>--re-interval</code>: enables <code>/pat{1,3}/</code> regexes; some versions of gawk enable by default, others don't
** <code>--traditional</code> or <code>--compat</code>: makes gawk behave like nawk
** <code>--posix</code>: like <code>--traditional --re-interval</code>, with some further restrictions
** <code>--exec scriptfile</code>: stops option processing and disables any further <code>-v</code>s; meant to be used in shebang line for scripts in untrusted environments (cgi)
** <code>--sandbox</code>: disable <code>system("foo")</code>, <code>"foo"|getline</code>, <code>getline <"file"</code>, <code>print|"foo"</code>, <code>print >"file"</code>, and gawk's <code>extension(obj, func)</code>; so only local resources explicitly specified in ARGV will be accessible. This feature is only available on recent versions of gawk.

* when handling <code>-f <var>path</var></code> options where <var>path</var> contains no <code>/</code>s, gawk will first search in directories specified in an AWKPATH environment variable

== Awk grammar ==

=== Blocks ===

; function definitions

* Functions have global scope, and they can be called from positions that syntactically precede their definitions.

* Scalars (that is, non-arrays) are passed by value, arrays are passed by reference.

* Function calls can be nested or recursive. Each invocation of the function has its own local environment: so upon return, values of the scalar parameters the caller supplied shall be unchanged (array parameters may have been mutated).

<ul><li>
Consider functions defined like this:
<pre>
function foo(x,y) {
...
bar()
return "result"
}

function bar(z) {
y += 1
return
}
</pre>
Here the variables <code>x</code> and <code>y</code> are local to foo, and the variable <code>z</code> is local to bar. All other variable references are ''global'': contrast the shell, where non-local variable references are instead ''dynamic''. That is, in the shell, when foo calls bar, bar will be incrementing foo's local variable <code>y</code>. In awk, on the other hand, bar always only increments a global variable <code>y</code>.

Note also that the number of arguments in a function call needn't match the number of parameters in the function's definition; if more arguments are supplied, they will be ignored; if fewer are supplied (as in foo's call of bar), the missing variables are assigned either "" or an empty array, depending on how they're used in the function.

Note also the the <code>return</code> statement needn't be given an explicit return value (it will default to ""). The <code>return</code> statement can also be omitted altogether.
</ul>

; BEGIN and END

BEGIN { ... } ...
END { ... } ...

* Multiple BEGIN blocks are merged; so too multiple END blocks.

* If there are only BEGIN blocks (no main loop or END blocks), and getline isn't used, then POSIX requires awk to terminate without reading stdin or any file operands. The implementations I checked honor this, but some historical implementations discarded input in this case. For portability, you can explicitly append <code>< /dev/null</code> to an invocation of awk you know shouldn't consume stdin.

* If there is a main loop or END blocks, and awk's processing of stdin hasn't been suppressed by encountering files in its ARGV list, then stdin will be processed before executing any END block(s).

* If there are END block(s), but <code>exit <var>status</var></code> is invoked outside them, then the main loop stops and control passes immediately to the first END block. If <code>exit <var>status</var></code> is invoked within an END block, or if there are no end blocks, the script terminates with result <var>status</var>.

* POSIX requires that inside END, all of <code>FILENAME NR FNR NF</code> retain their most-recent values, so long as <code>getline</code> is not invoked. My implementations comply, and also retain the most-recent fields <code>$0 ...</code>, but earlier versions of nawk did not; and Darwin's awk may not.

; main loop blocks

These are of the form:
<var>pattern</var> { <var>action</var> ... }
or:
<var>pattern</var>,<var>pattern</var> { <var>action</var> ... }

where <var>action</var> defaults to <code>print $0</code>; and <var>pattern</var> defaults to <code>1</code> (that is, to true).

<ul><li>
'''Patterns''' can take any of the forms:
* <code>/<var>regex</var>/</code>
* <code><var>relational</var></code>
* <code><var>pattern</var> && <var>pattern</var></code>
* <code><var>pattern</var> || <var>pattern</var></code>
* <code>! <var>pattern</var></code>
* <code>( <var>pattern</var> )</code>
* <code><var>pattern</var> ? <var>pattern</var> : <var>pattern</var></code>

The first form is interpreted the same as the relational <code>$0 ~ /<var>regex</var>/</code>.

<li>
'''Relationals''' can take any of the forms:
* <code><var>expr</var> ~ <var>RE</var></code>
* <code><var>expr</var> !~ <var>RE</var></code>
* <code><var>expr</var> <var>eqop</var> <var>expr</var></code>
* <code><var>expr</var> in <var>arrayname</var></code>
* <code>(<var>expr</var>, ...) in <var>arrayname</var></code>
* <code><var>expr</var></code>

The schemas <var>RE</var> can be regex literals like <code>/a[bc]+/</code> or any expression that evaluates to a string, like <code>"a[bc]+"</code>. Note that strings require an extra level of <code>\</code>s: you can write <code>/\w+/</code> or <code>"\\w+"</code>.

The scemas <var>eqop</var> can be any of: <code>== != <= < > >=</code>.

A bare expression, as in the last form, is interpreted as false when the expression evaluates to <code>0</code> or <code>""</code>, else to true.
</ul>

; other block forms
BEGINFILE { ... }
ENDFILE { ... }

These are only available in (recent versions of) gawk.

@include "filename"

This is only available in some versions of gawk. See also Aleksey Cheusov's [https://runawk.sourceforge.net/ Runawk], which uses a different approach.

=== Statements ===

Lines can be broken after any of: <code>\ , { && || ? :</code> (The last two only in BusyBox and gawk, and not in <code>gawk --posix</code>.)

; function calls

<var>func</var>(<var>expr</var>, ...)

always evaluates to a value, so can be used as an expression, but also can occur in statement contexts. (Some awks like nawk ''don't'' allow arbitrary expressions to occur in statement contexts; but BusyBox awk does.)

When calling user-defined functions, no space can separate the function name and the <code>(</code>.

; assignments

<var>lvalue</var> = <var>expr</var>
<var>lvalue</var> += 1 (similarly for -= *= /= %= ^=)
<var>lvalue</var> ++ (similarly for --)
++ <var>lvalue</var> (similarly for --)

<var>lvalue</var> can take any of the forms:
* <code><var>var</var></code>
* <code><var>arrayname</var>[<var>expr</var>]</code>
* <code><var>arrayname</var>[<var>expr</var>, ...]</code>
* <code>$<var>expr</var></code>

Like function calls, assignments always evaluate to a value, so can be used as expressions, but also can occur in statement contexts, even in nawk.

delete <var>arrayname</var>[<var>expr</var>]
delete <var>arrayname</var>[<var>expr</var>, ...]
delete <var>arrayname</var>

The last form is not available in <code>gawk --traditional</code>. More portably, you can get the same effect with:

split("", <var>arrayname</var>)

After an array has been deleted, it no longer has any elements; however, the array name remains unavailable for use as a scalar variable.

; control operators

if (<var>test</var>) <var>action</var>
if (<var>test</var>) <var>action</var>; else <var>action</var>
if (<var>test</var>) <var>action</var>; else if (<var>test</var>) <var>action</var>
if (<var>test</var>) <var>action</var>; else if (<var>test</var>) <var>action</var>; else <var>action</var>
if (<var>test</var>) { ... }
if (<var>test</var>) { ... } else <var>action</var>

and so on.

while (<var>test</var>) <var>action</var>
...
do <var>action</var> while (<var>test</var>)
...

The do...while form will execute <var>action</var> at least once.

for (i=1; i<=NF; i++) <var>action</var>
...
for (k in <var>arrayname</var>) <var>action</var>
...

The last form has an unspecified iteration order. Also, the effect of adding or removing elements from an array while iterating over it is undefined.

break
continue

Historic awk implementations interpreted <code>break</code> and <code>continue</code> outside of while/do/for-loops as <code>next</code>. BusyBox supports this usage; as do some versions of <code>gawk --traditional</code>.

next

This reads the next line of input and restarts the main loop from the first rule. For example, to treat the first line of awk's input specially, you can do this:

NR==1 {...<var>handle first line</var>...; next }
{...<var>handle other lines</var>...}

POSIX doesn't specify the behavior of <code>next</code> in BEGIN or END blocks.

nextfile

This aborts processing the current file and starts processing the next file (if any) from the first rule. It is not available in <code>gawk --traditional</code>.

return [<var>value</var>]

<var>value</var> defaults to <code>""</code>. POSIX doesn't specify the behavior of a <code>return</code> statement outside of a function.

exit <code>status</code>

This will begin executing END rules, or exit immediately if invoked inside an END block. <var>status</var> defaults to <code>0</code>.
In gawk and nawk, sequences like this:

{ ... exit n }
END { exit }

will preserve the <code>n</code> status code. In BusyBox awk, the second exit will instead revert to the default of <code>0</code>.

; printing

Parentheses are optional for <code>print</code> and <code>printf</code>, but are mandatory for <code>sprintf</code>. Also, parentheses should be used if any of the arguments to <code>print</code> or <code>printf</code> contains a <code>></code>.

Though <code>print</code> and <code>printf</code> accepts parenthesized argument lists, their invocations are statements not expressions. They return no value and cannot appear in non-statement contexts. (<code>sprintf</code> on the other hand is a function; and its invocations can appear in both statement and expression contexts.)

The first of these:
print "a" "b"
print "a","b"

invokes <code>print</code> with a single argument, which is the simple concatenation <code>"ab"</code> of the expressions <code>"a"</code> and <code>"b"</code>. On the other hand, the second form invokes <code>print</code> with two arguments. They will be separated in the output by the current value of OFS---which may, but need not, be "". The default value of OFS is a single space.

print

is interpreted the same as <code>print $0</code>. (Note also that a block of the form <code><var>pattern</var></code> with no <code>{...}</code> is interpreted as having the body <code>{ print $0 }</code>.)

print ""
print("")

both print a newline.

print (<var>expr</var>, ...) > "path"
print (<var>expr</var>, ...) >> "path"

print to the designated path. (See also [[#Built-in filenames]], below.) The output file is not closed until <code>close "path"</code> is executed, or awk exits.

print (<var>expr</var>, ...) | "shell pipeline"

prints to the designated pipeline. The pipeline is not closed until <code>close "shell pipeline"</code> is executed, or awk exits.

printf ( <var>format</var>, <var>expr</var>, ... )

can be followed by <code>> "path"</code> or <code>>> "path"</code> or <code>| "shell pipeline"</code>, just like <code>print</code>.

This usually implements a subset of the functonality of printf(3). The <var>format</var> string can contain:

<ul><li>
normal Awk string escape codes, such as:
* <code>\b</code> (0x8) which backspaces one space
* <code>\r</code> (0xd) which on Unix backspaces to the start of the current line
* <code>\v</code> and <code>\f</code> (0xb and 0xc) which on Unix stay in the current column but go to the next screen line
* <code>\n</code> and <code>\t</code> and <code>\"</code> and <code>\\</code>
* <code>\a</code> (0x7)
* <code>\c</code> which ignores the rest of the string (none of my awk implementations honored this)
* <code>\000</code> for up to three octal digits

Of the implementations I tried, only gawk would printf or sprintf <code>"\0"</code>; others would take it to terminate the string. (A different way to print <code>"\0"</code> is to use <code>printf "%c", 0</code>. This works with gawk's <code>printf</code> and <code>sprintf</code> and nawk's <code>printf</code>.)

<li>
formatting codes, of the form:
<pre>
%[n$][#][-|0][+| ]['][minwidth][.precision][wordsize specifier][format specifier]
</pre>
where:

* <code><var>n</var>$</code> means use argv[<var>n</var>] instead of the next argv in sequence. The count is 1-based, and only gawk honors this.
* <code>#</code> forces octals to have an initial <code>0</code>, hex to have initial <code>0x</code>, floats to always have a decimal point.
* <code>-</code> means align to the left
* <code>0</code> means right-align as usual but pad with zeros instead of spaces
* <code>+</code> forces the inclusion of a sign
* <code> </code> leads with a sign if negative, or space if positive
* <code>'</code> means write a million as <code>1,000,000</code>. None of my awks honor this.
* <code><var>minwidth</var></code> or <code><var>precision</var></code> can be <code>*</code>, in which case the values are supplied by the next argv. Only gawk and nawk honor this.
* <code><var>precision</var></code> gives the number of digits after the decimal for a number, or the maxwidth for a string.
* <code><var>wordsize specifier</var></code> only nawk honors these, and then only: <code>hh h l ll</code>
* <code><var>format specifier</var></code> can be any of the signed formats <code>fegdi</code> (the last two are equivalent), or any of the unsigned formats <code>xuo</code>, or any of the text formats <code>sc</code>. On BusyBox, the format <code>%c</code> only processes values up to 0x7fff, and the results are always masked to the range "\x00"..."\xff".

None of my awk implementations honored <code>%b</code> (which is like <code>echo -e</code>) or any other format.
</ul>

=== Expressions ===
{{Draft|}}

<div style="white-space:pre; font-family:monospace;"><nowiki>

/pat/ # when this is a complete expr, interpreted as `$0 ~ /pat/`
Differences from other EREs:
{m,n} treated as literal by nawk and gawk --traditional
In some versions of gawk --traditional, [[:classes:]] not available.
dot and [^x] do match newline
^ $ always anchors and only match against start-of-buffer and end-of-buffer (like \` and \')
\1 is \x01; no backrefs available in match patterns
In gawk and nawk, [a\]1] matches a,],1. In BusyBox, it matches a,\ followed by literal 1 then ].
In BusyBox and gawk, /ab\52c/ is interpreted as /ab*c/ not /ab\*c/. In nawk and gawk --traditional, it's interpreted as latter.
Literal newlines not allowed in /pat/, but ok in strings interpreted as patterns. /pat\nmore/ and "pat\\nmore" are both ok.

x=$1 $2 # string concatenation
$one
$(one+two) # any numeric-valued expression can follow $
x=1,2 # assigns 1 to x
x=(1,2) # assigns 1 SUBSEP 2 to x
== != <= < > >= ~ !~
&& has higher precedence than ||
!(k in A)
test ? expr : expr

in BusyBox and gawk, 0[0-7]+ is interpreted as octal and 0x[[:xdigit:]]+ is interpreted as hex
+ - * / % ^ (often, as in BusyBox, ** also does exponentiation)
++ -- lvalue | lvalue ++ --
lvalue += ... %= ^= value

C escapes in "string" and /pat/:
"\OOO" up to 3 octal digits
"\\ \" \n \t \r \f \v \b \a"
"\xff" # not in gawk --posix; BusyBox restricts to two digits
unspecified what is behavior of \m for other m; my awks use literal m (gawk gives warning)
only gawk suppresses \<newlines> inside string literals

The expression `k in array` doesn't create an array entry, but the reference `array[k]` will create an entry with an uninitialized value. (`k in array`
will then be true.)

References to fields > NF, on the other hand, don't create new fields. Assignments to these fields do create them (increasing NF and setting any
intermediate fields to uninitialized values). Assignments to any field (even <= NF) cause $0 to be recomputed using OFS, but do not cause $0 to be
reparsed. (So the modified/new field may contain embedded FS characters.)

Assignments to $0 do cause NF, $1, ... to be recomputed.

</nowiki></div>

=== String vs numeric ===
{{Draft|}}

<div style="white-space:pre; font-family:monospace;"><nowiki>

Uninitialized values include unset variables and array elements, invalid fields (> NF) or valid fields of length 0, and unassigned function parms
(which can be used as scalars or arrays). Unititalized scalars have value "", which math operators treat as 0.
Can force string interpretaton by `var ""`, or force numeric interpretation by `var + 0`. "1text" is coerced as 1.
In boolean contexts: false when expr evaluates to 0 or "", else true.
$(expr) is not reqired to convert uninitialized or string expr, but my implementations do so.

"Numeric string" := value is of the form / *[+-]?NUMBER */, and it was supplied in a way that doesn't distinguish strings from numbers:
n=$1 or split("string",n[]) or getline n
n=FILENAME or ARGV[1] or ENVIRON["foo"]
awk -v 'n=...' ...

Comparisons are numeric iff:
both operands are numeric, or one is numeric and other is a "numeric string" or is uninitialized
my implementations don't require that at least one operand be numeric
Otherwise (one of the operands is an explicit "string"), comparison is stringwise.

awk 'BEGIN {print "00" == 0}' # false, first operand is not a "numeric string"

awk -v'x=00' -v'n=000' 'BEGIN {
y="0000"
print(x=="0", x==0, x==u, x==n, y=="0", y==0, y==u, y==n) # only second, third and fourth will be true, all other comparisons are stringwise
x+y
print(x=="0", x==0, x==u, x==n, y=="0", y==0, y==u, y==n) # in nawk, the previous arithmetic reference to y converts its value to a "numeric string" too
# so now the last three comparisons are also true
# even numeric constants are susceptible to this side-effect
# (print the constant and it's converted to a numeric string, and ignores further changes to OFMT)
# however, stringwise evaluation of y still gives "0000"
}'
In POSIX and my other implementations, referencing doesn't have that side-effect.

</nowiki></div>

=== Arrays ===
{{Draft|}}

<div style="white-space:pre; font-family:monospace;"><nowiki>

flavor[1]="cherry" ... print flavor[1]
for (k in flavor) action
nfields = split(string, larray, [sep=FS]) # sep can be single char or regex
delete array[key] # BusyBox also honors "delete array"

multiarray[k1, k2]="foo"
(k1,k2) in multiarray
for (kk in multiarray) { split(kk,k,SUBSEP) ... } # now k[1],k[2]

</nowiki></div>

=== Built-in functions ===
{{Draft|}}

<div style="white-space:pre; font-family:monospace;"><nowiki>

cos(x), sin(x), atan2(x,y), exp(x), log(x), sqrt(x)
int(x) # just truncates towards 0, use `printf "%.0f" ...` to round

0 <= rand() < 1
# 1 + int(rand() * TOPNUM) # returns number in range [1..TOPNUM]
srand(seed=time_of_day) ~~> oldseed

# bit arith are only gawk and BusyBox
and(x,y) or(x,y) xor(x,y) lshift(x,count) rshift(x,count) compl(x) # 32-bit base 0xffffffff on BusyBox, may be 53-bit on x86_64 gawk

# time functions are only gawk and BusyBox
systime() # seconds since epoch
strftime("format",systime()=current)
mktime("YYYY MM DD HH MM SS [dst?=-1]") ~~> seconds since epoch
# HH etc values can be non-standard, e.g. -1
# uses local TZ; dst? 1 yes, 0 no, <0 auto

tolower("string"), toupper("string")
sprintf("format", expr...) # does require parens

# gawk is multibyte-aware, so length, substr, index, and match all count by chars, not bytes
length(string=$0)
# nawk and gawk support length without ()
# nawk and gawk (but not gawk --posix) support length(array)
gawk has length(A), returns count of keys rather than maxkey

substr("string", 1-based-start, maxlength=until_end) ~~> "substring"
index("haystack","needle") ~~> 1-based, or 0 if fails
match(string, /pat/) ~~> 1-based starting index, or 0 if fails
# sets RSTART and RLENGTH (when match fails, they are 0 and -1)
# ... match($0, /pat/) { print substr($0, RSTART, RLENGTH) } ... # prints first occurrence of /pat/
gawk has `match(string,/pat/,groups)`: fills groups[0,0start,0length,1,1start,1length,...] with text and positions of \\0, \\1, ...

split("string", larray, sep=FS) ~~> nitems
# splits into larray[1]...larray[nitems]
# some versions of gawk permit fourth argument: lsep, to receive actual FS values (lsep[0] [1] lsep[1] ... [nitems] lsep[nitems])
# BusyBox and gawk accept "" and // as sep; with // BusyBox makes an extra empty field at end
sub(/pat/, "subst", lstring=$0) ~~> 1 if successful, 0 if failed
gsub(/pat/, "subst", lstring=$0) ~~> nsubs
gensub(/pat/, "subst", "g" or which match, string=$0) ~~> newstring
# gawk and BusyBox only
# string is not mutated
# "subst" honors not only & (same as \\0), but also \\1, \\2 ...

system("command") ~~> exit code, output not captured

# getline is a function though it doesn't use parens
# all forms read one line each time they're evaluated; like "next" without restarting from first rule
# returns 1 on success, 0 on EOF, -1 on error; file is not closed automatically
# updates NF when assigning to $0
getline [var] # updates NR and NFR when file not supplied
getline [var] < "-" # read from stdin instead of ARGV[ARGIND]
# loop until we get a name
while (!name) { printf("Enter a name? "); getline name < "-" }
getline [var] < "file"
"pipe command" | getline [var]

close("file" or "pipe commnd") ~~> 0 if successful
# awk doesn't automatically close files, pipes, sockets, or co-processes when they return EOF.
# the return value of close() is unspecified; gawk uses value from fclose(3) or pclose(3), or -1 if the named file, piple, or co-process was not
opened with a redirection.
{ print ... | "sort>tmpfile" } END { close("sort>tmpfile"); while ((getline < "tmpfile")>0) ... close("tmpfile") }

fflush(output "file" or "pipe command") ~~> 0 if all requested buffers successfully flushed, else -1
# not in gawk --posix
# if no argument is supplied, flushes stdout
# if "" is supplied, flushes all open output files and pipes

</nowiki></div>

=== Built-in filenames ===

Only gawk handles these filenames internally:

* <code>"/dev/tty"</code>
* <code>"/dev/stdin"</code>
* <code>"/dev/stdout"</code>
* <code>"/dev/stderr"</code>
* <code>"/dev/fd/<var>n</var>"</code>

but in many Unix systems they're available externally anyway. As an alternative to <code>getline < "/dev/stdin"</code>, you can also use <code>getline < "-"</code>. As an alternative to <code>print ... > "/dev/stderr"</code>, you can also use: <code>print ... | "cat 1>&2"</code>.

=== Built-in variables ===
{{Draft|}}

; ENVIRON
: This is an associative array holding the current environment variables. The array is mutable, but POSIX does not specify whether changes to it must be visible to child processes spawned from awk. (In none of the implementations I checked were such changes visible.)

; ARGC and ARGV
: The number of command-line arguments to awk, and an array holding them. ARGV[0] will usually be "awk", and ARGV[1]...ARGV[ARGC-1] will be the arguments. Awk handles empty arguments specially, and also arguments of the form <code><var>var</var>=<var>value</var></code>.

: If your script only has a BEGIN block, and no main-loop rules or END block, then awk won't attempt to automatically read or process the ARGV arguments, or stdin, in any way.

: You can decrement ARGC; awk then won't process any arguments that have been lost. You can also set <code>ARGV[<var>n</var>] = ""</code>, or alternatively, <code>delete ARGV[<var>n</var>]</code>. Similarly, you can add additional ARGV entries, though if you do so, you need to increment ARGC manually.

: Arguments that awk does process should not refer to directories or nonexisting files (unless you are going to to scan the ARGV list manually and remove such). Some versions of some awk implementations will warn if asked to process a directory; others will raise an error.

; ARGIND
: Indicates which ARGV entry was last processed by awk. This is present only in gawk and BusyBox awk. The variable is mutable; but changes to it have no side-effect in gawk. In BusyBox, changes to it affect which ARGV entry will be processed next, after the current one is finished.

; FILENAME
: Indicates the name of the ARGV entry currently being processed. When stdin is being processed, this will be <code>"-"</code>.

<div style="white-space:pre; font-family:monospace;"><nowiki>

ERRNO In gawk and BusyBox, contains string error message after getline or close fails

NR Number of current record
NR is mutable but changing it has no side-effects.
FNR Like NR, but relative to the current file
RS Record separator (defaults to newline)
If RS is "", it's interpreted as a span of empty lines, and FS will then always implicitly include "\n".
nawk only honors first character of RS
BusyBox and gawk permit RS to be a regex, and set RT to the actual terminating text (will be "" at EOF):
awk -v 'RS=[\t\n]' 'BEGIN {ORS=""} {print $0 RT} END {print "\n"}'
awk -v 'RS=oldpat' -v 'ORS=newtext' '{ if (RT=="") printf "%s", $0 # EOF
else print }' # print text between matches
gawk --traditional still honors regex RS, but doesn't set RT
BusyBox permits FS to have 0-length matches:
echo aaba|awk -F 'b*' '{print NF}' # yields 5

ORS Output record separator (defaults to newline)

NF Number of fields in current record
gawk and BusyBox recalculate $0 when NF is either increased or decreased (in latter case, fields are discarded); nawk does neither.
FS Field separator (defaults to a space)
POSIX requires that assigning a new value to FS has no effect on the current input line; it only affects the next input line.
Only gawk conforms; BusyBox and FreeBSD awk will also use the new FS for current line if no fields have yet been referenced.
FS=space (default): strips leading and trailing space/tabs, fields are separated by spans of space/tabs/newlines (in gawk --posix, only spans of
spaces/tabs)
FS=":" or "\t": each occurrence of the char separates another field
FS="pat": separator is leftmost longest non-null and non-overlapping match of pattern
FS="" (gawk and BusyBox only): do character-wise splitting
They also accept "" and // as args to split (latter can't be assigned as value to FS)
When splitting on //, BusyBox generates an additional empty field
All my gawks permit sub(//,...) and gsub(//,...): matches each inter-character position, starting before first char
OFS Output field separator (defaults to a space)

SUBSEP Separator character for array subscripts (\034)

OFMT Output format for numbers (%.6g)
CONVFMT String conversion format for numbers (%.6g).
used for comparisons and array indexing, defaults to whatever value OFMT has
integer strings are always converted using "%d"
results are unspecified if CONVFMT isn't a floating-point format spec

RSTART First position in the string matched by match() function
RLENGTH Length of the string matched by match() function

IGNORECASE=1 in gawk and BusyBox only
Affects all pattern-matching and string comparison/indexing; doesn't affect array indexing

</nowiki></div>

== Gawk-only extensions ==
{{Draft|}}

<div style="white-space:pre; font-family:monospace;"><nowiki>

Some versions of gawk have:
switch (expression) {
case value|regex : statement
...
[ default: statement ]
}

Only gawk supports FIELDWIDTHS="2 4 2" # use FS=FS to revert to regular field-splitting
Only some versions of gawk support FPAT="a pat that every field satisfies" # use FS=FS to revert to regular field-splitting
also patsplit("string",larray,[pat=FPAT,lsep])
Only gawk has PROCINFO array, with fields:
version:3.1.8
pid:17171
ppid:17139
pgrpid:17171
uid:0
euid:0
gid:0
egid:0
group1:0 # group1..groupn are supplementary groups
FS:FS or FIELDWIDTHS or FPAT
[strftime]
[sorted_in]
Only some versions of gawk permit calling functions indirectly: ...funcname="foo"; @funcname(1,2)...

Only gawk has:
asort(a, [a.backup]) ~~> nelems, string "10" sorts lexicographically but numeric 10 sorts arithmetically
asorti(a, [a.backup]) ~~> nelems, this discards original values and sorts the original keys lexicographically
strtonum("string") # more portably, use "string"+0
isarray(a) in gawk4

command-or-socket |& getline # co-process
print ... |& command-or-socket

The following special filenames may be used with the |& co-process operator for creating TCP/IP network connections:
/inet{,4,6}/tcp/lport/rhost/rport
Files for a TCP/IP connection on local port lport to remote host
rhost on remote port rport. Use a port of 0 to have the system
pick a port. Use /inet4 to force an IPv4 connection, and /inet6
to force an IPv6 connection. Plain /inet uses the system
default (most likely IPv4).
/inet{,4,6}/udp/lport/rhost/rport
Similar, but use UDP/IP instead of TCP/IP.

optional second argument to the close() function.
ability to use positional specifiers with printf and sprintf().
Localizable strings. The bindtextdomain(), dcgettext(), dcngettext() functions.
BINMODE, LINT, TEXTDOMAIN
adding new built-in functions dynamically with the extension() function.

</nowiki></div>

== Useful links ==

These links may also be of interest:

* https://www.pement.org/awk/awk1line.txt
* https://www.catonmat.net/series/awk-one-liners-explained
* http://awk.freeshell.org/HomePage
* http://awk.freeshell.org/AwkFeatureComparison

== Awk and Lua ==

See [[Regex#Regex_in_Lua|summary of Lua regex]].

Commands <span style="color:brown">in brown</span> are from [https://github.com/dubiousjim/awkenough awkenough].

{| border="1"
! width=50% | in lua || in awk
|- valign=top
|<code>string.find(str, pattern, [startpos])</code> --> (start,stop) or nil

|<code>match(str, pat)</code> --> returns and sets RSTART, also sets RLENGTH <br />
<code>index(str, needle)</code> --> start or 0 <br />
<code style="color:brown">nthindex(str, needle, [nth=1, permits -1])</code> --> start or 0
|- valign=top
|<code>string.match(str, pattern, [start=1])</code> --> (%0) or nil or (%1,%2,...) 

|<code style="color:brown">matchstr(str, pat, [nth=1])</code> --> \\0, sets RSTART and RLENGTH <br />
gawk's <code>match</code> only matches nth=1; it returns RSTART and fills a third array argument with 0,0start,0length,1,1start...
|- valign=top
|<code>string.gmatch(str, pattern)</code> --> an iterator over all matches or sets of matching groups <br />
The iteration sequence will look like: (%0), (%0), (%0) ...; or like: (%1,%2...), (%1,%2...),... <br />
With this function, one can't specify the position to start matching.
|<code style="color:brown">gmatch(str, pat, MATCHES, STARTS)</code> --> nmatches
|- valign=top
|<code>string.gsub(str, pattern, replacement, [max#repls])</code> --> (newstr,nrepls)

|<code>gensub(pat, repl, nth/"g", str)</code>: is closest to Lua's gsub <br />
<code>sub(pat, repl, str)</code>: mutate first match in str <br />
<code>gsub(pat, repl, str)</code>: mutate all matches in str
|-
|<code>string:len</code>
|<code>length(str)</code>
|-
|<code>string:lower</code> <br />
<code>string:upper</code>
|<code>tolower</code> <br />
<code>toupper</code>
|-
|<code>string.rep(str, count,[5.2 adds sep])</code>
|<code style="color:brown">rep(str,count,[sep])</code>
|- valign=top
|<code>string.sub(str, start,[stop])</code>

|<code>substr(str,start,[len])</code> <br />
<code style="color:brown">has_prefix</code> <br />
<code style="color:brown">has_suffix</code>
|- valign=top
|
|<code>split(str,ITEMS,[seppat],[gawk's SEPS])</code> --> nitems <br />
<code style="color:brown">gsplit(str,ITEMS,[seppat],[SEPS])</code> --> nitems <br />
<code style="color:brown">asplit(str, PAIRS, ["="], [" "])</code> --> nitems
|- valign=top
|<code>table.concat(tbl,[sep],[start],[stop])</code> --> string
|<code style="color:brown">concat([start=1], [len=to_end], [fs=OFS], [A])</code> --> string <br />
if you want to preserve existing FS, need to use <code>gsplit</code> <br />
to concat an array without specifying len: <code>concat(start, <var>uninitialized</var>, OFS, A)</code>
|- valign=top
|<code>string:reverse</code>
|<code style="color:brown">reverse([A])</code>
|- valign=top
|<code>table.remove(tbl, [pos=from end])</code> --> value formerly at tbl[pos]

|<code style="color:brown">pop([start=from_end], [len=to_end], [A])</code> --> values sep by SUBSEP
|- valign=top
|<code>table.insert(tbl,[valpos=insert at end],value)</code> --> nil

|<code style="color:brown">insert(value, [start=after_end], [A])</code> --> new length of array <br />
<code style="color:brown">extend(VALS, [start=after_end], [A])</code> --> new length of array

|- valign=top
|<code>table.sort(tbl, [lessthan])</code>
|<code style="color:brown">sort(A)</code> <br />
<code style="color:brown">hsort(A)</code> <br />
<code style="color:brown">qsort(A, 1, length(A))</code>
|-
|
|<code style="color:brown">isempty(A)</code> <br />
<code style="color:brown">has_value(A, value)</code>
|-
|

|<code style="color:brown">includes(A, B, [onlykeys?])</code>: is B <= A? <br />
<code style="color:brown">union(A, B, [conflicts])</code> --> mutates A <br />
<code style="color:brown">intersect(A, B, [conflicts])</code> --> mutates A <br />
<code style="color:brown">subtract(A, B, [conflicts])</code> --> mutates A 

|}



[[Category:Shell]] [[Category:Lua]]

Alpine Linux:Overview

2024-10-19T00:22:26Z

Dubiousjim: /* Technical overview */ restored some older material that got garbled in 2019 edits, revised section for clarity

Alpine uses [https://musl.libc.org/ musl] as its libc, and [https://en.wikipedia.org/wiki/BusyBox BusyBox] as core utilities. These choices tend to make Alpine especially minimalist and secure.

== General overview ==

Alpine Linux has one of the '''fastest boot times''' of any operating system.

It's famous because of its small size and it's '''heavily used in containers'''.

It's also well known for '''wide use in embedded devices''' and as a '''base system for many enterprise routers'''.

The postmarketOS project, which is designed to run on mobile devices, is based on Alpine Linux.

=== Distinctive ===

Alpine Linux follows the principles of '''the SSS distro: Simple+Small+Secure''': due to usage of [https://musl.libc.org/ muslc] as the minimalist libc, BusyBox simple coreutils (with possibilities to alternate on inflated original packages of each coreutils tools also) and userland binaries compiled as Position Independent Executables (PIE) with stack smashing protection.

=== Efficient ===

Some main reasons:

# Usage of [https://musl.libc.org/ musl] as the minimalist libc
# Its own package manager called [[Alpine Package Keeper|apk]],
# The {{Pkg|openrc}} init system, script driven set-ups and that’s it!
# {{Pkg|busybox}}: simple coreutils (with possibilities to alternate on inflated original packages of each coreutils tools also)

This provides you with a simple, '''crystal-clear Linux environment without all the noise''', nothing else will get in the way.

=== Secure ===

All userland binaries are compiled as Position Independent Executables (PIE) with stack smashing protection.

== Technical overview ==

<ol>
<li>'''Architectures'''

<p>Alpine uses '''Linux''' as [https://www.kernel.org/ OS kernel], and has a focus on '''SSS distribution, Simple Small and Secure'''</p>

<p>A variety of architectures are officially supported:
* '''x86_64''': The popular AMD64 compatible 64-bit x86 based machines, i386 are not recommended for newer/latest hardware.
* '''x86''': (i386 pc 32bit) and x86_64 (i686 pc 64bit and amd64)
* '''armhf''': The newer ARM hard-float for newer, more powerful 32-bit devices alongside 64-bit
* '''armv7''': The 32-bit ARM only execution state of the ARMv7 devices machines.
* '''aarch64''': The 64-bit ARM only execution state of the ARMv8 device machines.
* '''ppc64le''': For 64-bit PowerPC devices with pure little-endian mode, mostly for POWER8 and POWER9.
* '''s390x''': For IBM Z mainframes, especially IBM Z and IBM LinuxONE.

</li><li>'''Installing'''

<p>Alpine can be installed to a hard disk/SSD/other storage medium like any other distro (this is called '''sys mode'''). The storage medium in question can be any block device (USB, Flash, SDD, HDD). It can be removable, so long as you can configure your machine to boot from it. But if you're working with removable media, you might prefer one of the other installation modes.</p>

<p>In each of these modes, you boot your machine from a static image. You will also need a writable medium to save updates to the system. In '''diskless mode''', that medium is usually a small USB key (or a partition on one) that holds the changes you want to persist. Both the base Alpine system and all your changes will be unpacked into a memory-based filesystem.</p>

<p>The other, '''data''' mode is for when you're dealing with a large amount of persisting data, that you want to keep on a hard disk/SSD/other storage medium, rather than unpacking into memory. The default setup here is to store your {{Path|/var}} partition directly on the hard storage medium. But as in the '''diskless''' mode, your root system still comes from a static ISO image.</p>

<p>These second and third installation modes are sometimes referred to, collectively, as "run-from-RAM" installations.</p>

<p>Key to these installation modes is Alpine's [[Alpine local backup|lbu]] utility. This tracks which files you've modified from their static ISO version, and want the changes to persist. The lbu utility saves those changes in {{Path|.apkovl}} "overlay" files. (These are essentially tar-gzip archives, though they can also be encrypted. You can use the lbu utility with the '''sys''' mode, too, if you like: as a form of backup, or to configure overlay files for other systems. But for a robust incremental backup system, you'll probably want a more specialized tool, such as {{Pkg|rsnapshot}}.)</p>

<p>The lbu utility is part of the {{Pkg|alpine-conf}} package, which is required by {{Pkg|alpine-base}}.</p>

<p>'''Alpine's installer''' consists of '''the {{Path|/sbin/setup-*}} scripts''', which are also part of the {{Pkg|alpine-conf}} package.

</p><p>'''A base Alpine install will include only needed packages''' such like {{Pkg|alpine-base}}, {{Pkg|syslinux}}, {{Pkg|linux-lts}} (or another kernel package), and depending on your purposes packages like {{Pkg|openssh}} and/or {{Pkg|chrony}}.

</p><p>Alpine's boot loader in that case is {{Pkg|syslinux}}, or its companions <code>isolinux</code> or <code>extlinux</code>. The latest releases also have Grub and [[Alpine and UEFI|UEFI support]].</p>

</li><li>'''The init system'''

<p>An "init system" includes several different components. First, there is the initramfs, which is loaded by the bootloader. Alpine's tool for generating the initramfs is {{Path|/sbin/mkinitfs}}, part of the {{Pkg|mkinitfs}} package, which is required by Alpine's kernel packages and by its {{Pkg|syslinux}} package. This tool's settings are read from {{Path|/etc/mkinitfs/*}}, and it installs the initscript {{Path|/usr/share/mkinitfs/initramfs-init}} into the initramfs.

</p><p>Second, Alpine uses [[Alpine Linux Init System|OpenRC]] to handle the rest of its initscripts. The base framework of this is in the {{Pkg|openrc}} package, which is required by {{Pkg|alpine-conf}}.
</p>

</li><li>'''The packaging and development system'''

<p>The last important distinguishing feature of a Linux distro is its packaging and development systems.

</p><p>In Alpine's case, these are something a hybrid between [https://www.archlinux.org/ ArchLinux]'s, on the one hand, and [https://www.gentoo.org/ Gentoo] and [https://www.freebsd.org/ FreeBSD]'s, on the other. Our package-management and build utilities work much like Arch's:

* {{Pkg|mkinitfs}}, mentioned above, rebuilds Alpine's initramfs, like Arch's "mkinitcpio"
* '''apk''' from {{Pkg|apk-tools}} is Alpine's package manager, like Arch's "pacman"; see [[Alpine Linux package management]]
* {{Pkg|abuild}} is Alpine's build utility, like Arch's "makepkg"; see [[Abuild and Helpers]]
* Alpine's package-building scripts are named APKBUILD, like Arch's "PKGBUILD"

</p><p>What Alpine borrows from Gentoo and FreeBSD is a tree of all the package-building scripts. It is called the [[Aports tree]], and is kept as a single git repository. (Compare Gentoo's "Portage" and FreeBSD's "ports". Something similar can be set up with Arch's "abs", but it's not as tightly integrated with their package manager and build utilities.)

</p><p>If you're only planning to install packages on a given system, and not do any development there, then the only pieces of this you'll need are {{Pkg|mkinitfs}} and {{Pkg|apk-tools}}, both included in a base Alpine install. If you do plan to do development, install {{Pkg|alpine-sdk}}, which includes gcc, git, abuild, and the like, and see [[Developer Documentation]].
</p>

</li></ol>

= See Also =

* [[Comparison with other distros]]
* [[Tutorials and Howtos]]

[[Category:Installation]]

Alpine Linux:Overview

2024-06-14T20:48:12Z

Dubiousjim: /* Technical overview */ grammer fix

Alpine uses [https://musl.libc.org/ musl] as its libc, and [https://en.wikipedia.org/wiki/BusyBox BusyBox] as core utilities. These choices tend to make Alpine especially minimalist and secure.

== General overview ==

Alpine Linux has one of the '''fastest boot times''' of any operating system.

It's famous because of its small size and it's '''heavily used in containers'''.

It's also well known for '''wide use in embedded devices''' and as a '''base system for many enterprise routers'''.

The postmarketOS project, which is designed to run on mobile devices, is based on Alpine Linux.

=== Distinctive ===

Alpine Linux follows the principles of '''the SSS distro: Simple+Small+Secure''': due to usage of [https://musl.libc.org/ muslc] as the minimalist libc, BusyBox simple coreutils (with possibilities to alternate on inflated original packages of each coreutils tools also) and userland binaries compiled as Position Independent Executables (PIE) with stack smashing protection.

=== Efficient ===

Some main reasons:

# Usage of [https://musl.libc.org/ musl] as the minimalist libc
# Its own package manager called [[Alpine Package Keeper|apk]],
# The {{Pkg|openrc}} init system, script driven set-ups and that’s it!
# {{Pkg|busybox}}: simple coreutils (with possibilities to alternate on inflated original packages of each coreutils tools also)

This provides you with a simple, '''crystal-clear Linux environment without all the noise''', nothing else will get in the way.

=== Secure ===

All userland binaries are compiled as Position Independent Executables (PIE) with stack smashing protection.

== Technical overview ==

<ol>
</li><li>'''The OS design'''

<p>Alpine uses '''Linux''' as [https://www.kernel.org/ OS kernel], and has a focus on '''SSS distribution, Simple Small and Secure'''</p>

<p>A variety of architectures are officially supported:
* '''x86_64''': The popular AMD64 compatible 64-bit x86 based machines, i386 are not recommended for newer/latest hardware.
* '''x86''': (i386 pc 32bit) and x86_64 (i686 pc 64bit and amd64)
* '''armhf''': The newer ARM hard-float for newer, more powerful 32-bit devices alongside 64-bit
* '''armv7''': The 32-bit ARM only execution state of the ARMv7 devices machines.
* '''aarch64''': The 64-bit ARM only execution state of the ARMv8 device machines.
* '''ppc64le''': For 64-bit PowerPC devices with pure little-endian mode, mostly for POWER8 and POWER9.
* '''s390x''': For IBM Z mainframes, especially IBM Z and IBM LinuxONE.

<p>Alpine can be installed to a hard disk/SSD/other storage medium like any other distro; (sys mode). The storage medium in question can be any block device (USB, Flash, SDD, HDD). Always in start, the base Alpine system and all your changes will be unpacked into a memory-based filesystem. If run some install script process (data mode) will keep your setup on a hard disk/SSD/other storage medium, rather than unpacking into memory. The default setup here is to store your /var partition directly on the hard storage medium. But as in the diskless mode, your root system still comes from a static ISO image.
</p>

</li><li>'''The installation'''

<p>In Alpine's case, '''the installer consists of the {{Path|/sbin/setup-*}} scripts''', which are also part of the {{Pkg|alpine-conf}} package.

</p><p>'''A base Alpine install will include only needed packages''' such like {{Pkg|alpine-base}}, {{Pkg|syslinux}}, {{Pkg|linux-lts}} (or another kernel package), and depending of purpose some like {{Pkg|openssh}}/{{Pkg|chrony}}.

</p><p>Alpine's boot loader case this is {{Pkg|syslinux}}, or its companions <code>isolinux</code> or <code>extlinux</code>. Latest releases have Grub and [[Alpine and UEFI|UEFI support]].</p>

</li><li>'''The init system'''

<p>An "init system" includes several different components. First, there is the initramfs, which is loaded by the bootloader. Alpine's tool for generating the initramfs is {{Path|/sbin/mkinitfs}}, part of the {{Pkg|mkinitfs}} package, which is required by Alpine's kernel packages and by its {{Pkg|syslinux}} package. This tool's settings are read from {{Path|/etc/mkinitfs/*}}, and it installs the initscript {{Path|/usr/share/mkinitfs/initramfs-init}} into the initramfs.

</p><p>Second, Alpine uses [[Alpine Linux Init System|OpenRC]] to handle the rest of its initscripts. The base framework of this is in the {{Pkg|openrc}} package, which is required by {{Pkg|alpine-conf}}.
</p>

</li><li>'''The packaging and development system'''

<p>The last important distinguishing feature of a Linux distro is its packaging and development systems.

</p><p>In Alpine's case, these are something a hybrid between [https://www.archlinux.org/ ArchLinux]'s, on the one hand, and [https://www.gentoo.org/ Gentoo] and [https://www.freebsd.org/ FreeBSD]'s, on the other. Our package-management and build utilities work much like Arch's:

* {{Pkg|mkinitfs}}, mentioned above, rebuilds Alpine's initramfs, like Arch's "mkinitcpio"
* '''apk''' from {{Pkg|apk-tools}} is Alpine's package manager, like Arch's "pacman"; see [[Alpine Linux package management]]
* {{Pkg|abuild}} is Alpine's build utility, like Arch's "makepkg"; see [[Abuild and Helpers]]
* Alpine's package-building scripts are named APKBUILD, like Arch's "PKGBUILD"

</p><p>What Alpine borrows from Gentoo and FreeBSD is a tree of all the package-building scripts. It is called the [[Aports tree]], and is kept as a single git repository. (Compare Gentoo's "Portage" and FreeBSD's "ports". Something similar can be set up with Arch's "abs", but it's not as tightly integrated with their package manager and build utilities.)

</p><p>If you're only planning to install packages on a given system, and not do any development there, then the only pieces of this you'll need are {{Pkg|mkinitfs}} and {{Pkg|apk-tools}}, both included in a base Alpine install. If you do plan to do development, install {{Pkg|alpine-sdk}}, which includes gcc, git, abuild, and the like, and see [[Developer Documentation]].
</p>

</li></ol>

= See Also =

* [[Comparison with other distros]]
* [[Tutorials and Howtos]]

[[Category:Installation]]

User:Dubiousjim

2024-06-13T09:41:58Z

Dubiousjim: Fix musl-cross

__NOTOC__

* Wiki [https://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [https://bugs.alpinelinux.org/my my] [https://bugs.alpinelinux.org/?query_id=15 all/open]  [https://bugs.alpinelinux.org/?query_id=14 watched] [https://bugs.alpinelinux.org/?query_id=13 watched/open] [https://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [https://git.alpinelinux.org/cgit/aports aports] [https://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[https://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [https://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [https://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [https://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [https://lists.alpinelinux.org/~alpine/devel alpine-devel] [https://lists.alpinelinux.org/~alpine/users alpine-users]  [[Project:Mailing_lists|info]] | [[Project:IRC|IRC channels]] [https://dev.alpinelinux.org/irclogs/ logs]

* [https://musl.libc.org/ musl] [https://wiki.musl-libc.org/faq.html FAQ] [https://wiki.musl-libc.org/faq.html Wiki_FAQ] [https://musl.libc.org/doc/1.0.0/manual.html Manual] [https://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [https://wiki.musl-libc.org/wiki/Compatibility Compatibility] [https://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [https://www.etalabs.net/compare_libcs.html comparisons]
*: [https://wiki.musl-libc.org/wiki/Getting_started Start] [https://wiki.musl-libc.org/wiki/Design_Concepts design] [https://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [https://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [https://git.musl-libc.org/cgit/musl/tree git] [https://wiki.musl-libc.org/wiki/Open_Issues issues] [https://wiki.musl-libc.org/wiki/Roadmap roadmap] [https://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums] (end-of-life [https://grsecurity.net/announce.php 1] [https://grsecurity.net/passing_the_baton_faq.php 2])
* [https://busybox.net/ BusyBox] [https://www.busybox.net/downloads/BusyBox.html man]
* [https://uclibc.org/ uClibc]
* [https://github.com/musl-cross/musl-cross musl-cross] [https://github.com/richfelker/musl-cross-make musl-cross-make] [https://buildroot.uclibc.org/ Buildroot] [https://crosstool-ng.github.io/ Crosstool-NG]
* [https://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]
* [[Migrating data]]
* [[Upgrading Alpine]]
* [https://docs.alpinelinux.org/ Alpine User Handbook]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] https://web.archive.org/web/20130412155218/http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** Verify install documentation <small>(formerly issue 595)</small>
** Document the different installation types <small>(formerly issue 594)</small>
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** Document ro/rw media for CF/usb <small>(formerly issue 601)</small>
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2023-05-08T19:38:38Z

Dubiousjim: Add more links (Upgrading, Alpine User Handbook)

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[http://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums] (end-of-life [https://grsecurity.net/announce.php 1] [https://grsecurity.net/passing_the_baton_faq.php 2])
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]
* [[Migrating data]]
* [[Upgrading Alpine]]
* [https://docs.alpinelinux.org/ Alpine User Handbook]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2023-05-08T19:30:22Z

Dubiousjim: Add Migrating data

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[http://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums] (end-of-life [https://grsecurity.net/announce.php 1] [https://grsecurity.net/passing_the_baton_faq.php 2])
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]
* [[Migrating data]]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Talk:EyeOS

2017-06-24T04:05:24Z

Dubiousjim: response

I wanted to update this page because the URLs are no longer valid.

Also, you forget to mention that MySQL needs to be installed, along with the PHP packages for it and for zlib.

I have a screenshot that I can submit, I just installed this today (22 Jun 2017), so it works.
It's not the greatest desktop, however and the application is no longer supported by its original developers.

: This is all useful info; go ahead and work it into the main page. -- [[User:Dubiousjim|Dubiousjim]] ([[User talk:Dubiousjim|talk]]) 04:05, 24 June 2017 (UTC)

Alpine Linux:Releases

2017-06-19T19:18:12Z

Dubiousjim: Remove two duplicates

There are several releases of Alpine Linux available at the same time. There is no fixed release cycle but rather every 6 month we make a snapshot of '''[[Edge|edge]]''' and make a release. We support each stable release for a certain time, normally for 2 years. We can do security fixes beyond that on request and when patches are available.

The latest release of Alpine Linux is: '''3.6.2''' [https://alpinelinux.org/posts/Alpine-3.6.2-released.html Release notes], [http://git.alpinelinux.org/cgit/aports/log/?h=v3.6.2 git log]

{| cellpadding="5" border="1" class="wikitable"
|-
! Branch
! Branch Date
! Latest Release
! Previous minor releases
! Directory name
! Updates
! End of Support
|-
| '''[[edge]]'''
| current
| rolling
| -
| [http://nl.alpinelinux.org/alpine/edge/ edge]
| development
| n/a
|-
| '''v3.6'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.6-stable 2017-05-24]
| [http://alpinelinux.org/posts/Alpine-3.6.2-released.html 3.6.2]
| [http://alpinelinux.org/posts/Alpine-3.6.0-released.html 3.6.0], [http://alpinelinux.org/posts/Alpine-3.6.1-released.html 3.6.1]
| [http://dl-cdn.alpinelinux.org/alpine/v3.6/ v3.6]
| bug fixes
| <span style="color: green;">2019-05-01</span>
|-
| '''v3.5'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.5-stable 2016-12-22]
| [http://alpinelinux.org/posts/Alpine-3.5.2-released.html 3.5.2]
| [http://alpinelinux.org/posts/Alpine-3.5.0-released.html 3.5.0], [http://alpinelinux.org/posts/Alpine-3.5.1-released.html 3.5.1]
| [http://dl-cdn.alpinelinux.org/alpine/v3.5/ v3.5]
| bug fixes
| <span style="color: green;">2018-11-01</span>
|-
| '''v3.4'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.4-stable 2016-05-31]
| [http://alpinelinux.org/posts/Alpine-3.4.6-released.html 3.4.6]
| [http://alpinelinux.org/posts/Alpine-3.4.0-released.html 3.4.0], [http://alpinelinux.org/posts/Alpine-3.4.1-released.html 3.4.1], [http://alpinelinux.org/posts/Alpine-3.4.2-released.html 3.4.2], [http://alpinelinux.org/posts/Alpine-3.4.3-released.html 3.4.3], [http://alpinelinux.org/posts/Alpine-3.4.4-released.html 3.4.4], [http://alpinelinux.org/posts/Alpine-3.4.5-released.html 3.4.5]
| [http://dl-cdn.alpinelinux.org/alpine/v3.4/ v3.4]
| security only
| <span style="color: green;">2018-05-01</span>
|-
| '''v3.3'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.3-stable 2016-01-06]
| [http://alpinelinux.org/posts/Alpine-3.3.3-released.html 3.3.3]
| [http://alpinelinux.org/posts/Alpine-3.3.0-released.html 3.3.0], [http://alpinelinux.org/posts/Alpine-3.3.1-released.html 3.3.1], [http://alpinelinux.org/posts/Alpine-3.3.2-released.html 3.3.2]
| [http://nl.alpinelinux.org/alpine/v3.3/ v3.3]
| security only
| <span style="color: orange;">2017-11-01</span>
|-
| '''v3.2'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.2-stable 2015-05-26]
| [http://alpinelinux.org/posts/Alpine-3.2.3-released.html 3.2.3]
| [http://alpinelinux.org/posts/Alpine-3.2.0-released.html 3.2.0], [http://alpinelinux.org/posts/Alpine-3.2.1-released.html 3.2.1], [http://alpinelinux.org/posts/Alpine-3.2.2-released.html 3.2.2]
| [http://nl.alpinelinux.org/alpine/v3.2/ v3.2]
| on request only
| <span style="color: red;">2017-05-01</span>
|-
| '''v3.1'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.1-stable 2014-12-10]
| [http://alpinelinux.org/posts/Alpine-3.1.4-released.html 3.1.4]
| [http://alpinelinux.org/release-3.1.0 3.1.0], [http://alpinelinux.org/release-3.1.1 3.1.1], [http://alpinelinux.org/posts/Alpine-3.1.2-released.html 3.1.2], [http://alpinelinux.org/posts/Alpine-3.1.3-released.html 3.1.3]
| [http://nl.alpinelinux.org/alpine/v3.1/ v3.1]
| on request only
| <span style="color: red;">2016-11-01</span>
|-
| '''v3.0'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=3.0-stable 2014-06-04]
| [http://alpinelinux.org/release-3.0.6 3.0.6]
| [http://alpinelinux.org/release-3.0.0 3.0.0], [http://alpinelinux.org/release-3.0.1 3.0.1], [http://alpinelinux.org/release-3.0.2 3.0.2], [http://alpinelinux.org/release-3.0.3 3.0.3], [http://alpinelinux.org/release-3.0.4 3.0.4], [http://alpinelinux.org/release-3.0.5 3.0.5]
| [http://nl.alpinelinux.org/alpine/v3.0/ v3.0]
| on request only
| <span style="color: red;">2016-05-01</span>
|-
| '''v2.7'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.7-stable 2013-11-08]
| [http://alpinelinux.org/release-2.7.9 2.7.9]
| [http://alpinelinux.org/release-2.7.0 2.7.0], [http://alpinelinux.org/release-2.7.1 2.7.1], [http://alpinelinux.org/release-2.7.2 2.7.2], [http://alpinelinux.org/release-2.7.3 2.7.3], [http://alpinelinux.org/release-2.7.4 2.7.4], [http://alpinelinux.org/release-2.7.5 2.7.5], [http://alpinelinux.org/release-2.7.6 2.7.6], [http://alpinelinux.org/release-2.7.7 2.7.7], [http://alpinelinux.org/release-2.7.8 2.7.8]
| [http://nl.alpinelinux.org/alpine/v2.7/ v2.7]
| on request only
| <span style="color: red;">2015-11-01</span>
|-
| '''v2.6'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.6-stable 2013-05-17]
| [http://alpinelinux.org/release-2.6.6 2.6.6]
| [http://alpinelinux.org/release-2.6.0 2.6.0], [http://alpinelinux.org/release-2.6.1 2.6.1], [http://alpinelinux.org/release-2.6.2 2.6.2], [http://alpinelinux.org/release-2.6.3 2.6.3], [http://alpinelinux.org/release-2.6.4 2.6.4], [http://alpinelinux.org/release-2.6.5 2.6.5]
| [http://nl.alpinelinux.org/alpine/v2.6/ v2.6]
| on request only
| <span style="color: red;">2015-05-01</span>
|-
| '''v2.5'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.5-stable 2012-11-07]
| [http://alpinelinux.org/release-2.5.4 2.5.4]
| [http://alpinelinux.org/release-2.5.0 2.5.0], [http://alpinelinux.org/release-2.5.1 2.5.1], [http://alpinelinux.org/release-2.5.2 2.5.2], [http://alpinelinux.org/release-2.5.3 2.5.3]
| [http://nl.alpinelinux.org/alpine/v2.5/ v2.5]
| on request only
| <span style="color: red;">2014-11-01</span>
|-
| '''v2.4'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.4-stable 2012-05-02]
| [http://alpinelinux.org/release-2.4.11 2.4.11]
| [http://alpinelinux.org/node/13811 2.4.0], [http://alpinelinux.org/node/13812 2.4.1], [http://alpinelinux.org/node/13845 2.4.2], [http://alpinelinux.org/node/13906 2.4.3], [http://alpinelinux.org/release-2.4.4 2.4.4], [http://alpinelinux.org/release-2.4.5 2.4.5], [http://alpinelinux.org/release-2.4.6 2.4.6], [http://alpinelinux.org/release-2.4.7 2.4.7], 2.4.8, [http://alpinelinux.org/node/14664 2.4.9], [http://alpinelinux.org/release-2.4.10 2.4.10]
| [http://nl.alpinelinux.org/alpine/v2.4/ v2.4]
| on request only
| <span style="color: red;">2014-05-01</span>
|-
| '''v2.3'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.3-stable 2011-11-01]
| [http://alpinelinux.org/node/13503 2.3.6]
| [http://alpinelinux.org/node/6841 2.3.0], [http://alpinelinux.org/node/6866 2.3.1], [http://alpinelinux.org/node/6911 2.3.2], [http://alpinelinux.org/node/6999 2.3.3], [http://alpinelinux.org/node/13466 2.3.4 & 2.3.5]
| [http://nl.alpinelinux.org/alpine/v2.3/ v2.3]
| on request only
| <span style="color: red;">2013-11-01</span>
|-
| '''v2.2'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.2-stable 2011-05-03]
| [http://alpinelinux.org/node/6455 2.2.3]
| [http://alpinelinux.org/node/5237 2.2.0], [http://lists.alpinelinux.org/alpine-devel/1618.html 2.2.1], [http://alpinelinux.org/node/5955 2.2.2]
| [http://nl.alpinelinux.org/alpine/v2.2/ v2.2]
| on request only
| <span style="color: red;">2013-05-01</span>
|-
| '''v2.1'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.1-stable 2010-11-01]
| [http://alpinelinux.org/node/5236 2.1.6]
| [[Release_Notes_for_Alpine_2.1.0|2.1.0]], [[Release_Notes_for_Alpine_2.1.1|2.1.1]], [[Release_Notes_for_Alpine_2.1.2|2.1.2]], [[Release_Notes_for_Alpine_2.1.3|2.1.3]], [http://alpinelinux.org/node/5230 2.1.4], [http://alpinelinux.org/node/5235 2.1.5]
| [http://nl.alpinelinux.org/alpine/v2.1/ v2.1]
| on request only
| <span style="color: red;">2012-11-01</span>
|-
| '''v2.0'''
| [http://git.alpinelinux.org/cgit/aports/log/?h=2.0-stable 2010-08-16]
| [http://wiki.alpinelinux.org/wiki/Release_Notes_for_Alpine_2.0.3 2.0.3]
| [[Release_Notes_for_Alpine_2.0.0|2.0.0]], [[Release_Notes_for_Alpine_2.0.1|2.0.1]], [[Release_Notes_for_Alpine_2.0.2|2.0.2]]
| [http://nl.alpinelinux.org/alpine/v2.0/ v2.0]
| on request only
| <span style="color: red;">2012-04-01</span>
|}

An archive for [[older releases]] is also available.

User:Dubiousjim

2017-06-08T10:33:14Z

Dubiousjim: More EOL

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[http://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums] (end-of-life [https://grsecurity.net/announce.php 1] [https://grsecurity.net/passing_the_baton_faq.php 2])
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2017-06-08T10:30:12Z

Dubiousjim: add grsec EOL

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[http://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums] ([https://grsecurity.net/passing_the_baton_faq.php EOL announcement])
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Alpine Linux:Mailing lists

2017-06-08T10:26:18Z

Dubiousjim: Update to match (and link to) community page on main site, demote specialist mailing lists and list inactive ones

'''[http://lists.alpinelinux.org/ Mailing List Archives]''' A Web listing of the mailing list archives in a searchable format. Since the mailing list is hosted on Alpine Linux, we are using [http://mlmmj.org/ mlmmj] for the mailing list, [http://www.hypermail-project.org/ hypermail] for translation into html and [http://swish-e.org/ swish-e] for search.

(Please don't [http://en.wikipedia.org/wiki/Top-posting top-post] to the list as it makes the archives more or less useless.)

See also https://alpinelinux.org/community/.

== Subscribing ==
Note: "<mailing-list>" can be any of the listed mailing lists below or at [http://lists.alpinelinux.org/ http://lists.alpinelinux.org/]
# Send an email to <mailing-list>+subscribe@lists.alpinelinux.org
# Wait for a reply from the <mailing-list>+help@lists.alpinelinux.org asking you to confirm your email address
# Send a reply to the given "Reply-To" address
# Receive a subscription confirmation from <mailing-list>+help@lists.alpinelinux.org with the subject line Welcome to <mailing-list>@lists.alpinelinux.org

== alpine-announce ==
Low-volume mailing list for release announcements (new versions of Alpine).
;Archives
:http://lists.alpinelinux.org/alpine-announce/
;Subscribe
:[mailto:alpine-announce+subscribe@lists.alpinelinux.org alpine-announce+subscribe@lists.alpinelinux.org]
;Unsubscribe
:[mailto:alpine-announce+unsubscribe@lists.alpinelinux.org alpine-announce+unsubscribe@lists.alpinelinux.org]
;Help
:[mailto:alpine-announce+help@lists.alpinelinux.org alpine-announce+help@lists.alpinelinux.org]

== alpine-user ==
Mailing list for general user support.
;Archives
:http://lists.alpinelinux.org/alpine-user/
;Subscribe
:[mailto:alpine-user+subscribe@lists.alpinelinux.org alpine-user+subscribe@lists.alpinelinux.org]
;Unsubscribe
:[mailto:alpine-user+unsubscribe@lists.alpinelinux.org alpine-user+unsubscribe@lists.alpinelinux.org]
;Help
:[mailto:alpine-user+help@lists.alpinelinux.org alpine-user+help@lists.alpinelinux.org]

== alpine-devel ==
Mailing list for Alpine Linux development.
;Archives
:http://lists.alpinelinux.org/alpine-devel/
;Subscribe
:[mailto:alpine-devel+subscribe@lists.alpinelinux.org alpine-devel+subscribe@lists.alpinelinux.org]
;Unsubscribe
:[mailto:alpine-devel+unsubscribe@lists.alpinelinux.org alpine-devel+unsubscribe@lists.alpinelinux.org]
;Help
:[mailto:alpine-devel+help@lists.alpinelinux.org alpine-devel+help@lists.alpinelinux.org]

== Other mailing lists ==

* [http://lists.alpinelinux.org/alpine-aports/ alpine-aports]
:Active mailing list with patches for packages (proposed for incorporating into aports package pools).

* [http://lists.alpinelinux.org/alpine-infra/ alpine-infra]
:Active mailing list discussing Alpine web infrastructure.

<div style="color:gray">

* [http://lists.alpinelinux.org/alpine-security/ alpine-security]
:Inactive mailing list.

* [http://lists.alpinelinux.org/alpine-acf/ alpine-acf]
:Inactive mailing list (only 3 messages since April 2013) about Alpine Configuration Framework.

* [http://lists.alpinelinux.org/alpine-build/ alpine-build]
:Inactive mailing list.

</div>

User:Dubiousjim

2017-06-07T21:52:04Z

Dubiousjim: add activity

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github] | <b>[http://bugs.alpinelinux.org/projects/alpine/activity activity]</b>
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Alpine Linux:Mirrors

2017-06-06T19:07:29Z

Dubiousjim: Add link

Please check the [http://rsync.alpinelinux.org/alpine/MIRRORS.txt mirror list] for details.

See also https://git.alpinelinux.org/cgit/aports/tree/main/alpine-mirrors/mirrors.yaml.

Porting GHC to Alpine

2017-06-05T07:46:33Z

Dubiousjim: mark as outdated

{{Obsolete|{{pkg|ghc}} is now available in aports; also these instructions target an older version of ghc (which is at [https://www.haskell.org/ghc/ v8.0.2 as of Jan 2017])}}

I wanted to port the [http://www.haskell.org/ghc/ Glasgow Haskell Compiler] to Alpine, and to do that, you need to start with some alreay-compiled GHC binary. So that means cross-compiling from some system where the binaries were already available.

After this is done once for each of Alpine's target architectures, other users can use those existing Alpine binaries to compile newer versions of GHC directly on Alpine, much more easily than is detailed below. (It does still take a long time.) But I am recording the steps necessary to port to Alpine in the first place, so that others can verify or reproduce my work. This may also help others porting GHC to other systems.

I assume anyone following these directions has already setup a cross-compiler targeting Alpine inside a chroot holding an existing Linux system where GHC binaries are available. These pages explain how to do that:

* [[Installing ArchLinux inside an Alpine chroot]]
* [[Cross-Compiler targeting Alpine]]

So here's how we use Arch's GHC to cross-compile a version of GHC we can run on Alpine:

<OL>
<LI><div>
In your '''outside Alpine system''', do this. I assume that <code>$ARCH_ROOT</code> contains the absolute path ''on your Alpine system'' of the Arch chroot's {{Path|/}}. I assume also that <code>$ARCH_HOME</code> contains the absolute path ''on your Arch system'' of the home directory of the non-root Arch user you'll be using to build GHC. (On the other hand, the plain <code>$ARCH</code> variable we set below indicates your machine architecture---nothing to do with ArchLinux.)

{{Cmd|<nowiki>sudo apk add paxctl libedit-dev libiconv-dev gmp-dev

mkdir -p $HOME/alien-scripts
ln -s $ARCH_ROOT/$ARCH_HOME/ghc-7.6.3 $HOME/ghc-7.6.3
mkdir /tmp/ghc-bootstrap $ARCH_ROOT/tmp/ghc-bootstrap
sudo mount --bind /tmp/ghc-bootstrap $ARCH_ROOT/tmp/ghc-bootstrap

case `uname -m` in
x86_64) ARCH=x86_64; T=$ARCH;;
i?86) ARCH=x86 T=i486;;
*) echo Unknown architecture;;
esac

mkdir -p $HOME/buildroot-$ARCH/host/usr/bin/
cat << "__EOF__" > $HOME/buildroot-$ARCH/host/usr/bin/$T-buildroot-linux-uclibc-gcc
#!/bin/sh
/usr/bin/gcc -nopie "$@"
__EOF__
chmod +x $HOME/buildroot-$ARCH/host/usr/bin/$T-buildroot-linux-uclibc-gcc
</nowiki>}}

</div>
<LI><div>
'''Inside the Arch chroot''', as the non-root user, do this:

{{Cmd|sudo pacman -S base-devel python2 wget ghc openssh
ssh-keygen
}}

You can give the ssh key a passphrase, but it's not necessary.

</div>
<LI><div>
Back in the '''outside Alpine system''', do this:

{{Cmd|<nowiki>cat $ARCH_ROOT/$ARCH_HOME/.ssh/id_rsa.pub >> $HOME/.ssh/authorized_keys
sudo paxctl -cm $ARCH_ROOT/usr/lib/ghc-7.6.3/ghc
</nowiki>}}

</div>
<LI><div>
Returning again to '''the Arch chroot''', do:

{{Cmd|eval `ssh-agent`
ssh-add}}

and unlock your ssh key if you gave it a passphrase. Now from this Arch session, we can do a password-less ssh or scp to the outside Alpine system.

</div>
<LI><div>
Still inside the Arch chroot, do:

{{Cmd|<nowiki>mkdir -p sources && cd sources

wget -N http://www.haskell.org/ghc/dist/7.6.3/ghc-7.6.3-src.tar.bz2
wget -N http://www.haskell.org/ghc/dist/7.6.3/ghc-7.6.3-testsuite.tar.bz2

mkdir -p patches/ghc/7.6.3 && cd patches/ghc/7.6.3
GIST_BASE=https://gist.github.com/dubiousjim/5607734/raw
wget -N $GIST_BASE/configure.patch
wget -N $GIST_BASE/libraries-configure.patch
wget -N $GIST_BASE/h_wcwidth.patch

cd $HOME/sources
cat << "__EOF__" > alien
#!/bin/sh
PORT=22 # change if you use different ssh port on your Alpine system
CMD=$2; shift 2
set -x
scp -P$PORT "$CMD" $USER@localhost:alien-scripts/ || exit 1
ssh -p$PORT $USER@localhost alien-scripts/"${CMD##*/}" "$@"
__EOF__
cat << "__EOF__" > alien-ghc
#!/bin/sh
PORT=22 # change if you use different ssh port on your Alpine system
set -x
ssh -p$PORT $USER@localhost "sh -c 'cd $PWD; $0.exe $*'"
__EOF__
chmod +x alien alien-ghc
</nowiki>}}

The two alien scripts assume that you're working with the same username on both the Alpine and Arch systems; if that's incorrect, then replace <code>$USER</code> with the relevant Alpine username. The alien-ghc script also assumes that you won't be working underneath any directories whose names need escaping for the shell.

</div>
<LI><div>
Still inside the Arch chroot, do this:

{{Cmd|<nowiki>cd
case `uname -m` in
x86_64) ARCH=x86_64; T=$ARCH;;
i?86) ARCH=x86 T=i486;;
*) echo Unknown architecture;;
esac

tar -xjf sources/ghc-7.6.3-src.tar.bz2
# next is optional, if you want to ...
# tar -xjf sources/ghc-7.6.3-testsuite.tar.bz2
BUILDROOT=$HOME/buildroot-$ARCH
export PATH=$HOME/python2-path:$PATH:$BUILDROOT/host/usr/bin
cd ghc-7.6.3
sed -e 's/^#BuildFlavour = unreg/BuildFlavour = unreg/' mk/build.mk.sample > mk/build.mk
patch -p1 -i $HOME/sources/patches/ghc/7.6.3/configure.patch
patch -p1 -i $HOME/sources/patches/ghc/7.6.3/libraries-configure.patch
patch -p1 -i $HOME/sources/patches/ghc/7.6.3/h_wcwidth.patch

./configure --prefix=/tmp/ghc-bootstrap \
--host=$T-buildroot-linux-uclibc \
--target=$T-buildroot-linux-uclibc \
--with-alien=$HOME/sources/alien 2>&1 | tee build.log

</nowiki>}}

The [http://hackage.haskell.org/trac/ghc/wiki/Building/CrossCompiling GHC wiki page on cross-compiling] seems to suggest that you should omit the <code>--host=...</code>, but if you compare the 7.6 and (at this point, pre-release) 7.7 GHC build system sources, you'll see that this is true (if at all) only post-7.6.

Continue with:
{{Cmd|<nowiki>make 2>&1 | tee -a build.log</nowiki>}}

</div>
<LI><div>
The build will eventually fail with this error message:

<pre>
".../buildroot-x86_64/host/usr/bin/x86_64-buildroot-linux-uclibc-gcc" -fno-stack-protector libraries/integer-gmp/cbits/mkGmpDerivedConstants.c -o libraries/integer-gmp/cbits/mkGmpDerivedConstants
libraries/integer-gmp/cbits/mkGmpDerivedConstants > libraries/integer-gmp/cbits/GmpDerivedConstants.h
/bin/sh: libraries/integer-gmp/cbits/mkGmpDerivedConstants: No such file or directory
make[1]: *** [libraries/integer-gmp/cbits/GmpDerivedConstants.h] Error 127
make[1]: *** Deleting file `libraries/integer-gmp/cbits/GmpDerivedConstants.h'
make: *** [all] Error 2
</pre>

Type this to continue:

{{Cmd|<nowiki>$HOME/sources/alien run libraries/integer-gmp/cbits/mkGmpDerivedConstants \
> libraries/integer-gmp/cbits/GmpDerivedConstants.h
make 2>&1 | tee -a build.log
</nowiki>}}

</div>
<LI><div>
A bit later, the build will again fail with this error message:

<pre>
HC [stage 1] libraries/base/dist-install/build/Foreign/C/Types.o

libraries/base/Foreign/C/Types.hs:162:25:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:162:215:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:162:290:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:162:398:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:162:470:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:162:548:
Not in scope: type constructor or class `HTYPE_FLOAT'

libraries/base/Foreign/C/Types.hs:164:27:
Not in scope: type constructor or class `HTYPE_DOUBLE'

libraries/base/Foreign/C/Types.hs:164:219:
Not in scope: type constructor or class `HTYPE_DOUBLE'

libraries/base/Foreign/C/Types.hs:164:295:
Not in scope: type constructor or class `HTYPE_DOUBLE'

libraries/base/Foreign/C/Types.hs:164:405:
Not in scope: type constructor or class `HTYPE_DOUBLE'

libraries/base/Foreign/C/Types.hs:164:478:
Not in scope: type constructor or class `HTYPE_DOUBLE'

libraries/base/Foreign/C/Types.hs:164:557:
Not in scope: type constructor or class `HTYPE_DOUBLE'
make[1]: *** [libraries/base/dist-install/build/Foreign/C/Types.o] Error 1
make: *** [all] Error 2
</pre>

Type this to continue:

{{Cmd|<nowiki>cat << __EOF__ >> libraries/base/include/HsBaseConfig.h
#define HTYPE_DOUBLE Double
#define HTYPE_FLOAT Float
__EOF__
make 2>&1 | tee -a build.log
</nowiki>}}

The {{Path|HsBaseConfig.h}} file is only generated during the build, so you can't make this change ahead
of time; you have to wait for the build to fail, make the change, and then reissue <code>make</code>.

</div>
<LI><div>

Finally, the build will fail a third time with this error:

<pre>
HC [stage 2] utils/ghctags/dist-install/build/Main.o
inplace/bin/ghc-stage2: line 7: .../ghc-7.6.3/inplace/lib/ghc-stage2: No such file or directory
make[1]: *** [utils/ghctags/dist-install/build/Main.o] Error 127
make: *** [all] Error 2
</pre>

Type this to continue:

{{Cmd|<nowiki>mv inplace/lib/ghc-stage2 inplace/lib/ghc-stage2.exe
cp $HOME/sources/alien-ghc inplace/lib/ghc-stage2
make 2>&1 | tee -a build.log
</nowiki>}}

</div>
<LI><div>

After this, the build should complete. We still have to do a bit of work to get it to install properly, though. Do this:

{{Cmd|<nowiki>mkdir -p /tmp/ghc-bootstrap/lib/ghc-7.6.3
mv ghc/stage2/build/tmp/ghc-stage2 /tmp/ghc-bootstrap/lib/ghc-7.6.3/ghc.exe
mv utils/ghc-pkg/dist-install/build/tmp/ghc-pkg /tmp/ghc-bootstrap/lib/ghc-7.6.3/ghc-pkg.exe
cp $HOME/sources/alien-ghc ghc/stage2/build/tmp/ghc-stage2
cp $HOME/sources/alien-ghc utils/ghc-pkg/dist-install/build/tmp/ghc-pkg
make install 2>&1 | tee -a build.log
</nowiki>}}

Once the installation finishes, clean up with:

{{Cmd|<nowiki>cd /tmp/ghc-bootstrap
mv lib/ghc-7.6.3/ghc.exe lib/ghc-7.6.3/ghc
mv lib/ghc-7.6.3/ghc-pkg.exe lib/ghc-7.6.3/ghc-pkg
for f in bin/*-buildroot-linux-uclibc-*; do mv $f bin/${f#*-uclibc-}; done
ln -sf ghc-7.6.3 bin/ghc
ln -sf ghc-pkg-7.6.3 bin/ghc-pkg
cd -
</nowiki>}}

</div>
<LI><div>

Now switch back to your '''outside Alpine system''' and do this:

{{Cmd|<nowiki>paxctl -cm /tmp/ghc-bootstrap/lib/ghc-7.6.3/ghc
sudo umount $ARCH_ROOT/tmp/ghc-bootstrap
sed -i -e 's|"C compiler command",.*|"C compiler command", "/usr/bin/gcc"),|' \
-e 's|"C compiler flags", "|"C compiler flags", " -nopie |' /tmp/ghc-bootstrap/lib/ghc-7.6.3/settings
rm -r $HOME/alien-scripts $HOME/buildroot-$ARCH
rm $HOME/ghc-7.6.3
</nowiki>}}

Now everything in your Alpine system is cleaned up, and you've got a working GHC installation in {{Path|/tmp/ghc-bootstrap}}, which the Alpine APKBUILD for ghc will recognize and use. You can delete the {{Path|$ARCH_HOME/ghc-7.6.3}} folder inside your Arch chroot now, and close that session.

</div>
</OL>

(I will prepare an Alpine APKBUILD for ghc, and arrange with the dev team how to make the initial binaries available, soon.)

[[Category:Development]]

User:Dubiousjim

2017-06-05T07:25:34Z

Dubiousjim: s/contents/which/

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 which]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2017-06-01T01:43:02Z

Dubiousjim: indent

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 contents]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
*: [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Help:Editing

2017-05-30T13:08:51Z

Dubiousjim: Use {{TOC right}}

{{TOC right}}
== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd><kbd></kbd> and <samp><samp></samp>
* <var><var></var> and <dfn><dfn></dfn>
* <cite><cite></cite>
* <q><q></q>

* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code>. Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

User:Dubiousjim

2017-05-30T13:05:54Z

Dubiousjim: /* Working */ add TOCs

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 contents]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
* [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]] [[Template:TOC left|TOC left]] [[Template:TOC right|TOC right]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Template:TOC right

2017-05-30T13:04:43Z

Dubiousjim: Improve example by actually using template

<noinclude>{{Template}}
{{TOC right}}<nowiki>Use {{TOC right}} in document to align TOC to the right, allowing text to float beside it.</nowiki>

</noinclude>{| cellspacing="0" cellpadding="0" style="clear: {{{clear|right}}}; margin-bottom: .5em; float: right; padding: .5em 0 .8em 1.4em; background: none; width: {{{width|{{{1|auto}}}}}};" {{ifn|{{{limit|}}}|class="toclimit-{{{limit}}}"}}
| __TOC__
|}

Template:TOC left

2017-05-30T13:03:30Z

Dubiousjim: Improve example by actually using template

<noinclude>{{Template}}
{{TOC left}}<nowiki>Use {{TOC left}} in document to align TOC to the left, allowing text to float beside it.</nowiki>

</noinclude>{| cellspacing="0" cellpadding="0" style="clear: {{{clear|left}}}; margin-bottom: .5em; float: left; padding: .5em 1.4em .8em 0; background: none; width: {{{width|{{{1|auto}}}}}};" {{ifn|{{{limit|}}}|class="toclimit-{{{limit}}}"}}
| __TOC__
|}

User:Dubiousjim

2017-05-30T13:00:56Z

Dubiousjim: /* Working */ tweak boxes

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 contents]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
* [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning|Warning]] [[Template:Note|Note]] [[Template:Tip|Tip]] [[Template:Todo|Todo]] [[Template:Box|Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2017-05-30T13:00:13Z

Dubiousjim: /* Working */ add Boxes

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 contents]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
* [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:Warning]] [[Template:Note]] [[Template:Tip]] [[Template:Todo]] [[Template:Box]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

User:Dubiousjim

2017-05-30T12:58:11Z

Dubiousjim: /* Working */ add Style

__NOTOC__

* Wiki [http://wiki.alpinelinux.org/w/index.php?title=Special:Watchlist&days=90&hideMinor=0&hideBots=0 watched] [[Project:Wiki maintenance|maintenance]] | [[Help:Editing|editing]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Bugs [http://bugs.alpinelinux.org/my my] [http://bugs.alpinelinux.org/?query_id=15 all/open]  [http://bugs.alpinelinux.org/?query_id=14 watched] [http://bugs.alpinelinux.org/?query_id=13 watched/open] [http://bugs.alpinelinux.org/projects/alpine/issues/new create]
* Git [http://git.alpinelinux.org/cgit/aports aports] [http://git.alpinelinux.org/ all] [https://github.com/alpinelinux/ github]
* Alpine [http://alpinelinux.org/ news]  [[Alpine Linux:Releases|releases]]  | [http://pkgs.alpinelinux.org/packages?name=&branch=edge&repo=&arch=x86_64&maintainer= packages] [http://pkgs.alpinelinux.org/contents?file=&path=&name=&branch=edge&repo=&arch=x86_64 contents]
* Lists [http://lists.alpinelinux.org/alpine-devel/ alpine-devel] [http://lists.alpinelinux.org/alpine-user/index.html alpine-user]  [[Project:Mailing_lists|info]] | [https://forum.alpinelinux.org/forum Forums] | [[Project:IRC|IRC channels]] [http://dev.alpinelinux.org/irclogs/ logs]

* [http://www.musl-libc.org/ musl] [http://www.musl-libc.org/faq.html FAQ] [http://wiki.musl-libc.org/wiki/FAQ Wiki_FAQ] [http://www.musl-libc.org/doc/1.0.0/manual.html Manual] [http://wiki.musl-libc.org/wiki/Environment_Variables env vars]
*: [http://wiki.musl-libc.org/wiki/Compatibility Compatibility] [http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc vs glibc] [http://www.etalabs.net/compare_libcs.html comparisons]
*: [http://wiki.musl-libc.org/wiki/Getting_started Start] [http://wiki.musl-libc.org/wiki/Design_Concepts design] [http://wiki.musl-libc.org/wiki/Guidelines_for_Distributions for distros] [http://wiki.musl-libc.org/wiki/Future_Ideas ideas]
* [http://git.musl-libc.org/cgit/musl/tree git] [http://wiki.musl-libc.org/wiki/Open_Issues issues] [http://wiki.musl-libc.org/wiki/Roadmap roadmap] [http://www.openwall.com/lists/musl/ mailing list]
* [https://grsecurity.net/features.php grsec] [https://en.wikibooks.org/wiki/Grsecurity wiki] [https://forums.grsecurity.net/ forums]
* [http://busybox.net/ BusyBox] [http://www.busybox.net/downloads/BusyBox.html man]
* [http://uclibc.org/ uClibc]
* [https://bitbucket.org/GregorR/musl-cross/ musl-cross] [http://buildroot.uclibc.org/ Buildroot] [http://crosstool-ng.org/ Crosstool-NG]
* [http://wiki.musl-libc.org/wiki/Alternative_libraries Lightweight libraries and programs]

== Working ==
* [https://git.alpinelinux.org/cgit/apk-tools/log apk-tools]
* [[Help:Editing|Editing]] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Markup_notes&action=edit Notes] [https://wiki.alpinelinux.org/w/index.php?title=User:Dubiousjim/Sandbox&action=edit Sandbox]

* [[Special:AllPages/Template:|Templates]]  ([[Help:Template|help]])
*: [[Template:Path|Path]] [[Template:Pkg|Pkg]] [[Template:Issue|Issue]] [[Template:Hint|Hint]] [[Template:Key|Key]]
*: [[Template:Cmd|Cmd]] [[Template:Cat|Cat]] [[Template:Define|Define]] [[Template:Clear|Clear]]
*: [[Template:Delete|Delete]] [[Template:Obsolete|Obsolete]] [[Template:Merge|Merge]] [[Template:Move|Move]] [[Template:Draft|Draft]] [[Template:Expand|Expand]] [[Template:Style|Style]]
*: [[Template:If|If]] [[Template:Ifn|Ifn]] [[Template:Ifz|Ifz]] [[Template:Ifeq|Ifeq]] [[Template:Deref|Deref]] [[Template:Month|Month]] [[Template:!|!]] [[Template:=|=]] [[Template:Lb|Lb]] [[Template:Rb|Rb]]
* [[Template:Codeline]] [http://en.gentoo-wiki.com/wiki/Template:Codeline Gentoo's] [https://wiki.archlinux.org/index.php/Template:Ic Arch's]

* Project [[Project:Overview|Overview]] | [[Comparison with other distros]] - [https://wiki.archlinux.org/index.php/Arch_Compared_to_Other_Distributions] [https://wiki.archlinux.org/index.php/Pacman_Rosetta]

* [[Alpine setup scripts]]
** {{Issue|595|Verify install documentation}}
** {{Issue|594|Document the different installation types}}
* [[Setting up disks manually]]
** {{Issue|749|setup-disk needs to be properly documented in wiki}}
** {{Issue|563|setup-disk should say if it can't find a hard drive}}
** {{Issue|601|Document ro/rw media for CF/usb}}
** {{Issue|497|in alpine 2.1.3 setup-disk on mounted directory does not create MBR}}

* [[Setting up a software raid array]]
* [[Setting up encrypted volumes with LUKS]]
* [[Setting up Logical Volumes with LVM]]
* [[Installing Alpine Linux in a chroot]]

* [[Installation]]
* [[User:Ncopa/Install_Handbook]]
* [[Template:Copying Alpine to Flash]]
* [[Installing Alpine on HDD dualbooting]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Upgrading_Alpine_-_v1.9.x|Upgrading Alpine]]
* [[Talk:Developer_Documentation]]

* [[User:Fab/Personal aports repo]]
* [[User:Mattx86/Alpine Fresh Installation]] (mostly outdated?)
* [[User:Mattx86/qwn:Install x86-2.1.5 and Upgrade to x86 64-edge]]
* [[User:Mattx86/qwn:Switching from Alpine Standard/Mini to Alpine VServer]]
* [[User:Mattx86/qwn:Renaming a network interface]]
* [[User:Mattx86/qwn:Enabling APK Caching]]

Help:Template

2017-05-30T11:25:11Z

Dubiousjim: Update note about ParserFunctions

This page is about designing templates more than using them. For details of how to use existing templates, see [[Help:Editing]] or the documentation for [[Special:AllPages/Template:|any template]].

== Including ==
To include a template---or any page---in another page:

* <code>{{lb}}T{{rb}}</code> includes [[Template:T]]
* <code>{{lb}}<b>:</b>Page name{{rb}}</code> includes [[Page name]]
* <code>{{lb}}subst:T{{rb}}</code> or <code>{{lb}}subst<b>::</b>Page name{{rb}}</code> are instead replaced by the current contents of [[Template:T]] or [[Page name]]
* <code>{{lb}}msgnw:T{{rb}}</code> includes [[Template:T]] in <code><nowiki></code> style

== If-templates ==
Templates have a limited condition-testing functionality. The following are based on code from the MediaWiki manuals:

<dl>
<dt>{{lb}}Ifn|<var>value</var>|<var>result</var>{{rb}}
<dd>
Yields <var>result</var> if <var>value</var> isn't blank.
(Compare shell's <code>if [ -n "value" ]; then result; fi</code>)
One limitation: {{lb}}ifn|2=<var>result</var>{{rb}} yields <var>result</var> (but works properly if <var>value</var> is defined and empty).

<dt>{{lb}}Ifz|<var>value</var>|<var>result</var>{{rb}}
<dd>
Yields <var>result</var> if <var>value</var> is blank.
(Compare shell's <code>if [ -z "value" ]; then result; fi</code>)

<dt>{{lb}}If|<var>value</var>|<var>resultyes</var>|<var>resultno</var>{{rb}}
<dd>
Yields <var>resultyes</var> if <var>value</var> isn't blank; otherwise it yields <var>resultno</var>.
(Compare shell's <code>if [ -n "value"]; then resultyes; else resultno; fi</code>)
One limitation: {{lb}}if|2=<var>resultyes</var>{{rb}} yields <var>resultyes</var> (but works properly if <var>value</var> is defined and empty, or <var>resultno</var> is defined).

<dt>{{lb}}Ifeq|<var>value</var>|<var>test</var>|<var>resultyes</var>|<var>resultno</var>{{rb}}
<dd>
Yields <var>resultyes</var> if <var>value</var> equals <var>test</var>; otherwise it yields <var>resultno</var>.
(Compare shell's <code>if ["value" = test ]; then resultyes; else resultno; fi</code>)
</dl>

Now that we've upgraded to MediaWiki >= 1.19.1, though (currently at 1.26.2), we <em>would</em> be able to use {{lb}}#if:<var>value</var>|<var>result</var>|<var>resultno</var>{{rb}} and {{lb}}#ifeq:<var>value</var>|<var>test</var>|<var>resultyes</var>|<var>resultno</var>{{rb}}, which don't suffer the above limitations. Here are [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions more details.] However, it seems that won't work until the ParserFunctions extension [[Special:Version|is enabled]].

== Template arguments ==

In the template's expansion markup, <code><nowiki>{{{</nowiki>1}}}</code> will expand to the first (implicitly named) argument, and <code><nowiki>{{{</nowiki>2|<var>default</var>}}}</code> will expand to the second but default to <var>default</var> if the second argument is not supplied. Note that if the template is invoked as <code>{{lb}}Foo|arg1|{{rb}}</code>, then the second argument ''has'' been supplied; here it's the empty string.

Arguments can also be explicitly named/numbered, as when you invoke <code>{{lb}}Foo|bar=arg1|2={{rb}}</code>. Arguments supplied in these ways have leading and trailing whitespace trimmed. (Whitespace is preserved when arguments are only implicitly named.)

To suppress expansion of an argument's contents, wrap <code>{{{<var>argument</var>}}}</code> with <code>{{lb}}#tag:nowiki|...{{rb}}</code>; see [[Template:Cat]] for an example.

Inside a template's expansion markup, substrings beginning with <code>*</code>, <code>#</code>, <code>:</code>, or <code>;</code> are automatically prefixed by a
newline. Use <code>start<nowiki>{{{</nowiki><var>dummy</var>|<b>;</b>}}}finish</code> to generate <code>start<b>;</b>finish</code>. (The empty string may be used for <var>dummy</var>.)

<code>{{lb}}ns:0{{rb}}</code> expands to the empty string.

If your template arguments are unexpectedly expanding as {{{1}}}, then you neglected to supply the argument; or you supplied text that the wiki markup engine is interpreting in a way you didn't expect. You can stop this from happening by surrounding the relevant text with <code><nowiki></code> tags. For example, instead of:

<pre>{{Cmd|export PS1="(chroot)$PS1"}}</pre>

use:

<pre>{{Cmd|<nowiki>export PS1="(chroot)$PS1"</nowiki>}}</pre>

A shorter alternative is to explicitly name the first argument:

<pre>{{Cmd|1=export PS1="(chroot)$PS1}"}}</pre>

See also [[Help:Editing#cat|the escape characters for {{lb}}Cat{{rb}}]], which can be used inside any template invocation.

== Skeleton for a new template ==

<pre><noinclude>{{Template}}
Short description.

=== Usage ===
Longer description.

<pre>{{Foo|arg}}</pre>

Further comments.

=== Example ===

<pre>{{Foo|arg}}</pre>

will produce:
{{Foo|arg}}

=== See also ===

* [[:Template:Bar]]

</noinclude><includeonly>EXPANSION</includeonly>
</pre>

[[Category:Wiki]]

Privacy Policy

2017-05-30T10:55:44Z

Dubiousjim: Removed protection from "Privacy Policy"

#REDIRECT [[Alpine Linux:Privacy policy]]

Alpine Linux:Copyrights

2017-05-30T10:50:22Z

Dubiousjim: update redirect

#REDIRECT [[Project:Privacy policy#Copyright]]

Alpine Linux:General disclaimer

2017-05-30T10:50:09Z

Dubiousjim: update redirect

#REDIRECT [[Project:Privacy policy]]

Privacy Policy

2017-05-30T10:49:44Z

Dubiousjim: spelling

#REDIRECT [[Alpine Linux:Privacy policy]]

Alpine Linux:Privacy policy

2017-05-30T10:48:58Z

Dubiousjim: Dubiousjim moved page Alpine Linux:Privacy Policy to Alpine Linux:Privacy policy without leaving a redirect

__NOTOC__
This site does not collect personal information about you. The web server does collect your web browser identification, IP address, and other non-personally identifiable information. We use this information to improve the site, provide aggregated statistics, and improve the Alpine Linux hosting platform. This information will not be sold, traded, or rented under any circumstances.

=Copyright=
All content is copyrighted by the original authors. It may not be republished in any form without prior permission. For inquiries, please direct email to alpine-devel@alpinelinux.org.

=Site Information=
This website is hosted in an Alpine Linux LXC container, running lighttpd and php (fastcgi). The web content is maintained using [[Special:Version|MediaWiki]].

Privacy Policy

2017-05-30T10:46:24Z

Dubiousjim: Dubiousjim moved page Privacy Policy to Alpine Linux:Privacy Policy: Belongs in Project: namespace

#REDIRECT [[Alpine Linux:Privacy Policy]]

Alpine Linux:Privacy policy

2017-05-30T10:46:24Z

Dubiousjim: Dubiousjim moved page Privacy Policy to Alpine Linux:Privacy Policy: Belongs in Project: namespace

MediaWiki:Edithelppage

2017-05-30T10:43:02Z

Dubiousjim: short form

Help:Editing

MediaWiki:Edithelppage

2017-05-30T10:40:50Z

Dubiousjim: Link to our own editing help page

https://wiki.alpinelinux.org/wiki/Help:Editing

Help:Editing

2017-05-30T10:16:35Z

Dubiousjim: /* Displaying code */ wiki now processes <kbd> and <samp>

== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd><kbd></kbd> and <samp><samp></samp>
* <var><var></var> and <dfn><dfn></dfn>
* <cite><cite></cite>
* <q><q></q>

* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code>. Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

Help:Editing

2017-05-30T10:12:19Z

Dubiousjim: /* Inline elements */ Does now process <kbd>, <samp>, <dfn>, and <q>

== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd><kbd></kbd> and <samp><samp></samp>
* <var><var></var> and <dfn><dfn></dfn>
* <cite><cite></cite>
* <q><q></q>

* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code> (which the wiki does not process). Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> (which the wiki does not process) or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

Help:Editing

2017-05-30T10:06:35Z

Dubiousjim: /* Inline elements */ <q> is processed (anyway it would need an opening <)

== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd> and <samp> and <dfn> are not processed by this wiki

* <var><var></var>
* <cite><cite></cite>
* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code> (which the wiki does not process). Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> (which the wiki does not process) or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

Help:Editing

2017-05-30T10:03:33Z

Dubiousjim: /* Headings */ cleanup

== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd> and <samp> and <q> and <dfn> are not processed by this wiki

* <var><var></var>
* <cite><cite></cite>
* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code> (which the wiki does not process). Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> (which the wiki does not process) or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

Help:Editing

2017-05-30T10:01:58Z

Dubiousjim: /* Headings */ add {{Style}}

== Guidelines ==

<dl>
<dt>Starting a page
<dd>
There are 2 ways to start a new page:
# Type the URL into the address bar. For example: http://wiki.alpinelinux.org/wiki/New_page
# Create a <code><nowiki>[[New page]]</nowiki></code> link on an existing page, then click the link.
New pages should be [[#categories|assigned at least one catgeory]]. If it's a top-level page, it should also be added to [[Tutorials and Howtos]], or if it concerns Alpine development, to [[Developer Documentation]]. Pages added to the latter index should include one of the categories [[:Category:Package Manager|Package Manager]], [[:Category:ACF|ACF]], or [[:Category:Development|Development]].

<dt>Temporary pages
<dd>
If you wish to create a temporary page, please use a subpage of your User namespace. For example: [[User:Hillary/Temporary page]]. This helps to keep the main namespace tidy and prevents the pages from turning up in normal searches (the User namespace is not searched by default).

To experiment with markup, use [[Sandbox]].

<dt>Moving/renaming pages
<dd>
* If the move might be controversial, [[#move|propose it first]] and try to resolve any disagrements on the discussion page.
* The new name must either not exist as a page, or exist as a redirect page with only 1 entry in its page history.
* Use the "What links here" link in the sidebar, and be sure to update all links to internal page targets. If this isn't done, double redirects are created. (That's where a redirect leads to a redirect, and in such cases only the first redirect is followed automatically.)
* In the default wiki skin, the link to Move pages (and also to Watch them) is in the popup menu between "View history" and the Search box.
* Always move the discussion page, too, unless you have a very good reason for not doing so.

<dt>Deleting pages
<dd>Only administrators can delete pages. Other users should instead use <code>{{lb}}Delete{{rb}}</code> to [[#delete|propose the page for deletion]]. (''Don't'' clear the page's content except where it's obviously spam.)


</dl>

== Inline elements ==

* ''<nowiki>''italic''</nowiki>'' or use <i><i></i> or <em><em></em> or {font-style:italic} in a style attribute
* '''<nowiki>'''bold'''</nowiki>''' or use <b><b></b> or <strong><strong></strong> or {font-weight:bold} in a style attribute


* <small><small></small> or use {font-size:smaller} in a style attribute
* <big><big></big> or use {font-size:larger} in a style attribute (invalid in HTML5)
* <sup><sup></sup> or use {vertical-align:super} in a style attribute
* <sub><sub></sub> or use {vertical-align:sub} in a style attribute


* <font> is deprecated; use {font-size:10pt; color:red; font-family:"Courier"} in a style attribute
* <nowiki><span style="</nowiki><span style="color:gray">color:gray</span>">
* <nowiki><span style="</nowiki><span style="color:white; background:red;">color:white; background:red</span>">
* <u><u></u> or use <ins><ins></ins> or {text-decoration:underline} in a style attribute (<u> is valid in HTML5 but not HTML4/strict; <ins> can also be a block element)
* <s><s></s> or use <del><del></del> or {text-decoration:line-through} in a style attribute (<s> is valid in HTML5 but not HTML4/strict; <del> can also be a block element)


* <code><code></code> uses {font-family:monospace;} (<tt> is invalid in HTML5)
*: <code><var>markup</var> and → entities are still honored</code>
*: See also [[#inlinecode|below]]
* <kbd> and <samp> and <q> and <dfn> are not processed by this wiki

* <var><var></var>
* <cite><cite></cite>
* <nowiki>{{Hint|</nowiki>{{Hint|term|explanation}}<nowiki>|explanation}}</nowiki>
* <nowiki>{{Path|</nowiki>{{Path|/a/path/name}}<nowiki>}}</nowiki>
* {{Lb}}Key| {{Key|Ctrl}}{{Rb}}+{{Lb}}Key| {{Key|C}}{{Rb}}

* Here is one line, followed by <br /><br /> and another line.

* Here is .

* [[HTML Entities]]

=== Links ===

Here is <nowiki>[[Wiki pagetitle|a wiki page]]</nowiki>: [[Wiki pagetitle|a wiki page]]. Text immediately suffixing the link will be incorporated into the link text; separate with <nowiki /> to suppress.

Here is <nowiki>{{Pkg|gtk+2.0}}</nowiki>: {{Pkg|gtk+2.0}}.

Here is an [http://bugs.alpinelinux.org/ Alpine Issue] link <nowiki>{{Issue|279}}</nowiki>: {{Issue|279}}. The issue's description can be included as an optional second argument.

Here is <nowiki>[http://www.example.org/ an external link]</nowiki>: [http://www.example.org/ an external link]. If no link text is supplied: [http:///www.example.org]. Omit brackets for http://www.example.org/<nowiki /> (use <nowiki> to suppress). 

<nowiki>[mailto:</nowiki>[mailto:info@example.org info@example.org]<nowiki>?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki>.

In Talk pages, <nowiki>-- ~~~~</nowiki> gives a signature and timestamp: -- [[User:Dubiousjim|Dubiousjim]] 10:00, 4 March 2012 (UTC)



== Headings ==

An article with 4 or more headings automatically creates a table of contents. You can force a table of contents (or fine-tune its placement) by inserting <nowiki>__TOC__</nowiki>. You can suppress the table of contents by inserting <nowiki>__NOTOC__</nowiki>.

Start headings at level 2, and don't skip levels.

<pre>== Heading2 ==</pre>
will produce:
<h2>Heading2</h2>

<pre>=== Heading3 ===</pre>
will produce:
<h3>Heading3</h3>

<pre>==== Heading4 ====</pre>
will produce:
<h4>Heading4</h4>

<div id="delete">
{{lb}}[[Template:Delete|Delete]]|Message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-user-trash-full.png|48px|left|link=]] This material is proposed for deletion ... </div><p style="text-align: center; font-size: 87%;">Message.
([[{{TALKPAGENAME}}|Discuss]])<br />Make sure no other pages link here and check the page's history before deleting.</p>
|}</center>

{{lb}}[[Template:Obsolete|Obsolete]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f1f1de; border:1px solid #cc9; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Out_of_date_clock_icon.svg‎|54px|left|link=]] This material is obsolete ... </div><p style="text-align: center; font-size: 87%;">Alternate message.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

{{lb}}[[Template:Merge|Merge]]|Page to merge with|Additional message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-two-arrows.png‎|75px|left|link=]] This material is proposed for merging ... </div><p style="text-align: center; font-size: 87%;">It should be merged with [[Page to merge with]].{{Ifn|Additional message.| Additional message.}}
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>

<div id="move">
{{lb}}[[Template:Move|Move]]|New page name|Reason.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-go-next.png‎|48px|left|link=]] This page is proposed for moving ... </div><p style="text-align: center; font-size: 87%;">It should be renamed to [[New page name]]. Reason.
([[{{TALKPAGENAME}}|Discuss]])</p>
|}</center>
</div>

{{lb}}[[Template:Draft|Draft]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Underconstruction_clock_icon_gray.svg‎|64px|left|link=]] This material is work-in-progress ... </div><p style="text-align: center; font-size: 87%;">Alternate message.<br /><i>(Last edited by
{{REVISIONUSER}} on {{REVISIONDAY}} {{Month|{{REVISIONMONTH}}}} {{REVISIONYEAR}}.)</i></p>
|}</center>

{{lb}}[[Template:Expand|Expand]]|Alternate message.}}
will produce:

<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-view-fullscreen.png‎|48px|left|link=]] This material needs expanding ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

{{lb}}[[Template:Style|Style]]|Alternate message.}}
will produce:

<center>
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>
</center>

== Block elements ==

=== Lists ===

<pre>
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.
</pre>

will produce:
# Here is a numbered list item.
## Doubly-numbered
#* Numbered and bulleted.

* Here is a bulleted list item.
** Doubly-bulleted
*# Bulleted and numbered.
*# Another item.

Blank lines, or non-bulleted/numbered lines, end the lists. You can also code a list manually, which gives you more flexibility with multi-line entries and styling:
<pre>
<ol start=2>
<li>Ordered list item
<li value=4>Another item
<li type="disc"><p>A third item</p><p>Next line</p>
</ol>
</pre>

and similarly for <code><ul></code>. Closing <code></li></code> tags are permitted but not necessary.

Each of these:
<pre>
;item: Body text

{{Define|item|Body text}}

<dl>
<dt>item
<dd>Body text
</dl>
</pre>

will produce:
;item: Body text

The second markup option also wraps a <code><nowiki><span id="item"></nowiki></code> around the block. Note that with the third option, you shouldn't use closing <code></dt></code> or <code></dd></code> tags.

=== Indenting unstyled text ===

<b>:</b> Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>

will produce:
: Simply indented text (on left side only).

<blockquote>This is a blockquote.
It collapses whitespace, and indents on both sides.</blockquote>



=== Displaying code ===

<dl>
<dt id="inlinecode">Inline code
<dd>Use <code><code></code> for styling, and <code><nowiki></code> to suppress markup. If you use both, they must appear in that order. <code><nowiki></code> converts → entities and collapses whitespace (even multiple <code>\n</code>s), but ignores all <nowiki>'''wiki'''</nowiki> and <code><span style="color:green"></code>HTML<code></span></code> <nowiki>[[markup]]</nowiki>.

<dt>User input
<dd>{{Cmd|{{lb}}[[Template:Cmd|Cmd]]{{!}}a <var><var>command</var></var> to try{{rb}}}}
This is a block-level equivalent for the inline HTML element <code><kbd></code> (which the wiki does not process). Note that wiki markup is still honored in the command text; but whitespace is not collapsed. [[#cat|See below]] for how to escape some special characters.

<dt>Command output; or shell sessions that intermix prompts, user input, and command output; or segments of files
<dd>Use space-indented blocks or <code><pre></code>:
<pre>
Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>
</pre>

will produce:

Every line
begins with '''a space'''.

<pre>
Lines aren't
indented with '''a space.'''
</pre>

<nowiki>Only first
line begins with '''a space'''.</nowiki>

All of these render as styled blocks, in monospace, and don't collapse whitespace. They are block-level equivalents for the inline HTML elements <code><samp></code> (which the wiki does not process) or <code><code></code>.

All of these markup options convert → entities. The first also processes <nowiki>'''wiki''' and <span style="color:green">HTML</span> [[markup]]</nowiki>.

The second and the third don't; and they give equivalent presentations. With the third option, lines after the first should not be space-prefixed; the block will extend to the closing <code></nowiki></code>.

<dt id="cat">File contents
<dd><pre>
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
</pre>

will produce:
{{Cat|/path/to/file|body '''text''' <br /> more
Second line.}}
Note that wiki and HTML markup in the file contents aren't converted, though entities still are. You must escape characters as follows:
: {{=}} not inside [[..]] use &#61; or {{lb}}{{=}}{{rb}}
: {{!}} not inside [[..]] use &#124; or {{lb}}!{{rb}}
: {{lb}} use &#123; twice or {{lb}}lb{{rb}}
: {{rb}} use &#125; twice or {{lb}}rb{{rb}}
: unmatched [[ use &#91; twice
: unmatched ]] use &#93; twice
: # at start of line use &#35;
: * at start of line use &#42;

As an alternative to all of these escapes, you could instead wrap the body in <nowiki> tags.

<dt>Block-level code with no additional styling
<dd><pre>
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p></pre>
will produce:
<p style="white-space:pre; font-family:monospace;">One line.
Second line.
</p>
This would be the behavior of HTML's <code><pre></code> without any styling. To wrap to screen width, use {white-space:pre-wrap} in a style attribute.


</dl>

=== Message Boxes ===

{{Warning|<nowiki>{{Warning|Write your Warning here.}}</nowiki>}}
{{Note|<nowiki>{{Note|Write your Note here.}}</nowiki>}}
{{Tip|<nowiki>{{Tip|Write your Tip here.}}</nowiki>}}
{{Todo|<nowiki>{{Todo|Write your Todo here.}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body}}</nowiki>}}
{{Box|Heading:|<nowiki>{{Box|Heading:|Body then border-color then background-color|#DF0000|#FFDFDF}}</nowiki>|#DF0000|#FFDFDF}}

== Tables ==

{{Expand}}

=== Simple table ===
<pre>{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}
</pre>

{| cellpadding="5" border="1" class="wikitable"
|-
! Row 1
! Row 2
! Row 3
|-
| 1.1
| 1.2
| 1.3
|-
| 2.1
| 2.2
| 2.3
|}

=== Advanced table ===

<pre>
{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}
</pre>

{| border="1" style="width:75%; height:200px" 
|+ The table's caption
|-
! width=100px | columnlabel 1
! columnlabel 2 !! columnlabel 3
|-
! rowlabel1
| Cell 1 || Cell 2 || Cell 3
|- style="height:100px; background:none" 
| align=right style="width:200px" | Cell A
| style="background:red; color:white" | Cell B
| colspan=2 align=center | Cell C
|- valign=top 
| rowspan=2 Cell D
| ...
|}

See also:
* http://www.mediawiki.org/wiki/Help:Tables
* http://meta.wikimedia.org/wiki/Help:Table



== Images ==

{{Expand}}

<pre>[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]</pre> will produce:

[[File:Alpinelinux 01.png|right|thumb|100px|Caption text]]
{{Clear}}
Options can appear in any order:
* <i>Caption text</i> defaults to filename; to wholly suppress, use <code><span title=""></span></code>
* '''alt='''<i>text</i>
* Size can be [<i>width</i>][<b>x</b><i>height</i>]<b>px</b>
* '''page='''<i>number</i>, for PDF images
* rendered inline, Caption shows as hover text: '''frameless''', and/or '''border'''
** rendered inline, on separate line: '''none'''
** Valign for inline images, defaults to middle: '''middle|baseline|sub|super|top|text-top|bottom|text-bottom'''
** Text flow can be stopped by placing <nowiki>{{Clear}}</nowiki>  before the text that should start below the floating image
** '''link='''<i>URL</i>|<i>pagetitle</i>|<i>blank</i>, only for inline images
* rendered floating, defaults to right align, Caption displayed below image: '''thumb''', '''thumb='''<i>alternate filename</i>, '''frame''' (ignores size options)
** rendered floating, defaults to thumb: '''left|right|center'''

To instead link to the file, you need to add a colon: [[:File:Alpinelinux 01.png]].

See also:
* http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
* http://meta.wikimedia.org/wiki/Help:Image_page
* http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax
* http://www.mediawiki.org/wiki/Help:Images
* http://www.mediawiki.org/wiki/Help:Managing_files
* http://meta.wikimedia.org/wiki/Help:Navigational_image

== Other ==

Create HRs like this:
<pre>----</pre>

<div id="categories">
Every page should be assigned at least one [[Special:Categories|Category]], by placing the following '''at the bottom of the page''':
<pre>[[Category:Category name]]</pre>

To '''link to''' a Category page, without adding the linking page to the category: <code><nowiki>[[</nowiki><b>:</b>Category:Not in this category]]</code>
</div>

A redirect page should contain only:
<pre>#REDIRECT [[pagename]]</pre>

== See also ==

* [[Help:Template]]
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki's User Manual]
* http://www.mediawiki.org/wiki/Help:Formatting
* http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:HTML_in_wikitext
* http://en.wikipedia.org/wiki/Help:Wiki_markup

There may be small divergences, but in general, ours seems to be just a standard MediaWiki installation.

[[Category:Wiki]]

Alpine Linux:Wiki maintenance

2017-05-30T10:00:12Z

Dubiousjim: /* Pages */ typo

__NOTOC__

== [[Special:SpecialPages|Special Pages]] ==

"Hey, [[User:Dubiousjim/Special|where did the link to the SpecialPages in the Sidebar go]]?"

Click the header above to go to the original page.

== Pages ==
* [[Special:NewPages|New]] or [[Special:PrefixIndex|all]]  pages
* Most:  [[Special:MostLinkedPages|linked-to]] [[Special:MostRevisions|revised]] pages
* Redirects: [[Special:ListRedirects|all]] [[Special:BrokenRedirects|broken]] [[Special:DoubleRedirects|double]]
* [[Special:LinkSearch|What pages link to offsite url]] ___?
* Pages that:
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Delete&hideredirs=1&hidelinks=1 are proposed for deletion] ([[Special:Nuke|bulk delete]])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Obsolete&hideredirs=1&hidelinks=1 are obsolete]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Merge&hideredirs=1&hidelinks=1 are proposed for merging] ([[Special:MergeHistory|merge histories]])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Move&hideredirs=1&hidelinks=1 are proposed for moving]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Draft&hideredirs=1&hidelinks=1 are drafts]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Expand&hideredirs=1&hidelinks=1 need expanding] ([https://wiki.alpinelinux.org/w/index.php?title=Special:ShortPages&limit=500&offset=0 short pages])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Style&hideredirs=1&hidelinks=1 need style improvements]
** [[Special:UncategorizedPages|have no category]]
** [[Special:LonelyPages|are orphaned]]
** [[Special:WantedPages|are wanted]]
** [[Special:ProtectedPages|are protected]] ([[Special:PagesWithProp|other properties]])
** [https://wiki.alpinelinux.org/w/index.php?title=Special:DeadendPages&limit=500&offset=0 have no links to other pages]

== Files/Images ==
* [[Special:NewFiles|New]] or [[Special:ListFiles|all]] files
* Files that:
** [[Special:UncategorizedFiles|have no category]]
** [[Special:UnusedFiles|are orphaned]]
** [[Special:WantedFiles|are wanted]]
** [[Special:ListDuplicatedFiles|are duplicates]]

== Templates ==
* [[Special:MostTranscludedPages|Used]] or [[Special:AllPages/Template:|all]] templates
* Templates that:
** [[Special:UnusedTemplates|are unused]]
** [[Special:WantedTemplates|are wanted]]
* [[Special:ExpandTemplates|Sandbox]]

== Categories ==
* Categories that:
** [[Special:AllPages/Category:|are described]]
** [[Special:Categories|are used]]
** [[Special:UnusedCategories|are unused]]
** [[Special:WantedCategories|are wanted]]

* Uncategorized: [[Special:UncategorizedPages|pages]] [[Special:UncategorizedFiles|files]]

== Wanted and Orphaned ==
* Wanted: [[Special:WantedPages|pages]] [[Special:WantedFiles|files]] [[Special:WantedTemplates|templates]] [[Special:WantedCategories|categories]]
* Orphaned: [[Special:LonelyPages|pages]] [[Special:UnusedFiles|files]]
* Unused: [[Special:UnusedTemplates|templates]] [[Special:UnusedCategories|categories]]

== Other ==

* [[Special:ActiveUsers|Active]] or [[Special:ListUsers|all]] users
* [[Special:ListGroupRights|User privileges]]
* [[Project:Developers|Developers]]
* [[Special:ComparePages|Compare pages]]

* Wiki [[Special:Log|logs]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Project [[Project:Overview|overview]] [[Alpine Linux:Releases|releases]] [http://pkgs.alpinelinux.org/packages packages] [[Special:AllPages/Alpine Linux:|pages]] [[glossary]]
* Project [http://alpinelinux.org/ news] [http://git.alpinelinux.org/ git] [http://bugs.alpinelinux.org/?query_id=15 bugs] [http://bugs.alpinelinux.org/projects/alpine/activity activity]

* [http://bugs.alpinelinux.org/projects/alpine/roadmap Roadmap] | Older ideas: [[Talk:Tutorials_and_Howtos|1]] [[Wishlist|2]] [[Project:Ideas|3]]

[[Category:Wiki]]

Alpine Linux:Wiki maintenance

2017-05-30T09:58:59Z

Dubiousjim: /* Pages */ add {{Style}} links

__NOTOC__

== [[Special:SpecialPages|Special Pages]] ==

"Hey, [[User:Dubiousjim/Special|where did the link to the SpecialPages in the Sidebar go]]?"

Click the header above to go to the original page.

== Pages ==
* [[Special:NewPages|New]] or [[Special:PrefixIndex|all]]  pages
* Most:  [[Special:MostLinkedPages|linked-to]] [[Special:MostRevisions|revised]] pages
* Redirects: [[Special:ListRedirects|all]] [[Special:BrokenRedirects|broken]] [[Special:DoubleRedirects|double]]
* [[Special:LinkSearch|What pages link to offsite url]] ___?
* Pages that:
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Delete&hideredirs=1&hidelinks=1 are proposed for deletion] ([[Special:Nuke|bulk delete]])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Obsolete&hideredirs=1&hidelinks=1 are obsolete]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Merge&hideredirs=1&hidelinks=1 are proposed for merging] ([[Special:MergeHistory|merge histories]])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Move&hideredirs=1&hidelinks=1 are proposed for moving]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Draft&hideredirs=1&hidelinks=1 are drafts]
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Expand&hideredirs=1&hidelinks=1 need expanding ([https://wiki.alpinelinux.org/w/index.php?title=Special:ShortPages&limit=500&offset=0 short pages])
** [http://wiki.alpinelinux.org/wiki/Special:WhatLinksHere/Template:Style&hideredirs=1&hidelinks=1 need style improvements]
** [[Special:UncategorizedPages|have no category]]
** [[Special:LonelyPages|are orphaned]]
** [[Special:WantedPages|are wanted]]
** [[Special:ProtectedPages|are protected]] ([[Special:PagesWithProp|other properties]])
** [https://wiki.alpinelinux.org/w/index.php?title=Special:DeadendPages&limit=500&offset=0 have no links to other pages]

== Files/Images ==
* [[Special:NewFiles|New]] or [[Special:ListFiles|all]] files
* Files that:
** [[Special:UncategorizedFiles|have no category]]
** [[Special:UnusedFiles|are orphaned]]
** [[Special:WantedFiles|are wanted]]
** [[Special:ListDuplicatedFiles|are duplicates]]

== Templates ==
* [[Special:MostTranscludedPages|Used]] or [[Special:AllPages/Template:|all]] templates
* Templates that:
** [[Special:UnusedTemplates|are unused]]
** [[Special:WantedTemplates|are wanted]]
* [[Special:ExpandTemplates|Sandbox]]

== Categories ==
* Categories that:
** [[Special:AllPages/Category:|are described]]
** [[Special:Categories|are used]]
** [[Special:UnusedCategories|are unused]]
** [[Special:WantedCategories|are wanted]]

* Uncategorized: [[Special:UncategorizedPages|pages]] [[Special:UncategorizedFiles|files]]

== Wanted and Orphaned ==
* Wanted: [[Special:WantedPages|pages]] [[Special:WantedFiles|files]] [[Special:WantedTemplates|templates]] [[Special:WantedCategories|categories]]
* Orphaned: [[Special:LonelyPages|pages]] [[Special:UnusedFiles|files]]
* Unused: [[Special:UnusedTemplates|templates]] [[Special:UnusedCategories|categories]]

== Other ==

* [[Special:ActiveUsers|Active]] or [[Special:ListUsers|all]] users
* [[Special:ListGroupRights|User privileges]]
* [[Project:Developers|Developers]]
* [[Special:ComparePages|Compare pages]]

* Wiki [[Special:Log|logs]] [[:Category:Wiki|help]] | [[Special:Version|version]] [https://www.mediawiki.org/wiki/Help:Contents userman] ([https://meta.wikimedia.org/wiki/Help:Contents older]) [https://www.mediawiki.org/wiki/Manual:Contents adminman]
* Project [[Project:Overview|overview]] [[Alpine Linux:Releases|releases]] [http://pkgs.alpinelinux.org/packages packages] [[Special:AllPages/Alpine Linux:|pages]] [[glossary]]
* Project [http://alpinelinux.org/ news] [http://git.alpinelinux.org/ git] [http://bugs.alpinelinux.org/?query_id=15 bugs] [http://bugs.alpinelinux.org/projects/alpine/activity activity]

* [http://bugs.alpinelinux.org/projects/alpine/roadmap Roadmap] | Older ideas: [[Talk:Tutorials_and_Howtos|1]] [[Wishlist|2]] [[Project:Ideas|3]]

[[Category:Wiki]]

Template:Style

2017-05-30T09:57:31Z

Dubiousjim: Protected "Template:Style": Template ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>{{Template}}
This template is for pages or sections that need wiki syntax or style improvements.

=== Usage ===
This template should be added at the beginning of pages whose wiki syntax and/or style needs cleaning up. You can explain in the first argument what specifically might be improved.

<pre>{{Style|Message.}}</pre>

Flagged pages can be found in [[Special:WhatLinksHere/Template:Style]]. If conversant with wiki syntax, users are encouraged to help clean the page up and remove the <nowiki>{{Style}}</nowiki> flag when finished.

=== Examples ===

<pre>{{Style}}</pre>

will produce:
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Please feel free to help us clean it up.</p>
|}</center>

<pre>{{Style|Alternate message.}}</pre>

will produce:
<center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">Alternate message.</p>
|}</center>

<hr>

</noinclude><includeonly><center>
{|style="width: 48em; padding:2px; margin:0; margin-bottom:10px; background-color:#f6f6f6; border:1px solid #aaa; -moz-border-radius-bottomright: 0.5em; -moz-border-radius-bottomleft: 1em; border-radius-bottomright: 0.5em; border-radius-bottomleft: 1em; -webkit-border-bottom-right-radius: 0.5em; -webkit-border-bottom-left-radius: 1em;"
|<div style="font-size: 1.5em; font-weight:bold; text-align:center;"> [[Image:Tango-edit-clear.png‎|48px|left|link=]] This material needs wiki syntax or style improvements ... </div><p style="text-align: center; font-size: 87%;">{{{1|Please feel free to help us clean it up.}}}</p>
|}</center></includeonly>

Template:Style

2017-05-30T09:57:14Z

Dubiousjim: Create, based on {{Expand}}

File:Tango-edit-clear.png

2017-05-30T09:52:06Z

Dubiousjim:

Template:Mirrors

2017-05-30T08:45:41Z

Dubiousjim: Protected "Template:Mirrors" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

* http://dl-cdn.alpinelinux.org/alpine/
* http://nl.alpinelinux.org/alpine/
* http://dl-2.alpinelinux.org/alpine/
* http://dl-3.alpinelinux.org/alpine/
* http://dl-4.alpinelinux.org/alpine/
* http://dl-5.alpinelinux.org/alpine/
* http://dl-6.alpinelinux.org/alpine/
* http://dl-8.alpinelinux.org/alpine/
* http://distrib-coffee.ipsl.jussieu.fr/pub/linux/alpine/alpine/
* http://mirror.yandex.ru/mirrors/alpine/
* http://mirrors.gigenet.com/alpinelinux/
* http://mirror1.hs-esslingen.de/pub/Mirrors/alpine/
* http://liskamm.alpinelinux.uk/
* http://mirrors.2f30.org/alpine/
* http://mirror.leaseweb.com/alpine/
* http://repository.fit.cvut.cz/mirrors/alpine/
* http://alpine.mirror.far.fi/
* http://lasca.ic.unicamp.br/pub/alpine/
* http://alpinelinux.c3sl.ufpr.br/
* http://mirrors.cug.edu.cn/alpine/
* http://mirrors.cicku.me/alpine/

Template:Mirrors

2017-05-30T08:45:27Z

Dubiousjim: Removed protection from "Template:Mirrors"

Template:Warning

2017-05-30T08:44:13Z

Dubiousjim: Protected "Template:Warning": Template ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>{{Template}}

'''A 'Warning' box used to report potential danger.

====Usage====

<nowiki>{{Warning|This text should be heeded.}}</nowiki>

====Example====

{{Warning|This text should be heeded.}}</noinclude><includeonly>[[Image:Tango-dialog-warning.png‎‎|48px|left|link=]]{{Box RED|Warning:|{{{1}}}}}<BR></includeonly>

Template:Box BLUE

2017-05-30T08:44:09Z

Dubiousjim: Protected "Template:Box BLUE": Template ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<noinclude>{{Template}}

'''A generic BLUE message box.'''

====Usage====

{{Codeline|1=<nowiki>{{Box BLUE|Example:|Content}}</nowiki>}}

====Example====

{{Box BLUE|Example:|Content}}</noinclude><includeonly>{{Box|{{{1}}}|{{{2}}}|#BBBBFF|#DDDDFF}}</includeonly>