Trying to run mystmd under Termux on Android

[lrq3000]

It is possible to install both nodejs and texlive on Android via Termux, so I figured why not try to run mystmd this way ;-)

To install nodejs, I had to do the following:

1. Install openssl-tool to get libcrypto.so.3 and library "libicui18n.so.75":

apt upgrade && apt update
apt install openssl-tool
apt install libicu

2. Install nodejs:

pkg install nodejs

3. Allow Termux to access local storage:
   termux-setup-storage
4. Cd to local storage so that we can easily edit files with other apps such as Squircle CE:

cd ~/storage/downloads

5. Install git (necessary for mystmd tuto) :

pkg install git

6. Install tex (note: this takes a while, about half a hour on a 2021 high end phone!) :

pkg install texlive-installer
texlive installer tl

Now the environment should be fully functional to run mystmd in theory, but in practice I run into an issue!

If i do a myst init;myst start --headless call, here is what I get:

~/.../mystmd-quickstart/new $ myst start --headless
📖 Built 03-test.md in 14 ms. 
📚 Built 1 pages for project in 65 ms. 
'files.0' file does not exist: _build/templates/site/myst/book-theme/server.js (at _build/templates/site/myst/book-theme/template.yml#template)
'files.1' file does not exist: _build/templates/site/myst/book-theme/package.json (at _build/templates/site/myst/book-theme/template.yml#template) 
'files.2' file does not exist: _build/templates/site/myst/book-theme/package-lock.json (at _build/templates/site/myst/book-theme/template.yml#template) 
'files.3' file does not exist: _build/templates/site/myst/book-theme/public/**/* (at _build/templates/site/myst/book-theme/template.yml#template) 
'files.4' file does not exist: _build/templates/site/myst/book-theme/build/**/* (at _build/templates/site/myst/book-theme/template.yml#template) 
Cannot use invalid template.yml: _build/templates/site/myst/book-theme/template.yml                                                                                                                                                         Myst CLI Versions:
- node                         20.2.0     Required: >= 16.0.0
- npm                           9.6.6     Required: >=7                                                               
- myst                          1.1.6

Note that my 03-test.md file's content is totally empty for the purpose of this test! I also tried to input things including an exports format frontmatter, it does not help. There is no log file.

I also tried to do the tutorial on the mystmd website, and i run into a similar error when i try to myst build 01-idontrememberthename.md --pdf (i here renamed it but it's the md file from the tutorial github repo):

~/.../termux/mystmd-quickstart $ myst build 03-test.md --pdf                                                       
📬 Performing exports:                                        
03-test.md -> _build/exports/test.pdf                  
 Loading project from path with no config file: /storage/emulated/0/Download/termux/mystmd-quickstart                  
Consider running "myst init --project" in that directory   Validation: 'frontmatter' extra key ignored: 0 (at 03-test.md)                                                        
📖 Built 03-test.md in 34 ms.                              
📚 Built 1 pages for export (including 0 dependencies) from /storage/emulated/0/Download/termux/mystmd-quickstart in 55 ms.                                                      
'files.0' file does not exist: _build/templates/tex/myst/curvenote/template.tex (at _build/templates/tex/myst/curvenote/template.yml#template)                                   
'files.1' file does not exist: _build/templates/tex/myst/curvenote/curvenote.def (at _build/templates/tex/myst/curvenote/template.yml#template)                                  
'files.2' file does not exist: _build/templates/tex/myst/curvenote/curvenote.png (at _build/templates/tex/myst/curvenote/template.yml#template)                                  
'files.3' file does not exist: _build/templates/tex/myst/curvenote/curvenote.sty (at _build/templates/tex/myst/curvenote/template.yml#template)                                  
Error: Cannot use invalid template.yml: /storage/emulated/0/Download/termux/mystmd-quickstart/_build/templates/tex/myst/curvenote/template.yml

I am a bit stumped at this point because I don't know what these files refer to.

Note that i can successfully manually launch the nodejs server by cding into _build/template/ etc etc and run npm install --no-bin-links;npm start run

Can someone help me about what these files are supposed to be and how i can maybe debug this further? It's frustrating because it seems I'm so close :-)

[lrq3000]

Ok so the files are defined under files: in the template.yml file. I checked and the files do not exist in the path it is looking them for in, but they exist just one folder below, inside curvenote-main. I tried modifying the paths in the template.yml file, or copy the files into the parent folder, the same error happens, even though the files do now exist in the paths!

I tried using the -d flag but there is no additional info for this error, the rest appears to work fine.

[lrq3000]

Also i tried with other templates such as frontiers, and although the files are different, the same error happens. So it seems for some reason myst fails to access the files, but i can't see why.

[lrq3000]

I just retried to run mystmd v1.2.3 under the latest update of Termux and nodejs and other packages, and after doing just a myst init command, I get the following errors:

💾 Writing new project and site config file: myst.yml

? Would you like to run myst start now? Yes
🔍 Querying template metadata from https://api.mystmd.org/templates/site/myst/book-theme
🐕 Fetching template from https://github.com/myst-templates/book-theme/archive/refs/heads/main.zip
💾 Saved template to path _build/templates/site/myst/book-theme
⤵️  Installing web libraries (can take up to 60 s)
⛔️ myst.yml 'files.0' file does not exist: _build/templates/site/myst/book-theme/server.js (at _build/templates/site/myst/book-theme/template.yml#template)
⛔️ myst.yml 'files.1' file does not exist: _build/templates/site/myst/book-theme/package.json (at _build/templates/site/myst/book-theme/template.yml#template)
⛔️ myst.yml 'files.2' file does not exist: _build/templates/site/myst/book-theme/package-lock.json (at _build/templates/site/myst/book-theme/template.yml#template)
⛔️ myst.yml 'files.3' file does not exist: _build/templates/site/myst/book-theme/public/**/* (at _build/templates/site/myst/book-theme/template.yml#template)
⛔️ myst.yml 'files.4' file does not exist: _build/templates/site/myst/book-theme/build/**/* (at _build/templates/site/myst/book-theme/template.yml#template)
Cannot use invalid template.yml: _build/templates/site/myst/book-theme/template.yml


Myst CLI Versions:
 - node                         21.6.2     Required: >= 18.0.0
 - npm                          10.2.4     Required: >=8.6.0
 - myst                          1.2.3

So the same problem continues to happee unfortunately.

Has anyone any idea to go further?