I'm a big fan of docs-as-code for more or less any type of content publishing, but I'm less of a fan of Jekyll, the default tool used in GitHub pages. I also prefer ReStructuredText over Markdown as a markup format, so Sphinx is definitely on my shortlist of SSGs (Static Site Generators) for my proj| LornaJane
I’ve never been a fan of Re-StructuredText, but most importantly I’m new to MySt, which leads to a lot of googling and painstaking trial-and-error while writing. Although my preferred references are the Jupyter Book MyST Cheatsheet, the Sphinx Book Theme Documentation, and the MyST Parser Reference, they are way too extensive, sometimes incorrect, and I don’t really use every directive or variant thereof. Therefore, I’ll use this post to gather the bits of the syntax and snippets I us...| Jayson Salazar Rodriguez | @jdsalaro | Blog
In order to come up with a reliable and standardized way of referring to document sections and document it in /cheatsheet/sphinx-myst-markdown, I went down a pretty deep rabbit hole of Sphinx label manipulations.| Jayson Salazar Rodriguez | @jdsalaro | Blog
Our next entry in the Monster Princess Project is Sphinx Princess!| Horror Flora
Set up link checking on your docs-as-code projects. This post explains the key design decisions you'll need to take, and shows some sample code for implementing with GitHub actions.| LornaJane
My frequent travels to Egypt have allowed me to get into places few people ever get to see. I have climbed down rickety ladders and deep shafts to explore and write about such things as the hidden water tunnels under the Great Pyramid (and even took water samples for analysis!). So when I had the opportunity […] The post Exploring Hidden Mysteries Under the Sphinx appeared first on Trinfinity8.| Trinfinity8