Saya mencoba menggunakan Sphinx untuk mendokumentasikan proyek 5.000+ line dengan Python. Ini memiliki sekitar 7 modul dasar. Sejauh yang saya tahu, Untuk menggunakan autodoc saya perlu menulis kode seperti ini untuk setiap file dalam proyek saya: .. automodule:: mods.set.tests :members: :show-inheritance: Ini terlalu membosankan karena saya punya banyak file. Akan …
Sphinx tidak membuat dokumen untuk __init __ (self) secara default. Saya telah mencoba yang berikut ini: .. automodule:: mymodule :members: dan ..autoclass:: MyClass :members: Di conf.py, pengaturan berikut hanya menambahkan docstring __init __ (self) ke kelas docstring ( dokumentasi autodoc Sphinx sepertinya setuju bahwa ini adalah perilaku yang diharapkan, tapi …
Saya mencoba untuk memulai dengan Sphinx dan sepertinya mengalami masalah tanpa henti. Perintah: docs/sphinx-quickstart Saya menjawab semua pertanyaan dan semuanya bekerja dengan baik. Perintah: docs/ls Semuanya terlihat normal. Hasil:build Makefile source Perintah: sphinx-build -d build/doctrees source build/html Sepertinya berhasil. Saya bisa membuka file index.html dan melihat "shell" dari apa yang …
Saya menggunakan sphinx dan plugin autodoc untuk menghasilkan dokumentasi API untuk modul Python saya. Meskipun saya dapat melihat cara mendokumentasikan parameter tertentu dengan baik, saya tidak dapat menemukan contoh cara mendokumentasikan **kwargsparameter. Adakah yang punya contoh bagus tentang cara yang jelas untuk mendokumentasikannya?
Tertutup . Pertanyaan ini perlu lebih difokuskan . Saat ini tidak menerima jawaban. Ingin memperbaiki pertanyaan ini? Perbarui pertanyaan sehingga hanya berfokus pada satu masalah dengan mengedit posting ini . Tutup 2 tahun lalu . Perbaiki pertanyaan ini Saya suka Doxygen untuk membuat dokumentasi kode C atau PHP. Saya memiliki …
Saya mencoba membuat daftar bersarang dengan benar menggunakan kode berikut (mengikuti dokumen Sphinx dan docutils ): 1. X a. U b. V c. W 2. Y 3. Z Saya berharap ini menghasilkan dua OLs tetapi saya mendapatkan output berikut sebagai gantinya: <ol class="arabic simple"> <li>X</li> </ol> <blockquote> <div> <ol class="loweralpha …
Saya menggunakan Sphinx untuk mendokumentasikan proyek non-Python. Saya ingin mendistribusikan ./docfolder di setiap submodule, berisi submodule_name.rstfile untuk mendokumentasikan modul itu. Saya kemudian ingin memasukkan file-file itu ke dalam hierarki master untuk membuat spesifikasi untuk keseluruhan desain. Yaitu: Project docs spec project_spec.rst conf.py modules module1 docs module1.rst src module2 docs module2.rst …
Saya ingin menambahkan link ke metode di kelas saya dari dalam docstring metode lain di kelas yang sama. Saya ingin tautannya berfungsi di sphinx dan terutama juga di Spyder dan IDE Python lainnya. Saya mencoba beberapa opsi dan hanya menemukan satu yang berfungsi, tetapi itu tidak praktis. Misalkan struktur berikut …
Pembuatan dokumen Sphinx pada read-the-docs gagal dengan kesalahan berikut (log lengkap di bawah): ImportError: cannot import name 'PackageFinder' from 'pip._internal.index' (/home/docs/checkouts/readthedocs.org/user_builds/cascade-python/envs/latest/lib/python3.7/site-packages/pip/_internal/index/__init__.py) Apakah saya melakukan sesuatu yang salah atau ini bug pada read-the-docs? Pembuatan lokal Sphinx docs berjalan dengan baik. Log kesalahan lengkap pada read-the-docs: Read the Docs build information Build …
Silakan unduh file simple.7zdan instal di sphinx Anda untuk mereproduksi masalah apa yang saya jelaskan di sini, untuk mereproduksinya, Anda dapat menjalankan: make clean make html unduh dan instal di sphinx Anda untuk mereproduksi masalah Ada dua artikel di dalam sample/source, isinya sama, hanya perbedaan judulnya. cd sample ls source …