CP Editor – 安裝

Docs: 在 Releases 中下載

Mon, 01 Jan 0001 00:00:00 +0000

你需要在 Releases 頁面找到你需要的版本，然後根據你的作業系統選擇相應的檔案並下載安裝。

Windows

安裝版

安裝版需要將本軟體安裝在您的電腦。設定組態將儲存於系統的設定目錄中，且 CP Editor 會出現在系統的已安裝程式清單上。

下載檔案列表中的 setup.exe 並安裝它。

免安裝版

免安裝版無需安裝即可執行。其設定組態將與 CP Editor 的可執行檔置於同一目錄，CP Editor 不會出現在系統的已安裝程式清單上。

下載檔案列表中的 portable.zip 並解壓縮到您喜歡的地方。

大多數 Linux 發行版

下載檔案列表中的 AppImage，並賦予其執行權限（chmod +x <AppImagePath>），再執行它。

Debian 衍生的 Linux 發行版

在一些由 Debian 衍生的 Linux 發行版（如 Ubuntu, Linux Mint）您可以下載 .deb 套件並在終端機執行這行命令：

sudo apt install <path to .deb package>

接著輸入 root 使用者的密碼並同意安裝。如果您習慣操作圖形介面，亦可使用像 Gdebi 這樣的工具來安裝 deb 套件。

支援的發行版：Debian 10 Buster、Ubuntu 18.04 Bionic Beaver、Linux Mint 19 Tara 以及更新的版本（或其他由前述版本再衍生的發行版）。

macOS

下載檔案列表中的 .dmg 檔案並安裝它。

在安裝過程中，您可能需要按幾次「好」以存取檔案系統。Apple 可能會警告您這個應用程式是來自未識別開發者的 Mac App。參考 Apple 的 macOS 使用手冊將 CP Editor 授予例外。

Docs: Use package managers

Mon, 01 Jan 0001 00:00:00 +0000

Packaging status

Some of the packages are officially maintained while most of them are maintained by the community.

However, at present, CP Editor is not available in many package repositories. Package maintainers can contact us if any help is needed. For example, we may add some scripts in our CI/CD workflow.

Here are a few guidelines to install the packages.

Snapcraft

You can use Snapcraft to install cpeditor , which is available on most Linux distros.

There are two channels available: latest/stable and latest/edge.

Due to technical reasons, it was published using classic confinement, so you’ll need the --classic option to install it.

To install the latest stable version: sudo snap install cpeditor --classic

To install the latest alpha version: sudo snap install cpeditor --classic --channel=latest/edge

AUR

If you are using Arch Linux , it’s recommended to install CP Editor via AUR . AUR usually also works on Arch-based distros like Manjaro, but it sometimes fails due to reasons like different main repositories.

There are two AUR packages for CP Editor: cpeditor for the stable version and cpeditor-git for the alpha version.

If you are unfamiliar with AUR, it’s recommended to install paru and use paru -S cpeditor to install. You can also read the wiki on how to manually install an AUR package or AUR helpers .

After the installation, you’ll be able to run CP Editor by cpeditor in your terminal or launch from the start menu like other apps.

Docs: 編譯原始碼

Mon, 01 Jan 0001 00:00:00 +0000

Clone 儲存庫及 submodules：

git clone --recurse-submodules https://github.com/cpeditor/cpeditor.git
cd cpeditor

安裝 Qt (5.15 or higher), CMake (3.12 or higher) 及 Python3 。
- 在 macOS 及某些 Linux 發行版，您可以透過套件管理系統來安裝。例如在 Arch Linux 上使用 sudo pacman -S qt5，在 macOS 上使用brew install qt5。
- 您也可以用 aqtinstall 安裝 Qt。
若 CMake 找不到 Qt 的安裝路徑，需要設定環境變數：CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake。以 macOS 而言，執行這個命令 export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.1"。

安裝 Extra CMake Modules 和 KDE (kf5) Syntax Highlighting 。它們不再作為子模組捆綁，必須在建置前安裝到系統中。

在 macOS 及某些 Linux 發行版，您可以透過套件管理系統來安裝。例如在 Arch Linux 上使用 sudo pacman -S syntax-highlighting5，在 macOS 上使用 Homebrew KDE 然後 brew install kde-mac/kde/kf5-syntax-highlighting。

否則，您需要手動 clone 並建置安裝：

git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git
cd extra-cmake-modules
cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF
cmake --build build --config Release --target install # 可能需要 sudo
cd ..

git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git
cd syntax-highlighting
cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF
cmake --build build --config Release --target install # 可能需要 sudo
cd ..

執行下列命令。

Linux/macOS:

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .

Windows:

 mkdir build
 cd build
 cmake ..
 cmake --build . --config Release

依據不同的系統，建置的檔案位於

Linux：build/cpeditor

macOS：build/cpeditor.app

Windows：build\cpeditor.exe 或 build\Release\cpeditor.exe 若執行時發生缺少 DLL 的錯誤，您可以在 PATH 環境變數加上%QtPath%\%QtVersion%\%Compiler%\bin (例如： D:\Qt\5.15.1\msvc2019_64\bin)。

Docs: Use Artifacts

Mon, 01 Jan 0001 00:00:00 +0000

If you want to use the latest version (even later than the beta release), but don’t want to build from source, you can download Artifacts from GitHub Actions .

However, it’s not recommended to use Artifacts, they are more unstable than beta releases, and could be a work in progress. You should read the commit logs and even the source codes before using Artifacts.

To run it on Windows/macOS, you should install from Releases first (usually any version is OK unless something like DLL missing happens). On Windows, replace cpeditor.exe in your install folder with the Artifact. On macOS, run cp path/to/Artifact cpeditor.app/Contents/MacOs, where cpeditor.app is the one already installed on your machine.

To run it on Ubuntu 18.04, you need to install Qt. Other Linux distributions may not support binaries compiled on Ubuntu 18.04.