Mastodon

Olivia A-CDiscussion post for <a href="https://blog.oliviaappleton.com/posts/0005-sphinx-fediverse.html" rel="nofollow noopener" target="_blank">Developing sphinx-fediverse</a> -------------------------- A few months ago, I had an idea. What if I could use the Fediverse to embed comments in my sphinx-generated pages? It turned out I wasn’t the first to think of this. Many others have used this kind of thing to power the comments of their blogs. Enough so that it was easy to find references on how to implement it. The main difficulty was the way I wanted to go about it. I wanted it to be a sphinx plugin, and I wanted it to be both flexible and configurable. This post covers the challenges I encountered. <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Fedi" rel="nofollow noopener" target="_blank">#Fedi</a> <a href="https://transfem.social/tags/JavaScript" rel="nofollow noopener" target="_blank">#JavaScript</a>

Zło ToJa się nie dziwię że programiści nie chcą dokumentować swoich programów. Weź ustaw sfinksa że wszystkimi plaginami 🤦<a href="https://101010.pl/tags/programowanie" class="mention hashtag" rel="nofollow noopener" target="_blank">#programowanie</a> <a href="https://101010.pl/tags/sphinxdoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#sphinxdoc</a>

Olivia A-Csphinx-fediverse 0.8.0 is now released. Since the previous version... New features: - Support for custom emoji in non-reaction content on Misskey - Support for individual media to be marked as sensitive (mostly in Misskey) - Support for account-wide content warnings in Misskey - Comment parsing now done with async methods Bug fixes: - Corrected a typo in article reaction rendering - More CSS changes related to word wrap - Fixed a bug in <code>replaceEmoji()</code> that caused only the first paragraph of posts to be rendered Likely next steps: - Custom emoji in reactions - Find a better way to sanitize Misskey posts - Verify that Mastodon actually returns sanitized HTML (and remove the worst parts if not) - Adapt <code>replaceEmoji()</code> to directly produce DOM elements instead of relying on the parser Special thanks to <a href="https://enby.life/@hazelnoot" class="u-url mention" rel="nofollow noopener" target="_blank">@hazelnoot@enby.life</a> for pushing me to rewrite the render code <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Fedi" rel="nofollow noopener" target="_blank">#Fedi</a>

Olivia A-Csphinx-fediverse 0.7.0 is now released. Since the previous version... New features: - Improved rendering security! It no longer relies on a massive HTML template. Still some progress to make - Support for unicode emoji reactions on Misskey instances - If a comment is too wide for the page, it will now split the username, so: <code>@LivInTheLookingGlass@transfem.social</code> will become <code>@LivInTheLookingGlass\n@transfem.social</code> - Increased use of the comment parser to avoid ambiguities - Comment posts will now include the title of the article and, if on Misskey, put the link on that text - Misskey now supports the following parts of MFM: - anything in standard Markdown - mentions - hashtags - <code></code> - <code><center></code> - <code></code> - <code><plain></code> Bug fixes: - Bumped the version of an insecure dependency Extra shout-out to the people who "bullied" me into fixing the render code. It's not perfect, but it's a lot better now. Figuring out a better way to 1. sanitize MFM input 2. adapt <code>replaceEmoji()</code> to work with DOM elements 3. get custom emoji working for Misskey instances are probably the last real blockers before a 1.0 release. There's a few more Misskey-related things that would be nice, but it's mostly about increasing parity at that point <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Fedi" rel="nofollow noopener" target="_blank">#Fedi</a>

Olivia A-CWhich of these issues should I tackle next? I leaning towards render support for emoji reactions (but not custom ones, because I still need to figure that out for Misskey) <a href="https://github.com/LivInTheLookingGlass/sphinx-fediverse/issues/" rel="nofollow noopener" target="_blank">https://github.com/LivInTheLookingGlass/sphinx-fediverse/issues/</a> <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Fedi" rel="nofollow noopener" target="_blank">#Fedi</a>

Olivia A-C<code>sphinx-fediverse</code> 0.6.0 is now released. Since the previous version... New features: - (Standard) Markdown rendering for Misskey instances (more MFM support to come later) - Support (in parser only) for emoji-based reactions - Support (in parser only) for sensitive images among non-sensitive images - Dump the post-to-page mapping to _static/ for ease of debug - Support for reply handling on Misskey instances Bug fixes: - Icons previously wouldn't show for posts outside the root directory - A typo led to a duplicate icon - Shibuya dark now produces legible icons (and this should be portable to other themes) - the hover effect no longer renders text unreadable on Shibuya dark (again, should be portable) <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Fedi" rel="nofollow noopener" target="_blank">#Fedi</a>

Olivia A-CAnd now <code>sphinx-fediverse</code> 0.5.3 is released. The big thing here is I've separated the rendering logic from comment parsing, so it's easier to support both flavors. Rendering is still pretty janky, but it's a good start towards the final setup. Next on the list: - *key media attachments - better rendering code <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a>

Olivia A-CAnd with that, <code>sphinx-fediverse</code> 0.5.2 is released with initial support for running on Misskey/*key instances. Known bugs: - Misskey instances cannot yet load custom emoji or media attachments - CSS for Shibuya theme on Chrome seems to have some minor problems, specifically with the hover effect Breaking changes: - the comment directive is now <code>fedi-comments</code> rather than <code>mastodon-comments</code> - some config values have had their name changed - you are now required to specify what flavor of fediverse instance you're hosting on <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a> <a href="https://transfem.social/tags/OSS" rel="nofollow noopener" target="_blank">#OSS</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Mastodon" rel="nofollow noopener" target="_blank">#Mastodon</a> <a href="https://transfem.social/tags/Misskey" rel="nofollow noopener" target="_blank">#Misskey</a> <a href="https://transfem.social/tags/Sharkey" rel="nofollow noopener" target="_blank">#Sharkey</a>

Olivia A-CGood news! <code>sphinx-fediverse</code> is now on pypi! <a href="https://pypi.org/project/sphinx-fediverse/" rel="nofollow noopener" target="_blank">https://pypi.org/project/sphinx-fediverse/</a> The project is not feature-complete yet, but it should be worth of the "beta" label 💖 <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a>

Olivia A-CAnd now the last barrier to me publishing <code>sphinx-fediverse</code> is literally adding the "twine" line to my Makefile. I'll probably get this tomorrow, and maybe make an auto-publish script on GitHub as well <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a>

Olivia A-CI've now updated sphinx-fediverse to include boost and like counts, both per-comment and for the originating post. This means there are now only 2 barriers between me and throwing it on PyPi: cleaning up the remaining CSS errors, and writing the publish script <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://transfem.social/tags/FediBridge" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://transfem.social/tags/FOSS" rel="nofollow noopener" target="_blank">#FOSS</a> <a href="https://transfem.social/tags/FLOSS" rel="nofollow noopener" target="_blank">#FLOSS</a>

Olivia A-CNew account, so new <a href="https://transfem.social/tags/introduction" rel="nofollow noopener" target="_blank">#introduction</a>. Let's do it again! I have a <a href="https://transfem.social/tags/MastersDegree" rel="nofollow noopener" target="_blank">#MastersDegree</a> in <a href="https://transfem.social/tags/ComputerScience" rel="nofollow noopener" target="_blank">#ComputerScience</a> and <a href="https://transfem.social/tags/ComputerEngineering" rel="nofollow noopener" target="_blank">#ComputerEngineering</a>. I went to <a href="https://transfem.social/tags/NMU" rel="nofollow noopener" target="_blank">#NMU</a> for undergrad and <a href="https://transfem.social/tags/MSU" rel="nofollow noopener" target="_blank">#MSU</a> for my graduate degree. I currently work at <a href="https://transfem.social/tags/UChicago" rel="nofollow noopener" target="_blank">#UChicago</a> for the <a href="https://transfem.social/tags/TMWCenter" rel="nofollow noopener" target="_blank">#TMWCenter</a>, which focuses on helping young children acquire language (and therefore other learning skills) faster. In my spare time, I develop <a href="https://transfem.social/tags/OpenSourceSoftware" rel="nofollow noopener" target="_blank">#OpenSourceSoftware</a> such as - a <a href="https://transfem.social/tags/SphinxDoc" rel="nofollow noopener" target="_blank">#SphinxDoc</a> extension that embed <a href="https://transfem.social/tags/Fediverse" rel="nofollow noopener" target="_blank">#Fediverse</a> comments on your page - a library to talk to <a href="https://transfem.social/tags/ManifoldMarkets" rel="nofollow noopener" target="_blank">#ManifoldMarkets</a> from native <a href="https://transfem.social/tags/Python" rel="nofollow noopener" target="_blank">#Python</a> - a <a href="https://transfem.social/tags/PredictionMarket" rel="nofollow noopener" target="_blank">#PredictionMarket</a> manager using the above - a <a href="https://transfem.social/tags/transpiler" rel="nofollow noopener" target="_blank">#transpiler</a> from a subset of Python to <a href="https://transfem.social/tags/OpenStreetMaps" rel="nofollow noopener" target="_blank">#OpenStreetMaps</a>'s <a href="https://transfem.social/tags/OverpassQL" rel="nofollow noopener" target="_blank">#OverpassQL</a> - bug fixes to many other projects, including <a href="https://transfem.social/tags/mypy" rel="nofollow noopener" target="_blank">#mypy</a>, <a href="https://transfem.social/tags/base58" rel="nofollow noopener" target="_blank">#base58</a>, <a href="https://transfem.social/tags/attrs" rel="nofollow noopener" target="_blank">#attrs</a>, <a href="https://transfem.social/tags/CPython" rel="nofollow noopener" target="_blank">#CPython</a>, & more I spend a fair bit of my time these days on <a href="https://transfem.social/tags/MathResearch" rel="nofollow noopener" target="_blank">#MathResearch</a>, specifically into the <a href="https://transfem.social/tags/ThueMorse" rel="nofollow noopener" target="_blank">#ThueMorse</a> Sequence and its extensions. I'm also a hobbyist editor on OpenStreetMap. <a href="https://transfem.social/tags/Demisexual" rel="nofollow noopener" target="_blank">#Demisexual</a>, <a href="https://transfem.social/tags/transfem" rel="nofollow noopener" target="_blank">#transfem</a>, and happily engaged to my <a href="https://transfem.social/tags/enby" rel="nofollow noopener" target="_blank">#enby</a> sweetheart. We have two cats: <a href="https://transfem.social/tags/OpheTheLoaf" rel="nofollow noopener" target="_blank">#OpheTheLoaf</a> and <a href="https://transfem.social/tags/MayalaranTheCat" rel="nofollow noopener" target="_blank">#MayalaranTheCat</a> (yes, from <a href="https://transfem.social/tags/StormlightArchive" rel="nofollow noopener" target="_blank">#StormlightArchive</a>) See <a href="https://transfem.social/notes/a4im5yv5i02700my" rel="nofollow noopener" target="_blank">here</a> for more on them! I speak English fluently, Spanish haltingly, and am trying to learn Chinese <a href="https://transfem.social/tags/queer" rel="nofollow noopener" target="_blank">#queer</a> <a href="https://transfem.social/tags/Chicago" rel="nofollow noopener" target="_blank">#Chicago</a>

Olivia A-CThis is the test post for the initial alpha of <code>sphinx-fediverse</code>!<a href="https://oliviaappleton.com/sphinx-fediverse/" rel="nofollow noopener" translate="no" target="_blank">https://oliviaappleton.com/sphinx-fediverse/</a>We're now on version 0.2.3, which adds support for automatic posting of comments sections + media attachment handling + unit tests<a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://tech.lgbt/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://tech.lgbt/tags/FediBridge" class="mention hashtag" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://tech.lgbt/tags/Fediverse" class="mention hashtag" rel="nofollow noopener" target="_blank">#Fediverse</a> <a href="https://tech.lgbt/tags/FOSS" class="mention hashtag" rel="nofollow noopener" target="_blank">#FOSS</a>

Olivia A-CHave any of my followers ever needed to test a <a href="https://tech.lgbt/tags/sphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#sphinxDoc</a> extension? I am having a remarkably hard time making it work<a href="https://tech.lgbt/tags/sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#sphinx</a> <a href="https://tech.lgbt/tags/python" class="mention hashtag" rel="nofollow noopener" target="_blank">#python</a> <a href="https://tech.lgbt/tags/askPython" class="mention hashtag" rel="nofollow noopener" target="_blank">#askPython</a> <a href="https://tech.lgbt/tags/AskFedi" class="mention hashtag" rel="nofollow noopener" target="_blank">#AskFedi</a>

Olivia A-C<a href="https://github.com/LivInTheLookingGlass/sphinx-fediverse" rel="nofollow noopener" target="_blank">This</a> is my very-WIP <a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a> extension to add comment sections hosted on the <a href="https://tech.lgbt/tags/Fediverse" class="mention hashtag" rel="nofollow noopener" target="_blank">#Fediverse</a>!Right now it is a solid PoC, & I want to improve it a fair bit before publishing. Feel free to play with it!Update: see here for more <a href="https://tech.lgbt/@LivInTheLookingGlass/114032235423688612" translate="no" rel="nofollow noopener" target="_blank">https://tech.lgbt/@LivInTheLookingGlass/114032235423688612</a><a href="https://tech.lgbt/tags/FediBridge" class="mention hashtag" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://tech.lgbt/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://tech.lgbt/tags/FOSS" class="mention hashtag" rel="nofollow noopener" target="_blank">#FOSS</a>

Olivia A-C<a href="https://hachyderm.io/@Unlogic" class="u-url mention" rel="nofollow noopener" target="_blank">@Unlogic</a> Now in a sphinx-generated doc!Next problem is going to be making it play well with themes. That is definitely a for-later problem. I'm going to be focusing on making it work with <code>shibuya</code> and Dark Reader first, if possible.If this works, all of my websites are going to instantly have comment sections! I build pretty much everything in Sphinx, since it's so easy<a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://tech.lgbt/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://tech.lgbt/tags/FediBridge" class="mention hashtag" rel="nofollow noopener" target="_blank">#FediBridge</a> <a href="https://tech.lgbt/tags/Fediverse" class="mention hashtag" rel="nofollow noopener" target="_blank">#Fediverse</a>

Olivia A-C<a href="https://hachyderm.io/@Unlogic" class="u-url mention" rel="nofollow noopener" target="_blank">@Unlogic</a> Behold! The prototype!<a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://tech.lgbt/tags/FediBridge" class="mention hashtag" rel="nofollow noopener" target="_blank">#FediBridge</a>

Olivia A-CSuppose I want to put comments on my static sphinx site, and I want it to be sourced from the fediverse.How difficult would this be? I would ideally like to support comment threading. I also might want to make this into a sphinx extension, such that it checks every page has a corresponding post before publishing. This would mean the URL needs to strictly define the post<a href="https://tech.lgbt/tags/AskMastodon" class="mention hashtag" rel="nofollow noopener" target="_blank">#AskMastodon</a> <a href="https://tech.lgbt/tags/AskFedi" class="mention hashtag" rel="nofollow noopener" target="_blank">#AskFedi</a> <a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a> <a href="https://tech.lgbt/tags/AskSysadmin" class="mention hashtag" rel="nofollow noopener" target="_blank">#AskSysadmin</a>

Olivia A-CDoes anyone know of a <a href="https://tech.lgbt/tags/Sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sphinx</a> toolkit that would be good for writing a programmer's <a href="https://tech.lgbt/tags/portfolio" class="mention hashtag" rel="nofollow noopener" target="_blank">#portfolio</a> / <a href="https://tech.lgbt/tags/resume" class="mention hashtag" rel="nofollow noopener" target="_blank">#resume</a>? I would love it if my resume could be (in part) a living website generated by <a href="https://tech.lgbt/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a>

🍒🌳 Hartmut GoebelI'm seeking experiences in multi-language <a href="https://nerdculture.de/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#documentation</a>, e.g in <a href="https://nerdculture.de/tags/Sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sphinx</a> <a href="https://nerdculture.de/tags/SphinxDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxDoc</a>, <a href="https://nerdculture.de/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#MkDocs</a>, …What system/tool can you recommend? How do you handle contributions in case a person not speaking English (which is the 'main' language) wants to add some section?The aim is to create docs for <a href="https://nerdculture.de/tags/tryton" class="mention hashtag" rel="nofollow noopener" target="_blank">#tryton</a>. Thus as a bonus we need/want multi-country docs, too. E.g. for describing country-specific taxing — where we don't need information for France in the English master neither in the German translation, but the German translation needs different parts for Germany, Austria and Switzerland. (And things get worse counting in all the countries speaking English or French.) If you have experiences with this, please share.<a href="https://nerdculture.de/tags/followerpower" class="mention hashtag" rel="nofollow noopener" target="_blank">#followerpower</a> <a href="https://nerdculture.de/tags/PleaseBoost" class="mention hashtag" rel="nofollow noopener" target="_blank">#PleaseBoost</a> <a href="https://nerdculture.de/tags/ReadTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#ReadTheDocs</a> <a href="https://nerdculture.de/tags/RTD" class="mention hashtag" rel="nofollow noopener" target="_blank">#RTD</a>

Recent searches

Search options

Administered by:

Server stats:

#sphinxdoc