add doc action

darcs-hash:20080528182707-84dde-5f15e83a1243ec29a890b3b258163d07db5fc329.gz

actions/doc.php

@@ -0,0 +1,39 @@
+<?php
+/*
+ * Laconica - a distributed open-source microblogging tool
+ * Copyright (C) 2008, Controlez-Vous, Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+if (!defined('LACONICA')) { exit(1); }
+
+require_once('markdown.php');
+
+class DocAction extends Action {
+
+	function handle($args) {
+		parent::handle($args);
+		$title = $this->trimmed('title');
+		$filename = INSTALLDIR.'/doc/'.$title;
+		if (!file_exists()) {
+			common_user_error(_t('No such document.'));
+			return;
+		}
+		$output = Markdown(file_get_contents($filename));
+		common_show_header(_t(ucfirst($title)));
+		common_raw($output);
+		common_show_footer();
+	}
+}

doc/README

@@ -1,14 +1,13 @@
 This package requires PHP 5.x and the following PHP Pear libraries:
 
-- DB_DataObject
-- Validate
-- XMLWriter
+- DB_DataObject http://pear.php.net/package/DB_DataObject
+- Validate http://pear.php.net/package/Validate
+- XMLWriter (built-in)
 - Auth_Yadis from OpenIDEnabled (not the PEAR version!). I decided
   to use the openidenabled.com version since it's more widely
   implemented, seems to be better supported, and it may make sense to
   use the openidenabled.com libraries for OpenID auth sometime in the
   future. Note that this is no longer distributed separately; it's only
   in the openidenabled.com OpenID PHP tarball.
-- OAuth.php from http://oauth.googlecode.com/svn/code/php/
   
   

lib/util.php

@@ -150,6 +150,11 @@ function common_text($txt) {
 	$xw->text($txt);
 }
 
+function common_raw($xml) {
+	global $xw;
+	$xw->writeRaw($xml);
+}
+
 function common_license_block() {
 	global $config, $xw;
 	common_element_start('p', 'license greenBg');