iwp - sae 版本

三里屯摇滚

iwp - sae 版本

http://1.iwp001.sinaapp.com/iwp/public/?q=framework.doc.index
http://1.iwp001.sinaapp.com/iwp/public/?q=testcase.index


那就在 sae 上开发吧,暂时...


文档集成了一个 不到100行的 wiki引擎


单元测试是我之前自己写的 kencore-unit




Php代码

1. 1.<?php   
   
2. 2.Core_Autoloader::loadFile(COREPATH . '/vendor/WikiDoc.class.php');   
   
3. 3.Core_Autoloader::loadFile(COREPATH . '/vendor/TplEngine.class.php');   
   
4. 4.  
   
5. 5./**  
   
6. 6. * Iwp 文档查看器  
   
7. 7. *  
   
8. 8. */  
   
9. 9.class Pkg_Iwp_Doc {   
   
10. 10.      
    
11. 11.    const queryHome = 'query-home';   
    
12. 12.    const queryController = 'query-controller';   
    
13. 13.    const queryAction = 'query-action';   
    
14. 14.    const queryApiName = 'api-index';   
    
15. 15.      
    
16. 16.    static $pageTitle = '';   
    
17. 17.      
    
18. 18.    static $apiQueryHome = 'http://iwp.iamsese';   
    
19. 19.    static $apiController = 'api';   
    
20. 20.    static $apiAction = 'index';   
    
21. 21.      
    
22. 22.    static function lookup(array $vars){   
    
23. 23.           
    
24. 24.        static $tplEngine = null;   
    
25. 25.        if (!$tplEngine){   
    
26. 26.            $tplConfig = array(   
    
27. 27.                'templateDir' => dirname(__FILE__) . '/_views',   
    
28. 28.                'enableCache' => false,   
    
29. 29.            );   
    
30. 30.            $tplEngine = new TplEngine($tplConfig);   
    
31. 31.               
    
32. 32.            // 注入扩展开发   
    
33. 33.            WikiDoc::addPlugin('title',"Pkg_Iwp_Doc::plugin_title");   
    
34. 34.            WikiDoc::addPlugin('apilink',"Pkg_Iwp_Doc::plugin_apilink");   
    
35. 35.               
    
36. 36.        }   
    
37. 37.           
    
38. 38.        $apiName = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryApiName,'index');   
    
39. 39.           
    
40. 40.        self::$apiQueryHome = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryHome,'http://iwp.iamsese');   
    
41. 41.        self::$apiController = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryController,'api');   
    
42. 42.        self::$apiAction = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryAction,'index');   
    
43. 43.           
    
44. 44.           
    
45. 45.        // 过滤特殊字符   
    
46. 46.        $apiName = preg_replace('/[^a-z0-9_]+/i', '', $apiName);   
    
47. 47.        $apiName = strtolower(trim($apiName));   
    
48. 48.           
    
49. 49.        $api_content = "{$apiName} 未找到";   
    
50. 50.        $last_mod = FALSE;   
    
51. 51.           
    
52. 52.        do {   
    
53. 53.            if (emptyempty($apiName)) {   
    
54. 54.                $api_content = "错误 500: 无效的 apiName ";   
    
55. 55.                break;   
    
56. 56.            }   
    
57. 57.            $apiFile = Pkg_Iwp_Doc::getApiFile($apiName);   
    
58. 58.            if ($apiFile){   
    
59. 59.                $last_mod = filemtime($apiFile);   
    
60. 60.                $api_content = WikiDoc::parse(file_get_contents($apiFile));   
    
61. 61.                break;   
    
62. 62.            }   
    
63. 63.        } while(false);   
    
64. 64.                       
    
65. 65.        $tplEngine->assign('page_title',Pkg_Iwp_Doc::$pageTitle);   
    
66. 66.        $tplEngine->assign('api_content',$api_content);   
    
67. 67.        $tplEngine->assign('last_mod',$last_mod ? date('y-m-d H:i:s',$last_mod) : '未知' );   
    
68. 68.                  
    
69. 69.        $tplEngine->display('display.php');   
    
70. 70.    }   
    
71. 71.      
    
72. 72.    static function getApiFile($apiName){   
    
73. 73.        $apiFile = dirname(__FILE__) . '/api' . "/{$apiName}.txt";   
    
74. 74.        if (is_readable($apiFile)){   
    
75. 75.            return $apiFile;   
    
76. 76.        }   
    
77. 77.        return false;   
    
78. 78.    }   
    
79. 79.      
    
80. 80.    /**  
    
81. 81.     * 增加 title 标签  
    
82. 82.     *   
    
83. 83.     * <<title Felix Pleșoianu>>  
    
84. 84.     *   
    
85. 85.     * @param string $title  
    
86. 86.     * @return string  
    
87. 87.     */  
    
88. 88.    static function plugin_title($title){   
    
89. 89.        Pkg_Iwp_Doc::$pageTitle = trim($title);   
    
90. 90.        return '';   
    
91. 91.    }   
    
92. 92.      
    
93. 93.    /**  
    
94. 94.     * 增加 applnk 标签,用于内部api name链接  
    
95. 95.     *   
    
96. 96.     * <<applnk about , 关于>>  
    
97. 97.     *   
    
98. 98.     * @param string $apiName  
    
99. 99.     * @return string  
    
100. 100.     */  
     
101. 101.    static function plugin_apilink($apiName){   
     
102. 102.           
     
103. 103.        static $tpl = '[%s %s]';   
     
104. 104.           
     
105. 105.        $secs = explode(',',trim($apiName));   
     
106. 106.        if (!emptyempty($secs)){   
     
107. 107.            $link = array_shift($secs);   
     
108. 108.            if (emptyempty($secs)) $text = $link;   
     
109. 109.            else $text = implode(',',$secs);   
     
110. 110.               
     
111. 111.            $link = self::$apiQueryHome . Core_AppUtils::url(self::$apiController,self::$apiAction,array(   
     
112. 112.                self::queryApiName => trim($link)   
     
113. 113.            ));   
     
114. 114.            return sprintf($tpl,$link,$text);   
     
115. 115.        }   
     
116. 116.        return $apiName;   
     
117. 117.    }   
     
118. 118.}  
     
119. <?php
     
120. Core_Autoloader::loadFile(COREPATH . '/vendor/WikiDoc.class.php');
     
121. Core_Autoloader::loadFile(COREPATH . '/vendor/TplEngine.class.php');
     
122. 
     
123. /**
     
124. * Iwp 文档查看器
     
125. *
     
126. */
     
127. class Pkg_Iwp_Doc {
     
128.        
     
129.         const queryHome = 'query-home';
     
130.         const queryController = 'query-controller';
     
131.         const queryAction = 'query-action';
     
132.         const queryApiName = 'api-index';
     
133.        
     
134.         static $pageTitle = '';
     
135.        
     
136.         static $apiQueryHome = 'http://iwp.iamsese';
     
137.         static $apiController = 'api';
     
138.         static $apiAction = 'index';
     
139.        
     
140.         static function lookup(array $vars){
     
141.                
     
142.                 static $tplEngine = null;
     
143.                 if (!$tplEngine){
     
144.                         $tplConfig = array(
     
145.                                 'templateDir' => dirname(__FILE__) . '/_views',
     
146.                                 'enableCache' => false,
     
147.                         );
     
148.                         $tplEngine = new TplEngine($tplConfig);
     
149.                        
     
150.                         // 注入扩展开发
     
151.                         WikiDoc::addPlugin('title',"Pkg_Iwp_Doc::plugin_title");
     
152.                         WikiDoc::addPlugin('apilink',"Pkg_Iwp_Doc::plugin_apilink");
     
153.                        
     
154.                 }
     
155.                
     
156.                 $apiName = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryApiName,'index');
     
157.                
     
158.                 self::$apiQueryHome = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryHome,'http://iwp.iamsese');
     
159.                 self::$apiController = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryController,'api');
     
160.                 self::$apiAction = Core_AppUtils::val($vars,Pkg_Iwp_Doc::queryAction,'index');
     
161.                
     
162.                
     
163.                 // 过滤特殊字符
     
164.                 $apiName = preg_replace('/[^a-z0-9_]+/i', '', $apiName);
     
165.                 $apiName = strtolower(trim($apiName));
     
166.                
     
167.                 $api_content = "{$apiName} 未找到";
     
168.                 $last_mod = FALSE;
     
169.                
     
170.                 do {
     
171.                         if (empty($apiName)) {
     
172.                                 $api_content = "错误 500: 无效的 apiName ";
     
173.                                 break;
     
174.                         }
     
175.                         $apiFile = Pkg_Iwp_Doc::getApiFile($apiName);
     
176.                         if ($apiFile){
     
177.                                 $last_mod = filemtime($apiFile);
     
178.                                 $api_content = WikiDoc::parse(file_get_contents($apiFile));
     
179.                                 break;
     
180.                         }
     
181.                 } while(false);
     
182.                                        
     
183.                 $tplEngine->assign('page_title',Pkg_Iwp_Doc::$pageTitle);
     
184.                 $tplEngine->assign('api_content',$api_content);
     
185.                 $tplEngine->assign('last_mod',$last_mod ? date('y-m-d H:i:s',$last_mod) : '未知' );
     
186.                                
     
187.                 $tplEngine->display('display.php');
     
188.         }
     
189.        
     
190.         static function getApiFile($apiName){
     
191.                 $apiFile = dirname(__FILE__) . '/api' . "/{$apiName}.txt";
     
192.                 if (is_readable($apiFile)){
     
193.                         return $apiFile;
     
194.                 }
     
195.                 return false;
     
196.         }
     
197.        
     
198.         /**
     
199.          * 增加 title 标签
     
200.          *       
     
201.          * <<title Felix Pleșoianu>>
     
202.          *
     
203.          * @param string $title
     
204.          * @return string
     
205.          */
     
206.         static function plugin_title($title){
     
207.                 Pkg_Iwp_Doc::$pageTitle = trim($title);
     
208.                 return '';
     
209.         }
     
210.        
     
211.         /**
     
212.          * 增加 applnk 标签,用于内部api name链接
     
213.          *       
     
214.          * <<applnk about , 关于>>
     
215.          *
     
216.          * @param string $apiName
     
217.          * @return string
     
218.          */
     
219.         static function plugin_apilink($apiName){
     
220.                
     
221.                 static $tpl = '[%s %s]';
     
222.                
     
223.                 $secs = explode(',',trim($apiName));
     
224.                 if (!empty($secs)){
     
225.                         $link = array_shift($secs);
     
226.                         if (empty($secs)) $text = $link;
     
227.                         else $text = implode(',',$secs);
     
228.                        
     
229.                         $link = self::$apiQueryHome . Core_AppUtils::url(self::$apiController,self::$apiAction,array(
     
230.                                 self::queryApiName => trim($link)
     
231.                         ));
     
232.                         return sprintf($tpl,$link,$text);
     
233.                 }
     
234.                 return $apiName;
     
235.         }
     
236. }

复制代码

这个是帮助文档的生成类




  index.txt 内容如下
写道
<<title 对 Iwp 的介绍>>
大多数PHPer都想写出运行状态良好的应用程序，而且希望尽可能做得简单且不费事。而Iwp就是一个达成以上目标的框架。

===== Iwp 是什么? 框架又是什么?
当发明计算机编程不久之后，便有人发现，这其中涉及到了太多的重复操作。之后，也许是 Ada Lovelace（人类历史上的首位程序员），又或许是 Alan Turning，决定将计算机程序模块化，从而使得片段程序代码可以重复使用。PHP 程序员们早已习惯了将需要重复使用的代码写在函数中，并将这些函数放在 include 文件里。

同样的，框架是为重用而发明的，存放在独立的文件中，用来简化重复操作的代码。

<<apilink about,关于作者 vb2005xu >>

{{http://1.iwp001.sinaapp.com/iwp/public/me.jpg}}

[http://vb2005xu.iteye.com/blog/1443451 关于这个文档的说明]

如果有一天21

谢谢分享