关于
许可证
Cherries
安装程序
构建
- 在哪些平台上最好使用 Conan 来构建 markdown-tools？
- 为 Windows 构建
  - 要为 Windows 构建完整的安装程序，您需要
已知问题
翻译

关于

这是一套用于处理 Markdown 的应用程序，包括编辑器、HTML 预览查看器以及转换为 PDF 的工具。

许可证

/*
    SPDX-FileCopyrightText: 2026 Igor Mironchik <igor.mironchik@gmail.com>
    SPDX-License-Identifier: GPL-3.0-or-later
*/

Cherries

你可以在这里]查看演示文稿。

安装程序

对于 Linux，尤其是 KDE，我建议使用系统自带的 Qt 进行自行构建，这样你在 KDE 中就不会遇到平台集成问题。

请查看发布页面以获取某些 Linux 和 Windows 发行版的安装程序。

构建

要构建这些应用程序，首先请安装依赖项：

zlib
extra-cmake-modules
kf6-syntax-highlighting
kf6-sonnet
kf6-kwidgetsaddons
Qt >= 6.7
fontconfig 用于 Linux

安装这些依赖项后，只需在 QtCreator 中打开 CMakeLists.txt （或从命令行使用 CMake）并运行构建。

你可以使用 Conan 来安装一些依赖项。

Fontconfig 应安装在系统中，因为从 Conan 使用 Fontconfig 会导致 UI 丑陋。

还有一件事 - 不要使用 jom。

在 KDE 上，我建议使用系统的 Qt 库，因为在这种情况下应用程序将使用 KDE 的 Platform Plugin，从而实现与系统的更好集成。

在哪些平台上最好使用 `Conan` 来构建 `markdown-tools`？

我不建议在 MacOS 上使用 Conan，因为会与 brew 和系统库发生冲突，正如我建议使用来自系统的 Fontconfig 一样。会出现问题。只需在 MacOS 上使用 brew 来安装依赖项。

在 Windows 上，Conan 是构建此项目的一股新风。

在 Linux 上，你可以使用任何你想要的工具，这就是为什么它是我最喜欢的操作系统。

为 Windows 构建

要在 Windows 上启动开发流程，您可以从根目录使用 QtCreator 和 CMakeLists.txt。但在此之前，您需要构建并安装 Sonnet、SyntaxHighlighting、KWidgetsAddons、Extra CMake Modules，并通过 PATH、INCLUDE、LIB 环境变量使其可用。

构建 Windows 完整安装程序需要

创建一个用于工作的文件夹。
将本仓库和 https://github.com/igormironchik/kde_breeze_win 克隆到第 1 点所述的文件夹中。
在本仓库的 markdown-tools 根目录下启动 script\windows\install-qt.bat。
在 kde_breeze_win 仓库中启动 install-kde.bat。
在 markdown-tools 仓库中启动：
- script\windows\install-kde.bat
- script\windows\build.bat
- script\windows\copy-binaries.bat
- script\windows\copy-qt.bat
- script\windows\deploy.bat

完成这些步骤后，在 markdown-tools 仓库的根目录下，您将获得 Markdown_Windows_x64.Installer.exe。

已知问题

不要在 HTML 标签中使用 HTML 属性 class，这可能导致内容渲染错误。 GitHub 在这种情况下会进行特殊处理，它只是删除了 class 属性，但该编辑器会按原样放置 HTML 标签。
在字体对话框中，勾选/取消勾选将字体限制为等宽字体的复选框时，字体组合框出现异常行为，原因是 QTBUG-112145
我在 PDF 中不渲染 HTML 标签。
在转换为 PDF 的转换器中，我不支持不使用空格分隔单词的语言。

翻译

要将这些应用程序翻译成您的语言，您需要运行

lupdate6 . ../3rdparty/github-release/src -ts ../translate/md_{locale}.ts

从 src 目录。

使用 Qt Linguist 翻译该文件，并在 translate 目录中运行

lrelease6 md_{locale}.ts -qm ../src/shared/tr/md_{locale}.qm

并在 src/shared/tr.qrc 文件中添加新行，记录新的翻译。

通过这些更改，你可以向该仓库提交一个 PR。

关于

许可证