Skip to content

Change the package to use "texi2any" instead of "texi2HTML" #15

@dasergatskov

Description

@dasergatskov

This is an initial attempt to use texi2any (and hence the modern texinfo processing) instead of texi2HTML.
Most of the changes in __texi2html__.m file:
Use html2any processor instead of texi2html (obviously).
@seealso handling is completely re-written.
<em> handling changed to keep <em class="math"> (I think this also fixed the bug in the old code.)

In function_texi2html.m and classdef_texi2html.m code to place "Source Code:" changed.
It is now relies on </dd><dl> marker.

I tested it on itself package_texi2html ("pkg-octave-doc") and on "statistics" and it seems to work.

There is still some debugging code left (temporary files are preserved with tmp1_ prefix rather than deleted,
errors/warnings from texi2any saved into *.log files).

Any comments are welcome.

Note, it still preserve the original handling of @@ in classnames. I think to change it to make it verbose (i.e. to render both of those symbolsane needs to have an additional diff totexi2html.m`:

         fname_file = strrep(fname, filesep, "_");
         my_see = strcat(new_see, "  <a href=\"", fname_file, ".html\">", fname, "</a>");
       else
-        my_see = strcat(my_see, fname);
+        ## Escape @ symbols to prevent HTML processing issues
+        escaped_fname = strrep(fname, "@", "&#64;");
+        my_see = strcat(my_see, escaped_fname);
       endif
       
       if (i < length(fnames))

(This is somewhat brute-force approach to avoid texi2any processing.)

das_texi2any.diff.gz

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions