document macOS support

[pkra]

We should add some instructions regarding macOS installation.

[pkra]

I recently tried to get things running on macos and failed. @BrianBartling could you share what you recall from your successful attempt a while back? In particular,

• which tex installation to use
• which approach for installing the perl modules

[BrianBartling]

Hi Peter,

Sorry for the delay on this! Here are my notes on installing texml on macosx using Ventura 13.5.2 from scratch:

1. Install mactex 2024 (https://www.tug.org/mactex/mactex-download.html)
2. Install Xcode Command Line Tools. On the terminal enter xcode-select --install & follow the steps for the installation process
3. Install homebrew (https://brew.sh/)
4. brew install libpng
5. brew install jpeg-turbo
6. brew install pdf2svg
7. type cpan on the terminal and configure local::lib
8. cpan File::MMagic::XS
9. cpan Config::IniFiles
10. cpan XML::Twig
11. cpan Image::PNG
12. cpan Image::JPEG::Size
13. cpan Lingua::EN::Numbers::Ordinate
14. install STIX Two and Source Sans
15. git clone https://github.com/AmerMathSoc/texml.git
16. cd texml
17. cp ./cfg/texml.cfg.template ./cfg/texml.cfg

Doing these steps got me to 104 successful tests using tests/00regress.sh, but 12 have failed. It looks like there's a problem with the graphics driver when loading in xcolor, e.g. when I do texml on graphics.tex I'm getting Undefined control sequence '\DeclareKeys', '\DefineNamedColor', etc. It also appears that there's a problem when processing binary characters e.g. accents.tex.

[pkra]

Thanks so much @BrianBartling !