Giter VIP home page Giter VIP logo

doxyphp2sphinx's Introduction

doxyphp2sphinx

API Documentation generator for PHP projects which use Sphinx.

It acts as a compatibility layer between Doxygen (which is good at reading PHP), and Sphinx (which is used by some online services to host HTML docs).

This tool is compatible with Python 2 and 3.

Installation

From source

git clone https://github.com/mike42/
python setup.py bdist_wheel --universal
pip install dist/doxyphp2sphinx-*.whl

From pip

pip install doxyphp2sphinx

Verification

Test that you have the command.

doxyphp2sphinx --help

Command-line use

This package provides the doxyphp2sphinx command, which generates .rst files as output, given a directory of doxygen XML files.

usage: doxyphp2sphinx [-h] [--xml-dir XML_DIR] [--out-dir OUT_DIR] [--verbose]
                      [--quiet]
                      root_namespace

Generate Sphinx-ready reStructuredText documentation or your PHP project,
using Doxygen XML as an input.

positional arguments:
  root_namespace

optional arguments:
  -h, --help         show this help message and exit
  --xml-dir XML_DIR  directory to read from
  --out-dir OUT_DIR  directory to write to
  --verbose, -v      more output
  --quiet, -q        less output

Example

The gfx-php project uses this tool to publish documentation to readthedocs.org, so we'll use that as an example:

git clone https://github.com/mike42/gfx-php
cd docs
doxygen
doxyphp2sphinx Mike42::GfxPhp
make html

License

doxyphp2sphinx is released under a BSD 2-Clause License. See LICENSE for the full text.

doxyphp2sphinx's People

Contributors

mike42 avatar silverfoxy avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.