山湖路常见问题及解决方案

关键词: 常见问题, WDTP, 山湖路, FAQ

本文档列举了用户在使用WDTP(山湖路)的过程中可能会产生困惑,或经常咨询并具有普遍性的一些问题。如果您的问题未列其中,请参阅《山湖路-快速上手》、《山湖路-示例及语法详解》或给我们发Email。

  · WDTP(山湖路)到底是一款什么样的软件?
  · 如何导入其它静页生成器的文档?
  · 如何插入项目内部某个文档的链接?
  · 如何快速插入一个文字型链接?
  · 如何使用文档大纲功能?
  · 如何使编辑内容和预览内容同步滚动?
  · 如何快速跳转到文档的某个部分?
  · 如何将文档或目录移动到其它目录下?
  · 如何换肤?
  · 如何录音?如何进行声音记录?
  · 如何使用语音输入文字?
  · 如何编辑处理已插入的图像或音频?
  · 如何搜索和替换?
  · 如何统计某个关键词出现的频次和所在的文档?
  · 如何将某个文档或批量集成的结果转换为PDF?
  · 如何将批量集成的结果转换为其它电子格式?
  · 如何生成项目的关键词索引页?
  · 如何设置表格的对齐方式及外观样式?
  · 如何合计单元格数字或求其平均值?
  · 如何指定图片和视频的宽度?
  · 如何设置文字的字体、大小与颜色?
  · 如何增大行间距(段落留白)和字间距?
  · 如何实现图文混排和双栏模式?
  · 如何设置目录的index页和整个网站的首页?
  · 文档属性面板中的“缩略语”是什么?
  · 文档的“隐身模式”是怎么回事?
  · 文档的“归档”是怎么回事?
  · 如何实现智能提示和自动补全?
  · “项目外源”是怎么回事?
  · 如何使用“时间轴”功能?
  · 如何让某篇文档分属不同的类别(目录)?
  · 如何修改、制作、备份、发布、加载主题?
  · “复习/锤炼/提醒”三合一功能是怎么回事?
  · 某些快捷键失效了?
  · 冗余文件未清理干净,打包数据导出后大小为0等
  · 关于众口难调的网页渲染结果

WDTP(山湖路)到底是一款什么样的软件?


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

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

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

如何导入其它静页生成器的文档?


WDTP(山湖路)的批量导入功能非常强大和智能。

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

如何插入项目内部某个文档的链接?


有三种办法可完成:

上图:获取某个文档的内部链接信息

上图:利用智能提示与自动补全自动输入某个内部项目的链接文本

如何快速插入一个文字型链接?


如何使用文档大纲功能?


文档大纲由该文档的所有二级标题和三级标题构成。也就是说,一篇文档中如果没有二级标题和三级标题,那么此文档是没有大纲的。查看文档大纲并跳转到对应的文档区域,可通过以下两个办法中的任意之一来实现:

上图:文件树面板中鼠标左键单击当前文档后弹出该文档的大纲

上图:编辑区右键菜单中的“文档大纲”

如何使编辑内容和预览内容同步滚动?


WDTP(山湖路)本身不支持编辑区和预览区的实时同步滚动。但是,可以通过“文档大纲”或“目录”功能来变相实现此功能,效率并不低,而且精准度更好。

如何快速跳转到文档的某个部分?


请参见上面的《如何使用文档大纲功能》。

如何将文档或目录移动到其它目录下?


如果仅需移动一个文档或目录,鼠标左键点击文件树面板中该文档或目录,选中,而后按住鼠标左键上下拖拽即可。注意:如果要移动的文档已被选中(当前处于编辑状态),并且该文档有二级标题和三级标题,则鼠标左键点击后将弹出该文档的大纲菜单,此时鼠标是无法进入拖拽模式的。解决办法:鼠标点击弹出大纲菜单后,不要点击任何菜单项,松开鼠标左键,而后再次点击该文档,点击后不要松开鼠标,直接进行拖拽。

如需批量移动多个文档或目录,文件树面板中按住Ctrl键或Shift键,而后鼠标单击要移动的文档和目录,此时可选择多个条目。选择后,鼠标上下拖拽之。

移动文档和目录时,文件树面板中会图形化指示拖放的目的地。松开鼠标左键,即可将所选文档或目录移动到新位置。

如何换肤?


上图:利用“系统菜单-界面颜色”来设置主界面的“皮肤”

上图:编辑区右键菜单,编辑器外观设置

如何录音?如何进行声音记录?


上图:编辑区右键菜单中的“录音”菜单项

上图:录音对话框

关于音频剪辑功能:录音完成后,播放试听,如感觉开头或结尾有太多空白,可点击录音对话框中的“剪刀”按钮,剪掉不需要的头尾。剪辑规则:

如何使用语音输入文字?


macOS平台,文本编辑状态下,按两下[fn]键即进入语音输入状态。为提高效率,可在“偏好设置-键盘-听写”中开启“使用优化听写”。更具体的说明请参见Apple官方文档: https://support.apple.com/zh-cn/HT202584

Windows下,由于该操作系统目前尚无内置的编辑状态语音输入功能(Win 10的小娜不算),因此WDTP暂不支持该平台下的语音输入。

如何编辑处理已插入的图像或音频?


上图:编辑器右键菜单,编辑当前所选中的图像/音频文件

如何搜索和替换?


不同于常规的文本编辑软件和建站程序,WDTP(山湖路)的搜索、替换功能非常智能和高效。

上图:工具栏搜索框

上图:文档内搜索

上图:预览模式下搜索当前页面

除此之外,WDTP还可以使用Google、Bing、Wikipedia搜索编辑模式下的所选内容。具体可参见编辑器右键菜单中的“外部搜索所选内容”。

上图:外部搜索所选内容

WDTP有三种替换模式,非常强大和高效:

上图:针对整个项目、某个文件夹下的所有文档和当前所选文档的智能化批量替换

如何统计某个关键词出现的频次和所在的文档?


除了常规的搜索之外,WDTP(山湖路)还有功能更加强大的“非常规搜索”,并且和数据统计与分析集成在了一起。文件树面板中,鼠标右键单击某个文档或某个目录(或根目录,即项目本身),弹出的菜单中点击“数据统计”或者“关键词表”。

上图:文件树右键菜单,数据统计与关键词表

在出现的浮动面板中,数据统计可搜索并统计某个特征词

上图:数据统计

关键词表中可直接点击以查找并定位该关键词所出现的文档(包括其出现的频次)。

上图:关键词表

关于特征词搜索

关于关键词定位

使用索引页进行精准搜索和定位

详情请参阅如何生成项目的关键词索引页

如何将某个文档或批量集成的结果转换为PDF?


某个文档转换为PDF非常简单。Windows平台下,预览界面,鼠标右键菜单,打印,打印为PDF。macOS平台下,可使用外部浏览器打开该文档所对应的网页(文件树面板,右键菜单,外部的浏览器中加载),而后用该浏览器自带的打印功能输出为PDF即可。目前所有主流浏览器均支持将网页打印输出为PDF。

整个项目或某个文件夹可进行“一键成书”(文件树选中项目根目录或某个文件夹后点击鼠标右键,弹出的菜单中点击“批量集成”)。批量集成的结果为一个独立的、大的html网页,浏览器中加载之,打印输出为PDF即可。

上图:批量集成(一键成书

如何将批量集成的结果转换为其它电子格式?


最通用的电子文档格式就是html:)几乎所有的电子格式均支持与html的互转,这样的工具很多,请自行选用。

如何生成项目的关键词索引页?


  1. 在项目根目录或一级目录下新建一个文档。
  2. 编辑该文档,在适当的地方输入或粘贴一个扩展标记“[keywords]”。
  3. 预览该文档,整个项目(网站)的关键词索引页已经自动生成,无需其它任何操作。
  4. 右侧的属性面板中,将该文档设置为“网站菜单”(此步骤可选)。
  5. 系统菜单 - 重新生成整个网站(此步骤可选)。

注1:如索引页出现在网站菜单栏中,并且其菜单项顺序不符合您的需求,可修改该文档的创建日期,而后重新生成整站。创建日期越早,一级菜单栏中的位置越靠右,二级弹出式菜单中的位置越靠下(其它要作为菜单项的文档或目录,其排序原理与此一致)。

注2:日常增删改文档,或者修改某个文档的关键词之后,无需通过重新生成整站的办法来更新索引页。只需在浏览索引页时重新生成该网页即可(系统菜单 - 重新生成并刷新当前页面,快捷键:F5)。

注3:软件默认生成的索引页中,出现多次的关键词,将给出频次(小括号括住的阿拉伯数字),鼠标指向这些关键词,自动弹出下拉菜单(菜单项是所有使用了该关键词的文档,点击即可浏览)。只出现了一次的关键词,不给出频次,直接点击该关键词即可浏览对应的文档。

如何设置表格的对齐方式及外观样式?


比如某个表格的表头行内容为:(>)第一列 | (^)第二列 | 第三列 | (>)第四列

渲染后的结果:该表格第一列的所有单元格全部右对齐;第二列居中;第三列左对齐(无对齐标记则默认为左对齐);第四列右对齐。

表格的外观样式通过表格文本标记的第二行内容来设置(第一行用来设置表头,可在第一行设置列的对齐方式)。WDTP默认的表格样式有三种,分别是:

用户可自定义或修改默认的表格样式(系统菜单-修改当前主题-全局样式表,table区)。样式表中与表格有关的class有:

关于表格的更多详情请参阅《WDTP(山湖路)示例及语法详解》中的有关内容。

如何合计单元格数字或求其平均值?


上图:自动计算表格行与列中的单元格数字

如何指定图片和视频的宽度?


以图片为例(视频指定宽度与此完全一致),语法格式:![图片标题](图片地址 = 500)图片标题可选)。详解:

如何设置文字的字体、大小与颜色?


如何增大行间距(段落留白)和字间距?


如何实现图文混排和双栏模式?


请参见《山湖路-示例与语法详解·图文混排》(示例页仅演示了图文混排的少数几种用法)。

如何设置目录的index页和整个网站的首页?


无需设置。WDTP(山湖路)将自动产生整个网站和每个目录的index页(包括分页)。基于您所选用或修改的主题,index页的样式、外观可能差别较大。除此之外,WDTP(山湖路)同样支持将某个文档设置为所在目录的index页,非常简单:

文档属性面板中的“缩略语”是什么?


请参阅:《山湖路-示例及语法详解·缩略语》。

文档的“隐身模式”是怎么回事?


文档属性面板中可设置任意文档为“隐身模式”。

上图:文档属性中的隐身模式

文档的“归档”是怎么回事?


如何实现智能提示和自动补全?


WDTP具有比常规的智能提示与自动补全更为强大灵活的操作模式,或者说这两个功能只是WDTP“智库”架构中的两个比较初级和基本的应用层实现。关于智库,简介如下:


# 智库文档的标题

一些必要的说明信息(可有可无)。

## 人物设定(标题可有可无)

- 张二狗
    - 总是得罪已婚少妇,只要吃饭,必被某女迎面泼酒。
- 李四爷
    - 不按套路出牌,不遵守物理学定律。善于手榴弹炸飞机,肩抗土炮打坦克。

## 时间安排

- 15'30"
    - 此处男主1需死,女配2随之出场。
- 18'25"
    - 男主1死而复生,女配2晕倒。

## 狗血桥段

- 连环惊险
    - 迎面撞上小怪,不知所措,小怪突然撤了。镜头一转,发现后面来了一个大怪。

## 自动补全

- 静夜思
    - 床前明月光,低头地上霜。抬头望明月,疑是思故乡。
- 蓝色仿宋
    - <span style="font-family:FangSong; font-size:120%; color:blue;">

## 智能提示

- 5号路段
    - 此处常有熊和交警出没,须谨慎驾驶。

上图:利用智能提示与自动补全自动输入某个内部项目的链接文本

“项目外源”是怎么回事?


日常使用WDTP时,计算机操作者可能需要随时运行、打开、查阅、浏览、视听一些与当前项目有直接或间接关联的程序、文档、资料、网址、各类多媒体文件等资源,即:本机或远程任意机器上的任何有关数据与资源(权限许可并地址明确的前提下)。这些数据(外部资源)也可视为项目的一部分,WDTP将其命名为“项目外源”。简介如下:

上图:添加/打开项目外源

上图:项目属性面板中的项目外源

如何使用“时间轴”功能?


如何让某篇文档分属不同的类别(目录)?


WDTP(山湖路)的文档组织与管理采取与磁盘文件、目录完全对应的底层架构。要实现文档分属功能,只能物理性的将该文档复制到其它目录下。可以通过“跨项目复制/粘贴”来完成(需临时建立或打开另一个山湖路项目)。或者新建一个文档,原文复制(包括各项属性)。

如何修改、制作、备份、发布、加载主题?


WDTP内置了主题修改、相关图像的直接设置等功能,使主题的修改与定制非常方便简单。

上图:查看源码、修改或自定义主题

修改或自定义样式表及模板文件

关于主题(代码)编辑器的搜索功能

关于设置css样式表中的颜色值

主题编辑器中可直接插入模板标签

上图:主题(模板)编辑器中插入模板标签

如何在外部修改制作主题

主题的备份与发布

加载主题

上图:系统菜单下的导出/导入/重置主题

“复习/锤炼/提醒”三合一功能是怎么回事?


先了解一下如何设置或取消某个文档的提醒日期:

上图:文档属性-提醒日期

批量设置提醒日期

文件树面板右击某个目录后,弹出的菜单中点击“批量设置提醒日期”,可一次性设置该目录下所有文档的提醒日期。

上图:批量设置某个文件夹下所有文档的提醒日期

此操作将在每个文档已有设置日期的基础上推迟或提前一些天数,也可批量清除已设置的提醒日期(输入一个正整数为推迟的天数,负整数为提前到期的天数,0则为批量清除)。:此操作不影响未设置提醒日期的文档。如果某个目录下(含其所有子目录)没有任何文档设置了提醒日期,则该菜单项暗显不可用。

上图:设置提醒日期对话框

查看已到期的文档

某个目录有数字后缀意味着该目录下有文档已设置了提醒日期。鼠标右键点击该目录,弹出文件树菜单,点击菜单项“高亮选择到期文档”后将自动展开该目录并高亮选择所有已到期的文档。

“复习/锤炼/提醒”三合一功能详解:

换个思维方式和分析问题的角度,WDTP(山湖路)的提醒功能还可用于其它目的……能够发挥更大的实用价值。

从辩证法的角度来看,人类所有的文明、知识与工具都是“双刃剑”。WDTP的提醒功能亦不例外。该功能对程序本身的代码品质和实际运行等方面来说没任何负面效应(由于底层架构合理,实现此功能的全部代码不超过10行),但是“提醒”这件事本身却有两面性。它能够更高效、更方便、更科学地帮助我们,同时也会给我们带来负担……究竟如何,还有赖于用户的正确认识与合理运用。

某些快捷键失效了?


运行WDTP(山湖路)的时候,如果操作系统同时还运行了某些比较“霸道”或不成熟的软件,而这些软件可能会优先接收并“独吞”键盘快捷键事件,则此时会发生WDTP中某些快捷键失效的问题。比如:Windows平台下,某翻译软件会导致所有正在运行的其它软件的Ctrl + C(复制)快捷键失效。解决办法:退出该软件或在该软件中修改与WDTP冲突的快捷键。

冗余文件未清理干净,打包数据导出后大小为0等


这类问题很罕见,个别Windows用户曾遇到过。经排查,是某些常驻系统的国产杀毒、防火墙软件阻挠了应用程序对系统磁盘所做的文件增删改等操作。解决方案:将WDTP所管理的项目文件夹移动到非系统盘;或者使用管理员权限登录操作系统并运行WDTP;或者在运行WDTP的时候彻底关闭(退出)这些捣乱的杀毒软件。

关于众口难调的网页渲染结果


网页的渲染结果,也就是内容所呈现的布局、格式和样式,是通过主题(css、模板文件及相关图片)来完成的,这个和程序本身的关系不大。网页前端这一块,我的想法是和目前流行的其他命令行静态网页生成器保持基本一致,交给用户和贡献者来负责。我个人非常希望能有更多的网页设计师、前端工程师和行业高手参与进来。按照html 5标准中新增的东西,包括这个标准以后肯定会不断丰富的拓展与规范,加上js和css,前端这一块可以实现很惊人的功能和效果,格式与样式接近完美的出版级文档自不必说,甚至可以写一个功能更强大的网页版WDTP(山湖路),或其他各种类型的网页端app,以帮助人们更好的工作、学习、生活、娱乐。

WDTP(山湖路)归根到底是一款新型的写作工具,对创作者、写作者来说,写出来好东西或许不难,但要把好东西完美地、贴合地呈现出来,很难。这是艺术必须借助技术来体现的最直接例子(反之也成立)。不管任何人,完全依托于任何格式与样式封闭、固定而强制的写作工具或主题,都几乎不可能做到这一点,充其量只是笼子里跳舞,更多只是令人昏昏欲睡的千篇一律,同质重复。但是,太自由与另类的控制模式、结果呈现也很难在短时间内被所有人认可与接受。因此,借助于简洁有力、应用广泛、技术成熟、资料丰富、完全免费的html、css、文本标记语法、JavaScript等通用技术,在兼顾大多数人审美观和实际所需的基础上进行个性化、创造性的定制,是非常值得考虑的解决方案。WDTP(山湖路)在这方面的体现就是上面所说的样式与模板基本交由用户负责,您甚至可以给任何一篇单独的文档应用任何一个独特的模板和样式表(文档属性面板中,最多点两下鼠标)。只要具备这些方面最基础的技术常识,配合足够的想象力、创造力、动手能力和艺术化的审美取向,就可以实现异常丰富、惊人的结果。请记住:一篇好的文档,不仅是内容本身优秀,它的“镜头语言(视觉呈现)”更应该优秀,二者至少应该是相得益彰的。这也必将是下一步所有类型的文档创作与发布的趋势与理念之一。

WDTP(山湖路)的主题制作和应用很简单,这个模块是完全开放的。此外,软件还内置了样式表(css)与模板文件(HTML)的代码编辑、插入标签等功能(系统菜单-编辑当前主题),编辑过程中可随时刷新并预览修改结果。模板文件中可调用的标签可在代码编辑模式下用右键菜单来插入。目前已有的肯定不够,如有需要,请告诉我,我觉得可行、想法不错,就及时定义新的Tag ,写出这部分代码,而后加到开发文档中供更多人使用。

对普通用户来说,可能觉得写html、css代码很困难,是“专业人士”才能做的事。这个认识非常错误。无论html,还是css,掌握它们的基本用法是很简单的一件事,可能也就是几个或十几个小时的学习时间而已。而后做做练习、看看优秀源码、在实际生产的过程中实践一段时间,以真实的任务和具体而清晰的需求来驱动自己进一步学习和研究,这样很快就能上手并运用了。而一旦掌握了它们,获益巨大,绝对比研究、摸索、记忆某个或某些软件的操作使用、界面布局、快捷键分配等等有价值的多。至少,您可以随心所欲地实现相对理想的渲染格式、样式和版面结构、布局等等。如果再掌握一些js、PHP、Python、Ruby、Go等前端脚本语言和服务器架设的基础知识,那么,您几乎可以实现任何想要的功能和效果(只要计算机和浏览器本身能够做到)。可以这么说,掌握了它们,绝对是掌握了强大的知识与技能,而学会用某个软件或者记住它所定义的快捷键,并不是知识,更不是技能,只是消耗了宝贵的脑力资源和时间精力,没太多实际意义。

从另一方面来讲,所有的软件都不会在所有情况下满足所有用户的各类需求。特别是封闭的、大众型的商业软件。或者说,即便满足也非常勉强或繁琐。对软件开发者来说,架构一套简洁而开放的系统绝对比强制、封闭性的设计更能体现自己的职业素养和用户至上的核心理念。而对用户来说,特别是高级用户,当软件本身不能满足所需时,如果不能借助于更简单和强大的知识和技术来轻松高效地弥补或实现,始终陷在某个现成的软件本身所固有(局限)的小圈子里苦苦打转,或者三天两头换软件,不停地试用并浅尝辄止,也是非常遗憾的一件事。这也是人类用计算机这个工具提高工作和学习效率、节约时间、脑力与能耗、增强生活品质等方面最不应该发生也最可悲的一件事。


Email: underwaySoft@126.com 微信公众号: UnderwaySoft