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

2017 年 2 月 4 日
 SwingCoder

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

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

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

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


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

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

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

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

想法中还包括了其他。比如:“静态网站生成器( 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


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

谢谢!

SwingCoder

35276 次点击
所在节点    分享创造
651 条回复
SwingCoder
2017 年 3 月 21 日
行了,哪说哪了。我也是金盆洗手,黄土已经埋到头顶的人了。犯不着跟谁死磕。

但是,还是那句话, Whose mum 都别把自己当根葱。苦逼程序员,不是谁都可以吆五喝六、低头俯视的。我今天掐你,不为我自己。为了这里所有的同行,特别是所有拿命做开源的同行。

QQ 拒绝你,原因你应该比所有人都清楚,还有脸拿出来晒委屈?知乎网站,我到现在都没注册过账号,何来去彼处推广一说?现在砸人流行拿知乎说事了?

世道确实变了。
SwingCoder
2017 年 4 月 5 日
善始善终吧。既然在这里开了贴,不管如何,还是尽力把事情做到底——至少将开发直播进行到铜板置零的那一刻,希望能撑到 WDTP 1.0 正式版发布。另一个原因:希望尽快将这一页翻过去。

开始刷屏,这段时间以来的主要更新记录逐条复制如下。
SwingCoder
2017 年 4 月 5 日
实现:设置图片的宽度,语法格式:![图片标题](图片地址 = 500)(图片标题可选)。详情请参见:
http://underwaysoft.com/works/wdtp/faq.html#如何指定图片的宽度?
SwingCoder
2017 年 4 月 5 日
实现:图文混排( Hybrid Layout )。该功能非常强大,可实现任意列数和行数、任意图、文的混合排版。可以很轻松地制作出 Portfolio 、照片墙、作品集、产品墙、九宫格日记、报刊版面、双栏多栏、图文环绕、图文并列、棋盘交错等版面样式。默认渲染效果请参见《 WDTP-示例页面》。语法格式:三个小写的波浪号成对匹配,包裹文本区域:

```
~~~5 ( 5 表示每个区块的间距,值范围: 0~9 。不指定默认为 0 )
第一行的第一列(内容可为文本,也可为插入的图片或图片链接。下同)
第一行的第二列
第一行的第三列
(空行表示换行)
第二行的第一列
第二行的第二列
第二行的第三列
...
~~~
```
SwingCoder
2017 年 4 月 5 日
新增:两个文本标记:(-) 本段文本取消缩进 (+) 本段文本强制缩进。
SwingCoder
2017 年 4 月 5 日
新增:注释文本标记。语法格式:至少 6 个斜杠“/”,成对匹配(多了不限),包裹要注释的文本区域。示例:

////////////////////
要注释的文本
123abc
这些文本都将注释掉
///////////////////

要注释的内容可以是大段的文本块,也可以是行内的某些文本。

WDTP 注释与普通 html 注释的差别:
html 注释内容虽然网页上不显示,但 html 源码文件中能看到。
WDTP 注释则根本不参与渲染,解析时全部丢弃,所生成的网页中看不到注释内容。
WDTP 注释写法更简单,文本编辑状态下也“更好看”。
SwingCoder
2017 年 4 月 5 日
文本编辑器右键菜单“格式”子菜单下新增“图文混排”、“反缩进”、“强制缩进”、“注释”四个菜单项。
SwingCoder
2017 年 4 月 5 日
发布: 0.9.0317 内测版
SwingCoder
2017 年 4 月 5 日
简化:插入(拖入)媒体文件的操作。插入图片和插入音频合二为一,系统内部将自动识别并给出相应的文本标记。
SwingCoder
2017 年 4 月 5 日
集中审校并更新了 WDTP 的中文文档,目前已近 7 万字。
SwingCoder
2017 年 4 月 5 日
改进:清理冗余媒体文件时一并清理 docs 和 site 两套目录下的冗余媒体。
SwingCoder
2017 年 4 月 5 日
优化:小幅度提升整站生成的执行效率。
SwingCoder
2017 年 4 月 5 日
新增:插入视频的文本标记。语法格式:@[](MP4 视频文件的地址 = 680)。

- 680 为视频的宽度,可任意指定。宽度指定后,视频画面将自动保持原始宽高比。
- WDTP 将插入图片、音频和视频这三项功能合而为一了。 Ctrl + M ,或者编辑器右键菜单-插入-图片 /音频 /视频,或者将操作系统文件浏览器中所选择的一到多个文件直接拖入 WDTP 的文本编辑器,系统内部将自动识别并给出每个文件所对应的文本标记。
- Ctrl + V 智能粘贴时,如果是远程或本地 MP4 文件,将自动识别并插入该视频的文本标记。
- 鉴于 Safari 、 Chrome 和 IE 这三大主流浏览器对 html 5 视频规范的支持现状,所插入的视频请使用 MP4 压缩编码格式。
- 默认效果请参见《 WDTP-示例页面·插入视频》
SwingCoder
2017 年 4 月 5 日
WDTP 授权协议由 GPL v3 改为 GPL v2
SwingCoder
2017 年 4 月 5 日
重构并实现:主界面布局功能。详情:

- 点击工具栏“<->”图标后不再直接切换“安静 /完整”模式,而是弹出主界面布局菜单。
- 主界面布局菜单包含三个菜单项:(隐 /现)文件树面板,(隐 /现)属性面板,(切换)安静 /完整模式。
- 切换安静 /完整模式的快捷键不变,依然是“ Ctrl + D ”。
- 切换为安静模式后,默认高度为屏幕高度(高度不变),宽度为 710 像素,自动位于屏幕中央。
- 隐现文件树和属性面板只能在完整模式下进行。隐现后,主界面大小保持不变,屏幕元素自动调整布局。
SwingCoder
2017 年 4 月 5 日
重构并优化:搜索功能。工具栏原有的两个搜索框合二为一,功能不变。关联工具栏搜索与文本编辑器内的搜索。
SwingCoder
2017 年 4 月 5 日
实现:录音完成后的剪辑功能。详情请参见:
http://underwaysoft.com/works/wdtp/faq.html
SwingCoder
2017 年 4 月 5 日
改进:切换编辑 /预览模式后,确保属性面板区不出现“残影重叠”现象。
SwingCoder
2017 年 4 月 5 日
修复:关闭项目或尚未加载任何项目时执行搜索功能导致的程序崩溃。
SwingCoder
2017 年 4 月 5 日
新增:返回页顶的文本标记。语法格式:[TOP]。也可在编辑器中通过右键菜单插入。该标记的默认解析结果为一个文本按钮,右对齐,点击后将跳回页顶。显示效果请参见本页每个二级标题的上一行。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://study.congcong.us/t/338138

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX