Skip to main content

Fortran domain and autodoc extensions to Sphinx

Project description

https://badge.fury.io/py/sphinx-fortran.svg https://travis-ci.org/VACUMM/sphinx-fortran.svg?branch=master https://readthedocs.org/projects/sphinx-fortran/badge/?version=latest

Purpose

This package provides two Sphinx (http://sphinx.pocoo.org/) extensions to the Fortran (90) language:

  • sphinxfortran.fortran_domain: Sphinx domain for fortran.
  • sphinxfortran.fortran_autodoc: Auto-documenting fortran code.

License

This package has the same license as VACUMM (http://www.ifremer.fr/vacumm) from which it originates: CeciLL-A (http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.html), which is compatible with the GPL.

Prerequisites

The sphinx and numpy packages.

Installation

Using pip:

pip install sphinx-fortran

From sources:

git clone https://github.com/VACUMM/sphinx-fortran.git
cd sphinx-fortran
python setup.py install

You can download sources also from the forge at IFREMER: https://forge.ifremer.fr/frs/?group_id=93

Quick start

  1. Add this extension to your sphinx conf.py.

  2. List you fortran source files in the variable fortran_src of your conf.py.

  3. Generate their documentation in rst files using directives like:

    .. f:automodule:: mymodule
    

Bugs and requests

Please go to this GitHub page: https://github.com/VACUMM/sphinx-fortran/issues

Authors

Stephane Raynaud (stephane.raynaud(at)gmail.com)

Thanks: Thomas Gastine

Documentation

Website: http://sphinx-fortran.readthedocs.org

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sphinx-fortran-1.0.1.tar.gz (34.7 kB) Copy SHA256 hash SHA256 Source None Oct 26, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page