WordPress 主题教程 #3：开始 Index.php
2007年06月04日
开始 Index.php 是从零开始创建 WordPress 主题系列教程的第三篇。在介绍了 WordPress 主题的一些规则和术语，以及对 WordPress 模板和模板文件了解之后，现在是开始动手创建 WordPress 主题了的时候。
在这篇中，你将要着手开始写 WordPress 代码。这里建议在本地电脑上安装 WordPress，而不是安装到服务器上，因为本地更方便测试。
第1步：打开 XAMPP 控制面板。
在 XAMPP 文件夹（通常是：C:\xampp），双击 xampp-control.exe 将会弹出一个新的窗口。单击 Apache 和 MySQL 的启动按钮。如下图所示：
启动之后你看最小化窗口了。
第2步：创建你的主题文件夹。
转到你本地安装的 WordPress 主题文件夹，应该在xampp/htdocs/wordpress/wp-content/themes。创建一个新的文件夹，命名为 tutorial。
第3步：创建 index.php 和 style.css 文件。
打开记事本或者你选择的文本编辑器，把 index.txt 这个文件中的所有内容都拷贝到你的记事本。保存为 index.php。
打开另外一个记事本，直接保存为 style.css 到相同的文件夹下.
现在有两个文件了: index.php 和 style.css.
index.php 解释：
点击上面的图片查看大图。我会向你解释每个红色圆圈区域是什么意思。
Doctype - 指明你用哪种类型的代码来编码你的主题。这里你暂时还不用管它的详细意思。
<html> 是网页开始的地方。
<head> 是你的网页头部开始的地方。每个网页都有一个头部和主体。</head> 是头部结束的地方。
<?php bloginfo(’stylesheet_url’); ?> 是一个 PHP 函数，它能取得 style.css 文件所在的路径，这样主题就能使用 style.css 样式化页面上所有元素。任何时候，PHP 代码都是在 <?php 和 ?> 之间的。PHP 代码和 HTML 的代码是不一样的，在 PHP 中，<?php 代表开始 PHP 代码而 ?> 是结束 PHP 代码。
所以：
- <?php - 开始 PHP 代码
- bloginfo(’stylesheet_url’) - 调用 style.css 文件所在的路径
- ; - 停止调用函数。分号是用来结束一个 PHP 语句。
- ?> - 结束 PHP 代码
<body> - 这是网页主体开始的地方。你能在网页上看到和读到的东西就是主体部分。你正在阅读的这个教程说明你在正在看当前这个网页的主体部分。</body> 是网页主体结束的地方。
</html> 是网页结束的地方，没有东西在它的后面了。
第4步：创建 style.css。
把 style.txt 中所有的代码拷贝到你的 style.css 文件中。保存和关闭它。
第5步：安装你的主题。
打开浏览器。在地址栏输入输入 http://localhost/wordpress/wp-login.php。登录到你的 WordPress 管理后台。（这里能够看到 WordPress 登录页面是因为你在第1步的时候启动了 Xampp。否者的话，在这里你的浏览器会报找不到的错误。）
在管理界面下到 外观 (Apperance) 菜单并激活名为 Tutorial 的主题。
注意，你的主题文件没有屏幕缩略图，所以是空白的。一旦激活了，WordPress 就会告诉你激活信息。
现在打开一个新的浏览器或者标签页（如果你的浏览器支持标签页浏览）并在地址栏输入 http://localhost/wordpress。你应该得到一个空白页面，恩，完全空白的页面。如果不是，那你就是在错误的页面上了。
你的主题已经创建好了，这就是这个课程，下一步我们将讨论主题头部模板。
不要忘记关闭 Xampp。双击它在任务栏中小图标，点击 Apache 和 MySQL 的停止按钮，然后点击推出。
WordPress 主题教程
- WordPress 主题教程：从零开始制作 WordPress 主题
- WordPress 主题教程 #1：介绍
- WordPress 主题教程 #2：模板文件和模板
- WordPress 主题教程 #3：开始 Index.php
- WordPress 主题教程 #4a：Header 模板
- WordPress 主题教程 #4b：Header 模板 2
- WordPress 主题教程 #5：主循环
- WordPress 主题教程 #5b：日志内容
- WordPress 主题教程 #5c：日志元数据
- WordPress 主题教程 #5d：Else，日志 ID，链接标题
- WordPress 主题教程 #5e：日志导航链接
- WordPress 主题教程 #6：侧边栏
- WordPress 主题教程 #6b：页面链接列表
- WordPress 主题教程 #6c：存档和链接列表
- WordPress 主题教程 #6d：搜索框和日历
- WordPress 主题教程 #6e：窗体化侧边栏
- WordPress 主题教程 #7：尾部
- WordPress 主题教程 #8：验证 XHTML
- WordPress 主题教程 #9：Style.css 和 CSS 介绍
- WordPress 主题教程 #10：十六进制颜色代码和样式化链接
- WordPress 主题教程 #11：宽度和布局
- WordPress 主题教程 #12：日志样式化和其他杂项
- WordPress 主题教程 #13：样式化侧边栏
- WordPress 主题教程 #14：底部和拆分 Index
- WordPress 主题教程 #15：子模板文件
- WordPress 主题教程 #16：留言模板
- erdaoo 的 WP Theme 教程学习笔记
- WordPress 主题教程电子书下载
翻译自：http://www.wpdesigner.com/2007/02/22/wp-theme-lesson-3-starting-indexphp/，并根据中文习惯和个人理解做了修改！
47 条评论 添加你的评论 →
1. 紫天 | 2007:06:05 - 13:38:56 | #
汗，一时不理解，把Xampp当成了编写工具…远离是集成环境吖…
嗯…都可以看明白…继续看
2. Denis | 2007:06:05 - 15:22:13 | #
XAMPP 是一个易于安装且包含 MySQL、PHP 和 Perl 的 Apache 发行版。XAMPP 的确非常容易安装和使用：只需下载，解压缩，启动即可。
具体你可以参考 http://www.apachefriends.org/zh_cn/xampp.html
3. keke | 2007:06:14 - 19:30:03 | #
正在使用当中，谢谢！
4. lisa | 2007:06:17 - 18:24:44 | #
获益非浅呐！！！！激动… 第一次用wordpress，要学的还很多。咳
5. kendy | 2007:07:10 - 14:27:06 | #
记事本保存编码应该为UTF-8 吧,还是没有关系呢
6. Denis | 2007:07:10 - 14:37:37 | #
最好保存为UTF-8，如果你的主题文件里面没有中文，可以保存为Anti
7. lyons | 2007:08:17 - 13:45:04 | #
为什么在进入http://localhost/wordpress/wp-login.php时，网页显示“Your PHP installation appears to be missing the MySQL which is required for WordPress.”
8. Denis | 2007:08:17 - 14:07:21 | #
to Lyons，请看如何安装 WordPress 那篇文章
9. 个 | 2007:09:25 - 09:27:48 | #
index.txt这个文件打不开啊??
10. lex | 2007:10:05 - 10:30:25 | #
我下载了你的教程，.PDF格式的那个。但是里面用到的好多文件没有，能不能把它们整合到附件里面，比如这篇文章中的index.txt和style.txt以及一些图片。
谢谢你的教程，它真的很有用。
11. Denis | 2007:10:05 - 15:47:58 | #
@ lex，如果你愿意帮忙整理，我会很感谢！
12. otouch | 2007:10:07 - 12:21:43 | #
style.txt打不开。。。
13. Persehone | 2007:11:26 - 14:15:06 | #
index.txt打不开啊，能不能重新传一下啊？
14. Persephone | 2007:11:27 - 08:39:53 | #
老大，有空麻烦一下重新传一下index.txt文件嘞，真的打不开啊！拜托了！
15. Denis | 2007:11:27 - 08:56:00 | #
@Persephone 使用代理，因为我链接到也是原英文博客！
16. Persephone | 2007:11:27 - 15:22:33 | #
谢谢回答，但是小妹愚昧啊，使用代理？什么意思？
还有原英文博客？在哪里啊？
坦白说我是把你这篇文章真当作教程来看了，现在就卡死在那里，学不下去了，所以还望您多帮忙啊！
17. Persephone | 2007:11:27 - 15:27:11 | #
使用代理？原英文博客？小女子愚昧，看不太懂啊，望老大明示！
是说要找原来的英文博客吗？能给个网址吗？
请原谅小女子迫切的心情，因为现在把你这篇文章当作教程，因为这个文件而卡死在半当中实在是难受啊！
18. Denis | 2007:11:27 - 15:48:52 | #
我这个教程是翻译的，所有 index.txt 也是原英文博客上的，我们保存到我自己的服务器上。你可以看到他的地址是：
http://www.wpdesigner.com/wp-content/files/wp-tutorial/index.txt
19. Persephone | 2007:11:27 - 16:42:30 | #
非常感谢飞猪大人一次又一次耐心地回答小的的问题。小的已经去原英文的博客上看过了，真是写的人好，翻译的人也好，小的无比佩服啊！（会不会太献媚了？呵呵）
好了，对于我三番两次提出的index问题，我已经解决了，其实原先的链接地址，我鼠标左击后弹出的页面还是空白，这个问题在原先的英文版博客中也有不少人问，我试着用了各种方法，后来才明白原来我们是思维定式了。
INDEX文件不是左击，而是右击另存为保存在电脑上（我是保存在桌面上的），然后右击文件打开方式用TXT就行了。
20. countyinfo | 2008:02:12 - 19:44:07 | #
按你的本节的指导，操作到到第五步，输入http://localhost/wordpress/wp-login.php后，在进入Presentation菜单后，出现以下信息：
Broken Themes
The following themes are installed but incomplete. Themes must have a stylesheet and a template.
Name Description
Tutorial Template is missing.
显示不是缩略图，请问如何解决？
21. Denis | 2010:01:17 - 01:42:43 | #
没有 style.css 文件！
22. countyinfo | 2008:02:12 - 21:49:07 | #
在建立的tutorial 文件夹中，用笔记本已经粘贴并存好了index和style。但到第五步后，就进行不下去了。请指教，如何化解？
23. countyinfo | 2008:02:13 - 21:47:11 | #
老大，很忙吗？
24. sethyu | 2009:03:08 - 17:31:40 | #
我要遇到这个问题了。怎么解决的？
按你的本节的指导，操作到到第五步，输入http://localhost/wordpress/wp-login.php后，在进入Presentation菜单后，出现以下信息：
Broken Themes
The following themes are installed but incomplete. Themes must have a stylesheet and a template.
Name Description
Tutorial Template is missing.
显示不是缩略图，请问如何解决？
25. MrHe | 2008:02:18 - 15:30:37 | #
我也是遇到index.txt下载不了的问题，最后解决了，很简单，用迅雷直接下就可以了（可以多种方式启动迅雷：把链接拖到迅雷的悬浮窗上，或者新建一个迅雷任务，或者在右键弹出的菜单里选迅雷下载均可。
很感谢本文的作者和翻译，学到了很多东西。SO，自己也来贡献一下
26. 善用佳软 | 2008:02:27 - 17:19:39 | #
刚刚转向wordpress，不过是小众友情搬家的。正在自学中，读了此教程，对我快速理上手帮助很大啊。
一个错字：“在 PHP 中，<?php 时”，应为“是”
27. Denis | 2008:02:27 - 17:42:54 | #
娃哈哈，我很多错别字的。谢谢提醒，什么时候一起改了！
28. 善用佳软 | 2008:02:27 - 17:58:18 | #
此教程确实很好，尤其对初学者。所以，值得出修订版。
（我的上一条留言多了一个“理”字）
29. 小虫 | 2008:03:05 - 12:29:16 | #
按照教程做下来，一路都正确，但是当我输入http://localhost/wordpress/wp-login.php后网页显示依然是报错~~
为什么？
30. smits | 2008:03:30 - 14:00:28 | #
怎样安装WP blog 到电脑上？
31. bofei | 2008:04:02 - 03:40:58 | #
在到第五步的时候我点击：http://localhost/wordpress/wp-login.php
出现
Warning: require(C:\xampp\htdocs\wordpress/wp-config.php) [function.require]: failed to open stream: No such file or directory in C:\xampp\htdocs\wordpress\wp-login.php on line 2
Fatal error: require() [function.require]: Failed opening required ‘C:\xampp\htdocs\wordpress/wp-config.php’ (include_path=’.;C:\xampp\php\pear\’) in C:\xampp\htdocs\wordpress\wp-login.php on line 2
请问老大这个问题怎么解决,谢谢
32. Denis | 2010:01:17 - 01:43:40 | #
你的 WP 包下载有问题！
33. 醉云 | 2008:05:29 - 21:28:09 | #
厄，为什么结尾加粗强调不要忘记关闭 Xampp，这个东西长期开着对电脑有害么？
还是容易被入侵？我是新手
34. Lean | 2008:06:10 - 04:45:00 | #
非常感谢你的教程！对于新手来说实在是太重要了、太有帮助了！
感谢阁下花费的心血！
另外，我尝试使用绿色版的wordpress,结果在输入http://localhost/wordpress/的时候导致服务器出错，然后，换成非绿色版就解决了这个问题。
如果有人发现同样的问题，不知道这个会不会管用。
35. 源子 | 2008:09:01 - 10:00:09 | #
太棒勒。比看小说有意思多勒。
36. Dan | 2008:10:24 - 10:12:47 | #
presentation找不到啊？用的是2.6.2版本的！
37. Dan | 2008:10:24 - 10:39:21 | #
谢谢教程，2.6.2版本的要把TUTORIAL的文件夹放在wp-content/themes directory下面，刷新下就可以看见了！
38. 源子 | 2008:12:18 - 00:04:36 | #
怎么图片都失效勒，5555.我心血来潮想学一下的，唉。唯一让我信任的教程又泡了…
39. 源子 | 2008:12:18 - 00:05:24 | #
哇。留言之后就看到图片勒…
40. millie | 2009:06:08 - 16:05:14 | #
为什么我安装的xampp到了第二步，在htdocs下根本找不到那个wordpress/wp-content/themes那个文件夹
41. Denis | 2009:12:20 - 23:54:02 | #
这个需要你自己去下载 WordPress 安装包的！
42. 阿正 | 2009:12:21 - 00:05:35 | #
博主是不是可以考虑，做成个chm的供人下载呢？
43. Denis | 2009:12:21 - 00:22:15 | #
以后再说！先修正完！
44. kreo | 2010:01:17 - 19:20:47 | #
博主,你好,我按照你的方法操作前面都非常正确.可是到了第五步的时,在安装自己创建的那个空白主题时候点击外观选项,在右边的主题预览里发现不了自己新建的那个主题.不单是空白,而且完全是什么都没有.下面连版本信息都没有.index.php文件和style.css都有,而且绝对是按照你发的粘贴过去的.我觉得应该是index.php文件里的代码有问题.因为我把其他系统默认主题的index.php文件复制过来,style.css文件用我们手工创建的就可以看到激活新主题的选项.而且版本信息时根据你提供的那个文件的版本信息.这说明style.css文件时正确的.
而且我又做了个试验,把手工创建的主题文件打成ZIP的包通过上传安装,也能提示安装成功,但是启用时候提示主题文件已损坏,使用默认的代替.
我想请博主给我分析下是什么原因呢?哦对了,我用的是最新版的2.9.1的WORDPRESS,主题文件跟程序文件的编码都是UTF-8的.
在线求解,不胜感激.
45. Denis | 2010:01:17 - 20:30:57 | #
我做过测试了，没有问题，应该是你复制有问题！
46. kreo | 2010:01:17 - 20:39:39 | #
…老大,不好意思,是我小白了…..
马虎害死人啊….
index.php被我打快了命名成inedx.php了.崩溃啊..为了这个我弄了3个多小时….
真实2010年第一次悲剧.
还是要感谢你.你的文章很好 受益匪浅.谢谢.
47. 草颗粒 | 2010:02:06 - 17:07:20 | #
怎么index.txt 什么也没有 啊