cowboycatranch, to Cats
@cowboycatranch@mastodon.online avatar

We are looking for people who live with a Sphinx cat for a research study. Interested?

hugovk, to python
@hugovk@mastodon.social avatar

I wrote a thing!

How to activate tabs for your OS in Sphinx

https://dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3

On pages like https://devguide.python.org and https://pillow.readthedocs.io/en/latest/installation/basic-installation.html we have tabs with specific instructions per operating system.

You can add a bit of JavaScript to automatically activate the relevant tab based on the reader's operating system, so they see the relevant info sooner.

stf, to random
@stf@chaos.social avatar

wow, threshold-sphinx is a thing! just managed to get a password for which the oprf key has been created by a dkg. not that we knew this is possible, sure. but now i have working code doing so! still a lot of work until this can be deployed, but it is very promising start!

ankedb, to random German
@ankedb@social.linksfraktion.de avatar

Diese Woche wird in UK entschieden, ob an die USA ausgeliefert werden darf. Dieses Verfahren gg ist eine Farce, denn Journalismus ist kein Verbrechen u eine Auslieferung wäre ein fundamentaler Angriff auf die - weltweit!

pi_crew,
@pi_crew@social.project-insanity.org avatar
csdummi, to mastodon German
@csdummi@babka.social avatar

I think inline is an important tool to making software readable. It makes software maintainable, encourages future development and makes it easier to join the project as a developer.

This is why I advocate for to start encouraging inline documentation with , requiring it for any new PRs and serving this API documentation on joinmastodon.org.

https://github.com/mastodon/mastodon/issues/29141

csdummi,
@csdummi@babka.social avatar

@serge many of the projects we use in Python, like , are documented using , which can be configured to automatically generate API documentation from Python source code:

https://www.sphinx-doc.org/en/master/tutorial/automatic-doc-generation.html

This is (similar to the and situation) backwards compatible with , though much more expressive due to the machine-readable format for defining parameters, return values and potential exceptions:

https://www.sphinx-doc.org/en/master/tutorial/automatic-doc-generation.html

https://docs.python.org/3/library/pydoc.html

bevanthomas, to fantasy
@bevanthomas@mstdn.ca avatar

Sphinxes by Orphné Achéron, an artist who draws heavily on mythological imagery.
https://instagram.com/orphne_acheron

Athenenoctua, to random French
@Athenenoctua@mastodon.gougere.fr avatar


Jour 1 - In extremis

On passait d'une année à l'autre sans un bruit, comme si les voisins étaient tous partis, quand tout à coup, in extremis, j'ai voulu tester le bouzin📯

Athenenoctua,
@Athenenoctua@mastodon.gougere.fr avatar
markarayner, to Cat
@markarayner@mas.to avatar

"Look, I'm a sphinx!"

Welcome to another mysterious !

jens2go, to aliens
@jens2go@mastodon.social avatar

No, it wasn't ... but, wait, could nature have had a hand in the formation of the Great of Giza? 🤔

https://www.nyu.edu/about/news-publications/news/2023/october/did-nature-have-a-hand-in-the-formation-of-the-great-sphinx--.html

louis, to random
@louis@emacs.ch avatar

⚠️​ Don't use for your documentation. They deliberately make it hard to impossible to export your work as Markdown or any other text format.

Write your docs in MD or Org, convert it to HTML and find a free hoster for static websites instead.

sigue,

@louis I've been really happy with Sphinx, which is what https://opendylan.org is written with.

It exports to a bunch of formats: https://www.sphinx-doc.org/en/master/usage/builders/index.html#builders

leece, to fantasy
@leece@aus.social avatar

Art Ink In October No.24

A Sphinx and a Manticore have found some romance.

The LAMY AL-Star and the Pilot Metropolitan have helped with it, the purple-ized Pelikan Rose Quartz and the black ink in the Pilot's cartridge.


pvergain, to python French
@pvergain@framapiaf.org avatar

--<--
Toulouse, October 17th, 2023

Today, we are releasing pglift 1.0, a new framework for deploying and operating PostgreSQL at scale.

The project ships with both a command-line interface to manage the life-cycle of your databases and a collection of Ansible modules to drive your infrastructure as code in a production context.
-->--

carlton, to random
@carlton@fosstodon.org avatar

meets ... 😜

blaise, to France
@blaise@hachyderm.io avatar

TIL about gandi.net
It's probably well known in , but it was new to me.

Anyway, I was impressed with the quality of this blog post
https://blog.gandi.net/en/posts/sphinx-doc-and-pagefind/
about a rather obscure and super useful solution for adding search to , which is common in projects.

I looked through their service descriptions and they seem to have the right stuff for cloud and apps.

Have any of us used them before?

scy, to linux
@scy@chaos.social avatar

Suppose I was thinking about writing ⁠s for the command-line tools I build, but I don’t want to learn a 50 year old typesetting language () to do that.

What are my options? ? What would you use? What do you use?

I looked into Markdown to man conversion, and it seemed to suck.

stsquad,
@stsquad@mastodon.org.uk avatar

@scy the project transitioned to and for its documentation pipeline. Works well enough and has definitely seen an increase in doc contributions since.

kushal, to opensource
@kushal@toots.dgplug.org avatar

What is the good way to generate docs in for classes?


Please boost for more reach.

bevanthomas, (edited ) to literature
@bevanthomas@mstdn.ca avatar

"Say, sirrah, hast thou ever proved thyself
A prophet? When the riddling Sphinx was here,
Why hadst thou no deliverance for this folk?
And yet the riddle was not to be solved
By guesswork, but required the prophet’s art."

  • Sophocles, "Oedipus Rex"

🎨 Sphinx kylix

Axomamma, to egypt
@Axomamma@mastodon.online avatar

Fascinating discussion of the and the struggle with dating its construction.

I never knew that the Sphinx was carved out of the ground, not "built." The geology explains the differences between the body, neck and head. Amazing!

https://youtu.be/seBTJKIvSfM?si=IdHL82np05SwdLRz

blaise, to python
@blaise@hachyderm.io avatar

Like peanut butter and chocolate, someone managed to blend and kubectl

:https://docs.kr8s.org/en/latest/index.html#object-api

maybe other geeks will enjoy this. It also has well automation , for anyone who wants to see an example of a good project.

NickEast, to Letters
@NickEast@geekdom.social avatar

There's no arguing with this! I'm going to need a black quartz sphinx to jude my vow 😂

@humour @linguisticsmemes

#Alphabet #Letters #Sphinx

kyonshi, to berlin

sphinx, berlin, aug 2023

stf, to random
@stf@chaos.social avatar

\o/ It seems my proposal has been accepted for funding by NLNet & NGI0 Entrust, there's gonna be a lot more OPRF based free software be available soon.

GottaLaff, to random
@GottaLaff@mastodon.social avatar

Dems in array:

Ocasio-Cortez endorses 's reelection campaign, sending a strong signal of Democratic unity (Michelle L. Price/Associated Press)

HistoPol, (edited )
@HistoPol@mastodon.social avatar

@whiskey

/i: I am not enigmatic enough, it seems.
Have to work on my skills. /i

/j: And you are on my my , mutant!--You clearly have mastered telepathy! /j

@GottaLaff

markarayner, to Cat
@markarayner@mas.to avatar

"Look, I'm a sphinx!"

Welcome to another historic !

mgorny, to python

sphinx_rtd_theme is slacking on adding 7 support to the point that people are actively seeking another theme.

And I thought that it is annoying for users (who have to downgrade their system Sphinx) only.

https://github.com/readthedocs/sphinx_rtd_theme/issues/1463

  • All
  • Subscribed
  • Moderated
  • Favorites
  • megavids
  • rosin
  • thenastyranch
  • GTA5RPClips
  • tester
  • InstantRegret
  • DreamBathrooms
  • ngwrru68w68
  • magazineikmin
  • everett
  • Youngstown
  • mdbf
  • slotface
  • kavyap
  • JUstTest
  • cisconetworking
  • khanakhh
  • normalnudes
  • osvaldo12
  • cubers
  • tacticalgear
  • Durango
  • ethstaker
  • modclub
  • anitta
  • provamag3
  • Leos
  • lostlight
  • All magazines