George in #Sphinx position.

#cat #GrayCats #Caturday

🎉 cmake-docs-l10n is published!

🚀 Preview:

https://projects.localizethedocs.org/cmake-docs-l10n

🌐 Crowdin:

https://localizethedocs.crowdin.com/cmake-docs-l10n

🐙 GitHub:

https://github.com/localizethedocs/cmake-docs-l10n

#Crowdin #GitHub #Sphinx #Clang #Cpp #CMake

Late last week, I dusted off a project that had been abandoned by one of our drive-by volunteers about three years ago.

I was strugglin' a bit getting the dependency restraints updated and re-familiarizing myself with the repo and publishing configurations. I think that's in good shape now & I can mostly focus on document conversion & layout.

Now that I've got more familiarity with #Sphinx and #pandoc than I did three years ago, I looking forward to making some progress this week.

It's been a long time itch to scratch of mine & now I've got some time & motivation. We shall see....

#Xfce #Documentation #ReadTheDocs

The cat came back, the very next day....

#meme #cat #ohno #kitty #memes #funny #catmemes #pets #sphinx #lostpet #roughnight #thecatcameback

J'en aussi fait une petite mise à jour dans mon article sur le déploiement d'une documentation Sphinx sur les GitHub Pages :

J'ai mis à jour les versions des actions utilisées et viré une config qui n'était plus utile.

➡️ https://blog.flozz.fr/2020/09/21/deployer-automatiquement-sur-github-pages-avec-github-actions/

#github #sphinx #doc

I'm wrapping up the last two pages of documentation for my thing and while documenting a handful of example commands in interactive mode, I thought

"Man wouldn't it be nice if this had syntax highlighting, at least for keywords and arguments? I wouldn't need to use 'console' for sphinx code blocks, and it would not be this drab gray..."

Fast forward 45 minutes later, I'm in the middle of a gnarly custom Pygments regex lexer and I think:

"Oh but what if I just read the commands module source tree and parsed the AST to extract command names from functions that have the typer decorator? I would never need to maintain that list again and they'd always be keywords!"

The real "What the fuck am I doing with my life?" moment was marginally offset by how it actually worked on first try, against all expectations.

Sphinx is insidious. Once you start extending it there's no end in sight.

#Python #Sphinx #Pygments #programming

Title: Sphinx (1925)

Artist: Hiroshi Yoshida

https://www3.nhk.or.jp/nhkworld/en/news/20250718_12/ #ShinHanga #Art #Taisho #HiroshiYoshida #Summer #Sphinx #Cairo #Egypt #Japan