寫投影片的工具換成 mkslides

作者:

之前寫過一篇關於我是怎麼撰寫技術投影片的：在不同工作機上不中斷的撰寫技術投影片

結果前陣子發現 revealjs-md 似乎慢慢降低維護能量了，也建議大家改用 mkslides…

用 mkslides 也用了一段時間了，沒什麼問題，語法也幾乎都跟 reveal-md 一樣，大家可以試試。

設定 postgresql 預設編碼

作者:

紀錄一下處理 postgresql 的編碼操作。

第一次安裝

在 Debian 下安裝 postgresql 的時候會根據系統預設的語系 (locale) 建立預設的編碼，包含 encoding、LC_COLATE、LC_CTYPE。如果希望指定資料庫預設的編碼（這邊以 zh_TW.UTF-8 為例），那就照以下步驟處理：

1. 產生對應的語系

編輯 /etc/locale.gen 取消 zh_TW.UTF-8 UTF-8 這一行的註解後，執行指令產生對應的語系：

locale-gen

2. 安裝 postgresql-common

執行：

apt install postgresql-common -y

修改 /etc/postgresql-common/createcluster.conf 

# 將被註解的 initdb_options = '' 取消註解並改成
initdb_options = '--locale=zh_TW.UTF-8 --encoding=UTF8'

3. 安裝 postgresql：

apt install postgresql -y

使用 psql 執行 \l 查看即可確認：

postgres=# \l
                                                     List of databases
   Name    |  Owner   | Encoding | Locale Provider |   Collate   |    Ctype    | Locale | ICU Rules |   Access privileges
-----------+----------+----------+-----------------+-------------+-------------+--------+-----------+-----------------------
 postgres  | postgres | UTF8     | libc            | zh_TW.UTF-8 | zh_TW.UTF-8 |        |           |
 template0 | postgres | UTF8     | libc            | zh_TW.UTF-8 | zh_TW.UTF-8 |        |           | =c/postgres          +
           |          |          |                 |             |             |        |           | postgres=CTc/postgres
 template1 | postgres | UTF8     | libc            | zh_TW.UTF-8 | zh_TW.UTF-8 |        |           | =c/postgres          +
           |          |          |                 |             |             |        |           | postgres=CTc/postgres
(3 rows)

postgres=#

已經安裝，想重建資料庫

如果因為各種意外，不小心安裝了 postgresql 卻忘記先設定語系，也可以照下面的步驟重建。我略過了建立語系的步驟，請參考前面步驟…

1. 停止 postgresql 服務

systemctl stop postgresql.service

2. 刪除 postgresql cluster

# 17 指的是你的 postgresql 的版本
pg_dropcluster 17 main --stop

3. 修改 createcluster.conf

# 將被註解的 initdb_options = '' 取消註解並改成
initdb_options = '--locale=zh_TW.UTF-8 --encoding=UTF8'

4. 建立 postgresql cluster

# 17 指的是你的 postgresql 的版本
pg_createcluster 17 main --start

5. 啟動 postgresql 服務

systemctl start postgresql.service

在不同工作機上不中斷的撰寫技術投影片

作者:

我遇到的狀況

因為工作環境特性的關係，常常會在公司的各個地方移動。雖然公司有配一台筆電給我，但因為一些因素，我還是傾向移動到公司特定地點後就用該位置的電腦繼續工作。所以想要記錄一下自己使用的工具組合，避免不久後金魚腦的自己又忘記了。

投影片本體的製作，我用的是 reveal-md 這套工具來撰寫，因為這工具符合我的幾個基本需求：

  1. 語法好寫可版控
  2. 可上色程式碼片段
  3. 支援 Mermaid 畫圖

我有寫了一篇教學丟在 Github 上，有興趣的可以參考：使用 reveal-md 撰寫投影片。

不過寫投影片常常會需要截圖，或是放一些圖案進去。截圖或是在圖上畫些標記箭頭等需求，Flameshot 這套開源軟體已經完美的解決了我的需求。但接下來的圖片處理，就會令人覺得煩躁，因為你得：

  1. 把圖檔搬移到特定的位置
  2. 撰寫 markdown 語法把圖檔插入

相信我，如果你有大量插入圖檔的需求，這真的很煩人。研究了一下之後，發現以下的配置可以很漂亮的解決這問題。

VSCode

我使用的編輯器是 VSCode。各家編輯器都有愛好者，但 VSCode 拿來寫 markdown 真的方便。除了語法上色，它還提供了即時預覽的功能，等於是你一邊寫一邊看結果，效率會非常的高。當然，還要搭配以下幾個擴充套件和特性，就可以讓撰寫 markdown 的流程一氣呵成：

Markdown Copy Files 功能

這功能是 2023 年 5 月開始支援的，好像沒有正式的名稱。顧名思義，它可以讓你把剪貼簿裡的圖檔直接存到指定的位置並產生 markdown 語法。圖檔名稱會自動序號遞增，所以不用擔心檔案被意外蓋掉的問題。更棒的是如果是搭配下面的 Remote – SSH 擴充套件使用，居然可以自動存到遠端機器上！非常方便好用。

我習慣把圖片都存在 markdown 檔案位置的 images 目錄下，所以我會針對此需求設定：到 Settings -> Workspace -> Extensions -> Markdown 後，拉到最下面，按下 Add Item 按鈕，將 Item 設為 **
，Value 設為 images/ 。

Remote – SSH 擴充套件

因為常常需要移動至不同的電腦工作，所以投影片我習慣都放在遠端機器上，這樣切換不同電腦也沒關係，只要使用 VSCode 連到同一台機器上，就可以繼續投影片的後續製作。這個 Remote – SSH 整合度真的出乎我的意料，除了上面說的複製截圖搭配這個擴充套件可以把圖檔存到遠端機器上之外，居然連 port forward 都有做，所以使用 reveal-md 啟用內建的投影片預覽功能也沒有問題，方便度真的非常高，推薦。

GitHub Markdown Preview 擴充套件

讓內建的 markdown 預覽效果和 Github 上的預覽一致。除此之外其實還多了一些功能，像是支援 task lists 語法，方便你的 markdown 檔案在編輯時與丟到 Github 上不會相差太多。

Markdown All in One 擴充套件

提供一些增強功能，可以看官方網站的說明。

Mermaid Markdown Syntax Highlighting 擴充套件

讓你在寫 Mermiad 語法的時候，支援語法上色。

大概是這樣，把上面的環境搭起來後，拿來寫支援 Markdown 語法的 Revealjs 投影片就很順手了，推薦可以試試看。

該振作了

作者:

結果在重弄這一切的過程當中，發現好多以前訂閱的部落格 RSS 都壞了… 所以這些部落客是選擇把寫出來的文章到處灑到各種社交平台，當作主要的散佈手段了嗎？ :/