COSCUP Mattermost 快速上手
====

# 基礎中的基礎

## Mattermost 是什麼？

一個給團隊使用的開源即時訊息溝通平台，由 2020/01/15 起藉 petercpg 協助架設取代 Slack，為大會籌辦團隊服務。

## 怎麼使用？

請到 https://chat.coscup.org 登入

1. 如果你曾經有 COSCUP Slack 帳號，那麼請到上述網址輸入你當初在 Slack 註冊所使用的 email 地址，然後以「忘記密碼」重新設定一下密碼，即可在 Mattermost 裡取回自己的帳號。
2. 新成員：以前未有 COSCUP Slack 帳號的新成員，你將會收到行政組發送的註冊邀請信。

登入後的介面大概長這樣


1. 你的帳號名稱，有空可以換一下大頭貼
2. 聊天頻道列表
3. 個人選單，可以設定一些有的沒的，例如外觀
4. 你目前所在的聊天頻道標題資訊，名稱旁邊有個星星可以點擊後把該頻道加入我的最愛
5. 訊息區
6. 點這裡輸入要跟大家講的話
7. 工具列，依序為
1. 該頻道人員名單
2. 該頻道釘選訊息清單
3. 全站搜尋
4. 全站裡，曾提到你的訊息
5. 全站裡，你個人標記的訊息

基礎大概就是文字聊天沒啥好講的，多的東西再慢慢由日常使用中學習吧？

## 有 App 可以裝嗎？

除了瀏覽器可以看之外，也可以下載 iOS/Android/Windows/Mac/Linux 的 App：

https://mattermost.com/download/#mattermostApps

由於人人都可安裝一台 Mattermost 主機，所以下載 App 啟動後也要先告訴 App 你要去哪台 Mattermost 主機 -- https://chat.coscup.org 輸入進去就對了。

<img src="https://i.imgur.com/ytWo1Ht.png" height="400"><br>

App 使用方式不贅述，基本跟其他聊天工具都大同小異

# 聊天快速概要

* 可以用 [Markdown](https://chat.coscup.org/help/formatting)
* 每則訊息的右上角都有一個選單 ，由左到右分別是「更多功能」、「加上表情符號回應」、「回應此訊息」。 <br><small>（詳細可參考官方文件對於[回應訊息](https://chat.coscup.org/help/composing)的中文說明）</small>
* 如果要特別提到某個人，可以用```@帳號名稱```的方式叫他，例如```@example```。<br><small>（詳細可參考官方文件對於[提到某人](https://chat.coscup.org/help/mentioning)的中文說明）</small>
* 如果要特別提到某個頻道，可以用```~頻道名稱```，例如```~coscup-2020```
* 可以把圖片等檔案直接拖曳進入 Mattermost 視窗中以夾檔，其中圖片會自動展開顯示。<br><small>（詳細可參考官方文件對於[附加檔案](https://chat.coscup.org/help/attaching)的中文說明）</small>
* 可以用```#標籤名稱```為訊息加上 hashtag，例如```#review2020```，請注意這個用法只能用英文字母為開頭，後面倒是可以接數字跟中文字無妨

# COSCUP 安裝的特異功能

一些比較特殊的 Plugin...

## 整合 COSCUP 志工系統

請參考[志工系統上的說明](https://volunteer.coscup.org/setting/link/chat)

## 整合 GitHub

輸入 ```/github connect``` 並連結到你的 GitHub 帳號後，就可以在 Mattermost 獲得你 GitHub 帳號裡的許多資訊，包括設定通知等等。

## 整合視訊

在任何頻道上按下此鈕，訊息欄就會出現一個視訊聊天室連結，點擊即可使用


## Mattermost Board

Mattermost 官方打造（但目前暫停維護）的多用途看板/議題追蹤系統，可以自訂每個議題（卡片）的欄位、設定多重檢視方式等等。

我加這行只是要附註：[只有 Select 或 Person 欄位才能拿來 Group](https://github.com/mattermost/focalboard/blob/main/docs/group-filter-sort-boards.md#:~:text=Card%20grouping%20is%20only%20available%20in%20board%20and%20table%20views%20and%20you%20must%20have%20at%20least%20one%20Select%20or%20Person%20property%20on%20your%20board%20for%20grouping%20to%20work.)

# 其他資訊

## 關於頻道管理

* 頻道的說明（「頻道敘述」）也可以用 Markdown，所以就可以加上連結等等的東西 
* 所有頻道成員都可以邀請人進頻道，也可以踢人
* 原先在 Slack 的 Pinned message ，可以搜尋以後重新 pin 上。

## 換個 COSCUP 風的佈景主題


1. 點擊個人選單 > 帳號設定
2. 在「顯示」下點選「管理主題」
3. 選擇「自訂主題」，並且在後面的輸入框裡貼上這堆，點「Save」

{"sidebarBg":"#517862","sidebarText":"#faf9f7","sidebarUnreadText":"#faf9f7","sidebarTextHoverBg":"#83bf87","sidebarTextActiveBorder":"#aaca86","sidebarTextActiveColor":"#faf9f7","sidebarHeaderBg":"#749b75","sidebarHeaderTextColor":"#faf9f7","onlineIndicator":"#ffe3a6","awayIndicator":"#e0b333","dndIndicator":"#f74343","mentionBg":"#fca4ad","mentionBj":"#ffffff","mentionColor":"#ffd7d7","centerChannelBg":"#333333","centerChannelColor":"#ffffff","newMessageSeparator":"#f80","linkColor":"#83d9f9","buttonBg":"#26a970","buttonColor":"#ffffff","errorTextColor":"#fd5960","mentionHighlightBg":"#f9d610","mentionHighlightLink":"#365050","codeTheme":"github"}

上面是黑色主題，下面是白色主題，可以自行選喜歡的樣式

{"sidebarBg":"#517862","sidebarText":"#faf9f7","sidebarUnreadText":"#faf9f7","sidebarTextHoverBg":"#83bf87","sidebarTextActiveBorder":"#aaca86","sidebarTextActiveColor":"#faf9f7","sidebarHeaderBg":"#749b75","sidebarHeaderTextColor":"#faf9f7","onlineIndicator":"#ffe3a6","mentionBg":"#fca4ad","awayIndicator":"#ffbc1f","dndIndicator":"#d24b4e","mentionBj":"#ffffff","mentionColor":"#1e325c","centerChannelBg":"#ffffff","centerChannelColor":"#3f4350","newMessageSeparator":"#cc8f00","linkColor":"#386fe5","buttonBg":"#1c58d9","buttonColor":"#ffffff","errorTextColor":"#d24b4e","mentionHighlightBg":"#ffd470","mentionHighlightLink":"#1b1d22","codeTheme":"github","sidebarTeamBarBg":"#5c7c5d"}

或者，可以上 [Mattermost Theme](https://avasconcelos114.github.io/mattermost-themes/) 這個主題搜集站看看。