使用XPWeb应用极限编程(隐喻)

隐喻

XP隐喻 (metaphor)必须能帮助你用可以理解的语言描述你的系统。

为了达到这个目的,我们可以在XP< /span>Web的“隐喻”一节中列出所有的隐喻术语。这些术语由一个名字/标题和他的解释组成。

“超描述”

通常作为“超描述”的东西现在是一个称为“文本模式”的一个大的功能特性。
如果在隐喻中定义了一个词,把{}放在词的两边,就可以把它变成“超词”……
注意你可以用词的复数形式(“words”可以找到“word”定义)。

事实上,搜索定义有三个级别:

  1. 搜索词的实际定义
  2. 如果没有结果,查找包含该词的那个词的定义。
  3. 最后,查找词的定义中包含该词的。

要获得更多的关于模式和如何修改的信息,看这里.

例子

参照只包含两个词的隐喻的例子,同时你注意第一个“连接”到了第二个。

尝试点击“senses”连接在第一个词的描述中,应该会出现一个弹出窗口连接到第二个词……

同时,通过点击“修改”,注意这个连接只会基于这个词的复数形式(用括号括出)。

使用XPWeb应用极限编程(安装)

ShiningRay @ NirvanaStudio

安装

安装 XP Web

  • 确保你已经拥有mysql(或者其他数据库,请在配置中指定)和一个可以运行PHP4或PHP5脚本的Web服务器(和相应的PHP库!如:如果要连接postgresql数据库必须启用php_pgsql扩展)。
  • [ 下载 ] the latest version of the tool (XPWeb.tgz 或者 XPWeb.zip).
  • [ 解压 ] (unzip 或者 ungzip 和 untar) 文档.
  • 把目录中的XPWeb 目录放到那个可以运行PHP和数据库的网络服务器的目录中。
  • 你也许想在配置文件里[ 配置 ] 一些参数,例如数据库名称,登录名和密码 ,
    注意:配置十分重要,包括负载因子和其他参数,必须在初始化/更新数据库之前完成……

    You should do this in a [ 本地配置]

    你只要新建一个 [ Config_local.inc.php ] 文件,并把它放到XPWeb的根目录下 -和Config.inc.php同一位置- 并且将你要“本地化”的设置从 Config.inc.php 中复制过来。

    你在本地进行的设置会覆盖默认的设置,那些没有放在本地文件中的设置就会设为默认。

    既然这样当升级到新的XPWeb的时候,可能会有一些新的默认设置,但不用担心你已经存在的本地设置(分发包里面不包含Config_local.inc.php文件,所以可以保证你在升级的时候原来的设置不会被覆盖……)
    这里有一个完整的Config_local.inc.php 文件的例子:

    <?php

    defineOnce(“XP_REPORT_TEMP_PATH”,”../../temp”);

    defineOnce(“XP_DEFAULT_LANGUAGE”,”fr”);

    defineOnce(“XP_DB_PASS”,”myPass”);

    ?>

    记住你无需复制所有的设置,只需要那些你要对默认设置进行改变的那些值……

  • 使用浏览器访问 [ index.php ] 页面,这时页面应该给出一个连接来新建或者初始化数据库。

升级 XP Web

任何XPWeb 的升级都会保证你所有的数据安全,当然也不会改变你使用 XPWeb 的习惯;-)

  • 如何创建一个本地的配置文件已经在上面解释过了。如果你已经有了一个文件, [ keep it safe ].
  • 按照一般安装的步骤替换你的XPWeb 目录(你不会丢失任何项目数据)。
  • 只要简单的 复制 你的 Config_local.inc.php文件到 XPWeb 根目录 (XPWeb/).
  • 浏览[ XPWeb/index.php ] 并按照他的指示来更新数据库。
    注意: 在进行数据库初始化或更新之前必须有一个正确的配置文件……
  • 好了,你肯定跃跃欲试了!
  • XPWeb 2.2之前版本进行升级的注意点

    XPWeb 直到2.2,任务是用“完成百分率”表示的。从2.2到以后,你要使用“done”和“todo”字段来替代。数据库的升级会删除“actual completion”(实际完成)字段并且生成相应的“done”和“todo”字段。确保你想要直接跳到当前版本。
    你也许应该考虑在升级之前备份一下你的数据库……

问题?

  • 你的Web服务器的配置文件应该说明以“.php”为扩展名的文件是PHP代码文件并且 “<?php” 和 “?>” 之间的代码是 php (这时通常的配置).
  • 要有一个正在运行的数据库服务器同时你必须在Config_local.inc.php中指定正确的 [ 数据库 用户/密码] 参数。
  • 如果你在身分验证上遇到了麻烦,你可以检查PHP Session 配置。你需要能在Web服务器上能处理Session文件。
    你也可以改变Config_local.inc.php 中的XP_SESSION_PATH 参数
  • 不能管理选择当前的项目或者在本地网络上登录 XPWeb ?
    这里有一个对于IE的 已知的bug你可能感兴趣(服务器名不能包含点)。
  • 请在你想问我们关于PHP的配置的问题前检查一下 php.net 手册……
  • 一般来说,关于[ 使用 ] 而不是 [ 安装 ] XPWeb的帮助, 请记得参考内部的帮助文件。
  • 请访问Sourceforge.net上的在线论坛来获得更多的帮助。

相关连接

  • XPWeb网站
  • XP Web 在Sourceforge.net上的论坛


  • Wampserver PHP/MySql for Windows
  • 熵.ch PHP5 for Mac OS X
  • PHP 安装
  • MySql 安装
  • CVSWeb
  • xUnit 测试框架
  • XProgramming.com
  • 其他 XP 软件
  • 极限编程Wiki

使用XPWeb应用极限编程(文档)

Doc

文档部分包括四个很相似的子部分:

  • 模型(modeling) 与模型相关的连接
  • Doc文档 其他文档文件
  • Javadoc Javadocs… 够明确了吧?
  • 目录(Directories) 你希望被显示以便直接显示并访问其中的文件而不需要添加指定文档。

这些连接都在项目部分中定义.

注意如果项目的这些部分中只有一个连接被定义了,点击“Doc”标签会默认直接打开它。
再次点击“Doc”标签会把你带回“通常”的文档部分,显示所有的子部分。

打开 / 下载文档 –

所有这些文档都要遵守同一个原则:

  • 文档会在一个框架页中打开,同时如果Web浏览器支持它的格式,它就会在页面中打开。
  • 如果你知道浏览器不支持文档的格式,最好在新的窗口中打开(同时它可能会弹出一个对话框让你下载这个文档)

目录

目录十分特殊。

这是一种无需一个个手工添加文档就可以访问文档的方法。
层次结构可以通过点击子目录来打开。

注意:配置目录的时候要小心,因为如果层次很复杂的话页面显示会要用很长时间。
只能够选择本地的目录。

这里有一个View目录的例子 (一些按钮被禁止了).