I used the nice #pdoc https://pdoc.dev/ package to **really** easily generate my #python package documentation.
I am hitting the walls of this simplicity and looking for alternatives.
I tried #sphinx a while ago and didn't really liked it.
#mkdocs seems nice.
any ideas about one of those or advantages/experiences?

I generally like working with reStructuredText for technical documentation. I use it a lot both at work and on my own projects.

But the little detail that a single space off on the indentation turns something into a block quote, which happens *all the time* in lists with sub points, is rather annoying. They should have stuck with ">" for block quotes instead.

I see these accidental block quotes all the time in documentation.

The Excavated Sphinx, Cairo, c.1930s - Ernst Landrock RP Postcard

https://www.ebid.net/uk/for-sale/the-excavated-sphinx-cairo-c-1930s-ernst-landrock-rp-postcard-222183561.htm

Earlier this year, I switched over to using the #denote #emacs package for managing the content on my #sphinx powered blog.

If you are interested in such things, I finally got around to writing up some notes on how I did this

https://www.alcarney.me/blog/2025/blogging-with-sphinx-and-denoteel/

Hawkmoth v0.21.0 is out.

Hawkmoth is a Sphinx extension to incorporate formatted C and C++ source code comments written in
reStructuredText into Sphinx based documentation.

v0.21.0 has improved support for documenting function pointer typedefs, fixes issues in looking up parsed results, and enables REUSE compliance.

https://jnikula.github.io/hawkmoth/stable/

"You may worship me in all my mystical magnificence, hoo-man."
#Cat #Cats #Sphinx.

I'm exploring ways to improve audio preprocessing for speech recognition for my [midi2hamlib](https://github.com/DO9RE/midi2hamlib) project. Do any of my followers have expertise with **SoX** or **speech recognition**? Specifically, I’m seeking advice on: Best practices for audio preparation for speech recognition. SoX command-line parameters that can optimize audio during recording or playback.
https://github.com/DO9RE/midi2hamlib/blob/main/tests/speech_menu.sh #SoX #SpeechRecognition #OpenSource #AudioProcessing #ShellScripting #Sphinx #PocketSphinx #Audio Retoot appreciated.

Did you know that the famous Great #Sphinx of Giza didn't just lose her nose?

She also lost her #beard.

It was long & braided, like that of pharaohs.

The Sphinx was also originally multicoloured.

Hawkmoth v0.20 is out!

Hawkmoth is a Sphinx extension to import C and C++ documentation comments into Sphinx based documentation.

The main new feature in this release is automatic configuration of the system header search paths. Unfortunately, libclang does not get them right out of the box on most distros, so we have to help it a little.

#Sphinx #Hawkmoth #Documentation #reStructuredText #C

https://github.com/jnikula/hawkmoth

\o/ @dyne now hosts the first public sphinx server not under my control at sphinx.dyne.org:443
their ltsigkey is

`TnQHEiiJtFXqhUskqAxtIhG/xlk9t79BXyLcofai32g=`

https://sphinx.pm/servers.html

#python #sphinx #documentation

#Sphinx release 8.2.0 (2025-02-18)

- https://www.sphinx-doc.org/en/master/changes/index.html#release-8-2-0-released-feb-18-2025

- https://www.sphinx-doc.org/en/master/changes/index.html#features-added

- https://github.com/sphinx-doc/sphinx/releases/tag/v8.2.0

- https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#collapsible-admonitions

Thank you Adam Turner ! (https://github.com/AA-Turner, Python Committer and #PEP Editor. Maintainer of Sphinx and #Docutils)

A portrait of a family cornish rex, in her cute red sweater, done last year.

Le théâtre des sortilèges, nouveau diorama imprimé en sérigraphie 4 couleurs et édité par "Les éditions I'Horreur Du Vide". Edité à 50 exemplaires. / 21 x 17 cm.

Si vous êtes intéressé, vous pouvez commander un exemplaire dans ma boutique.
www.brulex.fr/shop

looking for respected people/orgs to host *public* sphinx v2 servers for use in threshold setups: https://sphinx.pm/ - threshold setups only make sense if the "shareholders" are not all the same person... if you know anyone who would be so kind, please get in contact with me...

the server is in zig, there's documentation how to set it up: https://sphinx.pm/server_install.html

and there's a docker image in the works:
https://github.com/D3vl0per/zphinx-zerver-docker/tree/refactor-2025

#sphinx #passwordmanager #hosting

pls boost <3