X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=pakefile.php;h=ef2f31a0edc87847165fd4cecfdbd141c4acc478;hb=e344025b828aec0efa90d58902c87743b1ebf59f;hp=fc2633bca0860282a990a52d3bd05c52b7e90e43;hpb=9d4cfc9508b03a579dd62a28c0e9e428b5052f9b;p=plcapi.git diff --git a/pakefile.php b/pakefile.php index fc2633b..ef2f31a 100644 --- a/pakefile.php +++ b/pakefile.php @@ -3,7 +3,7 @@ * Makefile for phpxmlrpc library. * To be used with the Pake tool: https://github.com/indeyets/pake/wiki * - * @copyright (c) 2015 G. Giunta + * @copyright (c) 2015-2020 G. Giunta * * @todo !important allow user to specify location of docbook xslt instead of the one installed via composer */ @@ -257,8 +257,28 @@ function run_doc($task=null, $args=array(), $cliOpts=array()) // API docs // from phpdoc comments using phpdocumentor + //$cmd = Builder::tool('php'); + //pake_sh("$cmd vendor/phpdocumentor/phpdocumentor/bin/phpdoc run -d ".Builder::workspaceDir().'/src'." -t ".Builder::workspaceDir().'/doc/api --title PHP-XMLRPC'); + + // from phpdoc comments using Sami + $samiConfig = <<files() + ->exclude('debugger') + ->exclude('demo') + ->exclude('doc') + ->exclude('tests') + ->in('./build/workspace'); + return new Sami\Sami(\$iterator, array( + 'title' => 'PHP-XMLRPC', + 'build_dir' => 'build/workspace/doc/api', + 'cache_dir' => 'build/cache', + )); +EOT; + file_put_contents('build/sami_config.php', $samiConfig); $cmd = Builder::tool('php'); - pake_sh("$cmd vendor/phpdocumentor/phpdocumentor/bin/phpdoc run -d ".Builder::workspaceDir().'/src'." -t ".Builder::workspaceDir().'/doc/api --title PHP-XMLRPC'); + pake_sh("$cmd vendor/sami/sami/sami.php update -vvv build/sami_config.php"); // User Manual @@ -269,7 +289,7 @@ function run_doc($task=null, $args=array(), $cliOpts=array()) // then docbook from asciidoc /// @todo create phpxmlrpc_manual.xml with the good version number /// @todo create phpxmlrpc_manual.xml with the date set to the one of last commit (or today?) - pake_sh("$cmd -d book -b docbook $docDir/manual/phpxmlrpc_manual.adoc"); + pake_sh("$cmd -d book -b docbook $docDir/manual/phpxmlrpc_manual.adoc"); # Other tools for docbook... #