Skip to content

Instantly share code, notes, and snippets.

@maetl
Created April 28, 2011 10:23
Show Gist options
  • Save maetl/946129 to your computer and use it in GitHub Desktop.
Save maetl/946129 to your computer and use it in GitHub Desktop.
phpDocumentor.ini
;; phpDocumentor parse configuration file
;;
;; This file is designed to cut down on repetitive typing on the command-line or web interface
;; You can copy this file to create a number of configuration files that can be used with the
;; command-line switch -c, as in phpdoc -c default.ini or phpdoc -c myini.ini. The web
;; interface will automatically generate a list of .ini files that can be used.
;;
;; default.ini is used to generate the online manual at http://www.phpdoc.org/docs
;;
;; ALL .ini files must be in the user subdirectory of phpDocumentor with an extension of .ini
;;
;; Copyright 2002, Greg Beaver <cellog@php.net>
;;
;; WARNING: do not change the name of any command-line parameters, phpDocumentor will ignore them
[Parse Data]
;; title of all the documentation
;; legal values: any string
title = MODx Revolution API Documentation
;; parse files that start with a . like .bash_profile
;; legal values: true, false
hidden = false
;; show elements marked @access private in documentation by setting this to on
;; legal values: on, off
parseprivate = on
;; parse with javadoc-like description (first sentence is always the short description)
;; legal values: on, off
javadocdesc = off
;; add any custom @tags separated by commas here
;; legal values: any legal tagname separated by commas.
;customtags = mytag1,mytag2
;; This is only used by the XML:DocBook/peardoc2 converter
defaultcategoryname = MODx Revolution
;; what is the main package?
;; legal values: alphanumeric string plus - and _
defaultpackagename = modx
;; output any parsing information? set to on for cron jobs
;; legal values: on
;quiet = on
;; parse a PEAR-style repository. Do not turn this on if your project does
;; not have a parent directory named "pear"
;; legal values: on/off
;pear = on
;; where should the documentation be written?
;; legal values: a legal path
;target = /home/cellog/output
target = docs
;; Which files should be parsed out as special documentation files, such as README,
;; INSTALL and CHANGELOG? This overrides the default files found in
;; phpDocumentor.ini (this file is not a user .ini file, but the global file)
readmeinstallchangelog = README, INSTALL, FAQ, LICENSE, readme.txt, changelog.txt
;; limit output to the specified packages, even if others are parsed
;; legal values: package names separated by commas
packageoutput = modx,xpdo
;; comma-separated list of files to parse
;; legal values: paths separated by commas
;filename = /path/to/file1,/path/to/file2,fileincurrentdirectory
;; comma-separated list of directories to parse
;; legal values: directory paths separated by commas
directory = core/model/modx,core/xpdo,core/docs/tutorials
;; template base directory (the equivalent directory of <installdir>/phpDocumentor)
;templatebase = /path/to/my/templates
;; directory to find any example files in through @example and {@example} tags
;examplesdir = /path/to/my/templates
;; comma-separated list of files, directories or wildcards ? and * (any wildcard) to ignore
;; legal values: any wildcard strings separated by commas
;ignore = /path/to/ignore*,*list.php,myfile.php,subdirectory/
;ignore = pear-*,templates/,Documentation/,test*.php,Lexer.inc
;ignore = core/model/modx/processors/
ignore = *.js,*.tpl,*.inc.php,*.cache.php,*.tpl.php,*.idx.php,cache/*.js,cache/*.tpl,packages/,components/,phpthumb/,phpmailer/,extlib/,snoopy/,xmlrpc/,jsonrpc/,xmlrss/,*_mysql,*_mysql.class.php,core/model/modx/processors/,processors/*
;; comma-separated list of Converters to use in outputformat:Convertername:templatedirectory format
;; legal values: HTML:frames:default,HTML:frames:l0l33t,HTML:frames:phpdoc.de,HTML:frames:phphtmllib,
;; HTML:frames:earthli,
;; HTML:frames:DOM/default,HTML:frames:DOM/l0l33t,HTML:frames:DOM/phpdoc.de,
;; HTML:frames:DOM/phphtmllib,HTML:frames:DOM/earthli
;; HTML:Smarty:default,HTML:Smarty:PHP,HTML:Smarty:HandS
;; PDF:default:default,CHM:default:default,XML:DocBook/peardoc2:default
;output=HTML:frames:DOM/default
output=HTML:frames:DOM/earthli
;; turn this option on if you want highlighted source code for every file
;; legal values: on/off
sourcecode = off
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment