scriptogr.am是前年年底兴起的一个轻量级博客,其功能、配置和玩法都相对简单,界面也十分干净,更有趣的是,scriptogr.am直接支持基于Dropbox进行的Markdown写作,在Byword加入「发布」功能后,该博客的优势尽显。最近,在scriptogr.am上开了个分基地,用来发布没有配图的文字,于是便有了一些心得。

针对每个新接触scriptogr.am的写作者,系统会自动发布一篇说明日志,一来使你的站点看上去热闹些,二来也能对新手起到一定的指导作用。以下是我的译文:

感谢你使用scriptogr.am。目前我们尚处于早期测试阶段,希望你能够喜欢这款网页应用。它专为快速、简单的写作而设计,力求帮助你发掘最大的创意。

scriptogr.am 使用 Markdown语法,这是一种轻量级的标记语言,最初由John GruberAaron Swartz发明。Markdown是一种能将文本转化成HTML格式的工具,适合网络写作使用。Markdown允许你通过一种便于阅读和撰写的纯文本格式来写作,并将其转换成结构有效的XHTML格式(或者HTML格式)。与Markdown语法有关的详细内容,请参考语法指南 页面。你可以立即通过Dingus在线工具来尝试一下Markdown写作。

准备开始

在将你的Dropbox账户与scriptogr.am相关联之后,会有一些必要的文件和文件夹被添加到你的Dropbox中,并被置于Apps/scriptogram的路径下。首先,你会看到一个名为 GET_STARTED.txt的文本文件,它所解释的内容和你目前正在阅读的完全相同。接下来,你会看到我们已经在你的Dropbox里添加了一个posts文件夹。这是你在博客上添加的日志(post)页面(page) 都位于这个文件夹。这些文件皆为纯文本文件,但必须以.md (markdown) 的后缀名得到保存,例如: 你的文件.md

请使用标准的、不含非英语字符的文件名。Dropbox在同步含有无效HTML字符的文件名时可能会出错。我们已经在那里添加了一条示例日志(本文件),以帮助你熟悉本应用。

模板数据

所有文件都必须含有「文首区块」(front block)。文首区块是一个文件中最重要的部分,其形式如下:

Date: 2012-04-17
Title: 我的第一篇日志

你可以设置任何预定义变量(可参考下文)。但标题(Title)是必需的。没有标题,系统将会出错。

预定义全局变量

以下所有的变量名称都是区分大小写的:

必需变量:

标题(Title)

日志(或页面)的标题

非必需但也很重要的变量:

日期(Date)

正确可用的日期格式形如:2011–12–31 12:312011–12–31

日期变量可用来确保日志排序正确)

可选变量

已发布(Published)

如果你不希望在站点上显示某条日志,就将此变量设置为「假(false)」。

类型(Type)

如果你希望博文以「页面」形式而不是以「日志」形式出现,就将此变量设置成「页面(page)」。

缩略名(Slug)

自定义固定链接(代替基于「标题」变量自动生成的网址),在标题较长或频繁变更的情况下显得格外有用。例如my-custom-permalink-url

链接(Link)

将「日志」或「页面」与某个外部链接相连。例如http://google.com

标签(Tags)

为你的日志和页面添加标签。用逗号分隔关键词。一旦添加后,scriptogr.am将把所有标签都转换成有效的HTML基本字符。

摘要(Excerpt)

为你的日志或页面添加摘要1

「日志」和「页面」的区别

「日志」就是一篇博文。

「页面」与「日志」相似,但会在站点的菜单生成一个可见的链接,并指向一个拥有固定连接的页面。

发布你的日志

这很简单。只要前往管理面板并点击「同步(Synchronize)」按钮即可。在登入scriptogr.am浏览自己的页面时,你会在浏览器窗口的右上角看到scriptogr.am的标识符号。这是一个能够指向管理面板的链接。

已发布与未发布

「已发布(Published)」和「未发布(Unpublished)」日志(及页面)的总数就显示在「同步」按钮的旁边。「未发布」是指,你从Dropbox中删除了一篇日志,或者是Dropbox在与scriptogr.am同步的过程中发生了一些错误。当然,如果你在一篇有待发布的日志中设置了Published: false的变量,同样的情况也会发生。

最后,祝你发帖愉快。如果你有任何问题、建议或想法,请随时发电邮给我们 。


  1. 摘要 指从较长的文章或书籍中摘取的一段篇幅较小的样本文字。