野猪佩奇
WordPress 开发文档收录了这篇文章
主样式表(style.css)
style.css是每个WordPress主题所需的样式表（CSS）文件。 它控制网页的演示（视觉设计和布局）。
位置
为了使WordPress将主题模板文件的集合识别为有效的主题，style.css文件需要位于主题的根目录中，而不是子目录。
有关如何将style.css文件包含在主题中的更详细说明，请参阅“启动脚本和样式”的“样式表”部分。
基本结构
WordPress使用style.css的标题注释部分在“外观（主题）”仪表板面板中显示有关主题的信息。
示例
这是style.css的头部分的一个例子。
/* Theme Name: Twenty Seventeen Theme URI: https://wordpress.org/themes/twentyseventeen/ Author: the WordPress team Author URI: https://wordpress.org/ Description: Twenty Seventeen brings your site t... Version: 1.0 Text Domain: twentyseventeen */
注意：WordPress主题存储库使用此文件中“版本”之后的数字来确定主题是否具有可用的新版本。
Theme Name (): 主题名称。 Theme URI: 公共网页的URL，用户可以在其中找到有关该主题的更多信息。 Author (): 开发主题的个人或组织的名称。 建议使用主题作者的wordpress.org用户名。
Author URI: 创作个人或组织的网址。
Description (): 简短描述的主题。 Version (): 该版本以X.X或X.X.X格式编写。
License (): 主题的协议。 License URI (): 主题许可证的URL。
Text Domain (*): 用于文本域的字符串用于翻译。
Tags: 允许用户使用标签过滤器查找主题的单词或短语。 标签的完整列表在“主题评论手册”中。
在所需的标题部分之后，style.css可以包含常规CSS文件中的任何内容。
style.css中的子主题
如果您的主题是“子主题”，则在style.css标题中需要“模板”行。
/* Theme Name: My Child Theme Template: Twenty Seventeen */
常用 WordPress 模板文件
以下是 WordPress 识别的一些基本主题模板和文件的列表。
index.php
主模板文件。 所有主题都需要它。
style.css
主样式表。 它在所有主题中都是必需的，并且包含主题的信息标题。
rtl.css
如果网站语言的文本方向是从右到左，则会自动包含从右到左的样式表。
front-page.php（经典主题）或 front-page.html（块主题）
无论“管理”>“设置”>“阅读”上的设置如何，首页模板始终用作站点首页（如果存在）。
home.php（经典主题）或 home.html（块主题）
主页模板默认为首页。 如果您未将 WordPress 设置为使用静态首页，则此模板用于显示最新帖子。
singular.php（经典主题）或 singular.html（块主题）
单数模板用于未找到 single.php 时的帖子，或未找到 page.php 时的页面。 如果未找到singular.php，则使用index.php。
single.php（经典主题）或 single.html（块主题）
当访问者请求单个帖子时使用单个帖子模板。
single-{post-type}.php（经典主题）或 single-{post-type}.html（块主题）
当访问者从自定义帖子类型请求单个帖子时使用的单个帖子模板。 例如，single-book.php 将用于显示来自名为 book 的自定义帖子类型的单个帖子。
archive-{post-type}.php（经典主题）或 archive-{post-type}.html（块主题）
当访问者请求自定义帖子类型存档时，使用存档帖子类型模板。 例如，archive-books.php 将用于显示来自名为 books 的自定义帖子类型的帖子存档。 如果 archive-{post-type} 模板不存在，则使用存档模板文件。
page.php（经典主题）或 page.html（块主题）
当访问者请求单个页面时使用页面模板，这是一个内置模板。
page-{slug}.php（经典主题）或archive-{post-type}.html（块主题）
当访问者请求特定页面时使用页面 slug 模板，例如带有“about”slug (page-about.php) 的页面。
category.php（经典主题）或 category.html（块主题）
当访问者按类别请求帖子时使用类别模板。
tag.php（经典主题）或 tag.html（块主题）
当访问者通过标签请求帖子时使用标签模板。
taxonomy.php（经典主题）或 taxonomy.html（块主题）
当访问者请求自定义分类中的术语时，使用分类术语模板。
author.php（经典主题）或 author.html（块主题）
每当访问者加载作者页面时，都会使用作者页面模板。
date.php（经典主题）或 date.html（块主题）
当按日期或时间请求帖子时，使用日期/时间模板。 例如，使用这些 slug 生成的页面：
http://example.com/blog/2014/
http://example.com/blog/2014/05/
http://example.com/blog/2014/05/26/
archive.php（经典主题）或archive.html（块主题）
当访问者按类别、作者或日期请求帖子时，将使用存档模板。 注意：如果存在更具体的模板，如 category.php、author.php 和 date.php，则此模板将被覆盖。
search.php（经典主题）或 search.html（块主题）
搜索结果模板用于显示访问者的搜索结果。
attachment.php（经典主题）或 attachment.html（块主题）
附件模板用于查看单个附件（如图像、pdf 或其他媒体文件）。
image.php（经典主题）或 image.html（块主题）
图片附件模板是 attachment.php 的更具体版本，用于查看单个图片附件。 如果不存在，WordPress 将使用 attachment.php 代替。
404.php（经典主题）或 404.html（块主题）
当 WordPress 无法找到与访问者请求匹配的帖子、页面或其他内容时，将使用 404 模板。
comments.php
经典主题中的评论模板。 在块主题中，改为使用块。
修改时间 2024-06-27