Skip to content

A PHP domain for sphinx. Allows you to annotate PHP objects in your sphinx docs.

License

Notifications You must be signed in to change notification settings

ViktorHaag/sphinxcontrib-phpdomain

 
 

Repository files navigation

PHP Domain for Sphinx

Author: Mark Story <mark at mark-story.com>

About

A domain for sphinx >= 1.0 that provides language support for PHP.

PHP Domain supports following objects:

  • Global variable
  • Global function
  • Constant
  • Namespace
    • Function
    • Class
  • Class
    • Class constant
    • Instance methods
    • Static methods
    • Properties

Note

This domain expresses methods and attribute names like this:

Class::method_name
Class::$attribute_name

You address classes/functions in namespaces using \ syntax as you would in PHP:

Package\Subpackage\Class

URLs

PyPI:http://pypi.python.org/pypi/sphinxcontrib-phpdomain
Detail Document:http://packages.python.org/sphinxcontrib-phpdomain

Quick Sample

This is source:

.. php:class:: DateTime

  Datetime class

  .. php:method:: setDate($year, $month, $day)

      Set the date.

      :param int $year: The year.
      :param int $month: The month.
      :param int $day: The day.
      :returns: Either false on failure, or the datetime object for method chaining.


  .. php:method:: setTime($hour, $minute[, $second])

      Set the time.

      :param int $hour: The hour
      :param int $minute: The minute
      :param int $second: The second
      :returns: Either false on failure, or the datetime object for method chaining.

  .. php:const:: ATOM

      Y-m-d\TH:i:sP

Result

.. php:class:: DateTime

  Datetime class

  .. php:method:: setDate($year, $month, $day)

      Set the date.

      :param int $year: The year.
      :param int $month: The month.
      :param int $day: The day.
      :returns: Either false on failure, or the DateTime object for method chaining.


  .. php:method:: setTime($hour, $minute[, $second])

      Set the time.

      :param int $hour: The hour
      :param int $minute: The minute
      :param int $second: The second
      :returns: Either false on failure, or the DateTime object for method chaining.

  .. php:const:: ATOM

      Y-m-d\TH:i:sP

Cross referencing

From other place, you can create cross reference like that:

You can modify a DateTime's date using :php:meth:`DateTime::setDate`.

Result

You can modify a DateTime's date using :php:meth:`DateTime::setDate`.

Install

You can install the phpdomain using pip:

pip install -U sphinxcontrib-phpdomain

About

A PHP domain for sphinx. Allows you to annotate PHP objects in your sphinx docs.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 79.8%
  • Makefile 10.7%
  • Batchfile 9.5%