README.md

# Thank you for try Alter Linux i3 Edition

This document will show how to use Alter Linux i3 Edition.
このドキュメントでは、Alter Linux i3エディションの使い方を紹介します。

1. 日本語
2. English

## 目次

1. インストールされているi3wmについて
2. 基本的な使い方
   1. ソフトを起動する
   2. ウィンドウの簡易的な操作
   3. ソフトを追加・更新する
   4. シャットダウンする
   5. テーマを変更する
   6. システム設定マネージャを使用する
   7. インストール方法
3. ショートカットキー
   1. キーの定義
   2. 重要ショートカット
   3. ワークスペース・ウィンドウ
   4. ソフトウェア
4. 設定を変更したい
5. その他

## インストールされているi3wmについて

Alter Linuxでは，ウィンドウマネージャとしてi3wmからフォークされたi3-gapsがインストールされています。
これはオリジナルのi3wmに，ウィンドウの間を空ける機能などが搭載されたものです。
以降はi3-gapsをi3wmとして解説します。

## 基本的な使い方

i3wmはタイル型ウィンドウマネージャです。ウィンドウが増えるたびに、i3wmは自動でウィンドウをリサイズし、整列させます。
基本的な操作はショートカットで行います。ショートカットについては、こちらを参考にしてください。
豊富なショートカットが用意されていますが、その全てを覚える必要はありません。まずはデスクトップに表示しているショートカットキーを覚えるところからはじめましょう。

### ソフトを起動する

ソフトを起動するために、ランチャーが用意されています。
mod(Windowsキー)+Dでランチャーを起動し、上下キーでソフトを選択、Enterキーで起動します。
デフォルトでインストールされている主なソフトの一部を紹介します。

- Chromium (Webブラウザー)
- Thunderbird (メーラー)
- VLC メディアプレイヤー
- LibreOffice

### ウィンドウの簡易的な操作

mod+上下左右キーで、アクティブなウィンドウを切り替えることが出来ます。
また、mod+Shift+Qキーで、アクティブなウィンドウを閉じることが出来ます。

### ソフトを追加・更新する

mod+Dキーでランチャーを開き、「ソフトウェアの追加と削除」を起動してください。ストアが表示されます。
ソフトの更新は、上部の「アップデート」タブからすることができます。
「パッケージが見つかりません」と表示された場合は、右上のメニューから「データベースをアップデートする」を選択してください。

### シャットダウンする

mod(Windows)+Shift+iキーでメニューが表示されます。
「Shutdown」を選択することでシャットダウンが開始されます。
また、再起動やスリープなどもここから選択することが出来ます。

## テーマを変更する

mod+Shift+S で、Alter Linux i3独自のテーママネージャを起動できます。
このテーママネージャでは、画面の上 (デフォルト) にあるパネルの見た目、位置などを変更することが出来ます。

## システム設定マネージャを使用する

mod+Bで、システム設定マネージャを起動できます。
このショートカットを押すと、新規ターミナル上で設定マネージャが起動します。変更したい設定に該当するカテゴリの数字を入力し、設定を変更してください。

### インストール方法

ライブ環境を試してみて、インストールしてみたいと思ったら、mod+iキーでインストーラが起動します。
インストーラの指示通りに進み、インストールしてみてください。

## ショートカットキー

i3wmには多数の便利なショートカットがあります。ショートカットは[mod]と呼ばれるキーとの組み合わせであることがほとんどです。
ここでは、ショートカットの一部を紹介します。

### キーの定義

- mod : super (Windowsキー)
- Arrow : ←[ j ], ↓[ k ], ↑[ l ], →[ ; ]キー (カッコ内キーで代用可)

### 重要ショートカット

ショートカット | 内容
--- | ---
mod+Enter | ターミナルを開く
mod+Shift+Q | アクティブウィンドウを閉じる
mod+D | ランチャーの表示
super+Esc | 画面のロック
mod+Shift+E | 電源メニュー
| (電源メニュー時)
S | シャットダウン
R | 再起動
O | ログアウト
L | ロック
Q, Esc, Enter | キャンセル

### ワークスペース・ウィンドウ

ショートカット | 内容
--- | ---
mod+0-9 | ワークスペースの変更
mod+R | リサイズモード (リサイズモード中に押すとキャンセル)
mod+Shift+0-9 | アクティブウィンドウを他のワークスペースに移動する
mod+Arrow | アクティブウィンドウの切り替え
mod+Shift+Arrow | アクティブウィンドウの移動
mod+h | 新規ウィンドウの作成位置を水平 (横) 方向にする
mod+v | 新規ウィンドウの作成位置を垂直 (縦) 方向にする
mod+Shift+R | i3wmの再読込

### ソフトウェア

ショートカット | 内容
--- | ---
mod+Shift+S | テーママネージャ (パネルの見た目変更)
mod+B | システム設定マネージャ
mod+Shift+PrtScr | スクリーンショットの撮影

この他にも多数の便利なショートカットがあります。

## 設定を変更したい

カスタマイズを加えたい場合は、この項目を参考にしてください。

- パネルを変えたい
  前述のテーママネージャを使用してください
- 画面の解像度など、システムの設定を変更したい
  前述の設定マネージャを使用してください
- 壁紙を変えたい
  ランチャーなどからnitrogenを起動し，お好みの画像に変更してください
  壁紙を追加したい場合は右下のボタンから設定を開き，壁紙があるフォルダを追加してください
- 操作方法が表示されたウィンドウを非表示にしたい
  `~/.config/conky` を削除する、もしくは `~/.config/i3/config` を編集し、42行目 (`exec --no-startup-id conky`) を削除することで無効に出来ます

## その他

- わからないことがある
  Twitter (@Fascode_SPT) へのDMや返信等で気軽に聞いてください。

## Table of Contents

1. Basic Usage
   1. Launch the software
   2. Simple manipulation of windows
   3. Add or update software
   4. Shutdown
   5. Change the theme
   6. Using the System Configuration Manager
   7. How to install
2. Shortcut keys
   1. key definitions
   2. Most important shortcut
   3. Workspace, window
   4. Softwares
3. How to change the settings
4. Q&A

## About installed i3wm

Alter Linux installed i3-gaps forked from i3wm as a window manager.
i3-gaps added gaps between window to original i3wm.
This document will explain i3-gaps as i3wm.

## Basic Usage

i3wm is a tiling window manager. Each time you add more windows, i3wm will automatically resize and align them.
The basic operations are done using shortcuts. See Shortcut keys for more information on shortcuts.
There are many shortcuts available, but you don't need to remember them all. Let's start by learning the shortcut keys that displaying on your desktop.

### Launch the software

The launcher is installed to launch the software.
Start the launcher by pressing mod(Windows key)+D, select the software by pressing the up and down keys, and start it by pressing Enter.
Some of the main software installed by default are listed below.

- Chromium (web browser)
- Thunderbird (mailer)
- VLC Media Player
- LibreOffice

### Simple manipulation of windows

You can use the mod+up, down, left, and right keys to switch between the active windows.
You can also use the mod+Shift+Q keys to close the active window.

### Add or update software

Use the mod+D keys to open the launcher and launch "Add/Remove Software". The Store will start.
You can update the software from the 'Update' tab at the top.
If you get a message "Package not found", select "Update database" from the top right menu.

### Shutdown

Press mod(Windows)+Shift+E to bring up the menu.
Selecting "Shutdown" will start the shutdown.
You can also choose "reboot", "Logout" and more.

## Change the theme

You can use mod+Shift+S to launch Alter Linux i3's own theme manager.
This theme manager allows you to change the appearance, position, etc. of the panels at the top of the screen (the default).

## Using the System Configuration Manager

You can use mod+B to start the System Configuration Manager.
Pressing this shortcut will launch system manager in a new terminal. Enter the number of the category whose settings you want to change and change the settings.

### How to install

If you want to try the live environment and install it, use the mod+i key to launch the installer.
Follow the installer's instructions and try to install it.

## Shortcut keys

i3wm has many useful shortcut keys. Most of the shortcuts are in combination with a key called [mod].
Here are some of them.

### Key Definitions

- mod : super (Windows key)
- Arrow : ←[ j ], ↓[ k ], ↑[ l ], →[ ; ] key (you can substitute the key in parentheses)

### Most important shortcut

Shortcuts | Contents
--- | ---
mod+Enter | Open a new terminal
mod+Shift+Q | Kill active window
mod+D | Software launcher
super+Esc | Screen lock
mod+Shift+E | Power menu
Esc | Canncel the power menu

### Workspace, window

Shortcuts | Contents
--- | ---
mod+0-9 | Switch workspaces
mod+R | Resize mode (Canncel when )
mod+Shift+0-9 | Move active window to other workspace
mod+Arrow | Switch active window
mod+Shift+Arrow | Move active window
mod+h | Change the new window position horizontally
mod+v | Change the new window position horizontally
mod+Shift+R | Reload i3wm

### Softwares

Shortcuts | Contents
--- | ---
mod+Shift+S | Theme Manager (change the look of the panel )
mod+B | System setting manager

There are many other useful shortcuts.

## How to change settings

If you want to add some customization, please refer to this section.

- Change the panel
  Use the Theme Manager described above
- Change the system settings, such as screen resolution, etc.
  Use system manager as described above
- Change the wallpaper
  Run `nitrogen` from the launcher or terminal, and select the image to one you like.
  If you want to add a wallpaper, click the button on bottom right to open the settings window, and add the folder where the wallpaper is located.
- Hide the window with the operating instructions
  Remove `~/.config/conky` , or edit `~/.config/i3/config` and remove line 42 (`exec --no-startup-id conky` )

## Q&A

- There's something I don't understand
  Feel free to ask by DM or reply to Twitter (@Fascode_SPT).

    	Alter Linux i3 edition help document
    	Watasuke
    	Twitter: @Watasuke102
    	Email  : Watasuke102@gmail.com
    	(c) 2021 Fascode Network.