?
[翻譯:陳市明 摘自:http://drupal.org/node/82926]?? To focus this tutorial, we'll start by creating a block module that lists links to content such as blog entries or forum discussions that were created one week ago.這份指南將教會我們如何在一個drupal的結點上創建block content,創建鏈接和回復信息。
?? 首先在drupal的安裝路徑下創建目錄sites/all/modules/onthisdate（呵呵 當然先得創建目錄sites/all/modules哈）。在目錄sites/all/modules/ onthisdate下創建一個文件，命名為onthisdate.module。在drupal 5.x中，目錄sites/all/modules放置的是一些非核心模塊。這個使得你在升級核心模塊的時候更加方便，無需擔心你之前定制化。
<?php
/*?$Id$?*/
?? 在每個模塊的php文件末尾可以省去?>的標記，只要在開頭加上<?php即可。$Id$則是有助CVS的版本控制。在你模塊中，所有需要被Drupal調用的函數都必須以“{模塊名}_{鉤子名}”命名，鉤子名是drupal中一些預定義的方法的前綴。通過這樣的命名方式，可以很容易的讓Druapl調用到這些方法，從而得到你定制的數據。
?? 這個模塊目前還沒運行起來，因為它還沒有被激活。在后面的章節中，我們可以看到如何激活該模塊。
原文
01.?Getting?started
Drupal?5.x
To?focus?this?tutorial,?we'll?start?by?creating?a?block?module?that?lists?links?to?content?such?as?blog?entries?or?forum?discussions?that?were?created?one?week?ago.?The?full?tutorial?will?teach?us?how?to?create?block?content,?write?links,?and?retrieve?information?from?Drupal?nodes.
Start?your?module?by?creating?a?folder?in?your?Drupal?installation?at?the?path:?sites/all/modules/onthisdate?You?may?need?to?create?the?sites/all/modules?directory?first.?Create?a?PHP?file?and?save?it?as?onthisdate.module?in?the?directory?sites/all/modules/onthisdate.?As?of?Drupal?5.x,?sites/all/modules?is?the?preferred?place?for?non-core?modules?(and?sites/all/themes?for?non-core?themes),?since?this?places?all?site-specific?files?in?the?sites?directory.?This?allows?you?to?more?easily?update?the?core?files?and?modules?without?erasing?your?customizations.
<?php
/*?$Id$?*/
As?per?the?Coding?standards,?omit?the?closing??>?tag?and?use?the?longhand?<?php?tag.?The?$Id$?string?will?help?keep?track?of?the?revision?number?and?date?when?you?commit?the?file?to?CVS.
All?functions?in?your?module?that?will?be?used?by?Drupal?are?named?{modulename}_{hook},?where?"hook"?is?a?pre-defined?function?name?suffix.?Drupal?will?call?these?functions?to?get?specific?data,?so?having?these?well-defined?names?means?Drupal?knows?where?to?look.?We?will?come?to?hooks?in?a?while.
The?module?is?not?operational?yet:?it?hasn't?been?activated.?We'll?activate?the?module?later?in?the?tutorial.?