transcludeplugin

PhpWiki是sourceforge的一个开源项目

Date: Tue, 17 Sep 2002 13:03:19 -0700
Mime-Version: 1.0 (Produced by PhpWiki 1.3.4pre)
X-Rcs-Id: $Id: TranscludePlugin,v 1.1 2004/04/29 23:59:07 rurban Exp $
Content-Type: application/x-phpwiki;
  pagename=TranscludePlugin;
  pgsrc_version="2 $Revision: 1.1 $";
  flags="";
  markup=2;
  charset=UTF-8
Content-Transfer-Encoding: binary

TranscludePlugin 用來嵌入整個(外部)網頁到 wiki 頁面.

! Plugin Arguments

=src= |
  要 transclude 的網頁 URL.
=height= |
  初始化 transclusion 框架的高度.
  如果,可能的話,在 transcluded 頁面載入後,可以透過 javascript 改變框架大小,
  讓它能塞下整個 transcluded 頁面. (參閱下面可以得到更多.)

! Bugs / Caveats

o 頁面是利用 =<iframe>= 標籤達到 transclude 的目的. 舊的瀏覽器不支援
  ''iframe''. 這種情況下,使用者將會看到超連結.

o When possible, JavaScript code is used to adjust the height of the
  _iframe_ so that it fits the entire transcluded page.
  Unfortunately, this seems possible only when the transcluded page
  comes from the same server as the wiki page.  (This restriction is
  due to security checks built in to the JavaScript language.)

o The recursion detection code does not currently work.  Be careful to
  avoid recursive transclusions, or you'll be sorry (or at least
  amused.)

! Example

<verbatim>
<?plugin Transclude src="http://phpwiki.sourceforge.net/demo/ChangeLog" ?>
</verbatim>

將會得到

<?plugin Transclude src="http://phpwiki.sourceforge.net/demo/ChangeLog" ?>