查看自己的電腦的 man 信息
查看已經加載的 man 手冊列表
man -aw
查看某個指令在哪一個 man 手冊中,會列出匹配到的 man 列表。用 ls 舉例。
man -aw ls
中文手冊地址
中文 man 手冊頁計划 https://github.com/man-pages-zh/manpages-zh
構建依賴
構建依賴包括:
autotools (autoconf, automake)
python3
opencc 1.x
因為在MacOS中,您會發現它通常是Python 2.7.x的某些變體,可能是2.7.4或2.7.10或類似的。
Python的兩個安裝都將共存而不會發生沖突。
所以放心大膽的用 Homebrew 安裝更新的 Python 3,預裝了Mac OS和Mac OS X的Python 2.7的默認版本仍將安裝,完全不受影響,並且可以使用簡單的“python”命令運行 python3 --version查看版本.
還可以使用'which'或'whereis'命令找出每個python版本的安裝位置.
環境安裝
brew install python3
其自動會下載依賴 : gdbm, openssl@1.1, readline, sqlite 和 xz
Python 安裝在 /usr/local/bin/python3
因為版本問題部分指令python, python-config, pip 已經分別鏈接到 python3, python3-config, pip3 等等, 各自安裝到目錄 /usr/local/opt/python/libexec/bin
具體查看 https://docs.brew.sh/Homebrew-and-Python

brew install autoconf
brew install automake

brew install opencc
獲取中文手冊
把項目下載下來:
git clone https://github.com/man-pages-zh/manpages-zh.git
cd manpages-zh
autoreconf --install --force
./configure
make
sudo make install
可以查看中文文檔是否已經加載
man -aw
/usr/local/share/man:/usr/share/man:/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/share/man:/Library/Developer/CommandLineTools/usr/share/man # 可以看到沒有加載
添加手冊路徑
添加完路徑可以再次檢查手冊是否加載
sudo vim /etc/man.conf
...
MANPATH /usr/local/X11/man #line 44
MANPATH /usr/local/share/man/zh_CN #添加中文手冊路徑
...
:wq
man -aw
/usr/local/share/man:/usr/share/man:/usr/local/share/man/zh_CN:/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/share/man:/Library/Developer/CommandLineTools/usr/share/man # 中文手冊已經加載
將別名添加進 zsh (可要可不要)
echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.zshrc
source ~/.zshrc
或者自己用 vim 編輯,具體看自己怎么操作。
此時可以用cman ls查看下是不是中文,如果是的話就可以了。如果出現亂碼則需要繼續。
解決亂碼
如果系統的groff版本太低,文檔可能出現亂碼,可以將groff更新到最新版本

可以看到是系統等版本較低,所以
brew install groff
安裝完成后,配置 man.conf
sudo vim /etc/man.conf
...
#修改NROFF配置如下(將UTF8編碼的MAN頁面通過轉碼而被groff識別)
#line 95
NROFF preconv -e utf8 | /usr/local/bin/groff -Wall -mtty-char -Tutf8 -mandoc -c
...
#修改PAGER配置如下(這樣可以避免MAN手冊頁面中的ANSI Escape字符序列干擾(用於控制顯示粗體等格式))
#line 106
PAGER /usr/bin/less -isR
...
:wq
完結
經過測試,終於 可以查看中文的手冊。 但是 mac 的觸屏 bar 仍然使用的是 系統的MacOS 自帶的, 所以設置的別名就很方便了 直接輸入 cman ls 就可以查看中文的ls 文檔。
