Posts in Sphinx
Misleading Error Message from ablog.post, Aggressive Looking Ahead
- 17 May 2025
Today I am getting some strange error when I am trying to convert my blogs to the ablog extension of Sphinx. The error log has the following lines
Extension error (ablog.post)!
Sphinx project always rebuild after installing the ablog extension
- 08 May 2025
After checking the source code of the PyData theme, it is apparent that the theme’s __init__.py force the setting to be on. If not on, then it sets the config and forces a full rebuild.
The solution is setting
Merge wordpress.com site with GitHub Pages
- 07 May 2025
As I am a tech person familiar with HTML/CSS/Javascript, the WordPress.Com free plan’s limitations has been an obstacle to my creatively (e.g. add sortable tables). I have a Github Pages web site running for a few years now and I think now is the time to migrate to github pages.
I first looked migration tutorials on the internet. For me the Exporter Plugin (https://blog.netnerds.net/2020/08/migrating-my-wordpress-sites-to-github-pages/) is not an option, as one of the WordPress.Com free plan’s limitations is plugin support. Exporting the content looks like the only way to go, but how to import the exported WordPress XML to formats supported by Github Pages is another problem.
ExtensionError: Could not import extension sphinx.builders.latex
- 07 May 2025
Today I got this error when building my blog based on Sphinx after upgrading Sphinx to the latest version.
when I do a pip list, the 4.1 version of roman_numerals is indeed installed. Just the build script cannot find it. It probably has something to do with the fact that roman-numerals-py (deprecated) is also installed. Older version of sphinx that requires roman-numerals-py instead of roman_numerals.
ABlog Exception Missing title from Invisible Character
- 07 May 2025
Today I got this error when building my blog based on Sphinx/ABlog extension.
When I remove the ABlog post directive, Sphinx indeed gives a warning about the file’s title:
Another Aggressive Looking Ahead and Misleading Error Message from ablog.post
- 06 May 2025
Today I am getting some strange error when I am trying to convert my blogs to the ablog extension of Sphinx. The error log has the following lines
Extension error (ablog.post)!
Misleading Error Message WARNING: All children of a ‘grid-row’ should be ‘grid-item’ [design.grid]
- 30 April 2025
Today I am hit by a message “WARNING: All children of a ‘grid-row’ should be ‘grid-item’ [design.grid] “ from the sphinx-design extension when building a Sphinx documentation. The error line points to a grid that works perfect fine in another file.
After some digging, it appears that when the next paragraph is indented as quoted text, no matter how many blanks are in between the grid still think it as its children.
Misleading Error Message WARNING: All children of a ‘grid-row’ should be ‘grid-item’ [design.grid]
- 27 April 2025
Today I am hit by a message “WARNING: All children of a ‘grid-row’ should be ‘grid-item’” from the sphinx-design extension when building a Sphinx documentation. The error line points to a grid whose only members are grid items.
After some digging, it appears that when a space is missing between .. grid-item-card:: and the card name, then the card won’t be recognized as a card, and generates this message.
Fix sphinxcontrib-googleanalytics on Sphinx 1.8
- 05 January 2019
The Google Analytics extension from
does not work on Sphinx 1.8. When I run it, I get the following error