Mac配置中文 man 手冊


查看自己的電腦的 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

屏幕快照 2019-11-13 下午7.06.53

brew install autoconf
brew install automake

屏幕快照 2019-11-13 下午7.11.19

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更新到最新版本
屏幕快照 2019-11-13 下午8.25.07

可以看到是系統等版本較低,所以

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 文檔。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM