01. 开始

为更好理解这个手册，我们开始建立一个区块模块：列出一周前建立的blog或者forum讨论文章的连接。整个手册将教我们怎么样建立区域内容，写出连接和获得Drupal节点里的内容。

开始首先在你的drupal安装目录下建立一个文件夹：

sites/all/modules/onthisdate

你需要首先建立sites/all/modules这个文件夹， 然后在此文件夹里建立一个名叫onthisdate.module的php文件。对于Drupal 5.x，sites/all/modules里最好存放不是核心模块的模块（例如site/all/themes里最好存放不是核心模板的模板），因为这样站点本身文件会在他们自己的文件夹里。这会让你更容易更新核心文件和核心模块而不会删除你自己修改的地方。

根据代码书写标准，免去?>标签，并且使用完整的<?php标签。 在你给CVS提交文件的时候，$Id$字符串将帮助跟踪修改号码和时间。

在你模块里所有将被Drupal调用的功能，应该命名为{modulename}_{hook}，"hook"是预先定义功能的后缀。Drupal将调用这些功能来得到具体数据，所以有了这些完整定义好的名字意味着Drupal知道在哪里寻找。我们将很快讲解hooks。

本模块现在还不可以运行，因为它还没有被激活。我们将在后面的讲解中激活此模块。

原文：http://drupal.org/node/82926