WDTP：利器，在于轻便犀利

2018-02-07 本文已影响732人果儿圆杏儿甜

来自WDTP项目主页

相逢便是缘

初次相逢时，我正在寻觅着一款比较好用的静态网站生成器，忽然间，看到一篇文章，【软件推荐】推荐款适合搭建个人知识体系的小众软件...。顿时感觉自己有幸，有一次遇到了一款利器，犹如之前遇到ALTRun。

该软件现已闭源，但是确实值得一用。下面将其项目主页介绍转来，供大家参考。毕竟适合自己的，才是最好的。

以下内容，均转自项目主页。当初我看完之后，倒是感觉热血沸腾，这个作者真会写。。。

WDTP（山湖路）到底是一款什么样的软件？

简单说，它是一款基于内容/样式分离的新型写作工具、文档编辑软件与桌面GUI版的静态网站生成与管理器。写作方面，不仅适用于创作、编辑并组织管理正规的书籍（技术图书和文艺作品），也适合于个人知识管理，比如笔记、个人维基系统等等。另外，WDTP还可以作为一款简易的网页设计、前端开发与编码调试工具。更令人想不到的是：WDTP不仅可以进行文字型记录，更可以进行声音记录（录音机）……如果您对这些感到一头雾水，不要紧。更简单的解释：WDTP什么都不是，它就是WDTP，一个新型的写作、记录与作品分享工具。

有多个因素促使我开发了这个软件，其中一大原因就是个人所需。主要是：

一个简洁高效和优雅的写作利器和功能多合一的办公软件，能部分或完全替代Pages、Word、Excel、Numbers等传统的巨无霸、单打一软件。这件利器能够方便、快速、直观地组织、管理具有复杂结构与逻辑层次的多目录、多文档，能分章节撰写编辑，能一键导出（导出后无需任何第三方软件，只要有浏览器即可阅读审校），能随时将自己的文字作品传播、发布和分享给他人。
一个更加方便、先进和智能的个人知识管理与笔记系统，用于取代各类传统、僵化、老旧的笔记软件，比如：Evernote（印象笔记）。同样，必须简洁高效、优雅灵活；必须要有专业级的录音和基本的音频处理功能；必须能够方便简单地插入并管理图像、视频并能够进行基本的处理；必须能够一键成册、批量集成，便于保存、分享和传播；必须具有复习、回顾、提醒等功能，以便将各类信息高效固化为永久记忆，真正形成属于自己的知识体系与智慧来源。
极端重视简洁与效率的GUI桌面版建站工具和静态网页生成器，或者说博客/网站的内容创建、编辑、管理与维护工具，数据本机存储，无需任何改动或设置，随时均可全站迁移（包括更换域名）。用于取代WordPress等所有服务器端建站程序和当前世面上所有的命令行式“静态网站生成器”。该生成器必须要自带文本编辑器、在兼容Markdown的基础上具有更加丰富实用和强悍灵活的文本标记，能够实时渲染和预览；必须要有最基本的、简单直观的、与网页相关的代码编辑、前端开发、美工设计、调试与效果预览等功能；必须能够方便简单地随时修改并制作全新的主题（样式表及渲染模板）；整个网站的成千上万篇文档，必须能够一键点击、瞬间生成；必须能进行SEO优化并增加网页的搜索引擎友好度。
以上几点，必须是所有原始数据本机直接可视；数据的检索、备份与恢复等重要功能必须简单和智能；软件本身必须能够跨平台使用；必须方便GIT及各类云盘的版本控制和数据回滚；诸多功能必须无缝集成在一起等等。
文档编辑方面，回归经典和传统，以简洁和高效的内容/样式（对应：编辑/预览）完全分离的方式来完成各类写作任务，并兼顾网页设计、代码编写与调试（主要是html、css、js、php等网络编程方面的语言代码）。

WDTP就是这么一款注重先进、强悍、易用、简洁与高效、功能多合一的跨平台桌面单机软件。如果您也有和我基本一致的上述需求，它一定会让您感到惊喜并爱不释手。

软件概述

WDTP（山湖路）不止是新一代智能写作、文艺创作、知识管理、个人笔记、网页设计、静态网站生成与编辑器，还是一款高度追求用户体验、支持丰富的文本标记语法和各类多媒体数据的多文档编辑/管理器，更象是一个知识、技能、经验、见闻、感悟与图文作品的积累、记录、编撰、创作、组织、管理、分享与传播等“一揽子”和“一条龙”解决方案。本软件的特点可用16个字囊括：简洁高效，精致优雅，轻灵强悍，先进易用。

WDTP（山湖路）运行主界面

WDTP（山湖路）可运行于macOS和Windows系统下，旨在提高这两大平台下所有写作、创作、记录、前端开发、网页设计及作品分享者的生产力及生产效率，节约耗时，减少无谓的智能、体力与资源消耗。它适合于以下群体：

以文字、图像、声音、视频为主要内容的写作/创作/记录/分享者
各类作家、文字工作者、自媒体、内容创业、图书/教程/文章的作者及编译者
经常记笔记或写点东西的人
打算采用静态页面的个人博客
打算采用静态页面的中小企业
前端开发与网页设计人员

WDTP的全名是：Walden Trip，中文名称：山·湖·路，UnderwaySoft开发出品。立项日期：2016年8月2日，第一个内测版发布日期：2017年2月3日。

关于本软件的发音：

“WDTP”的正确发音就是它的全称：Walden Trip ['vɑ:lden trɪp]，汉语拼音：“WāoDen ChùiPu”
“山湖路”的正确发音：（略）。

:-D

核心功能

笔记。可随时记录并管理学习笔记、读书笔记以及有一定篇幅并打算结构化保存、管理、检视和封装的零星随记、杂感等等。可定期将所有或任意分类（目录）下的笔记“装订成册”、集中输出，一键即可完成。
创作。对职业作家（特别是技术作家以及需要大量构思与情节编排的文艺作家）来说比Pages、Word等WYSWYG类型的桌面文字软件更加高效、简洁和灵活的内容创作、章节管理与格式化排版工具。可方便地实现多章节（情节、场景、概念、故事主线等）并发创作/编辑、任意调序、随意归类等强大功能，完稿后一键即可成书。
建站。强大而新颖的静态网站维护、编辑、生成、代码调试与内容、结构管理系统。特别适合追求全站真正静态化、内容至上的个人博客与中小企业官网。
文档编辑器。WDTP根据大多数作者/作家/博主/站长的实际需求，支持丰富的文本标记语法。比如：插入图注和表注、居中、靠右、多种类型的表格、图文混排、插入音视频媒体文件、内容注释、跨文档扩展标记等等。该编辑器还针对Windows系统对中文字体的渲染结果不尽人意等情况专门做了特殊优化与调整，使用户在输入、编辑时可获得更良好的体验。
以上几项，不仅可以文字输入，更可以语音输入（现场录音），并可进行专业级的音频编辑处理（剪辑头尾、调整音量等等）。此功能对不擅长文字表达的朋友或者记者、演员、各类主持人、音乐家、演奏家等群体来说非常方便。
WDTP还有更多独具特色并灵活强悍的功能。比如：复习/提醒/回顾，数据统计与分析，文档隐身，文章归档，缩略语，智库，智能提示与自动补全，按需生成并插入时间轴（线性事件的时间点），项目外源，英汉互译，表格与数字的自动计算（合计、求平均值等），主题（模板及样式表）的编辑修改及实时更新，直接处理图像数据，调用外部程序编辑处理文档内的图像与音频等多媒体数据……等等等等。
在“笔记、写书、建站/博客、前端开发”这几个方面，WDTP（山湖路）无缝集成，一键切换。即：同一套内容，随时可生成上述任何一种类型，还可多种类型混合使用。

主要特点

编程语言为C++。扎实高效、轻灵强悍。纯绿色软件，仅有一个可执行文件。无论macOS平台下的，还是Windows下的，压缩为zip后均不超过2M。网络下载或传播，瞬间可得。注意：程序小并不代表功能弱。事实上，截至目前，WDTP（山湖路）的功能已经足够强悍了。
软件采用共享协议，您可以自由下载并试用。试用满意后，可决定是否注册。
GUI桌面单机程序。界面简约，上手极快，基本无学习压力与成本。
数据本地存储。备份、管理、检索、迁移、二次发布等等简单便利。
内容与样式完全分离。内容生产者无需在创作时为样式或格式而分心。
丰富实用、强大灵活的文本标记语法，全兼容Markdown、HTML、CSS和JS、PHP等所有服务器脚本语言。
可随意定制主题。良好的可扩展性，专为高级用户而设。
macOS和Windows跨平台运行，界面外观与操作模式完全一致。
软件内置book及blog两套完整的主题，开箱即用。

平台支持

本软件在以下平台测试通过，运行结果符合预期：
- macOS 10.9以上（已安装“微软雅黑”字体）。推荐10.12及以上，Retina显示屏。
- Windows 7 x64以上（IE版本为10.0以上）。推荐Windows 10 x64及以上。
本软件静态网页的生成结果在以下浏览器中测试通过，显示结果符合预期：
- Apple Safari 10.0及以上版本
- Google Chrome 51.0及以上版本
- Mozilla Firefox 50.0及以上版本
- Microsoft IE 9.0及以上版本
- Microsoft Edge 38.0及以上版本
- 尚未在其他品牌及版本的浏览器中严格测试。近3年来流行的任一款浏览器应该都无碍（这取决于浏览器对您所定制的前端代码以及音视频多媒体格式的支持程度）。

程序下载

最新版本：1.1.1004
(截止到本文完成时：2018年2月7日)

请阅读《UnderwaySoft共享协议》，如不同意，请勿下载试用。
Windows 64位版本 点此下载（小于1.5M）
macOS版本 点此下载（小于1.7M）
纯绿色软件，无需安装。将压缩包中的可执行文件解压到本机某个文件夹下（请确保有权限可以执行），双击即可运行。
运行后可将程序图标保留在桌面、Dock或任务栏中，以便今后随时启动。

如何开始

启动程序，点击主界面顶部工具栏“齿轮”图标，弹出系统菜单，新建项目。

创建项目

创建项目后，主界面左侧文件树面板，鼠标右击项目，弹出文件树菜单，新建文件夹或文档。一个项目可创建任意多的文件夹和文档。

创建文件夹或文档

新建文档后，主界面中部的编辑/预览区自动切换为编辑模式，在此写作和编辑。

编辑区

开始写。随便写。但是我们建议：
- 第一行为本文档的标题（一级标题，以#号和一个空格开始，后接文档标题文本。#号已自动给出）。
- 与标题隔一行，写内容。

第一行为标题（# 开头），隔一行，而后是正文内容

WDTP（山湖路）是基于纯文本模式的文档编写工具，这一点对习惯了所见即所得（WYSWYG）模式撰写并编辑文档的用户来说，肯定是个挑战，需要一段时间来适应。但是，一旦适应之后，您绝对会体验到“纯文本编写内容+适当的文本标记控制样式+适时预览渲染结果”这种模式的巨大优势、便利、灵活与惊人的高效性。
- WDTP使用文本型标记语法对文档内容进行渲染后的控制和设置。但是，会不会使用标记语法并不重要（编辑器右键菜单中的语法标记“应有尽有”），而且，使用标记来控制或美化内容的呈现并不是创作和写作过程中的必须步骤。这些东西不是也不应该是思想表达的束缚。任何时候，请不要为了标记而标记。创作和记录的重点与核心始终应该是内容本身。在此基础上，可适当进行“美学拓展”与“内容呈现的贴合性、艺术化与个性化”，绝对不要颠倒顺序、无因而果。

文档编辑区点击鼠标右键，弹出的菜单中包含所有可用的控制标记

随时可点击工具栏“大眼睛”图标或按快捷键“Ctrl + S”预览文档。再次点击则切换回编辑模式。

在编辑/预览两种状态之间切换

可将正在编辑的某些内容高亮选择后提取为该文档的标题、摘要、加入关键词列表（通过编辑区右键菜单来完成）。这些属性亦可手工输入或编辑（主界面右侧的属性面板）。

将所选内容提取为标题、摘要，或加入本文关键词列表中

写累了，关闭退出。想写了，启动程序。这就是日常使用WDTP（山湖路）的全部流程。
如本机已有现成的文本文档、Markdown文档或其它静站生成器的专有文档，则可将其批量导入WDTP。鼠标右键单击文件树面板中的某个文件夹（或根目录），弹出的菜单中选择：导入外部数据-文本文档……

将外部文档导入到某个文件夹下

发布和分享：鼠右点击文件树面板中的项目、目录或文档，看看弹出的菜单中都有些什么……

导出整个项目、某个文件夹或单个文档

用更简洁的流程概括“快速开始”：
- 新建项目（工具栏“齿轮图标”，系统菜单）
- 新建目录和文档（或导入外部已有文档。文件树右键菜单）
- 写作编辑，随时预览（编辑/预览区）
- 根据具体情况和需要，主界面右侧的属性面板中分别提取并设置项目、目录和文档的属性
- 发布（集成或打包，随便上传、服务器端解压、本机备份、传播、发给亲朋好友、出版社编辑、git版本控制管理，等等等等。Just do whatever you want...）
进阶与高级使用：请参阅《山湖路-快速上手》。

备份、同步与回滚

点击工具栏“齿轮”图标，弹出的系统菜单中点击“项目打包”。
打包后的数据文件位于磁盘项目目录下。
项目打包数据包含：
- 项目文件
- 项目所管理的所有目录与文档的结构
- 项目所管理的所有文档的内容数据（含媒体文件）
- 项目所管理的所有目录与文档的属性
- 项目当前所用的主题（非系统默认的主题）
项目打包数据不含：
- 静态生成的所有网站数据（网页及媒体）
WDTP可直接加载项目打包文件。
更好的备份策略是使用Git对整个项目进行版本控制、数据同步和历史回滚。比如将项目目录设置为本机git仓库，ignore文件中忽略site目录。远程托管仓库，可使用GitHub或自建的git服务器。
使用git备份、同步和管理项目数据，相对来说最稳妥和灵活。这也是UnderwaySoft推荐的备份方案。以GitHub为例，如果对控制台界面下使用git命令不熟悉，可以下载并使用GitHub出品的跨平台自由软件：GitHub Desktop，其使用非常简单。
多个设备之间进行数据的实时备份和同步，除Git外，还可使用第三方公司出品的各类网盘（云盘），更加方便简单。详情可参阅各云盘的使用说明。

发布网站数据

文件树面板，鼠右单击根项目，弹出的菜单中点击“网站数据打包 - 全部打包”。
网站打包数据中不含任何与项目有关的数据。
全部打包后的网站数据解压后可直接传到任意域名的服务器上（或直接上传zip打包文件，服务器端解压），无需任何配置，无需任何额外操作，一个完整的网站就可以直接运营了。
日常修改或新建文档后，只需上传对应的和受到影响的html文件即可。或者打包网站/目录数据时仅打包网页，而后再次上传。
如果新建的文档使用了本机多媒体文件，则可单独将所使用的多媒体文件上传到服务器。
注意：WDTP的网站数据打包功能，针对当前所选的目录。如果当前所选是根目录，则意味着整站打包；如果当前所选是某个子目录，则仅打包该子目录的所有网站数据。文件树右键菜单中很多菜单项都是针对当前所选的目录或文档进行某种处理或操作，并不影响其同级，也不影响其上级。也就是说，文件树右键菜单有识别功能、针对性和一定程度上的智能化。

分享并传播作品

作为开发者，我最希望用户直接分享并传播项目的备份数据，而受众也使用WDTP（山湖路）。这样，受众可以直接加载并用自己喜欢的模板与样式浏览其他同仁的作品。这种方式对各方来说都最为理想（虽然不太现实，因为不管山湖路有多么简洁易用、方便强大，也不太可能吸引更广泛的用户群，特别是早已习惯并形成固化观念的WYSWYG类写作用户）。

退一步来说，即使受众不使用WDTP（山湖路），解压项目备份数据后，也可以用任意文本编辑工具（包括某些可以进行Markdown解析与渲染的文本工具）直接浏览WDTP中所建立并管理的文档。WDTP所支持的文本标记本身就是为了易读和简单强调而存在，即便直接阅读也应该无太大压力和困惑。

另一种常规的分享策略就是建站，向全世界展示您的精彩作品、与众不同与别具一格。有无独立域名和服务器都可以很方便地实现，而且随时可以迁移，随时可以更换域名，无需做任何配置，再次上传site目录下的所有数据即可。这方面WDTP（山湖路）应该是做到了极致简约。

程序升级

备份项目数据。
下载最新版本的二进制主程序文件，直接覆盖老程序。如果不放心，也可先将老程序文件改名。待新程序运行无误后，再将老的删掉。如有问题或感觉新不如旧，则随时可以删掉新的，重新使用旧版本。
启动本程序。
如未使用自定义的主题，则系统菜单中点击“重置/修复系统主题”。因为WDTP每次升级均可能涉及到默认样式表和模板文件的更新。如已经使用了自定义主题，重置之前请先备份，或不要执行此步骤。
点击工具栏“齿轮”图标，弹出系统菜单，重新生成整个网站。