网站集成

几个小小的约定就能让 Sitecake 适配任意手工搭建的网站，而无需改变你的工作方式。你继续编写纯 HTML — Sitecake 只是学会哪些部分是可编辑的。

网站结构

下载并解压 Sitecake 压缩包后，结构如下：

sitecake/
sitecake.php

sitecake/ 文件夹包含 CMS 代码和配置。 sitecake.php 是编辑的入口。仅有 Sitecake 本身还不能运行 — 你至少需要一个首页页面，其中至少包含一个可编辑的 div 才能开始编辑。

sitecake/
sitecake.php
index.html

有了一个首页文件和其中一个可编辑的 div，你就可以添加新内容了：标题、文字、列表、视频……

<!DOCTYPE html>
<html>
  <head></head>
  <body>
    <div class="sc-content"></div>
  </body>
</html>

files/
images/
cms-backup/
cms-temp/
sitecake/
sitecake.php
index.html

Sitecake 自动创建了以下文件夹：

files/ — 用于保存上传的文件（例如 PDF）
images/ — 用于保存上传的图片
cms-backup/ — 备份。每次发布后， Sitecake 都会对所有文件生成一次快照，并保存到带日期戳的文件夹中，以便回滚。
cms-temp/ — 用于草稿页面、正在进行的上传和日志文件

排除特定文件

如果你的网站包含不应由 Sitecake 管理的目录或文件，请在站点根目录创建一个 .scignore 文件，逐行列出这些文件或目录。

默认情况下，Sitecake 只检查 .html、 .htm、.php 和 .php5 文件（可以通过配置修改）。

framework-dir/
wordpress/
some-file-not-managed-by-sitecake.php
some-file-not-managed-by-sitecake.html
subfolder/some-file-not-managed-by-sitecake.html

页面结构

添加到 HTML 标签上的 sc-content CSS 类会使该标签成为可编辑内容的容器。Sitecake 加载后，容器内已有的代码会成为初始内容。

Sitecake 目前支持以下内容类型：

h1-h6 — 标题
p — 段落
ul — 无序列表
img — 图片
a — 链接（位于 p、h1-h6 或 ul 内）
sc-gallery — 多图图库，在已发布页面上带灯箱效果
视频 — 嵌入的 YouTube / Vimeo
sc-map — 嵌入的 Google 地图
文件 — 带下载链接的上传文档
HTML — 原始 HTML 代码块

sc-content 容器有两种类型：

基本容器 sc-content — 网页中单纯可编辑的部分。
重复容器 sc-content-name — 在多个页面上重复出现的内容。编辑一次，Sitecake 就会同步到所有位置。