README

Photo Stream是一个用于您照片的自托管静态网站，具有出色的加载性能，由Cecil提供支持。

演示：https://photo-stream-demo.cecil.app（由Netlify托管并由Unsplash提供内容）。

功能

响应式图片和移动友好
文件优化和懒加载
丰富的内容标题
图片占位符（低质量或主导颜色）
键盘导航
直接下载按钮
简单的工作流程：拖放和提交

安装

需要PHP 8.1+和Cecil 8.0+。

首先，您应该克隆或下载Git仓库，或者运行composer create-project cecil/photo-stream myproject。

仓库附带默认版本的cecil.phar，因此您可以立即使用它，或者您可以通过以下命令下载最新版本

curl -LO https://cecil.app/cecil.phar

使用方法

添加照片

只需将图片文件拖放到static/photos目录中。

添加详细信息（可选）

对于每张照片，您都可以通过data/photos.yaml文件添加标题、替代文本和作者名称/URL。

<file basename>: # without file extension
  title: <photo title>
  alt: <alternative text>
  author:
    name: <author name>
    url: <author URL>

配置

您可以通过编辑config.yml文件来定义相册标题、基本URL、作者、颜色、缩略图大小、排序等。

photo:
  style:
    color:
      background: black
      text: white
    img:
      height: 300px
      margin: 2px
  sort: asc
  size:
    thumbnail: 640
    full: 1920
  placeholder: image # image, color or false

本地预览

您可以通过双击命令快捷键

macOS上的preview.command
Windows上的preview.cmd

或者在终端中运行以下命令

php cecil.phar serve -v --open

本地化

您可以将Photo Stream轻松本地化为您的语言。

添加语言

config.yml:

language: <language_code> # e.g.: fr
languages:
  - code: <language_code>
    locale: <locale_code> # e.g.: fr_FR

添加翻译

在translations目录中，将translations.en.yaml复制到translations.<language_code>.yaml，然后翻译每个键。

部署

首先构建网站

php cecil.phar build -v

然后将生成文件中的_site复制到您的Web服务器。

或使用提供商

许可证

Photo Stream是在MIT许可证下分发的免费软件。

PhotoSwipe是在MIT许可证下。

演示中的照片是在Unsplash许可证下。

cecil / photo-stream

维护者

详细信息