CLI on CoCalc

[Rob Beezer]

Hi,

I am transitioning to the CLI. At least for workshop presentations on CoCalc!
;-) Went very well last week in Denver with disability services staff. Some
notes. v1.0.4, iirc.

1. We've already discussed the *.ptx files not being found and bleeding into
the server messages at the terminal.

2. "pretext -h" works great. I had to guess that "pretext build -h" would
provide more targeted depth. Perhaps I missed a suggestion to try that.

3. After both "pretext build print" and "pretext build web" I had to click on
the link in the terminal, they did not open automatically. Perhaps just a
CoCalc thing.

4. If you turn on MathJax's accessibillty features, they normally stick in
local storage. Not so on CoCalc, since you get a new base URL after each build
(or a new server, or both?). Volker Sorge says MathJax 4.0 will just have these
features on all the time. So time may cure this one.

Let me know what is a genuine issue that is new and can be resolved, and I am
happy to make the requisite issues. Thanks for all the CLI work, it made the
workshop go somoothly with an audience of non-STEM folks. I may put my workshop
handout (w/ screenshots) into the Guide as an appendix.

Rob

[Steven Clontz]

2. We currently do make such a suggestion. Please advise if you have a better suggestion (one idea might be to make the suggestion higher in the output).

$ pretext -h
Usage: pretext [OPTIONS] COMMAND [ARGS]...

  Command line tools for quickly creating, authoring, and building PreTeXt
  projects.

  PreTeXt Guide for authors and publishers:

  - https://pretextbook.org/documentation.html

  PreTeXt CLI README for developers:

  - https://github.com/PreTeXtBook/pretext-cli/

  Use the `--help` option on any CLI command to learn more, for example,
  `pretext build --help`.

[Steven Clontz]

3. Yes, the CoCalc terminal does not work with the automatic link opening. However, the VS Code terminal run via CoCalc does. One of my goals for the spring is to develop documentation/tutorials that push users toward CoCalc+VSCode for several reasons.

[Steven Clontz]

4. You should be getting the same base URL for each invocation of pretext view, unless for some reason the port number is changing. If port 8000 gets hung up somehow, however, then a random port is chosen as a backup, which might cause a problem.

[Rob Beezer]

Thanks for the replies. Clearly that was a low-quality report. ;-) But it was
going to be that, or nothing, at the rate I've been going the past few days. :-(

Rob

> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-dev...@googlegroups.com
> <mailto:pretext-dev...@googlegroups.com>.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pretext-dev/775b224c-186b-466f-8675-6b23ea3740ffn%40googlegroups.com <https://groups.google.com/d/msgid/pretext-dev/775b224c-186b-466f-8675-6b23ea3740ffn%40googlegroups.com?utm_medium=email&utm_source=footer>.