PageEdit 技术文档

PageEdit 技术文档

PageEdit ePub XHTML Visual Editor 项目地址: https://gitcode.com/gh_mirrors/pa/PageEdit

PageEdit 是一个基于Sigil的弃用BookView的ePub可视化XHTML编辑器，它采用了WebEngine作为渲染引擎。本项目已完成基本功能并稳定工作。以下内容将指导您如何安装、使用以及理解PageEdit项目。

安装指南

macOS Ventura

1. 环境准备: 确保拥有cmake 3.0+版本，并设置Qt 6.7.2的路径（或至少Qt 6.4.2）。
2. 编译步骤:

   export MACOSX_DEPLOYMENT_TARGET=11.0
   export MYQTHOME=~/Qt672
   export PATH=$PATH:$MYQTHOME/bin
   mkdir build && cd build
   cmake -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 ... ../PageEdit
   make
   make addframeworks
   

   运行编辑器，可以通过命令行或拖放文件到应用上完成。

Linux

共通步骤:

• 确认已安装Qt6.4.2+（推荐6.7.2），cmake。
• 在源代码目录外创建构建目录并执行cmake及make。

Ubuntu特有步骤:

• 安装必要的依赖包，如cmake, qt6-webengine-dev等。

Arch Linux特有步骤:

• 使用pacman安装必要的Qt相关工具和包。

Windows

• 需要Qt6.4.2及以上版本与Visual Studio 2022，确保cmake及Qt的bin目录在系统路径中。
• 使用NMake Makefiles作为生成系统，指定Qt6的路径进行编译。

项目的使用说明

PageEdit允许您直接编辑未打包的ePub中的XHTML文件，支持视觉上的所见即所得（WYSIWYG）编辑。您可以通过加载OPF文件按ePub的Spine顺序编辑文件，或者直接打开一个XHTML文件来开始编辑。

主要功能特性

• 可视化编辑：直观地添加、删除或修改页面元素。
• 黑暗模式：适用于夜间工作的用户界面选项。
• 元素检查器：查看和调整页面元素属性。
• 插入图片与特殊字符：丰富文档内容。
• 链接管理：轻松创建内部或外部链接。

项目API使用文档

本项目主要是GUI应用程序，不提供对外部开发者直接的API接口。不过，开发者可以通过研究源码学习如何利用Qt框架结合WebEngine组件实现类似的功能集成。

项目构建方式（已包含于安装指南）

构建过程依据目标操作系统有所不同，关键在于正确配置Qt环境，设置好构建路径，并通过cmake指定正确的参数进行编译。

---

以上就是PageEdit项目的详细技术文档，包含了安装指南、使用说明以及简化的构建流程概述。希望这能够帮助您顺利使用和理解PageEdit项目。

PageEdit ePub XHTML Visual Editor 项目地址: https://gitcode.com/gh_mirrors/pa/PageEdit