wiki:APIDocs

Version 11 (modified by exarkun, 6 years ago) (diff)

new slightly simpler procedure

Twisted API Documentation

This page describes how to generate the API docs for the Twisted web site.

You will need the latest Twisted release unpacked and the latest version of pydoctor

Steps

  1. Run an interactive Python session that goes something like this:
    >>> from twisted.python._release import APIBuilder
    >>> from twisted.python.filepath import FilePath
    >>> APIBuilder().build('Twisted', 'http://twistedmatrix.com/trac', 'http://twistedmatrix.com/trac/browser/tags/releases/twisted-8.2.0', FilePath('twisted'), FilePath('apidocs'))
    
    Be sure to use the tag which corresponds to the version of Twisted the docs are being generated for.
  1. Upload the resulting apidocs directory to www-data@cube. Use tar cx apidocs | ssh www-data@twistedmatrix.com tar xv or something.
  2. Put the apidocs directory into the appropriate location beneath vhosts/twistedmatrix.com/documents/ (eg 8.2.0)
  3. If desired, update the current symlink.