Sphinx - How to generate documentation from python doc strings - Five + Minutes on Tips and Tricks

[@johnmiller0000]

THANK YOU a million times. I had spent hours trying to make sense of the official documentation and other tutorials. This was exactly what I needed!

[@krishnarajagopal1964]

Thanks a Lot for the step by step instructions and it really helped me to create the Simple API documentation that I was looking for

[@learnprogrammingwithjoel5654]

Glad it helped!

[@seamusrohe9226]

Great video, right to the point and great speed of explination. Subscribed :)

[@learnprogrammingwithjoel5654]

Awesome, thank you!

[@alla-anastasiiagnatkiv2193]

Amazing concise tutorial!

[@farlfc]

What if the project contains multiple sub directories under src which in turn have more sub directories? How do we create Sphinx documentation for that?

[@learnprogrammingwithjoel5654]

I would say to use the init.py file inside the nested folders, so the sphinx tool recognizes it. But I am not sure about your use case :/

[@Lotus_Feet]

Try this command sphinx-apidoc -o docs . ..

[@abyssus9934]

very clear explanation! thanks for sharing!

[@learnprogrammingwithjoel5654]

Glad it was helpful!

[@marvinong]

Thank you so much the excellent guide with clear explanation! 😃👍

[@esooghazy]

Linux users should write "make html" instead of ".\make.bat html".

[@ebalogs]

Actually even windows right now is the same. Windows 11 is slowly shifting to linux.

[@Neeoooo]

Lifesaver

[@ziadsalem7014]

Hi, Thank you fro the intersting explanation. i am trying to use sphnix for vhdl code but it is not possible to install the extension (pip -m install sphinxcontrib-vhdl ). I get an error message: ERROR: Could not find a version that satisfies the requirement sphinxcontrib-vhdl (from versions: none) ERROR: No matching distribution found for sphinxcontrib-vhdl. did anyone try that extension? thanks

[@AbdolaMike]

awesome video! definitely need to use this for a project! Quick question, if my tests are in a separate location at the root do I run sphinx-apidoc -0 twice? once for src and once for tests every time i want to generate?

[@RG-ot1vy]

This is kinda off topic, but what powerline theme are you using? Maybe it’s the video quality, but it almost looks 3D, like it has a gradient or something.

[@learnprogrammingwithjoel5654]

You can follow this tutorial: www.hanselman.com/blog/my-ultimate-powershell-prompt-with-oh-my-posh-and-the-windows-terminal

[@galbeeri6258]

Such a great video. Thank you so much!

[@knightrider6478]

what VSC extension you used for the fancy terminal ? Thanks for the great tutorial !

[@learnprogrammingwithjoel5654]

it is not a VS studio extension. I my PowerShell with some fancy configuration. you can find a sample of how to do it here: www.hanselman.com/blog/my-ultimate-powershell-prompt-with-oh-my-posh-and-the-windows-terminal

[@SpiritualCoder1165]

Thanks a lot, which terminal extension are you using in here ?

[@learnprogrammingwithjoel5654]

www.hanselman.com/blog/my-ultimate-powershell-prompt-with-oh-my-posh-and-the-windows-terminal

[@kenmiles7409]

Hi, can you also make a video, how you made your command line so nice and colorful?.thanks.

[@learnprogrammingwithjoel5654]

You can follow this post :www.hanselman.com/blog/my-ultimate-powershell-prompt-with-oh-my-posh-and-the-windows-terminal 😉

[@ayanchakraborty943]

That was really helpful, thanks a bunch!

[@navin1412]

solid explanation

[@TrendMover]

Awesome video. Do you know Shinx needs, and what do you think about it?

[@learnprogrammingwithjoel5654]

Hi, I am not sure if I understood your question.

[@pedrodias3064]

Very good. Thank you

[@pulga5605]

Thx, very good video 👍

[@codeklaudia9696]

Hello. Thank you very very much for this great video. Do you happen to have a github repository?

[@learnprogrammingwithjoel5654]

Yes, the link is on the video description :)

[@JoseThomaziniImagem]

Thanks, bro! Thank you very much!

[@smoothoprator]

Amazing video thank you..!

[@learnprogrammingwithjoel5654]

Glad you liked it!

[@shedryn]

9:19 и до конца - краткая информация как все задокументировать

[@jandiramirez9886]

thanks, you help me :)

[@learnprogrammingwithjoel5654]

I'm glad it helped you :)

[@SoumyaMohanty-ly2pj]

Thanks. But this does not work on a mac

[@learnprogrammingwithjoel5654]

Sorry but I never worked with a Mac machine so I cannot help you in that regard :/

[@seamusrohe9226]

@learnprogrammingwithjoel5654 please make a video on your VS code setup it looks really cool!

[@learnprogrammingwithjoel5654]

Are you talking about the PowerShell?

[@seamusrohe9226]

@@learnprogrammingwithjoel5654 Ya the terminal. It's showing you possible flags you can pass in and the themes look helpful. It would be awesome to see what it all means and how you set it up.

[@learnprogrammingwithjoel5654]

You can follow this: www.hanselman.com/blog/my-ultimate-powershell-prompt-with-oh-my-posh-and-the-windows-terminal

[@learnprogrammingwithjoel5654]

You can look on his KZbin channel for a video explaining the whole setup as well :)

[@ABN48837]

thanks$

[@ralphblach2952]

I followed your directions and keep getting the results below Any Suggestions? WARNING: autodoc: failed to import module 'rfm69_sr' from module 'rfm69_sr'; the following exception was raised: No module named 'rfm69_sr.rfm69_sr'; 'rfm69_sr' is not a package /home/pi/rfm_test/rfm69_sr/rfm69_sr.py:docstring of rfm69_sr.Tracker.check_file:4: WARNING: Field list ends without a blank line; unexpected unindent. looking for now-outdated files... none found pickling environment... done checking consistency... /home/pi/rfm_test/rfm69_sr/docs/modules.rst: WARNING: document isn't included in any toctree /home/pi/rfm_test/rfm69_sr/docs/rfm69_sr.rst: WARNING: document isn't included in any toctree

[@learnprogrammingwithjoel5654]

I am not sure, but it seems the doc string could be wrongly structured leading to the error.