# Libreoffice 或 Openoffice
> 建議用 Libreoffice。 Openoffice 轉換效果不是很完美。
## 作用
對 office 文檔進行轉換處理。在我們程序中，主要用它來將 office 文檔轉成 PDF。
## 安裝
到 Libreoffice 官網下載相應系統`最新版`的 64 位版本的程序。
* 官網：[https://www.libreoffice.org/](https://www.libreoffice.org/)
### Windows
1. 雙擊下載下來的 Libreoffice 程序，全部使用默認安裝的方式進行安裝，直接點擊“下一步”安裝完成。
2. 將Libreoffice 加入到 Windows系統環境 Path 變量。 我這里Windows的安裝路徑是:
~~~
C:\Program Files\LibreOffice
~~~
加入到系統環境變量中的 Path 變量值：
~~~
C:\Program Files\LibreOffice\program
~~~
### Linux
> 建議所有`Linux`系統都用 Ubuntu。
直接在官網進行下載，或者使用如下命令一鍵安裝:
~~~
[sudo] apt install libreoffice
~~~
### Mac
Mac 下，可直接從官網下載 Mac 下的軟件包進行一鍵安裝。或者用`brew`命令一鍵安裝：
~~~
[sudo] brew install libreoffice
~~~
## 是否安裝成功
在`終端`執行如下命令，查看版本號，能查到版本號，即表示安裝成功。
~~~
soffice --version
~~~
如果查看不到版本號或者提示命令不存在，請檢查 Libreoffice 是否已經安裝并且配置了 Libreoffice 的系統環境變量。
如果是Linux或者Mac系統下使用命令一鍵安裝的方式的話，在安裝的過程中就已經自動添加進去了。
## 測試
> `Libreoffice`在進行文檔轉換的過程中，轉換出來的文檔可能會出現亂碼，所以需要在正式使用之前，把可能存在的亂碼問題進行測試和解決。
創建一個`中英文`內容的`.doc`文檔，用如下命令將文檔轉成 PDF:
~~~
[sudo] soffice --headless --invisible --convert-to pdf example.doc
~~~
轉換成功之后，會在當前目錄下生成一個 example.pdf 的文件，然后打開轉換后的PDF文件，查看文件中的中文是否存在亂碼等。如果存在亂碼，則朝以下兩個方向去解決。
1. 字符編碼是否支持，比如 gbk 或者 utf-8 等
2. 是否缺少相應的中文字體庫。如 ubuntu 下，可以使用如下的方式進行安裝：
~~~
[sudo] apt install ttf-wqy-zenhei [sudo] apt install fonts-wqy-microhei
~~~
