README

这是一个几乎准备好的 ("pronto" 在意大利语中意为“立即”）CMS，供您使用。

Pronto的目标是成为一个下载后即可运行的基于平面文件的CMS，具有高速和低维护成本。它使用Laravel Lumen作为其核心。

特性

• Markdown内容解析
• 章节和子章节
• 页面和章节可配置顺序
• 多级页面嵌套
• 多语言支持
• 主题
• 文件下载和资产管理
• 想象力

浏览器兼容性

目前计划针对所有现代浏览器（IE10、IE11、Edge、Chrome、Firefox、Safari、Opera最新版本）。

要求

• php 5.5.9+
• php fileinfo 扩展
• Composer（用于管理PHP依赖项）
• NodeJS和NPM（用于构建前端）

安装

要创建新项目，请使用Composer "create-project" 命令。传递包名（avvertix/pronto），以及创建项目的目录（例如 path）。您还可以提供第三个参数作为版本，否则将使用最新版本。

php composer.phar create-project avvertix/pronto path

现在，所有PHP代码都在那里，您可以启动来初始化前端（即默认主题）：

npm install
gulp

内容编写

您的网站内容将从 storage/content 文件夹中的文件夹和Markdown文件中收集。

文件夹将被转换为章节，而Markdown文件是页面。只有扩展名为 .md 的Markdown文件将被考虑。

如果文件夹包含名为 index.md 的文件，则当请求章节时将显示它。

我们支持以下Markdown规范：

• Markdown
• Markdown Extra

该框架提供语法高亮功能，因此请为每个带围栏的代码块指定语言。

文件夹命名规则

• 小写字母
• 无空格
• 使用 - 和 _ 作为单词分隔符

文件命名规则

• .md 扩展名
• 无空格
• 使用 - 作为单词分隔符
• 完全小写

添加图像（png、jpg等）和资源（pdf、zip等）

图像可以存储在 storage/images 中，然后在Markdown页面中通过特殊路径引用其名称，如下例所示

![alt](./i/image-name.png)

图像文件名遵循与Markdown页面相同的文件命名规则。

如果您想在图像上设置链接，可以使用以下Markdown语法

[![](./i/image-name.png)](./i/image-name.png)

前面的示例将在点击图像预览时打开图像的完整大小版本。

全局导航菜单

将插入到网站页眉中的全局导航菜单完全使用基于JSON的配置创建。配置文件，命名为 config.json，必须位于 storage/app 文件夹中。

全局导航中可以插入三种类型的元素

1. 外部链接，
2. 页面链接，
3. 章节链接。

菜单中的每个元素都必须有一个用于菜单UI的 title 属性和一个包含元素链接的 ref 属性。

外部链接

对于外部链接，您需要指定

• title：要向用户显示的链接标题
• ref：绝对URL

页面链接

对于页面，您需要指定

• title：要向用户显示的标题
• type：page
• ref：页面的路径，由章节缩略语和页面缩略语组成（相对于 content 文件夹）

章节链接

• title：要向用户显示的标题
• type：section
• ref：章节的路径（相对于 content 文件夹）

以下代码块是 config.json 菜单部分的示例。

{
	"menu": [
		{
			"title": "Git",
			"ref": "http://git.project"
		},
		{
			"title": "Sub Section Promoted",
			"type": "section",
			"ref": "example-section/sub-section-1"
		},
		{
			"title": "Home",
			"type": "page",
			"ref": "index"
		}
	]
}

保护您的安装

...

使用 Visual Studio Code 创建