WDTP：一款“三合一”的写作工具和桌面版静态网站生成器

[SwingCoder]

谢谢 Akkuman 和 CoderZh 两位朋友的介绍和推荐，让我得知了 V2EX 这个尊重原创，热爱分享与创造的好网站。我想在此和大家分享一款我刚刚开发完成的软件（目前是内测版，正在不断完善更新），如有不妥，请管理员批评指正并谅解。

WDTP 是一款“三合一”的另类写作工具与桌面 GUI 单机性质的静态网站（博客）生成器，这个项目的主页是：

http://underwaysoft.com/works/wdtp/index.html

WDTP 昨天首发于国内的凯迪论坛，我将原帖复制粘贴在此吧。

---

WDTP ：源于凯迪论坛的又一款写作利器

2016 年年初，我在凯迪论坛看帖的时候，意外地发现了一座高楼，所讨论的话题是我前几年很感兴趣的。于是开始关注，时不时也掺和几句，然后就和几位骨干帖友混了个脸熟——其中一位是陈坪先生。有天我去拜访他的博客，浏览文章的时候突然冒出一个 idea ，可能更像是一些自我觉察，大致如下：

• 多年以来，在写稍微正规一点的东西时， Pages 或 Word 之类的巨无霸实在让人心累，可能也不是太必要。即便这些巨无霸，对多个文档的集中组织与结构化管理也不好使，更别说那些纯文本的编辑器和网页端基于各类脚本写就的编辑器；
• 平时读书、学习或做笔记时，除了我个人开发的一款同类软件， Evernote 等臃肿不堪的云笔记已经很难让我有愉悦的使用体验；
• 写博客时，我可能并不需要 WordPress 等服务器端运行的脚本+数据库，更别说现成的各类博客平台……

诸如此类。相信其他一大批小众也会有这些想法。说实话，以上这些真心不好用，尤其是学习与使用成本，还有使用时的心情，数据的随时检视、备份、管理与迁移，远程修改、调试与刷新等等。很折磨人。它们或许非常适合更广泛的一大批用户，某些情况下肯定也是非用不可，但很多时候确实不再适合我，也没必要时时动用这些怪兽级的庞然大物。

更进一步，笔记、写书、博客、网站这几件看似互相割裂的事，其实完全可以也早就应该简简单单、清清爽爽地合而为一了。而写作时，“内容与样式分离、样式与模板分离”等程序员最熟悉的理念与常规做法，这么多年以来，我为什么没有在自己的文字写作过程中更深入地理解和贯彻呢？有点不应该。

想法中还包括了其他。比如：“静态网站生成器（ Static Site Generator ）”，这东西近两年在喜欢尝鲜的技术类博主中很受推崇。有媒体放言：“下一批互联网大事件中，新型的静态网页及其生成将位列其中”……据我所知，这类程序目前至少上百，采用了各种各样的编程语言，它们中比较知名的有： Jeklly 、 Hugo 、 Hexo 、 Octopress 、 Pelican 、 Hyde 等等。尤其是 Jekyll ，背靠 Github 这棵大树，几乎一夜之间风靡全球。我对此做了一些肤浅的调查，一个匪夷所思的事实是：就我所接触到的“对口者”，竟无一例外——清一色的命令行程序！没有 GUI ，没有文本编辑器与可视化的 TreeView ，有的居然还要安装整个语言环境或依赖库。动辄百兆以上，太让人愤慨了。大不说，还麻烦。无论获取、安装，还是设置、使用，都不直观，也不方便，对一般人来说门槛有点高。这就势必将更广泛的用户群（比如普通的写作者）排斥在外，使他们很难享受到文本标记语法、内容 /样式分离、高自由度和灵活随意的静态博客等另类而好玩的写作 /分享模式。

既然尚无，那迟早就会有人下手，不妨等等，于是我就把这个事搁置了。此期间，我曾加入一个推广某静态生成器的国内群，也在 Stack Overflow 上转了转，四下打探一番，无果。有人曾抱怨过，但最终也是不了了之。

浏览陈坪先生的文章时，以上想法突然变得强烈起来。我琢磨了一下，这个事技术含量虽不高，但并不轻巧。脏活总是让同行包揽始终让人过意不去，干脆我自己趟一次浑水，再造个轮子吧：写一款跨平台且简洁清爽的桌面版静态网页生成器，顺便糅合上面提到的那几个功能，尽量将它们捏到一起，争取做的轻巧点、优雅点，先把基础和架子搭起来，后续事务和细化处理慢慢再捯饬。

琢磨的七七八八后，就立项动工了。关于编程语言的选择，脚本不考虑，平台相关的谢绝，数据库滚蛋。这么一来，似乎只有 Java 或 C++了。 Java 一贯不是我篮子里的菜，就 C++吧。

然后……然后就是今天 WDTP 内测版的首发，地点就在凯迪论坛的猫眼看人版块。可能有点唐突违和，请允许我解释一下：一方面这个程序的诞生确实与凯迪有直接的关系；另一方面此处风云际会、藏龙卧虎，能写、会写、喜欢写的人非常多，给这批笔友提供另一件顺手的写作工具应该是一件有意思的事。此外，似乎还没有哪位同行在这样的大杂烩论坛里做过这种类型的“主播”。这事有挑战性，风险并不小。但我想试试。

产品的首发式上，一般都会真真假假、虚虚实实地谈谈愿景、希望什么的。我这会儿有点忐忑，不敢满口火车。现在最大的希望是：值班编辑此刻心情不错，不删改这个贴，也不打算将它转移到凯迪的其他版块里。

关于程序的授权方式和性质， GPL v3 ，开源免费。不光凯迪的网友，全世界任何个人和组织都可以随意使用、传播、解剖源码或 PR 贡献，也接受来自任何方面的捐助。这些没什么需要多解释的。该有的，《授权协议》里都提到了，不够我再加几条：）

项目开工后，中间曾停工 3 个多月。 2016 年我周围发生了几件悲伤的事，让人心碎，这几乎导致了项目的夭折。费了很大劲我才将自己振作起来，硬挺着把 WDTP 的第一个版本敲了出来。活干得如何，横竖不论，交给诸位评说。目前 Bugs 肯定一堆，代码急需规整，很多细节也亟待完善。我实在不好意思说自己是一个敲了整整 30 年代码的老一代苦逼程序员——面老色衰，人狗远之。大江东去，属于我们的时代过去了……滚出这个行业之前，尽力散发点余温吧。希望热情还在，理想还在，更希望能听到真实而有价值的反馈与意见，以及各位同行的 PR 提交、无私贡献。

可能有人对大部分开源软件的维护更新感到不放心。我在此表个态吧：未来很长一段时间内，我可能每天都要用它，而且是重度使用。无论作为设计人、开发者、项目的第一责任人，还是作为用户之一，我肯定不愿意为了它而过分难堪或郁闷，更不会让它在七歪八扭、一团乱麻的失控状态下无果而终。

关于 WDTP ，还有几个必须要感谢的人——期待未来会更多，以后有机会一定专门提及。

That's it. 谢谢所有看了此贴的人，谢谢即将成为 WDTP 用户的每一个人，谢谢陈坪先生和那个高楼长贴，以及该贴中所有让我感到温馨的人。

今日立春，使用愉快！

SwingCoder 2017.02.03 于凯迪论坛

本文已发布在凯迪论坛的猫眼看人版块： http://club.kdnet.net/dispbbs.asp?id=12102372&boardid=1

---

• WDTP 简介： http://underwaysoft.com/works/wdtp/introduce.html
• 授权协议（免责声明与使用许可）： http://underwaysoft.com/works/wdtp/license.html
• 下载、安装及运行： http://underwaysoft.com/works/wdtp/download.html
• WDTP 原生支持的 Markdown 语法及默认的渲染效果： http://underwaysoft.com/works/wdtp/mdDemo.html
• 快速上手： http://underwaysoft.com/works/wdtp/gettingStarted.html
• 常见问题及解决方案： http://underwaysoft.com/works/wdtp/QA.html
• 主要更新记录： http://underwaysoft.com/works/wdtp/updateList.html
• Memo list: http://underwaysoft.com/works/wdtp/memoList.html

欢迎大家下载试用并提出宝贵意见！

谢谢！

SwingCoder

上述网址自WDTP第一个内测版发布后陆续做了修改，部分已失效。目前最新的有效网址是：

• 简介、编译及下载：http://underwaysoft.com/works/wdtp/download.html
• 主要更新记录：http://underwaysoft.com/works/wdtp/updateList.html
• 示例及语法详解：http://underwaysoft.com/works/wdtp/syntaxMark.html
• 快速上手：http://underwaysoft.com/works/wdtp/gettingStarted.html
• 常见问题及解决方案：http://underwaysoft.com/works/wdtp/faq.html
• GitHub主页：https://github.com/LegendRhine/WDTP
• 在线交流、提问、报告BUG、反馈意见和建议：https://github.com/LegendRhine/WDTP/issues
• PR提交：https://github.com/LegendRhine/WDTP/pulls

欢迎下载试用并提出宝贵建议，欢迎反馈意见及BUG（包括网站BUG）。所有BUG一经确认，我将放下手头上一切事务，以最高优先级去解决。

[SwingCoder]

谢谢 @iscraft 朋友的支持和鼓励：）

[SwingCoder]

修复： Windows 平台下，导入某些文本文档后显示乱码的 bug 。

[SwingCoder]

实现：智库的构建与重建。

[SwingCoder]

发布： 0.9.0331 内测版。编译及下载地址：
http://underwaysoft.com/works/wdtp/download.html

[ivvei]

看到后面感觉画风突变啊…… 作者为何如此容易动怒…… 你和 TheKiteRunner 前面关系不是看起来一直很融洽的嘛，怎么一句 SublimeText3 就怒了。他那句也不是有意和 SublimeText 比较说你的不如 ST3 ，无非是想表达你这个不是专门的编辑器所以正则不是核心功能如果不想添加或者一时没空添加也无妨之类的意思而已。分明是给你找台阶啊。这误会了也就罢了，就当是有代沟吧，怎么后面还能上纲上线到那种地步……

[SwingCoder]

更新：程序图标由“绿羽霓”改为“山·湖·路”（ UnderwaySoft LOGO 的左半部分）。

[SwingCoder]

实现：基于 WDTP “智库”架构的自定义智能提示与自动补全。详情请参见：
http://underwaysoft.com/works/wdtp/faq.html#如何实现智能提示和自动补全？

[SwingCoder]

改进：编辑修改智库文档后（ root/tips ），系统内部自动重建智库。

[SwingCoder]

实现：编辑模式下，选择文本后可右键菜单（提示与替换）或 Ctrl + G 弹出所选内容的智库信息（如果有的话）。同样，也可将所选文本加到智库中。

[SwingCoder]

完善：“复习 /提醒 /回顾”功能。文件树面板右击某个目录后，弹出的菜单中点击“批量设置提醒日期”，可一次性设置该目录下所有文档的提醒日期。此操作将在每个文档已有设置日期的基础上推迟或提前一些天数，也可批量清除已设置的提醒日期（输入一个正整数为推迟的天数，负整数为提前到期的天数， 0 或非数字则为批量清除）。注：此操作不影响未设置提醒日期的文档。如果某个目录下（含其所有子目录）没有任何文档设置了提醒日期，则该菜单项暗显不可用。

[SwingCoder]

完善：删除操作时，如所选包含目录，确保删除对应的网站目录，而非仅删除其网页文件。

[SwingCoder]

实现：软件内置的主题修改 /自定义功能。详情请参见：
http://underwaysoft.com/works/wdtp/faq.html#如何修改 /制作 /备份 /发布 /加载主题？

[rosu]

楼主真是全倾全力了。加油～

[SwingCoder]

实现：录音完成后，可调整音量（录音对话框右上方新增一个调整音量的推子）。音量调整的范围： 0.2~10.0 （原始录音音量的倍数。 2 倍意味着增益 6dB ； 0.5 倍意味着衰减 6dB ）。调整音量将实时影响波形缩略图的显示及播放的音量，同样也将影响最终的录音结果。双击音量推子将恢复为 1.0 （意味着既不增益，亦不衰减）。

[SwingCoder]

@rosu 谢谢：）

[SwingCoder]

实现：首次启动本程序或者启动后未加载任何项目的情况下，弹出一个 Callout Box （标注框），箭头指向工具栏“齿轮”图标并显示提示信息，以方便新用户尽快上手。

[SwingCoder]

实现：首次运行本程序，如操作系统的默认语言为中文，则 WDTP 自动设置为中文界面。注：当前仅支持英文和中文这两种语言，更多语言有待今后陆续加入。

[SwingCoder]

取消：软件内置的图像、音频、视频等多媒体数据的本机非线性编辑及 DSP 处理模块的底层架构。

[SuperMild]

不知道为什么，有一种老派的古板的感觉

[SwingCoder]

@SuperMild 你好。“老派古板”是程序界面，默认配色与布局，目前的纯文本编辑模式，默认的渲染效果，程序的操作模式，某些功能的设计、架构与实现模式，编程风格， C++语言的运用……还是目前 UnderwaySoft 网站的样式、文档语言的风格……还是我在这里发布的主要更新记录的行文风格？能否具体一些？如不吝指教，能否提供明确的改进建议？

谢谢。

[SwingCoder]

本次刷屏结束，以下继续“实况播报”：）尽力争取第一时间发上来，如有延误请谅解。

也可随时关注网站的《 WDTP 主要更新与发布记录》，地址：
http://underwaysoft.com/works/wdtp/updateList.html

再次感谢诸位的支持、鼓励与顶贴。

[SwingCoder]

实现：图像与音频数据的外部编辑功能。详情：

•文本编辑模式下，选中当前所插入的图像或音频文件的文件名（包括其扩展名，不包括其上级目录）。该文件需位于当前文档的 media 目录下。
•鼠右弹出菜单，可找到一个菜单项为“外部编辑媒体文件”。其下有两个子菜单：“用外部编辑器打开”，“指定默认的编辑器”。
•如所选文件无法识别，这两个菜单项暗显不可用。
•如当前尚未指定所选媒体文件的外部编辑器，“用外部编辑器打开”菜单项暗显不可用。此时可“指定默认的编辑器”。
•指定适合所选媒体类型的编辑器（本机已安装的某个程序的可执行文件），该信息将被 WDTP 记录并保存。如无意外，以后无需再次指定（当然，也可以随时更换另一个更合适的程序，再次指定即可）。
•图像编辑与音频编辑需分别指定。除非安装了某个程序既可以编辑图像，又可以编辑音频。
•指定默认的外部编辑器后，上述第一个菜单项可用。点击此菜单项后，操作系统将启动所指定的外部程序并自动加载当前所选的媒体文件（媒体类型由所选文件的扩展名决定，其对应的外部编辑器由 WDTP 自动决定）。
•外部编辑器中进行必要的处理。处理结束，保存退出，返回 WDTP 主界面。 Ctrl + S 预览，如对结果不满意，可再次处理。

[SwingCoder]

完善：使用快捷键 Ctrl + V 进行智能粘贴时，如当前所粘贴的内容为代码并且包含 TAB 缩进标志，则将其替换为四个空格。此举可解决粘贴某些代码后，编辑模式下未正确显示缩进的问题（预览模式下缩进正常）。 注：如需粘贴原始内容（不替换 TAB ，也不进行插入网址、媒体文件等智能识别与处理），则点击右键菜单中的“粘贴”菜单项（某些时候，可能需要粘贴原始内容）。

[SwingCoder]

完善：重新生成整站之前清除冗余数据时一并清除所有项目文档 media 目录下的子目录（这些子目录有可能是运行外部编辑器后遗留下的）。

[SwingCoder]

更新：关于对话框标题栏显示本程序的位数（ 32 或 64 ），而不是操作系统的。

[hzwei]

首次在这里看见楼主自己回复这么多的帖子，楼主确实好尽心尽力啊， star 一下。

[SwingCoder]

WDTP 更名为“ Walden Trip ”，中文名称：“山·湖·路”（如果你喜欢，也可以称之为“山葫芦”： D ）。 WDTP 的简称不变。

[SwingCoder]

@hzwei 谢谢：）

[imcocc]

开发者的效率好高。虽然不使用您的软件，可被您尽责尽心的精神震撼了，有此精神，什么事都能做成功，做的完美。
虽然我不是您软件的受益者，可我是您所表现出来的精神的受益者。很多时间后，我可能记不住您的软件名，可我能记住 有一位前辈，尽心的信守承诺。

[SwingCoder]

完善：新用户上手提示功能。创建项目后，弹出标注框，箭头指向刚刚创建的项目根目录并显示提示信息。

[SwingCoder]

@imcocc 朋友，谢谢您的支持与鼓励！

[FEDT]

关注一下

[SwingCoder]

上面有位朋友说的对，我对 TheKiteRunner 先生的言辞过于尖刻寡情了。事情虽然已过去，但这些天我总是感到内心不安。 WDTP 刚发布的时候，他给出过非常多的宝贵意见，缩略语这个重要功能和我由此而产生的很多全新思路都是因他的建议而来。他也是第一个捐助 WDTP 的热心用户。可以说，他有大恩于 WDTP 。不管后来发生了什么，你们看到的，还有没看到的……无论如何，我不该如此翻脸无情并将某些一贯难忍的事迁怒于他，这显得忘恩负义，心胸狭隘。

这是一个深刻的教训，我定当继续认真反思。如果 TheKiteRunner 先生能看到我的这些话，我愿意加他的 QQ 并和他长谈一次，当面致歉。

我的其它一些观点和想法，他公开了一部分，技术、网站和 WDTP 的发展大方向等方面，我依然保持原有立场。这和我与任何人的私交及关系好坏都基本无关。

再次感谢大家对 WDTP 和我个人的支持与鼓励。虽然这个软件不是高大上、高精尖甚至人命关天的专业级、工业级重大项目，也没有多少新意和玩法，但是我既然下手了，在病情和时间允许的前提下，就一定会尽力把它做好，做得更加不同质，更好玩一些。我的时间可能不多了，在还能敲得动键盘之前，争取多做一点，把架子搭得更扎实一些。以后如有其他朋友接手，可能会省一点时间和心力。

欢迎各类宝贵意见和建议，特别是各种疯狂而不可思议的点子：）

[SwingCoder]

@FEDT 谢谢关注：）

[SwingCoder]

改进：设置提醒日期的文本框仅接受数字字符，并且最大为 4 位数字。

[SwingCoder]

更新： Markdown 二级标题文本标记解析后自动在标题下添加一条分割线。

[SwingCoder]

实现：文章归档功能。详情：

•文档属性面板中新增一个设置项：文章归档。勾选即可将当前文档设置为“归档”。
•归档后，无法编辑修改该文档（编辑模式下，文本颜色与背景色均与常规文档不同，不显示插字符）。
•无法替换归档文档中的任何内容，也无法删除或重命名已归档的文档。
•其它方面，归档文档同普通文档。
•随时可将任意文档归档，或取消归档。

[izgnod]

@SwingCoder 感谢作者带来这么好的软件，今天仔细的用了一番。发现一些小问题。 1. catagory 的顺序无法改变，只能创建的时候排好顺序。 2. 重新生成网站的时候 site 目录中不能删除修改过的目录或者是文件。例如：根目录下有一个 temp 目录，把 temp 修改成 temp2 之后，重新生成网站 temp 和 temp2 都有。 3.浏览模式下，修改文件名或者改变文件名字等不能够跟随改变。

有几点疑惑:1.能够修改 logo 的图片么？^_^
2. 如何加入评论？

[izgnod]

还有就是我本地没有 build 的环境，作者是否有地方可以下载到每日的更新好的可执行文件

[SwingCoder]

归档文档的文件树图标为一个实心三角形：▲

[SwingCoder]

@izgnod 朋友，您好。感谢试用 WDTP 并提出宝贵意见。

1. 文件树面板中，目录和文档的显示顺序可随意设置，右键菜单-排序基于。 WDTP 没有 category 这个概念，所组织和管理的目录文档与本机磁盘文件结构严格对应，完全一致。如果某些目录或文档作为静站菜单项（导航菜单），其默认的排序依据是该目录 /文档的创建时间。所有目录和文档均可在右侧属性面板中设置创建时间（这个不同于实际磁盘文件的创建时间）。

2. 确认有这个问题，是前段时间提升整站生成执行效率后的又一处“遗漏”，稍后我将解决。

3. 无法全面理解您的反馈，也无法重现。浏览模式下，文档重命名后，对应的网页一并重命名并实时刷新。任何情况下，不建议在 WDTP 之外对它所组织并管理的磁盘目录及文件进行任何操作。如需调用外部编辑器编辑某个文档，可通过文件树右键菜单“外部编辑器打开”来完成。外部编辑结束后，如文档内容发生改变， WDTP 会自动更新编辑器中该文档的所有内容。

4. 与主题（图片、样式表、模板文件等）修改、自定义有关的事宜，请参见：
http://underwaysoft.com/works/wdtp/faq.html#如何修改 /制作 /备份 /发布 /加载主题？

5. 网站功能方面，实现评论、浏览次数、更多统计和分析信息等等，有多种思路和解决方案。可以直接编程实现（ WDTP 本身就是一个简单直观的前端开发 IDE ）；可以使用第三方提供的社会化评论系统，将该系统提供的代码粘贴到任意文档中；可以嵌入外部网页（该网址是一个独立的论坛或评论页面）；可以在文档中给出外部链接……

6. 各平台下 release 版本的二进制程序，可以做到每次 git 提交都自动构建并发布，但是这么做不太合适。最主要的， C++程序需要静态编译，不是动态解析并执行的脚本类语言，每次 Release 编译及随后的黑盒测试、二次编译等等相当浪费时间，也很难保证每次提交后的源码都编译并运行无误。目前 WDTP 的做法是每隔一段时间发布一个新版本，发布之前，各个平台下都会做相对全面和仔细的测试，非常耗时。 git pull 源码后本地自行编译，对熟悉 C++开发和编译的朋友来说很简单，所需的库、 IDE 、步骤和流程我都给出了，基本上无需多说。但是，对不熟悉的朋友来说，掌握这些技术不是几句话能说清楚的，也和 WDTP 这个软件本身关系不大，只能等待新版本二进制程序的发布。如果不是非常急需新版本的新增功能或与己有关的 bug 修复，其实没必要频繁更新。使用软件的目的是出活，提高出活的效率，不是为了使用而使用。

[SwingCoder]

第二个问题确认错了。正常使用 WDTP ，不会出现此问题。

我能想到的出现此问题的情况是：在目录或文档改名的一瞬间（不会超过 1000 个 CPU 运转周期），计算机掉电或磁盘物理性损坏。或者外部修改了 WDTP 所组织并管理的磁盘数据——这一点绝对不推荐。

正常使用 WDTP ，根本无需关心磁盘目录和文件的一切情况，甚至无需知道磁盘上存在这么一堆数据。面向普通用户的现代计算机桌面操作系统及运行其上的普通应用程序有一个发展趋势是黑盒化（沙箱化），我个人赞成这一点。 WDTP 在设计和架构时遵循了这个开发原则（目前不太严格，下一步可能会逐渐严格并规范起来）。

[izgnod]

嗯，又折腾了一晚上，发现大部分是由于我的使用方法不正确所致，多谢细心的回答。

[SwingCoder]

完善：重置 /修复系统主题时，保留用户自定义的网站 ico 和 logo （不予覆盖）。

[SwingCoder]

@izgnod 朋友，祝您使用愉快！如有问题，敬请随时垂询。如能一事一议，更加欢迎和感谢：）

[SwingCoder]

完善：模板标签{{siteLogo}}的解析，增加 title 属性（网站标题）并固定 logo 的显示宽度为 165 像素。

[SwingCoder]

新增：源码新添一个结构体： SwingRegex ，静态函数全部内联执行，用于封装并使用 C++ 11 标准库中的正则表达式功能。

[SwingCoder]

改写 C++ 11 标准库中的 Regex 正则表达式模块，使之更加简洁、执行效率更高，以适应 WDTP 的独特需求。

这部分改写的代码，目前尚未最后定型，未加入（也不太方便加入） WDTP 的 git 仓库。改写后不影响标准库中的原有接口。任何用户均可直接 include 原库文件进行 WDTP 的编译。

[SwingCoder]

正则表达式的底层架构与接口基本就绪。有条件和能力的朋友可直接使用 SwingRegex 结构体提供的接口，修改 WDTP 中搜索与替换等方面的代码，以实现个人所需。

WDTP 提供的此架构与接口应该是目前世界上执行效率最高、最强悍和最成熟稳定的正则功能（应该没有之一）。如目前所提供的不能满足所需，或者抽象层次太高，需要面对更具体的问题域，请提出建议，我将酌情修改或增加这方面的代码与接口。

[SwingCoder]

实现：设置网站 ico 和项目 LOGO 。详情：

•点击工具栏“齿轮”图标，弹出系统菜单。“修改当前主题”下新增两个菜单项：“设置网站图标”和“设置项目 LOGO ”。
•点击上述菜单项后，弹出文件选择对话框，选择一个图像文件，确定。注：网站图标需是 ico 类型的图像，项目 LOGO 需是 png 类型的图像。类型如不对，系统会给出提示。所选择图像的文件名随便。
•网站图标的大小建议 32x32 像素。该图标将出现在外部浏览器标签页的左侧（ WDTP 的任何界面中都不会显示该图标）。
•项目 LOGO 的宽度建议不大于 200 像素， 165 像素最适宜。该图像默认将出现在每个预览页面（网页）的左上方。

[izgnod]

@SwingCoder 注意身体呀，你这是一晚上没睡么

[SwingCoder]

关于 WDTP 封装的 C++ 11 正则表达式模块，补充一点说明：

封装后的几个静态函数中，异常捕获采用了“就地处置”的方式，捕获后的处理比较“粗暴蛮横”，可能部分比较“传统”的同行对此不太习惯，请自行修改这部分代码。

[SwingCoder]

@izgnod 朋友，谢谢您的关心：）

[SwingCoder]

更新：系统默认的样式表及 blog 与 book 两个主题下的所有模板文件。

[izgnod]

MarkDown 中写入这个会出现问题。
# Nginx HTTP2.0
浏览的时候：
Nginx" target="_blank">HTTP2.0 ">Nginx HTTP2.0

[Damaidaner]

佩服 LZ ，赞一个！ 主题模板 能再丰富一些就更好了！

[izgnod]

@SwingCoder  红圈部分是被修改过的文件名称，一直显示在这里，不知道如何删除掉，这些链接对应的文件现在也不存在了。

[SwingCoder]

完善： Markdown 文本超链接的解析。如网址中包含英文右小括号“)”等“特殊字符”，可使用小写引号将网址引起来（否则解析时会提前截断网址，导致链接文本显示不正确，解析后的网址也不正确等问题）。示例：

[链接文本]("https://xxx.com/abc(120).html") 显示效果：链接文本

如需新窗加载“引号网址”，则将“ -”写在引号内（注意减号前面有空格）：
[新窗加载]("https://xxx.com/abc(120).html -") 显示效果：新窗加载

WDTP 有标点符号的自动匹配和自动包裹功能，高亮选择网址后只需输入一次小写引号即可完成引号配对与包裹。

[SwingCoder]

@izgnod 朋友，确认有这个问题。稍后我就解决它：）

[SwingCoder]

谢谢 @Damaidaner 朋友的支持和鼓励：）

模板的问题，我之前的粗浅想法在和朋友、热心用户讨论的时候说过一点：
http://underwaysoft.com/works/wdtp/faq.html#关于众口难调的网页渲染结果

目前我正在考虑是否有另外一些更好的解决方案，几个方面能多管齐下就比较理想了：）
如有好的思路和点子，欢迎提供：）

[SwingCoder]

@izgnod 朋友，能否提供一下这几篇文章的标题内容？仅仅看这个图，无法发现更多端倪，不好判断原因并尽快找到需要修补的代码。谢谢。

[SwingCoder]

@izgnod 朋友， 454 楼的问题解决了：）
https://github.com/LegendRhine/WDTP/commit/f8fab37595e0b4912be09c01a91e5f8c50c62c14

[SwingCoder]

WDTP （山·湖·路）发布 0.9.0407 公测版

欢迎下载试用并提出宝贵意见。

主要更新记录： http://underwaysoft.com/works/wdtp/updateList.html
简介及下载： http://underwaysoft.com/works/wdtp/download.html

示例及文本标记语法： http://underwaysoft.com/works/wdtp/syntaxMark.html
常见问题及解决方案： http://underwaysoft.com/works/wdtp/faq.html
快速上手： http://underwaysoft.com/works/wdtp/gettingStarted.html

[izgnod]

@SwingCoder 二级标题会自动缩进，如何强制二级标题不缩进呢？我找了一下文档，没有发现解决的方法。

[SwingCoder]

@izgnod 朋友，前端这一块，以 WDTP 为例，文本内容解析后的结果，渲染到模板文件，模板文件有了解析后的结果，就是一个完整的网页，网页中几乎所有元素的具体呈现（视觉效果）通常由 CSS 样式表来控制和细化处理。

Markdown 的二级标题， WDTP 解析为 html 规范中的<h2/>。大多数 html 标记， WDTP 是通过项目的全局样式表来控制和修饰的。

点击系统菜单-修改当前主题-全局样式表，主界面右侧将自动切换为主题编辑模式并加载全局样式表供修改或另存（目前也是基于纯文本的，还比较简陋，下一步如有时间和精力，我会慢慢捯饬一下）。找到这一行：

```
h1, h2, h3, h4, h5, h6 { text-indent: 24pt; line-height: 1.0; }
```
这就是一行很简单的 css 代码，其中 text-indent 负责处理 h1~h6 的缩进。您随意修改它的值，而后鼠右菜单-保存并应用，看看会发生什么？

依此类推，可以随意自定义任意 css class 的样式，还可以随意修改模板文件……您可以另存到 themes 下的一个新目录里面，做一套自己的个性化主题。很方便，这一切都可以在 WDTP 内部完成：）

[DaCong]

非常感谢楼主的辛勤付出！
很少在 V2 看到这么认真地更新自己的作品的人了。
另外，提一个小小的要求，其实现在 Linux 桌面环境下还是比较缺少这类完善的笔记软件的，不知楼主有没有心思去释出 Linux 版本？（如果说因为工程量太大，无法顾及，我也能够立即）
最后，再次感谢楼主不计回报地付出！

[SwingCoder]

@DaCong 朋友，谢谢您的鼓励与垂询。 WDTP 在其它平台下的版本慢慢都会陆续发布，这件事从设计的第一天就记到备忘里了：）已经有不少朋友提出 Linux 版本的明确需求。但是我想先缓一缓，有一些原因，最主要的是我目前一个人的时间和精力实在不够，同步维护三个平台下的版本有点吃力。技术方面的障碍不大，本身 WDTP 的代码在设计和编写时就考虑到了五大主流平台下的通用性。介绍我来这里的 Akkuman 兄就曾经编译了一个 Linux 下的版本，代码基本未改动就跑起来了：） WDTP 目前还处在快速发展和完善阶段，我的想法是先在 macOS 和 Windows 这两个平台下把架子搭起来，尽量搭完整些，搞扎实，等稍微稳定后再逐步向其它平台下移植。第三个支持的平台可能是 iOS 。作为普通用户，我很喜欢这个系统，但是作为开发者，又很不爽 Apple 在某些方面的理念和政策……所以现在还不好确定……

此外还有其它一些原因，比如：我这两三年很少用 Linux 的系统。 WDTP 的开发初衷就是我个人和少数几个朋友用着玩的又一个小工具，似乎几个老顽童都对 Linux 不太有兴致了：）这个系统的发行版很多，以用户较多的 Ubuntu 为例，它下一步要换回 Gnome ，这个事我觉得也需要观望一下：）

[DaCong]

@SwingCoder 多谢了，我先自己编译玩玩吧，楼主加油啊。
另外，我想冒昧问一下，楼主将很多精力都放在了开发这个软件上，不知是否有稳定的经济来源？没有别的意思，只是我认为，只有您有了一个稳定的收入，才能够在未来的很长时间内保证该软件的更新。

[SwingCoder]

@DaCong 朋友，谢谢您的支持：）

我有稳定的经济来源：）虽然不是世俗意义上的富人或“成功人士”。我对金钱没有太高的追求，但普通的一日三餐、基本的衣食住行等等都没有问题：）我是素食者，在某些方面有异于常人的精神信仰与道德约束，对物质的需求量和消耗量极低，对环境和他人的要求也很低。基本上每天我都觉得很快乐：）特别是做自己喜欢做的事，同时能为他人带来一些益处和方便。可以说，目前的大部分时候，就是我多年前的理想：）

唯一不利的因素是我的健康状况不太乐观。我一直用最大的毅力和不屈对抗着这些不利的东西，效果还不错：）

一切都会越来越好，也希望每个人都会越来越好：）

[izgnod]

@SwingCoder 提醒功能是否可以在提醒的时候上一级目录也能够高亮，因为我每次都要打开一级一级的目录之后才能够看到高亮的文章。

[SwingCoder]

@izgnod 朋友，谢谢您的建议。稍后我考虑一下，看看有没有更好的提醒办法，或者直接实现您的需求：）

[SwingCoder]

实现：文件树面板中，如果某个目录（含其所有子目录）有设置了提醒日期的文档，则该目录添加小括号括住的数字后缀，样式为：“(3/5)”。 3 的意思是该目录下有 3 个设置了提醒日期的文档已经到期， 5 的意思是该目录下一共有 5 个文档设置了提醒日期。鼠标右键点击该目录，弹出文件树菜单，点击菜单项“高亮选择到期文档”后将自动展开该目录并高亮选择所有已到期的文档。

[SwingCoder]

@izgnod 朋友，您的需求实现了。请参见 471 楼的更新记录。

[izgnod]

楼主好高效啊。

[SwingCoder]

重构：选择文本后输入~, *, `等 Markdown 标记后的自动包裹功能。

[SwingCoder]

更新： macOS 平台下，文本编辑时插入超链接的快捷键由“ cmd + H ”更改为“ Ctrl + H ”。

[SwingCoder]

重构：文本编辑器标点匹配、自动包裹、智能提示与自动补全等功能模块。

[SwingCoder]

修复： macOS 平台下使用某些“比较特殊的”中文输入法后匹配、包裹、提示与补全等功能失效的问题。

[SwingCoder]

新增： Windows 下 Ctrl + Q 退出本程序。（ macOS 下依然是 cmd + Q ，这个是系统级快捷键）。

[SwingCoder]

新增：系统菜单-查看当前页的 HTML 源码。点击后右侧的属性面板切换为代码编辑模式并加载当前页的 HTML 源码。此功能在修改或制作主题时比较有用，可查看并获取页面元素的 css 类、应用新的模板后所生成的详细结果等等。

[everedit]

既然编辑工具是该软件的定位之一的话，那么编辑区的体验还是很重要的。目前的版本的编辑区，还有很长的路要走，可以参考一下 ulysses ， 或者我的 Markdownmate ，或者 V2EX 右侧广告的那个石墨 :-)

[izgnod]

@SwingCoder WDTP 是否可以支持一些 MAC 上的快捷键功能，例如： Ctrl+E 到段尾， Ctrl+A 到段首部，这样编辑的时候会方便很多。

[SwingCoder]

@everedit 嗯？什么路？同质和模仿之路吗？呵……我想我不太可能参考任何现有的同类软件——至少 WDTP 3.0 发布之前：）在这个项目立项之前，我对这一块有一点肤浅的了解，但是除了几个巨无霸，亲自用过的极少，毕竟几十年来几乎每天都面对电脑，有点空闲就巴不得立刻摆脱它，真的没有太多时间和精力了解更多。目前这个阶段，更没有，也更得刻意远离任何同类项目，至少得避嫌，对不对？呵……目前，很多方面，包括计算机、程序等本身，确实是笼子里跳舞，很多模式约定成俗，一下子改变确实困难，包括我自己的思维模式和行为习惯，还有我一直很陌生的国内的开发与用户环境……另外就是开发时的语言与库的选择与整个项目几乎完全的从无到有。 WDTP 发布后，一直在国内折腾，确实给我上了好几堂课……一切，慢慢来吧：）很多事需要一个过程，欲速不达。

谢谢建议（虽然看起来似乎更适于私下 Email 性质的交流），和顺风广告， It's free :)

[SwingCoder]

@izgnod 朋友，谢谢您的建议。关于快捷键，我似乎在这个帖子里与网友有过不太深入的讨论（印象中就是 TheKiteRunner 先生）。简单说一下吧。我的很多观念与看法可能与常人不太一致，欢迎批评指正。

快捷键属于上世纪 80 年代遗留下来的软件工程界路子走偏之后的“副产品”之一，其弊端远远大于益处。它的历史使命基本已经完成。下一步，桌面软件的发展趋势是（也应该是）去键盘化、去快捷键化。但是，目前，很多时候不得不妥协，特别是 WDTP 这种内容生产为主的软件。陆陆续续， WDTP 已经添加了一大批快捷键（可在开发文档中找到具体的分配和定义），这些，我看起来都觉得恐惧……

不管如何，您的建议我会认真考虑……但是， Ctrl + A 这个不能作为跳到段尾。我们必须得兼顾几个平台下的键盘布局。 Apple 键盘有 Ctrl 和 cmd ，可扩展一倍的快捷键。但是 Windows 和 Linux 等系统就只有一个 Ctrl ，默认， Ctrl + A 是全选……

[SwingCoder]

修改并澄清 mac 平台下的一处快捷键分配（编辑器右键菜单， ctrl + H 插入超链接的快捷键描述）

[SwingCoder]

实现：主题编辑器（代码编辑器）的搜索功能。详情：

◦主题编辑器右键菜单中添加一个菜单项“搜索内容”，快捷键： Ctrl + F 。点击后其左侧出现一个标注式搜索悬浮窗。
◦搜索窗口中的关键词输入文本框，其内容为当前所选择的编辑器内容。如果执行搜索之前未选择任何内容，则为系统剪贴板中的文本数据。
◦点击“查找上一个”或“查找下一个”进行搜索。找到后，编辑器自动高亮并选择该内容。没找到则给出文字和声音提示。
◦点击或触摸搜索窗口之外的任意屏幕区域可关闭该窗口。

[SwingCoder]

统一 mac 和 Windows 两个平台下插入文本超链接的快捷键（ Ctrl/cmd + E ）。

[SwingCoder]

Windows 下新增一组快捷键： Ctrl + H （隐藏 /最小化本程序），使之与 macOS 平台下的系统级隐藏本程序的快捷键保持一致。

[SwingCoder]

实现：主题（代码）编辑器以拖拽式调整调色板的 GUI 方式实时设置颜色值。详情：

◦修改 css 样式表等主题文件时，可鼠标双击以高亮选择某个颜色值。
◦选择后，点击主题编辑器右键菜单中的“设置颜色”。编辑器左侧将出现调色板悬浮窗。
◦调色板的顶部显示当前颜色，鼠标在颜色区、右侧的色柱区、下方的 RGB 推子区等位置拖拽可调整颜色。
◦所调整的颜色显示在调色板的顶部并实时写入当前主题文件中（覆盖先前高亮选择的颜色值）。
◦颜色设置完毕，点击或触摸调色板悬浮窗之外的任意屏幕区域可关闭之。

[SwingCoder]

完善：进入主题（代码）编辑模式时，主界面自动布局（隐藏文件树面板，代码编辑器扩展宽度）。退出代码编辑模式时，布局恢复。

[SwingCoder]

代码编辑器中选择颜色值之后，右键菜单弹出调色板实时设置颜色时，程序会自动将当前高亮选择的颜色值置入操作系统剪贴板中。此举可实现：修改颜色后如不满意，可直接将原来的值粘贴回去。

[SwingCoder]

实现：主题编辑器中可直接插入模板标签。详情：

◦主题编辑器右键菜单中新增“插入模板标签”，该菜单项仅在当前编辑模板文件时才可用。
◦“插入模板标签”下的子菜单项即 WDTP 所提供的所有区模板标签。
◦子菜单项并不直接显示标签文本，而是标签的文本描述，一看便知其作用与意义，使用户设计模板插入标签时更加方便直观。

[SwingCoder]

V2EX 把尖括号连同其中的 body 给吃了：）

上面回复中第二个列表项的原文是：“插入模板标签”下的子菜单项即 WDTP 所提供的所有 body 区模板标签。

[TheKiteRunner]

您好，原本已经说了在这个楼里消失，今天在 V2EX 首页上看到这个帖子活了。我的确有做得不对的地方，最后您能理解，我真的很开心和感激。

不再使用 wdtp ，还是非常感激您的辛勤创作让我看到另一种生活方式，还有对我在不少方面的点拨。

好聚好散也挺好，希望您能够继续发挥自己的创造力，也希望我能够向您一样努力地实现价值。

[SwingCoder]

完善：如当前模板文件中已使用了要插入的标签，则给出提示。

[SwingCoder]

关于如何修改、制作、备份、发布、加载主题，可参见：
http://underwaysoft.com/works/wdtp/faq.html

[hing]

@SwingCoder 很钦佩你的创作和精神！

我觉得现在的安静模式并不能让人在安静的状态下码字，
可以增加一个只有编辑区域并且全屏化的沉浸模式吗？

WDTP 几乎满足了我对信息的三个基本需求：保存、消化、传播，
这三个需求也刚好有点对应它的中文名：山、湖、路。

另外如果能是 Web 端就好了，
好处是一样能全平台通用而且还可以随处随用！
不过这样就不符合 WDTP 的定位和理念了。

感谢！

[SwingCoder]

@hing 朋友，谢谢您的关注与理解。

全屏编辑模式，对大多数横屏摆放的桌面机来说，太宽，并不利于有一定篇幅的文档撰写与编辑。时间稍长，眼睛和大脑的负担相当重，会很疲劳。 WDTP 立项后，我做了一些调查了解，查阅过一些比较新的相关论文，这个问题曾被业内高度重视和争论过。我在这个帖子里，就此问题也和网友有过讨论。

一个比较好的解决思路： Windows 10 和下一步将会推出的 Linux 版本，在这两个平台下新建一个全新桌面，这个桌面只放置 WDTP 这一个程序，切换为安静模式。 macOS 平台下，可先进入全屏（独立桌面霸占），而后切换为 WDTP 的安静模式，此时，背景是全黑的，感觉很不错。

大屏移动设备上，这个问题基本不存在。我在 iOS 平台下试跑 WDTP ，竖屏安静模式下的效果非常完美。

基于浏览器的版本，我在立项时也考虑过，最后否了。主要是执行效率、前端开发语言本身的局限性、程序的稳定性、服务器维护管理、客户端数据读写和浏览器对各类规范的支持、统一程度与发展趋势等等，未知因素和不好把握的因素太多。特别是执行效率（目前用 C++其实也是妥协，我个人很多时候对 C++的效率和简洁性都不满意）。

下一步如果时间和精力充足，用户数量较多、较稳定，我会陆续给 WDTP 添加更多绝无仅有、先进而新鲜的功能，实现我个人在此方面的一些比较另类和前卫的想法。这些都严重依赖于执行效率，对开发语言、算法实现、数据吞吐量等方面的要求相当高。也相当于扬长避短，最大限度体现单机 GUI 程序的优势，颠覆一些习惯性的认知与整个业内普遍存在的错误做法。目前其实也可以上，但是我想先给更多普通用户一个适应过程。慢慢来。否则，可能大家接受不了，反而对 WDTP 的下一步发展起到负面影响。

[SwingCoder]

完善：编辑模式下，弹出智能提示并自动补全后自动删除刚刚输入的智库关键词。

[SwingCoder]

完善：编辑模式下，弹出智能提示菜单后自动高亮第一个条目，以方便直接回车完成自动补全。