HyperWiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
pt:manual:installation [2020/04/26 05:57]
i3_relativism 		pt:manual:installation [2025/02/26 16:25] (current)
luck02 [Partition disks]
Line 1: Line 1:
 ... (WIP) ... (WIP)
  
-====== The Installation Guide ======+====== O Guia de Instalação ======
  
-The Installation Guide for Hyperbola live-CD image (launchable from USB thumb-drive, too) is intended to assist experienced GNU/Linux users in installing **Hyperbola** from the live system booted with the official installation image. This page assumes a **high-level of experience** with GNU/Linux systems and utilities, especially the command line. If you'd like a more detailed, step-by-step guide through the installation process, see the [[en:guide:Beginners|Beginners guide]]. Before beginning, we recommend you view our [[en:main:FAQ]], the [[https://wiki.archlinux.org/index.php/Frequently_asked_questions|Arch FAQ]] , and employ the <color #620BB9/#EEDDFF>man ''command''</color> to read the man page of any command they are not familiar with. The Hyperbola wiki (known as **HyperWiki**), as well as the **ArchWiki**, should be the primary source of information and your first resource during trouble-shooting. +O Guia da Instalação para a imagem live-CD da Hyperbola (launchable from USB thumb-drive, too) is intended to assist experienced GNU/Linux users in installing **Hyperbola** from the live system booted with the official installation image. This page assumes a **high-level of experience** with GNU/Linux systems and utilities, especially the command line. If you'd like a more detailed, step-by-step guide through the installation process, see the [[archive:en:manual:beginner_installation|Beginners guide]]. Before beginning, we recommend you view our [[en:project:faq]], the [[https://wiki.archlinux.org/index.php/Frequently_asked_questions|Arch FAQ]] , and employ the <color #620BB9/#EEDDFF>man ''command''</color> to read the man page of any command they are not familiar with. The Hyperbola wiki (known as **HyperWiki**), as well as the **ArchWiki**, should be the primary source of information and your first resource during trouble-shooting. 
  
 ===== Download ===== ===== Download =====
  
-Download the new **Hyperbola ISO** from the [[en:main:downloads|download page]].+Download the new **Hyperbola ISO** from the [[en:project:downloads|download page]].
   * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/Linux-libre** over the network.   * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/Linux-libre** over the network.
   * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**, this can be done by using <color #620BB9/#EEDDFF>pacman-key -v <iso-file>.sig</color>   * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**, this can be done by using <color #620BB9/#EEDDFF>pacman-key -v <iso-file>.sig</color>
   * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #620BB9/#EEDDFF>dd</color>. It is intended for new installations only; an existing **Hyperbola GNU/Linux-libre** system can always be updated with <color #620BB9/#EEDDFF>pacman -Syu</color>.   * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #620BB9/#EEDDFF>dd</color>. It is intended for new installations only; an existing **Hyperbola GNU/Linux-libre** system can always be updated with <color #620BB9/#EEDDFF>pacman -Syu</color>.
  
-===== Blind and visually impaired users =====+===== Usuários cegos e com deficiência visual =====
  
-There is a ISO called [[en:main:downloads#HyperTalking|]] that is a derivative install CD based on **TalkingArch** and a respin of the Hyperbola ISO modified to include speech and braille output.+There is a ISO called [[en:project:downloads#HyperTalking]] that is a derivative install CD based on **TalkingArch** and a respin of the Hyperbola ISO modified to include speech and braille output.
  
-===== Writing a Hyperbola ISO image to an USB drive =====+===== Escrevendo uma imagem ISO Hyperbola para uma unidade USB =====
  
 <code bash> <code bash>
Line 26: Line 26:
 <note>''**[usb device file]**'' is the path to the **USB device** file. <color #620BB9/#EEDDFF>dmesg</color> or <color #620BB9/#EEDDFF>lsblk --fs</color> can be used to learn this path. It is often similar to device filenames of storage devices like hard drives and SSDs, e.g. <color #0B71B9/#DDF1FF>/dev/sdb</color> '''**It is very important to use the correct value**''' to avoid overwriting other storage devices.</note> <note>''**[usb device file]**'' is the path to the **USB device** file. <color #620BB9/#EEDDFF>dmesg</color> or <color #620BB9/#EEDDFF>lsblk --fs</color> can be used to learn this path. It is often similar to device filenames of storage devices like hard drives and SSDs, e.g. <color #0B71B9/#DDF1FF>/dev/sdb</color> '''**It is very important to use the correct value**''' to avoid overwriting other storage devices.</note>
  
-===== Installation =====+===== Instalação =====
  
  
-==== Keyboard layout ====+==== Layout do teclado ====
  
 For many countries and keyboard types appropriate keymaps are available already, and a command like <color #0B71B9/#DDF1FF>loadkeys uk</color> might do what you want. More available keymap files can be found in <color #0B71B9/#DDF1FF>/usr/share/kbd/keymaps/</color> (you can omit the keymap path and file extension when using <color #620BB9/#EEDDFF>loadkeys</color>). For many countries and keyboard types appropriate keymaps are available already, and a command like <color #0B71B9/#DDF1FF>loadkeys uk</color> might do what you want. More available keymap files can be found in <color #0B71B9/#DDF1FF>/usr/share/kbd/keymaps/</color> (you can omit the keymap path and file extension when using <color #620BB9/#EEDDFF>loadkeys</color>).
Line 35: Line 35:
 === Braille Support === === Braille Support ===
  
-[[en:main:downloads#HyperTalking]] includes **brltty**, for those who own braille displays.  The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available on the [[en:main:downloads#HyperTalking]] CD was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt.  Alternatively, you can start <color #620BB9/#EEDDFF>brltty</color> from the shell, after the system has booted.+[[en:project:downloads#HyperTalking]] includes **brltty**, for those who own braille displays.  The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available on the [[en:project:downloads#HyperTalking]] CD was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt.  Alternatively, you can start <color #620BB9/#EEDDFF>brltty</color> from the shell, after the system has booted.
  
 The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**.  The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table.  You can use "<color #620BB9/#EEDDFF>auto</color>" to specify that the driver should be automatically detected.  I encourage you to read the <color #620BB9/#EEDDFF>brltty</color> documentation for a fuller explanation of the program. The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**.  The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table.  You can use "<color #620BB9/#EEDDFF>auto</color>" to specify that the driver should be automatically detected.  I encourage you to read the <color #620BB9/#EEDDFF>brltty</color> documentation for a fuller explanation of the program.
Line 47: Line 47:
 Once <color #620BB9/#EEDDFF>brltty</color> is running, you may wish to disable speech.  You can do so via the "<color #620BB9/#EEDDFF>print screen</color>" key, also known as <color #620BB9/#EEDDFF>sysrq</color>.  On my qwerty keyboard, that key is located directly above the insert key, between F12 and scroll lock. Once <color #620BB9/#EEDDFF>brltty</color> is running, you may wish to disable speech.  You can do so via the "<color #620BB9/#EEDDFF>print screen</color>" key, also known as <color #620BB9/#EEDDFF>sysrq</color>.  On my qwerty keyboard, that key is located directly above the insert key, between F12 and scroll lock.
  
-==== Partition disks ====+==== Partição dos Discos ====
  
 See [[https://wiki.archlinux.org/index.php/Partitioning|partitioning]] for details. See [[https://wiki.archlinux.org/index.php/Partitioning|partitioning]] for details.
Line 341: Line 341:
  
 <note important> <note important>
-Keep in mind these steps will fail if your system is not set to the correct time, or if you are not connected to the internet. See [[en:guide:installation#connect_to_the_internet|above]] for internet setup instructions.+Keep in mind these steps will fail if your system is not set to the correct time, or if you are not connected to the internet. See [[en:manual:reference_installation#connect_to_the_internet|above]] for internet setup instructions.
 </note> </note>
  
Line 457: Line 457:
 </code> </code>
  
-  * Install GRUB after chrooting (refer to the [[en:guide:Installation#Configure the system]] section).+  * Install GRUB after chrooting (refer to the [[en:manual:reference_installation#Configure the system]] section).
  
 See [[https://wiki.parabola.nu/GRUB2|GRUB]] for further details. See [[https://wiki.parabola.nu/GRUB2|GRUB]] for further details.
Line 503: Line 503:
 </code> </code>
  
-  * Set [[en:guide:beginners#locale|locale]] preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color>+  * Set [[archive:en:manual:beginner_installation#locale|locale]] preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color>
   * Add console keymap and font preferences in <color #0B71B9/#DDF1FF>/etc/conf.d/keymaps</color>   * Add console keymap and font preferences in <color #0B71B9/#DDF1FF>/etc/conf.d/keymaps</color>
   * Uncomment the selected locale in <color #0B71B9/#DDF1FF>/etc/locale.gen</color> and generate it with <color #620BB9/#EEDDFF>locale-gen</color>   * Uncomment the selected locale in <color #0B71B9/#DDF1FF>/etc/locale.gen</color> and generate it with <color #620BB9/#EEDDFF>locale-gen</color>
Line 532: Line 532:
  
 <note important> <note important>
-If you want to [[en:guide:encrypted_installation|install GRUB on a Libreboot system]], keep in mind your system **does not use UEFI or Legacy BIOS**, but instead loads GRUB as its only payload. So you we will run this command instead:+If you want to [[en:manual:fde_installation|install GRUB on a Libreboot system]], keep in mind your system **does not use UEFI or Legacy BIOS**, but instead loads GRUB as its only payload. So you we will run this command instead:
  
 <code bash> <code bash>
Line 546: Line 546:
  
 <note tip> <note tip>
-If you are following the [[en:guide:encrypted_installation|libreboot encrypted installation]] instructions, be sure to save a copy of grub.cfg on a thumbdrive in case the one flashed to libreboot is incorrect. You can use the grub shell to boot from the extra copy.+If you are following the [[en:manual:fde_installation|libreboot encrypted installation]] instructions, be sure to save a copy of grub.cfg on a thumbdrive in case the one flashed to libreboot is incorrect. You can use the grub shell to boot from the extra copy.
 </note> </note>
  
 ==== Configure speech support (for blind and visually impaired users) ==== ==== Configure speech support (for blind and visually impaired users) ====
  
-If you are using  [[en:main:downloads#HyperTalking]] and need start speech support when you boot the system, you will need to do:+If you are using  [[en:project:downloads#HyperTalking]] and need start speech support when you boot the system, you will need to do:
  
   * Install [[https://www.hyperbola.info/packages/?q=espeakup|espeakup]] and [[https://www.hyperbola.info/packages/?q=alsa-utils|alsa-utils]].   * Install [[https://www.hyperbola.info/packages/?q=espeakup|espeakup]] and [[https://www.hyperbola.info/packages/?q=alsa-utils|alsa-utils]].
Line 581: Line 581:
 Edit <color #0B71B9/#DDF1FF>/etc/pacman.conf</color> and configure pacman's options, also enabling the repositories you need. Edit <color #0B71B9/#DDF1FF>/etc/pacman.conf</color> and configure pacman's options, also enabling the repositories you need.
  
-See [[https://wiki.archlinux.org/index.php/Pacman|Pacman]] and [[en:main:Repositories]] for details.+See [[https://wiki.archlinux.org/index.php/Pacman|Pacman]] and [[en:project:repositories]] for details.
  
 ==== Update the system ==== ==== Update the system ====