# 在 Gentoo 上安裝

將儲存庫中的 ebuild 加入本機 Portage 儲存庫，安裝 doona v0.1.0-rc.2。doona lite 請使用[手動安裝](https://doona.daeuniverse.org/zh-TW/install-manual.md)。

在閘道器上開啟終端機，進入新建的下載目錄，並在同一 shell 中完成各步。使用 root shell 時省略 `sudo`。安裝後端前先檢查 [honk 的前提條件](https://doona.daeuniverse.org/zh-TW/install.md#install)。

缺少 `net-misc/curl` 或 `app-misc/ca-certificates` 時，先安裝它們。下列命令使用 sudo 寫入系統目錄。

```sh
sudo emerge --ask net-misc/curl app-misc/ca-certificates
```

## 1. 準備本機儲存庫

已有本機儲存庫時，將 `REPO` 設為其絕對路徑，並跳過建立命令。否則，建立名為 `doona-local` 的新儲存庫：

```sh
REPO=/var/db/repos/doona-local
sudo mkdir -p "$REPO/metadata" "$REPO/profiles" /etc/portage/repos.conf
printf '%s
' doona-local | sudo tee "$REPO/profiles/repo_name"
printf 'masters = gentoo
auto-sync = false
' | sudo tee "$REPO/metadata/layout.conf"
printf '[doona-local]
location = %s
' "$REPO" | sudo tee /etc/portage/repos.conf/doona-local.conf
portageq get_repos /
```

最後一條命令的輸出必須包含該儲存庫名稱。

## 2. 新增 ebuild

```sh
VERSION=0.1.0-rc.2
PV=0.1.0_rc2
RAW=https://raw.githubusercontent.com/Zakkaus/doona/v${VERSION}/install/gentoo/net-proxy/doona
sudo mkdir -p "$REPO/net-proxy/doona"
sudo curl -fL -o "$REPO/net-proxy/doona/doona-$PV.ebuild" "$RAW/doona-$PV.ebuild"
sudo curl -fL -o "$REPO/net-proxy/doona/metadata.xml" "$RAW/metadata.xml"
```

## 3. 驗證發行壓縮檔

ebuild 使用程式壓縮檔，並預設啟用 `fonts` USE 旗標。在下載目錄中下載並驗證兩個壓縮檔：

```sh
BASE=https://github.com/Zakkaus/doona/releases/download/v$VERSION
curl -fL -O "$BASE/doona-${VERSION}.tar.gz" -O "$BASE/doona-fonts-${VERSION}.tar.gz" -O "$BASE/SHA256SUMS"
awk -v file="doona-${VERSION}.tar.gz" '$2 == file' SHA256SUMS | sha256sum -c -
awk -v file="doona-fonts-${VERSION}.tar.gz" '$2 == file' SHA256SUMS | sha256sum -c -
```

所有選定檔案都顯示 `OK` 後才能繼續。如果驗證失敗或找不到校驗和項目，先核對檔名並重新下載，再安裝。

下載或執行檔出錯時，見[安裝故障](https://doona.daeuniverse.org/zh-TW/install.md#安裝故障)。

將已驗證的檔案依 ebuild 使用的名稱放入 Portage distfiles 目錄，再產生 Manifest：

```sh
DISTDIR=$(portageq distdir)
sudo install -m 0644 "$PWD/doona-${VERSION}.tar.gz" "$DISTDIR/doona-$PV.tar.gz"
sudo install -m 0644 "$PWD/doona-fonts-${VERSION}.tar.gz" "$DISTDIR/doona-$PV-fonts.tar.gz"
sudo ebuild "$REPO/net-proxy/doona/doona-$PV.ebuild" manifest
```

## 4. 接受測試關鍵字並安裝

將 `=net-proxy/doona-0.1.0_rc2 ~amd64` 新增至 `package.accept_keywords` 設定，將 `~amd64` 替換為目前架構的測試關鍵字，例如 `~arm64`。如果該設定是目錄，則寫入其中的檔案。

不需要字型時，在安裝前將 `net-proxy/doona -fonts` 新增至 `package.use`。

```sh
sudo emerge --ask =net-proxy/doona-0.1.0_rc2
ls -l /usr/share/doona/index.html
```

最後一條命令必須列出 `index.html`。依照[最小設定](https://doona.daeuniverse.org/zh-TW/minimal-configuration.md)操作時，將 UI 目錄設為 `/usr/share/doona`；設定項目說明見 [`ui` 參考](https://doona.daeuniverse.org/zh-TW/configuration.md#config)。

### Portage 故障

| 錯誤 | 檢查方式 |
| --- | --- |
| Portage 找不到 `net-proxy/doona` | 執行 `portageq get_repos /`，確認輸出列出了本機儲存庫。確認 ebuild 位於該儲存庫的 `net-proxy/doona/` 目錄；儲存庫未註冊時依照第 1 步修正。 |
| 套件被 testing keyword 遮罩 | 檢查第 4 步的 `package.accept_keywords` 項目是否使用目前架構的關鍵字，例如 `~amd64` 或 `~arm64`。 |

## 5. 安裝後端

依照[安裝 honk](https://doona.daeuniverse.org/zh-TW/install.md#install)安裝後端後返回本頁。已有相容的 honk 時無需重複安裝。

systemd 主機使用[服務管理](https://doona.daeuniverse.org/zh-TW/service-management.md)中的 systemd 步驟。OpenRC 主機可使用該頁的前景命令完成首次連線。

接著依照[快速開始](https://doona.daeuniverse.org/zh-TW/quick-start.md)設定 honk 並登入。