Karl O. Pinc

On Wed, 23 Apr 2025 18:57:34 -0000 Günter Milde via Docutils-develop docutils-develop@lists.sourceforge.net wrote: This approach would add a level of complexity that makes it more suitable for an extension or a custom HTML writer than for standard Docutils. Some alternatives come to mind: A "simple script" could also be used to pre-process the rST source or post-process the generated HTML to add image dimensions instead of generating sidecar files. FWIW, I've used the m4 macro processor (https://www.gnu.org/software/m4/m4.html)...

On Tue, 12 Dec 2023 20:12:18 -0000 "Günter Milde" via Docutils-develop docutils-develop@lists.sourceforge.net wrote: [feature-requests:#85] Enable easily-typed hard line-breaks in paragraphs. Created: Sat Jan 01, 2022 08:21 AM UTC by jon Last Updated: Tue Dec 12, 2023 08:02 PM UTC I don't understand why arbitrary line-breaks are the norm. In early email and code editors line length was limited, but I don't see why any form of markup or markdown expects people to insert them these days. When I don't...

On Sun, 26 Nov 2023 16:04:10 -0000 "Günter Milde" via Docutils-develop docutils-develop@lists.sourceforge.net wrote: Embed SVG images directly, not as data URI . +1 Allows interactive SVG images (cf. [feature-requests:#100]). +1 Smaller image size. I don't understand "Smaller image size". Embedding SVG directly into HTML5 pages makes each page larger, and because the SVG is not referenced as a URI the browser cannot share the same SVG between different pages so more RAM is used and more network bandwidth...

On Mon, 20 Nov 2023 07:56:06 -0000 "Günter Milde" via Docutils-develop docutils-develop@lists.sourceforge.net wrote: We are here at the Docutils (not Sphinx) where there is no conf.py nor a "project directory". So the "natural" and backwards compatible default for the new "include_root" setting is the filesystem root. Thanks very much. Apologies for my confusion. Regards, Karl kop@karlpinc.com Free Software: "You don't pay back, you pay forward." -- Robert A. Heinlein

I guess the full development of my thoughts leads to this observation (which might not be true because I'm not steeped in Sphinx): If "root path" declarations take absolute paths in config.py then a single config.py is not (in the general case) reusable in sphinx-build invocations which use different "sourcedir" paths, because if the sourcedir is different there's likely different image dirs/etc. There seem to be multiple solutions. 1) Allow absolute file system paths, relative to the overall root...

On Sun, 19 Nov 2023 21:39:11 -0000 "Günter Milde" via Docutils-develop docutils-develop@lists.sourceforge.net wrote: Waiting for a consensus about behaviour of image file reading (see comment above) … I have not read and understood the entire thread, so apologies if my comment here is not helpful. When I think of a "root directory" for Sphinx I think in terms of a webserver's "Document Root" -- the uppermost part of the filesystem hierarchy to which the webserver (symlinks, etc., aside) has access....

On Thu, 02 Nov 2023 00:03:36 -0000 engelbert gruber via Docutils-develop docutils-develop@lists.sourceforge.net wrote: at least an example of what you want would be really helpful Here's a random web page with SVG that responds to events: https://www.tutorialspoint.com/svg/svg_interactivity.htm Note that it is not, at the same time, resizeable depending on browser window size. (See below.) Here's another with SVG that contains a hyperlink: https://developer.mozilla.org/en-US/docs/Web/SVG/Element/a...

See also, the releated Sphinx bug: https://github.com/sphinx-doc/sphinx/issues/2240