AsciidocFX配置完全手册：自定义主题、字体与快捷键设置

AsciidocFX配置完全手册：自定义主题、字体与快捷键设置

【免费下载链接】AsciidocFXAsciidoc Editor and Toolchain written with JavaFX 21 (Build PDF, Epub, Mobi and HTML books, documents and slides)项目地址: https://gitcode.com/gh_mirrors/as/AsciidocFX

AsciidocFX是一款功能强大的Asciidoc编辑器和工具链，基于JavaFX 21构建，能够帮助用户轻松创建PDF、Epub、Mobi和HTML格式的书籍、文档和幻灯片。本文将详细介绍如何自定义AsciidocFX的主题、字体和快捷键，让你的编辑体验更加个性化和高效。

一、主题自定义：打造专属编辑器外观

AsciidocFX提供了多种内置主题，用户可以根据自己的喜好选择，也可以创建自定义主题。主题设置主要通过theme.json文件进行配置。

1.1 切换内置主题

AsciidocFX默认提供了两种主题：Default和Dark。你可以在conf/themes目录下找到这两个主题的配置文件：

• 默认主题配置文件：conf/themes/default/theme.json
• 深色主题配置文件：conf/themes/dark/theme.json

主题配置文件的基本结构如下：

{ "enabled": true, "theme-name": "Dark", "root-css": "./Style.css", "ace-theme": "tomorrow_night" }

要切换主题，只需修改enabled属性为true，并确保其他主题的enabled属性为false。

1.2 创建自定义主题

如果你对内置主题不满意，可以创建自己的主题。只需在conf/themes目录下创建一个新的文件夹，例如my-theme，然后在该文件夹中创建theme.json和Style.css文件。

theme.json文件定义了主题的基本信息，Style.css文件则用于自定义编辑器的样式。你可以参考内置主题的配置，根据自己的需求修改颜色、字体大小等样式。

二、字体设置：选择适合自己的字体

AsciidocFX支持自定义编辑器的字体，你可以选择系统中已安装的字体，也可以添加新的字体文件。

2.1 内置字体

AsciidocFX内置了多种字体，存放在conf/fonts目录下，包括：

• Dejavu字体：conf/fonts/Dejavu/
• JetBrainsMono字体：conf/fonts/JetBrainsMono-2.225/
• NotoSerif字体：conf/fonts/NotoSerif/

其中，JetBrainsMono是一款专为编程设计的等宽字体，具有良好的可读性和美观的外观。

2.2 添加自定义字体

要添加自定义字体，只需将字体文件（如.ttf格式）复制到conf/fonts目录下的任意子文件夹中。然后在主题的Style.css文件中指定字体：

body { font-family: "My Custom Font", sans-serif; }

三、快捷键配置：提升编辑效率

AsciidocFX允许用户自定义快捷键，以适应个人的操作习惯。快捷键配置文件为conf/shortcut_config.json。

3.1 查看默认快捷键

默认的快捷键配置如下：

{ "disabled": false, "debugMode": false, "dumpMode": false, "shortcuts": [ { "name": "copylinesdown", "desc": "Copy Lines Down", "win": "Ctrl+D", "mac": "Command+D" }, { "name": "fold", "desc": "Fold", "win": "Alt-L|Ctrl-F1", "mac": "Command-Alt-L|Command-F1" }, { "name": "openlink", "desc": "Open Link", "win": "Ctrl+F3", "mac": "F3" }, { "name": "unfold", "desc": "Unfold", "win": "Alt-Shift-L|Ctrl-Shift-F1", "mac": "Command-Alt-Shift-L|Command-Shift-F1" } ] }

3.2 修改快捷键

要修改快捷键，只需编辑shortcut_config.json文件，修改对应操作的win（Windows系统）或mac（Mac系统）属性。例如，将"Copy Lines Down"的快捷键修改为Ctrl+Shift+D：

{ "name": "copylinesdown", "desc": "Copy Lines Down", "win": "Ctrl+Shift+D", "mac": "Command+Shift+D" }

3.3 添加新快捷键

如果需要添加新的快捷键，可以在shortcuts数组中添加一个新的对象，指定name、desc、win和mac属性。

四、项目结构：了解配置文件位置

为了更好地进行配置，了解AsciidocFX的项目结构是很有必要的。主要的配置文件和资源目录如下：

• 主题配置：conf/themes/
• 字体文件：conf/fonts/
• 快捷键配置：conf/shortcut_config.json
• 图片资源：images/

五、总结

通过自定义主题、字体和快捷键，你可以将AsciidocFX打造成最适合自己的编辑器。无论是喜欢深色主题还是浅色主题，偏好等宽字体还是衬线字体，都可以通过简单的配置实现。希望本文能够帮助你更好地使用AsciidocFX，提高文档编辑效率。

如果你想了解更多关于AsciidocFX的使用技巧，可以参考项目中的官方文档：README.adoc。如果你还没有安装AsciidocFX，可以通过以下命令克隆仓库进行安装：

git clone https://gitcode.com/gh_mirrors/as/AsciidocFX

开始你的Asciidoc编辑之旅吧！🚀

【免费下载链接】AsciidocFXAsciidoc Editor and Toolchain written with JavaFX 21 (Build PDF, Epub, Mobi and HTML books, documents and slides)项目地址: https://gitcode.com/gh_mirrors/as/AsciidocFX