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

แชร์
ฝัง
  • เผยแพร่เมื่อ 4 พ.ย. 2024

ความคิดเห็น • 48

  • @esooghazy
    @esooghazy ปีที่แล้ว +17

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

    • @ebalogs
      @ebalogs ปีที่แล้ว +2

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

    • @Neeoooo
      @Neeoooo ปีที่แล้ว +1

      Lifesaver

  • @krishnarajagopal1964
    @krishnarajagopal1964 ปีที่แล้ว +5

    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

  • @alla-anastasiiagnatkiv2193
    @alla-anastasiiagnatkiv2193 2 หลายเดือนก่อน +2

    Amazing concise tutorial!

  • @AbdolaMike
    @AbdolaMike 5 หลายเดือนก่อน +1

    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?

  • @seamusrohe9226
    @seamusrohe9226 ปีที่แล้ว +6

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

  • @marvinong
    @marvinong 2 ปีที่แล้ว +5

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

  • @RG-ot1vy
    @RG-ot1vy ปีที่แล้ว +4

    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
      @learnprogrammingwithjoel5654  ปีที่แล้ว +2

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

  • @galbeeri6258
    @galbeeri6258 8 หลายเดือนก่อน +1

    Such a great video. Thank you so much!

  • @abyssus9934
    @abyssus9934 ปีที่แล้ว +7

    very clear explanation! thanks for sharing!

  • @farlfc
    @farlfc 9 หลายเดือนก่อน +2

    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
      @learnprogrammingwithjoel5654  9 หลายเดือนก่อน

      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
      @Lotus_Feet 6 หลายเดือนก่อน

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

  • @kenmiles7409
    @kenmiles7409 ปีที่แล้ว +3

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

    • @learnprogrammingwithjoel5654
      @learnprogrammingwithjoel5654  ปีที่แล้ว +1

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

  • @pedrodias3064
    @pedrodias3064 3 วันที่ผ่านมา

    Very good. Thank you

  • @ayanchakraborty943
    @ayanchakraborty943 6 หลายเดือนก่อน +1

    That was really helpful, thanks a bunch!

  • @TrendMover
    @TrendMover 9 หลายเดือนก่อน

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

  • @ziadsalem7014
    @ziadsalem7014 8 หลายเดือนก่อน

    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

  • @codeklaudia9696
    @codeklaudia9696 ปีที่แล้ว +1

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

  • @SpiritualCoder1165
    @SpiritualCoder1165 ปีที่แล้ว +1

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

    • @learnprogrammingwithjoel5654
      @learnprogrammingwithjoel5654  ปีที่แล้ว

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

  • @navin1412
    @navin1412 ปีที่แล้ว +3

    solid explanation

  • @smoothoprator
    @smoothoprator ปีที่แล้ว +2

    Amazing video thank you..!

  • @JoseThomaziniImagem
    @JoseThomaziniImagem ปีที่แล้ว +1

    Thanks, bro! Thank you very much!

  • @pulga5605
    @pulga5605 ปีที่แล้ว +3

    Thx, very good video 👍

  • @jandiramirez9886
    @jandiramirez9886 10 หลายเดือนก่อน

    thanks, you help me :)

  • @shedryn
    @shedryn 8 หลายเดือนก่อน

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

  • @seamusrohe9226
    @seamusrohe9226 ปีที่แล้ว

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

    • @learnprogrammingwithjoel5654
      @learnprogrammingwithjoel5654  ปีที่แล้ว

      Are you talking about the PowerShell?

    • @seamusrohe9226
      @seamusrohe9226 ปีที่แล้ว +1

      @@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
      @learnprogrammingwithjoel5654  ปีที่แล้ว

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

    • @learnprogrammingwithjoel5654
      @learnprogrammingwithjoel5654  ปีที่แล้ว

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

  • @SoumyaMohanty-ly2pj
    @SoumyaMohanty-ly2pj ปีที่แล้ว

    Thanks. But this does not work on a mac

  • @ABN48837
    @ABN48837 ปีที่แล้ว +1

    thanks$

  • @ralphblach2952
    @ralphblach2952 ปีที่แล้ว +1

    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
      @learnprogrammingwithjoel5654  ปีที่แล้ว

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