How do I...Display an attached file on a page?

One very powerful capability of MindTouch Deki is the ability to display the contents of certain files which are attached to the MindTouch Deki without having to cut and paste the contents of the file onto the page.  This makes it very easy to display the contents and quickly change the contents displayed when the file is updated or changed.

This feature which uses the web.text function is very handy for software documentation when used in conjunction with the Syntax function.

Note that the filed displayed can be located on any page within the wiki or anywhere on the Net or Internet.

{{ syntax.php(web.text("http://wiki.developer.mindtouch.com/@api/deki/files/2939/=core.get_include_path.php")) }}

<?php
/**
 * Smarty plugin
 * @package Smarty
 * @subpackage plugins
 */

/**
 * Get path to file from include_path
 *
 * @param string $file_path
 * @param string $new_file_path
 * @return boolean
 * @staticvar array|null
 */

//  $file_path, &$new_file_path

function smarty_core_get_include_path(&$params, &$smarty)
{
    static $_path_array = null;

    if(!isset($_path_array)) {
        $_ini_include_path = ini_get('include_path');

        if(strstr($_ini_include_path,';')) {
            // windows pathnames
            $_path_array = explode(';',$_ini_include_path);
        } else {
            $_path_array = explode(':',$_ini_include_path);
        }
    }
    foreach ($_path_array as $_include_path) {
        if (@is_readable($_include_path . DIRECTORY_SEPARATOR . $params['file_path'])) {
               $params['new_file_path'] = $_include_path . DIRECTORY_SEPARATOR . $params['file_path'];
            return true;
        }
    }
    return false;
}

/* vim: set expandtab: */

?>

Go to top

alternatively, you can index a file attached to the current page by name using:

{{ syntax.php(web.text(page.files["core.get_include_path.php"].uri)) }}