Après avoir écrit le module python, comment rédiger la documentation ?
黄舟
黄舟 2017-05-24 11:35:07
0
3
587

Je suis un débutant et je n'ai jamais publié de programme Python auparavant.
Récemment, le professeur m'a demandé d'écrire deux petits modules python, l'un pour convertir le pdf en txt et l'autre pour calculer la similarité du document txt converti. Je l'ai écrit et je sais comment l'emballer dans une bibliothèque tierce, mais je ne sais pas comment rédiger la documentation de support ?
J'ai également vérifié sur Internet. Certaines personnes ont dit que le contenu du commentaire est le document (j'ai écrit ce commentaire avec soin), mais je ne sais pas si je dois mettre un fichier txt dans le package et l'écrire. utiliser différentes fonctions dans différents modules, ou quoi ?
Merci à tous, je ne sais vraiment pas comment faire ce document...

黄舟
黄舟

人生最曼妙的风景,竟是内心的淡定与从容!

répondre à tous(3)
Ty80

sphinx

仅有的幸福

Je suppose que vous avez également utilisé git, qui est similaire au fichier readme du projet git. Regardez comment les deux projets open source sont écrits. Le but de l'écriture du readme est probablement d'aider les autres à savoir ce qu'est le projet, de quoi il s'agit. peut faire, et comment l'utiliser. Veuillez faire attention aux points principaux, presque assez de sauce

.
漂亮男人

Exemple :

模块.py

'''
这是模块文档
'''
pass
>>> import 模块
>>> help(模块)
Help on module 模块:

NAME
    模块 - 这是模块文档

FILE
    d:\python34\模块.py


>>> 
Derniers téléchargements
Plus>
effets Web
Code source du site Web
Matériel du site Web
Modèle frontal
À propos de nous Clause de non-responsabilité Sitemap
Site Web PHP chinois:Formation PHP en ligne sur le bien-être public,Aidez les apprenants PHP à grandir rapidement!