scriptogr.am自动生成的说明日志

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

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

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

scriptogr.am 使用 Markdown语法，这是一种轻量级的标记语言，最初由John Gruber和Aaron 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:31或2011–12–31。
（日期变量可用来确保日志排序正确）

可选变量

已发布（Published）

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

类型（Type）

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

缩略名（Slug）

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

链接（Link）

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

标签（Tags）

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

摘要（Excerpt）

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

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

「日志」就是一篇博文。

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

发布你的日志

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

已发布与未发布

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

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

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