<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="../assets/xml/rss.xsl" media="all"?><rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Sean Gillies (Posts about sphinx)</title><link>https://sgillies.net/</link><description></description><atom:link href="https://sgillies.net/tags/sphinx.xml" rel="self" type="application/rss+xml"></atom:link><language>en</language><lastBuildDate>Sun, 31 Dec 2023 01:26:18 GMT</lastBuildDate><generator>Nikola (getnikola.com)</generator><docs>http://blogs.law.harvard.edu/tech/rss</docs><item><title>Atom extension for Tinkerer</title><link>https://sgillies.net/2013/12/03/atom-extension-for-tinkerer.html</link><dc:creator>Sean Gillies</dc:creator><description>&lt;p&gt;&lt;a class="reference external" href="http://tinkerer.me/"&gt;Tinkerer&lt;/a&gt;, the software I'm using for my blog, lacks
a good Atom feed, so last night I wrote my first Sphinx extension to provide
one. &lt;a class="reference external" href="https://github.com/sgillies/rutherford"&gt;Rutherford&lt;/a&gt; adds a couple new
config items and a full content Atom feed. It exposes the Tinker categories and
tags and tracks the modification times of posted .rst files so that feeds and
their entries get updated accordingly. My own feed is
&lt;a class="reference external" href="http://sgillies.net/blog/feed.atom"&gt;http://sgillies.net/blog/feed.atom&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;I'm becoming a fan of the Sphinx &lt;a class="reference external" href="http://sphinx-doc.org/extensions.html"&gt;extension story&lt;/a&gt;, at least for simple cases like
mine. Python's packaging situation continues to &lt;a class="reference external" href="https://python-packaging-user-guide.readthedocs.org/en/latest/"&gt;get better&lt;/a&gt; and there
are all kinds of wins for insisting that extensions (think &lt;a class="reference external" href="http://www.qgis.org/en/docs/pyqgis_developer_cookbook/plugins.html"&gt;QGIS plugins&lt;/a&gt;) be Python
packages: support from pip and setuptools, version pinning, package dependency
resolution, etc.&lt;/p&gt;
&lt;aside class="system-message"&gt;
&lt;p class="system-message-title"&gt;System Message: ERROR/3 (&lt;span class="docutils literal"&gt;&amp;lt;string&amp;gt;&lt;/span&gt;, line 20)&lt;/p&gt;
&lt;p&gt;Unknown directive type "summary".&lt;/p&gt;
&lt;pre class="literal-block"&gt;.. summary:: I'm becoming a fan of the Sphinx extension story&lt;/pre&gt;
&lt;/aside&gt;</description><category>atom</category><category>extension</category><category>packaging</category><category>plugin</category><category>python</category><category>rss</category><category>sphinx</category><category>tinkerer</category><category>work</category><guid>https://sgillies.net/2013/12/03/atom-extension-for-tinkerer.html</guid><pubDate>Tue, 03 Dec 2013 07:00:00 GMT</pubDate></item><item><title>Downgrading my blog</title><link>https://sgillies.net/2013/10/07/downgrading-my-blog.html</link><dc:creator>Sean Gillies</dc:creator><description>&lt;p&gt;Welcome to my new blog. It's made with &lt;a class="reference external" href="http://tinkerer.me"&gt;Tinkerer&lt;/a&gt;.
I'm calling it a downgrade because there's no more database, no more comments,
no more Python objects published for every request. It's just rsync and static
HTML generated by Tinkerer and Sphinx from ReStructured Text docs I type into
Vim.  There are moving parts in this new blog, but they are all on my laptop.
None of them are deployed to a web server.&lt;/p&gt;
&lt;p&gt;My old posts were all written using ReST, so migrating is going to be easy
peasy. Until I get around to it, old posts will be at
&lt;a class="reference external" href="http://sgillies.net/olden-days-blog/"&gt;http://sgillies.net/olden-days-blog/&lt;/a&gt; and I'll make sure the old URLs redirect.&lt;/p&gt;</description><category>blog</category><category>life</category><category>restructuredtext</category><category>sphinx</category><category>tinkerer</category><guid>https://sgillies.net/2013/10/07/downgrading-my-blog.html</guid><pubDate>Mon, 07 Oct 2013 06:00:00 GMT</pubDate></item></channel></rss>