mastodon.world is one of the many independent Mastodon servers you can use to participate in the fediverse.
Generic Mastodon server for anyone to use.

Server stats:

8.2K
active users

#sphinx

3 posts3 participants0 posts today

🌘 我為何偏好 rST 而非 Markdown
➤ 剖析 reStructuredText 的結構化優勢與 Sphinx 的強大擴展能力
buttondown.com/hillelwayne/arc
作者分享了他從 Markdown 轉向 reStructuredText (rST) 的經驗,並詳細闡述了 rST 在結構化、擴展性以及處理複雜文件需求(如書籍中的習題與解答的靈活呈現)方面的優勢。儘管 rST 語法較為複雜,但其背後強大的文件處理架構,特別是 Sphinx 工具鏈,能透過自訂指令和後處理轉換,實現比 Markdown 更為精細和彈性的文件生成,尤其適合大型或有特殊排版需求的專案。
+ 雖然 rST 的語法確實讓人卻步,但看到它能處理像習題解答這種複雜的呈現方式,確實很吸引人。
+ 我一直習慣用 Markdown,這篇文章讓我重新思考了工具的選擇,特別是對於我正在進行的技術文件項目。
#文件標記語言 #Sphinx #rST #Markdown #文件處理

Computer Things · Why I prefer rST to markdownBy Computer Things

I might have finally found the tooling I was looking for on requirement engineering: sphix-needs, extension to the #sphinx documentation tooling from #python land.

I always disliked the idea of the big comercial ones to have a db for requirements - i wanted "requirements as code" sit next to the code, with the option to have full traceability back and forth from high level specs down to code and back...

This seems more then promising due to customization options

sphinx-needs.readthedocs.io/en

sphinx-needs.readthedocs.ioSphinx-Needs 5.1.0 documentation

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....

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.

Ausgerechnet der #Zwergmilliardär und #BigShort-Abzocker(#SchwarzerMittwoch) #ScottBessent, empfiehlt seinem Kumpel #ElonMusk, sich aus der #Politik herauszuhalten. Ein Mann, der selbst so widersprüchlich, wie die #Sphinx höchstpersönlich, ist (siehe Profil auf Wikipedia)-der in einer prinzipiell homophoben #Regierung arbeitet; will Musk Vorschriften machen.

#DonaldTrump nennt Elon Musk eine »Vollkatastrophe« und Gründung einer neuen #Partei »lächerlich« - DER SPIEGEL
spiegel.de/ausland/donald-trum

DER SPIEGEL · Fehde zweier Ex-Kumpanen: Trump bezeichnet Musk als »Vollkatastrophe«By DER SPIEGEL

I made a #pencil #sketch of the chubby #sphinx at the Galerie du Temps at #LouvreLens (still #MuséeDuLouvre I guess). It's really awesome that entry to the museum is free of charge and that you even get to borrow a folding stool! More artists should make use of French musea #MastoArt #TraditionalArt


(The original is quite faint so I boosted the contrast on this scan.)

I set out to train proportions and clair-obscur. I got decent proportions down surprisingly quickly, but the face still ended up slightly too slender. When I noticed this I got mad and just winged the rest. I guess I am still positively surprised with the result. I spent too much time on one sketch so I guess I should try drawing on a timer next time.

CyMaIS statt Workday: Digitale Souveränität für HR & Organisationen

Während viele Organisationen sich von Workday begeistern lassen, wird oft übersehen, dass diese Lösung in einer proprietären Blackbox läuft – mit allen Risiken von Vendor-Lock-in, Datenspeicherung in Drittstaaten und hohen Lizenzkosten.Doch es gibt eine echte Alternative: CyMaIS, das freie Framework für selbstbestimmte IT-Infrastruktur.

[…]

blog.cymais.cloud/blog/2025/06