Premiers pas avec Sphinx. Générer docstring avec Sphinx

Sphinx-Apidoc génère automatiquement une docstring python Utilise OSX 10.9.4. Utilise Sphinx v1.1.3. Après avoir installé sphinx. Que fais-tu maintenant?

Structure du répertoire

├── documents_source/
├── publish/
└── src/
    └── main.py

main.py


# -*- coding: UTF-8 -*-
import sys

def main(name, age=None):
    """Greeting function.

    :param name: Your name.
    :param age: Youre age. (option)
    """
    print "hello, " + name

    if age is not None:
        print "You are " + age

Génération de papier à lettres

Exécutez la commande sphinx-apidoc. $ sphinx-apidoc -F -o ./documents_source ./src

Ce qui précède n'est que pour la première fois. Générez une configuration complète avec l'option -F. À partir de la deuxième fois, exécutez ceci.

$ sphinx-apidoc -f -o ./documents_source ./src




 Il y a de nombreux fichiers sous `` documents_source / ''. Ceci est la source de la documentation générée.

## Autoriser l'importation du module cible
 Ouvrez `` documents_source / conf.py '' et éditez et activez cette partie commentée. Le module autodoc importe et lit le fichier cible, il vous indique donc l'emplacement.


#### **` conf.py`**
```py

#sys.path.insert(0, os.path.abspath('.'))
sys.path.insert(0, os.path.abspath('../src'))

Sortie de document

Exécutez la commande sphinx-build. $ sphinx-build -a ./documents_source ./publish

Vérifiez qu'il sera généré sous forme de document consultable sous le répertoire `` publish / ''.

Il est affiché comme suit.

4ebcad1ef56765133d31fcfaa75fe0b0.png

Il est plus facile de comprendre si vous lisez le document officiel après avoir supprimé ce flux. http://docs.sphinx-users.jp/index.html

Recommended Posts

Premiers pas avec Sphinx. Générer docstring avec Sphinx
Premiers pas avec Android!
1.1 Premiers pas avec Python
Premiers pas avec apache2
Premiers pas avec Python
Premiers pas avec Django 1
Introduction à l'optimisation
Premiers pas avec Numpy
Premiers pas avec Spark
Premiers pas avec Python
Premiers pas avec Pydantic
Premiers pas avec Jython
Premiers pas avec Django 2
Traduire Premiers pas avec TensorFlow
Introduction aux fonctions Python
Introduction à Tkinter 2: Button
Premiers pas avec Go Assembly
Premiers pas avec PKI avec Golang ―― 4
Premiers pas avec Python Django (1)
Premiers pas avec Python Django (4)
Premiers pas avec Python Django (3)
Introduction à Python Django (6)
Premiers pas avec Django avec PyCharm
Premiers pas avec Python Django (5)
Premiers pas avec Python responder v2
Introduction à Git (1) Stockage d'historique
Premiers pas avec les applications Web Python
Premiers pas avec Python pour les classes PHPer
Premiers pas avec Sparse Matrix avec scipy.sparse
Premiers pas avec Julia pour Pythonista
Premiers pas avec Python Bases de Python
Premiers pas avec Cisco Spark REST-API
Commençant par USD sur Windows
Premiers pas avec les algorithmes génétiques Python
Premiers pas avec Python 3.8 sous Windows
Premiers pas avec Python pour les fonctions PHPer
Premiers pas avec CPU Steal Time
Premiers pas avec python3 # 1 Apprenez les connaissances de base
Premiers pas avec Python Web Scraping Practice
Génération automatique de documents à partir de docstring avec sphinx
Premiers pas avec l'outil de documentation Sphinx
Premiers pas avec Python pour PHPer-Super Basics
Premiers pas avec Python Web Scraping Practice
Premiers pas avec Dynamo de Python boto
Premiers pas avec Lisp pour Pythonista: Supplément
Premiers pas avec Heroku, déploiement de l'application Flask
Premiers pas avec TDD avec Cyber-dojo chez MobPro
Grails pour commencer
Démarrer avec Python avec 100 coups sur le traitement du langage
Principes de base de MongoDB: Premiers pas avec CRUD avec JAVA
Premiers pas avec la traduction japonaise du modèle séquentiel Keras
[Français] Premiers pas avec Rust pour les programmeurs Python
Essayez de générer automatiquement des documents Python avec Sphinx
Django Getting Started Part 2 avec eclipse Plugin (PyDev)
Premiers pas avec AWS IoT facilement en Python