README

这是Pico官方默认主题的仓库。

Pico是一个极其简单、速度极快、基于扁平文件的CMS。更多信息请访问http://picocms.org/。

有关如何贡献或获取帮助的信息，请参阅picocms/Pico。

屏幕截图

安装

通常您不需要手动安装此主题，它与Pico的预构建发布包一起提供，并且是picocms/pico-composer的默认依赖项。

如果您使用的是自定义主题，您可以安全地删除此主题。

如果您使用基于composer的Pico安装，并想删除或安装Pico的默认主题，只需在您的服务器上打开shell并导航到Pico的安装目录（例如/var/www/html）。运行composer remove picocms/pico-theme删除主题，或运行composer require picocms/pico-theme（通过Packagist.org）安装主题。

如果您想使用Pico的某个预构建发布包，最好还是让Pico的默认主题保持原样——这不会有什么坏处... 😊 原因在于，该主题是Pico预构建发布包的一部分，因此当更新Pico时，它将被自动重新安装。但是，如果您真的想删除主题，只需删除Pico安装目录中的themes/default目录（例如/var/www/html）。如果您想安装Pico的默认主题，您必须首先在您的服务器上创建一个空的themes/default目录，下载与您的Pico安装版本匹配的主题版本，并将所有包含的文件（例如index.twig）上传到该themes/default目录（结果为themes/default/index.twig）。

Pico默认主题的版本严格遵循Pico核心的版本。您必须不使用与Pico核心版本不匹配的主题版本（例如，版本2.0.1与Pico 2.0.0不兼容）。如果您使用基于composer的Pico安装，只需使用版本约束如^2.0 - picocms/pico-theme将确保其版本与Pico的版本匹配。即使您使用Pico的某个预构建发布包，您也不必担心任何事情——匹配版本的主题已经是Pico预构建发布包的一部分了。

用法

Pico的默认主题并不是真正用于生产网站的，它更多的是创建您自己主题的起点。只需复制主题目录（例如从themes/default/复制到themes/my_theme/），然后在您的config/config.yml中添加以下行：

theme: my_theme

现在您可以编辑主题的样式表和JavaScript来满足您的需求。如果您想使用第三方主题，只需将主题的目录添加到您的themes/目录（例如：themes/some_other_theme/）并相应更新您的config/config.yml文件。Pico的默认主题现在已完全禁用，不会再干扰您的自定义主题或您的网站。如果您想再次使用Pico的默认主题，可以删除该行或将它替换为theme: default。

无论如何，由于Pico的默认主题是为了作为您自己的主题的起点，它展示了如何通过主题来调整主题的行为。因此，它支持“宽屏”模式：通过在您的config/config.yml文件中添加theme_config.widescreen: true，主题的主容器宽度从768px增加到1152px，这是由于在网站的<body>元素中添加了class="widescreen"。Pico的默认主题还支持在页眉中显示标志和标语，并在页脚中添加社交按钮。而不是使用Pico的配置，它使用content/_meta.md Markdown文件的YAML Frontmatter。以下是Pico示例内容中的content/_meta.md：

---
Logo: %theme_url%/img/pico-white.svg
Tagline: Making the web easy.
Social:
    - title: Visit us on GitHub
      url: https://github.com/picocms/Pico
      icon: octocat
    - title: Join us on Libera.Chat
      url: https://web.libera.chat/#picocms
      icon: chat
---

您还应该查看主题的pico-theme.yml：首先，它告诉Pico使用最新的API版本并为Pico的默认Twig配置进行调整。但更重要的是，它还注册了提到的widescreen主题配置以及元头信息Logo、Tagline和Social。

获取帮助

请参阅我们主仓库中的“获取帮助”部分。

贡献

请参阅我们主仓库中的“贡献”部分。

通过为Pico做出贡献，您接受并同意针对您向Pico提交的现有和未来贡献的开发者证书。请参阅我们主仓库中的CONTRIBUTING.md文件中的“开发者证书”部分。

picocms/ pico-theme

维护者

详细信息

README

屏幕截图

安装

用法

获取帮助

贡献