MWeb 官方 Telegram 群已建立,点击可查看
MWeb 3.2.8 及以下版本升级到 3.3.1 版本说明

文档 - MWeb 生成静态网站 & 博客


MWeb 的静态网站分类

在 MWeb 的文档库中,有两种分类,一种是普通分类,另一种就是静态网站分类了。你可以直接新增一个静态网站分类,也可以在普通分类的顶层的分类中右键,选择 编辑,然后在出来的界面中点击 设置为静态网站 按钮。

网站分类可以设置网站相关的一些东西,设置界面如下:

上图中的设置应该都不难理解,如果要生成静态网站,在设置好之后,点击 生成网站 按钮即可,在生成之前,请务必保证你的分类中有至少一篇文章。你也可以直接右键来选择相关菜单项来生成网站。如果你修改了网站模板,请使用 清理并重新生成 按钮。当然,你任何时候都可以使用这个按钮来清理并重新生成网站。

可以看出,在 MWeb 中生成静态网站非常简单,就写好文章,然后归类到静态网站分类中,再右键静态网站分类并选择生成网站即可,当然你可以先预览一下。

MWeb 中的两种文章类型

MWeb 和 Wordpress 等这类博客的结构一样,分为 一般文章页面 两种文章类型。页面 是用来做像关于我们、联系我们等等这类不用放在正式文章中的网页。

如下图,把 MWeb 文档库中的文档设置为 页面 非常简单,点击 最上方的信息条 ,勾选 是否页面(Is Page) 即可。其中 HTML 文件名 栏是用来设置生成的 HTML 文件名的。比如说上图中的这个文章会生成 mweb-static-blog.html。一般文章 生成的 HTML 文件名也是在此设定。

网站的扩展设置

有些网站模板支持一些扩展设置,比如说网站的图标和 logo,可以自定义自己的图标和 logo 图片,还有,有些网站支持配置 disqus 评论,只要填入 disqus 的 shortname 即可。这些网站的配置是需要网站模板支持的,在 偏好设置 - 网站扩展 - 网站扩展设置 里可以设置,如下图就是使用了 site-mweb-bluma 模板的 Coder For Art 网站的扩展设置。

比如,这里我要设置 “site icon”,也就是网站图标。这就有一个问题,就是:网站图标是图片形式的,而输入框是要填入文本的,那要把图片增加到那里呢?
MWeb 中的做法是在网站分类中,新建一个分类,名为“其它”,然后在其中,新增一个文档,并且设置这个文档的文章类型是属于页面。然后把图片拖拽进这个文档并删除 mweb 生成的 markdown 语法,这样就不会显示在文档中了。
然后如下图,打开大纲视图,找到刚刚拖入的图标,点“Copy”按钮复制,并在 “site icon” 的输入框,粘贴一下即可(我是拿 MWeb 的图标做测试)。

下图为设置好网站图标的效果:

其它需要填入图片的,也是用这用方法。

设置文档扩展

有些网站模板支持文档扩展,我这里还是以使用了 site-mweb-bluma 模板的 Coder For Art 网站为例子。

如下图,打开其中一篇文档,在文档大纲视图最下边,就会发现网站模板所支持的文档扩展填写。

比如说我要填写 featured 图片,则可以先复制 “mweb3-1.jpg” 这张图,然后粘贴入 featured 输入框即可。另外我也顺便填写了 excerpt 这个字段。填写后,在 site-mweb-bluma 模板中的效果如下图:

设置网站的主菜单

偏好设置 - 网站扩展 - 网站菜单 中,先选择要设置的网站,并选中 网站菜单 这个选项卡,如下图:

你可以新增,编辑和删除菜单,或者拖拽来调整顺序。要注意的是,自带的网站模板中,MWeb-Foundation-Book 这个模板是不支持网站菜单的。

其它比如说:“网站扩展”、“文档扩展” 这两个选项卡的功能,是属于自定义模板和功能,这里暂时不做介绍。

文档间的引用

在 MWeb 中引用其它文档非常简单,在文档列表中,右键要引用的文档,选择 复制,如下图所示。


然后在要引用的文档的位置 CMD + V 粘贴即可,MWeb 会生成 [如何使用“发布脚本”功能发布静态网站](how_to_use_shell_script.html) 这种语法。如果你按住 CMD 键并点击,则会打开这个引用的文档。

生成静态网站功能可以很好的处理这种引用,并生成相关的网页连接。

增加阅读更多注释

阅读更多的用途请看下面的图片,这个需要网站模板的支持,你可以使用菜单:标签 - 插入阅读更多注释 来插入阅读更多,然后要注意的是,这个注释是要前后空一行的,也如下图。

另外,比如说发布到 Wordpress 中时,Wordpress 也能识别这个阅读更多的设置。

配置网站发布脚本

这个功能 MWeb for Mac 2.2.3 版就有的,是为了让 MWeb 中的静态网站体验能达到 “新增文档并编辑” - “右键并选择执行发布脚本” 这样一个简单的流程。避免之前那样,生成网站后还要去敲命令进行发布。
相关详细说明,请直接参考这个文章:如何使用“发布脚本”功能发布静态网站