WDTP, 一款笔记,写作,博客三位一体的软件,同时也是个静态网站生成器

本贴最后更新于 2847 天前,其中的信息可能已经沧海桑田

** 首先声明作者不是我,是一位朋友 SwingCoder,文章首发与凯迪,然后发布到 v2ex,我帮他转过来的**

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

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

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

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

谢谢!

WDTP-主要更新记录

  • 2017.02.04

  • 编辑器右键菜单,插入,新增“插入图注 /表注”

  • 插入图片或表格时一并插入图注和表注行

  • Markdown 解析新增语法:图注和表注,语法格式“^^ 注解文字”

  • 2017.02.03

  • 发布 macOS 和 Windows 两个平台下的内测版( 0.9.170201 )

  • 系统菜单新增:重置 /修复系统默认的模板及样式表

  • 实现:项目数据的打包与解包

  • 文档内搜索所选内容添加快捷键。 F3 :下一个, Shift + F3 :上一个

这个项目目前的 github 地址是:
https://github.com/LegendRhine/WDTP

我现在还没想好,可能过一段时间将它单独拉出来,或者放在另一个账户下,或者拉到国内,这样方便大家访问和 PR 。
我最近会尽快规整代码,完善注释和开发文档,便于各位同行、老师审阅代码并无私贡献。

  • WDTP
    2 引用 • 96 回帖
  • C++

    C++ 是在 C 语言的基础上开发的一种通用编程语言,应用广泛。C++ 支持多种编程范式,面向对象编程、泛型编程和过程化编程。

    107 引用 • 153 回帖
  • 笔记

    好记性不如烂笔头。

    308 引用 • 793 回帖
  • 博客

    记录并分享人生的经历。

    273 引用 • 2388 回帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • SwingCoder
    • 改进:使用操作系统默认的文件打开/保存对话框。一是使不同平台下的用户有更熟悉的使用体验,二是解决某些 Windows 版本下新建项目时【保存】按钮可能暗显的问题。
  • 其他回帖
  • SwingCoder
    • 实现:缩略语功能。详解如下:
      • 编辑文档时,部分内容可能太“碍眼”,不想时时看到;或者无需经常改动(防止误编辑);或者由于非阅读性字符太多、太难看而破坏编辑时版面的美感(比如包含非标字符的 UTF-8 转义或复杂参数的较长网址、代码等等),此时可用一个自定义的短语来代替这部分内容。
      • 文档属性面板,“Abbrev(缩略语)”专司其职。格式为:“缩略语(空格)所代表的原始内容”。一行一个,行与行之间可使用空行隔开,以便区别。
      • 设置好缩略语之后,编辑模式下,可将要缩略显示的内容删掉,代之以刚刚自定义的缩略语。
      • 原始内容虽然在编辑模式下看不到了(看到的是缩略语),但预览时会出现。即:原始的文档中虽然已经找不到这些内容,但预览并生成网页时,这些内容还是会出现(此时网页中不出现这些内容的缩略语)。
      • 也可以用这个思路理解:编辑模式下,缩略语用来替代它所代表的原始内容;而预览并生成的网页中,原始内容反过来再替代它所对应的缩略语。
      • 可在文档属性面板的“Abbrev(缩略语)”中增删改已有的缩略语,即改即生效(预览模式下按 F5 刷新当前页面即可)。
      • 注 1:如果某个文档定义的缩略语太多,可能会出现缩略语重复的情况(此时它们所代表的原始内容有可能一致,也可能不一致)。此时,软件不进行校验、提醒或干扰,以第一个为准。
      • 注 2:一个文档中,同一个缩略语可多次出现。所有出现的地方,在预览或生成网页时全部替换为该缩略语所代表的原始内容。
      • 注 3:所定义的缩略语,请不要和文档中已有的语句或短语相同,否则,这些内容也将成为缩略语(原因见注 2)。此外,为了便于阅读、编辑和理解,可使用自己习惯的前缀和后缀来包裹缩略语。比如:“长链 01”、“@ 该处不宜改动 @”、“AbbrevOfSomeFunnyThings”……等等。
      • 注 4:缩略语所代表的原始内容中可包含 Markdown 或任意 html、css、js 等标记/代码。这些标记和代码在预览或生成网页时和普通内容一样,将被正确识别和处理。这一点在编辑高级功能的文档时非常实用(比如动态网页或格式与样式非常丰富的个性化/专业性文档/网页,编辑时不破坏版面的可读性与美观度)。还可以用该功能实现 Code snippets 展示……玩法很多,敬请摸索:)
      • 注 5:采用缩略语后,无论整个项目的搜索替换,还是当前文档的搜索替换,都无法再针对缩略前的原始内容进行。这一点我稍后将予以改进。
  • SwingCoder
    • 实现:智能粘贴(使用快捷键 Ctrl + V 时)。详情:
      • 如果系统剪贴板中的数据是项目内部链接(文件树-右键菜单-Get Path 所获取的),则插入该文档或目录 Markdown 格式的内部链接
      • 如果系统剪贴板中的数据是一个合法的 http/https 网址,则插入此网址 Markdown 格式的链接。此时,如果未选择任何文本,则给出“Click here(点此访问)”的链接文字,并自动选择之,以便用户输入改写。如果插入网址前选择了文本,则所选文本成为链接文字。
      • 如果系统剪贴板中的数据是网络图片的地址,则插入显示此图片的 Markdown 格式(此图片不拉回本地)。
      • 以上粘贴,仅适用于快捷键 Ctrl + V。如使用右键菜单中的“Paste”菜单命令,则不做任何处理(某些时候需要“原始粘贴”)。
  • SwingCoder

    谢谢试用:)WDTP 管理的目录和 md 文档都位于本机磁盘。

    静态网页也可以实现针对网站访客的搜索,但是会有点麻烦和限制。一个可参考的例子是 Doxygen 那样的“关键条目搜索”。
    过一段时间,等程序功能七七八八后,我看看是否加上这个功能:)我个人对这个功能不是非常需要和重视,在设计 WDTP 之前,我做了一些调查和思考,个人博客性质的网站,访客很少使用本站搜索这个功能,除了忠诚度较高的老访客,一般都是搜索引擎或其他渠道带过来的。网站内容的搜索,更多是作者自己的经常性行为。本机搜索,也就是作者自己的搜索,我觉得本地操作更方便。WDTP 工具栏两端的搜索框就行(一个是搜索整个项目,一个是搜索当前文档)。

    我的想法可能有误区,或者太“传统”和保守,欢迎批评指正:)谢谢!

    1 回复
  • 查看全部回帖
Akkuman
python与二次元爱好者,开车司机 荆州

推荐标签 标签

  • TensorFlow

    TensorFlow 是一个采用数据流图(data flow graphs),用于数值计算的开源软件库。节点(Nodes)在图中表示数学操作,图中的线(edges)则表示在节点间相互联系的多维数据数组,即张量(tensor)。

    20 引用 • 19 回帖
  • wolai

    我来 wolai:不仅仅是未来的云端笔记!

    2 引用 • 14 回帖
  • Ubuntu

    Ubuntu(友帮拓、优般图、乌班图)是一个以桌面应用为主的 Linux 操作系统,其名称来自非洲南部祖鲁语或豪萨语的“ubuntu”一词,意思是“人性”、“我的存在是因为大家的存在”,是非洲传统的一种价值观,类似华人社会的“仁爱”思想。Ubuntu 的目标在于为一般用户提供一个最新的、同时又相当稳定的主要由自由软件构建而成的操作系统。

    125 引用 • 169 回帖 • 1 关注
  • InfluxDB

    InfluxDB 是一个开源的没有外部依赖的时间序列数据库。适用于记录度量,事件及实时分析。

    2 引用 • 72 关注
  • Ruby

    Ruby 是一种开源的面向对象程序设计的服务器端脚本语言,在 20 世纪 90 年代中期由日本的松本行弘(まつもとゆきひろ/Yukihiro Matsumoto)设计并开发。在 Ruby 社区,松本也被称为马茨(Matz)。

    7 引用 • 31 回帖 • 210 关注
  • Openfire

    Openfire 是开源的、基于可拓展通讯和表示协议 (XMPP)、采用 Java 编程语言开发的实时协作服务器。Openfire 的效率很高,单台服务器可支持上万并发用户。

    6 引用 • 7 回帖 • 94 关注
  • JavaScript

    JavaScript 一种动态类型、弱类型、基于原型的直译式脚本语言,内置支持类型。它的解释器被称为 JavaScript 引擎,为浏览器的一部分,广泛用于客户端的脚本语言,最早是在 HTML 网页上使用,用来给 HTML 网页增加动态功能。

    729 引用 • 1327 回帖
  • Vim

    Vim 是类 UNIX 系统文本编辑器 Vi 的加强版本,加入了更多特性来帮助编辑源代码。Vim 的部分增强功能包括文件比较(vimdiff)、语法高亮、全面的帮助系统、本地脚本(Vimscript)和便于选择的可视化模式。

    29 引用 • 66 回帖
  • BAE

    百度应用引擎(Baidu App Engine)提供了 PHP、Java、Python 的执行环境,以及云存储、消息服务、云数据库等全面的云服务。它可以让开发者实现自动地部署和管理应用,并且提供动态扩容和负载均衡的运行环境,让开发者不用考虑高成本的运维工作,只需专注于业务逻辑,大大降低了开发者学习和迁移的成本。

    19 引用 • 75 回帖 • 641 关注
  • 安装

    你若安好,便是晴天。

    132 引用 • 1184 回帖
  • 知乎

    知乎是网络问答社区,连接各行各业的用户。用户分享着彼此的知识、经验和见解,为中文互联网源源不断地提供多种多样的信息。

    10 引用 • 66 回帖
  • 钉钉

    钉钉,专为中国企业打造的免费沟通协同多端平台, 阿里巴巴出品。

    15 引用 • 67 回帖 • 340 关注
  • 安全

    安全永远都不是一个小问题。

    199 引用 • 816 回帖 • 1 关注
  • 面试

    面试造航母,上班拧螺丝。多面试,少加班。

    325 引用 • 1395 回帖
  • OkHttp

    OkHttp 是一款 HTTP & HTTP/2 客户端库,专为 Android 和 Java 应用打造。

    16 引用 • 6 回帖 • 62 关注
  • Dubbo

    Dubbo 是一个分布式服务框架,致力于提供高性能和透明化的 RPC 远程服务调用方案,是 [阿里巴巴] SOA 服务化治理方案的核心框架,每天为 2,000+ 个服务提供 3,000,000,000+ 次访问量支持,并被广泛应用于阿里巴巴集团的各成员站点。

    60 引用 • 82 回帖 • 595 关注
  • uTools

    uTools 是一个极简、插件化、跨平台的现代桌面软件。通过自由选配丰富的插件,打造你得心应手的工具集合。

    6 引用 • 14 回帖 • 2 关注
  • Bootstrap

    Bootstrap 是 Twitter 推出的一个用于前端开发的开源工具包。它由 Twitter 的设计师 Mark Otto 和 Jacob Thornton 合作开发,是一个 CSS / HTML 框架。

    18 引用 • 33 回帖 • 660 关注
  • TextBundle

    TextBundle 文件格式旨在应用程序之间交换 Markdown 或 Fountain 之类的纯文本文件时,提供更无缝的用户体验。

    1 引用 • 2 回帖 • 48 关注
  • ZooKeeper

    ZooKeeper 是一个分布式的,开放源码的分布式应用程序协调服务,是 Google 的 Chubby 一个开源的实现,是 Hadoop 和 HBase 的重要组件。它是一个为分布式应用提供一致性服务的软件,提供的功能包括:配置维护、域名服务、分布式同步、组服务等。

    59 引用 • 29 回帖 • 4 关注
  • 负能量

    上帝为你关上了一扇门,然后就去睡觉了....努力不一定能成功,但不努力一定很轻松 (° ー °〃)

    88 引用 • 1235 回帖 • 411 关注
  • Netty

    Netty 是一个基于 NIO 的客户端-服务器编程框架,使用 Netty 可以让你快速、简单地开发出一个可维护、高性能的网络应用,例如实现了某种协议的客户、服务端应用。

    49 引用 • 33 回帖 • 21 关注
  • 宕机

    宕机,多指一些网站、游戏、网络应用等服务器一种区别于正常运行的状态,也叫“Down 机”、“当机”或“死机”。宕机状态不仅仅是指服务器“挂掉了”、“死机了”状态,也包括服务器假死、停用、关闭等一些原因而导致出现的不能够正常运行的状态。

    13 引用 • 82 回帖 • 52 关注
  • Windows

    Microsoft Windows 是美国微软公司研发的一套操作系统,它问世于 1985 年,起初仅仅是 Microsoft-DOS 模拟环境,后续的系统版本由于微软不断的更新升级,不但易用,也慢慢的成为家家户户人们最喜爱的操作系统。

    222 引用 • 473 回帖
  • 百度

    百度(Nasdaq:BIDU)是全球最大的中文搜索引擎、最大的中文网站。2000 年 1 月由李彦宏创立于北京中关村,致力于向人们提供“简单,可依赖”的信息获取方式。“百度”二字源于中国宋朝词人辛弃疾的《青玉案·元夕》词句“众里寻他千百度”,象征着百度对中文信息检索技术的执著追求。

    63 引用 • 785 回帖 • 177 关注
  • 数据库

    据说 99% 的性能瓶颈都在数据库。

    342 引用 • 708 回帖
  • 酷鸟浏览器

    安全 · 稳定 · 快速
    为跨境从业人员提供专业的跨境浏览器

    3 引用 • 59 回帖 • 26 关注