supermemo-wiki / SuperMemoAssistant.Wiki

Documentation resources
MIT License
3 stars 7 forks source link

the documented MikTex install process should be rechecked #30

Open DavidGretzschel opened 4 years ago

DavidGretzschel commented 4 years ago

in https://supermemo.wiki/sma/#/plugin-LaTeX Specifically:

image

When I installed zhmetrics the program seemed to have been stuck indefinitely at the "extracting files from zhmetrics.tar"-step. After a forced taskkill and rebooting the system zhmetrics was properly installed.

There should be a warning in the documentation if this process takes a long time.

Afterwards amsmath also was already installed (even though I never did that). If amsmath comes preinstalled or is an automatically installed dependency of zhmetrics, the documentation should not mention it.

alexis- commented 4 years ago

When I installed zhmetrics the program seemed to have been stuck indefinitely at the "extracting files from zhmetrics.tar"-step. After a forced taskkill and rebooting the system zhmetrics was properly installed. There should be a warning in the documentation if this process takes a long time.

I think this is specific to your computer. Packages should install smoothly. However, if several users report the same issue, we could add a small note.

Afterwards amsmath also was already installed (even though I never did that). If amsmath comes preinstalled or is an automatically installed dependency of zhmetrics, the documentation should not mention it.

I disagree here. We have no guarantee that amsmath will always be bundled, or that it is provided with all versions of the installer. It is a requirement for the default LaTeX plugin configuration to work properly, and as such should be indicated no matter what. Perhaps it could be rephrased better in the documentation.