Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Install.md: add link to TinyTeX #103

Merged
merged 3 commits into from
Nov 14, 2022
Merged

Install.md: add link to TinyTeX #103

merged 3 commits into from
Nov 14, 2022

Conversation

tfiers
Copy link
Contributor

@tfiers tfiers commented Nov 9, 2022

All 4000+ packages, at ~8GB and 2h30 download/install time, are not needed..

All 4000+ packages, at ~8GB and 2h30 download/install time, are not needed..
@jlelong
Copy link
Owner

jlelong commented Nov 10, 2022

TinyTeX seems basically dedicated to rstudio users and more importantly does not include latexmk, which is used by the default LaTeX-Workshop default building recipe. Therefore, I do not want to advocate the use of a LaTeX distribution which will fail with our default settings.

@jlelong jlelong closed this Nov 10, 2022
@tfiers
Copy link
Contributor Author

tfiers commented Nov 11, 2022

Thanks for looking into this.
I think that assessment might not be entirely accurate:

I use TinyTex succesfully with LaTeX-Workshop, with default settings [¹].
I am not an R / RStudio user [²].

TinyTeX does include latexmk.
(TinyTeX is in fact based on TeX Live, the distribution strongly recommend by LaTeX-Workshop).

[¹]: Or at least settings that do not deviate from the defaults where relevant for this.
[²] As the readme on versions states,
"compiling common R Markdown documents was the original motivation of the TinyTeX project",
but it has grown beyond that. I downloaded the 'TinyTeX' version.

Given this, would you reconsider linking to tinytex as an alternative?
I'm sure many LaTeX users will be grateful for the smaller download.

I myself switched to TeX Live from MikTeX after I saw the recommendation in this Install.md file -- but was surprised to see the TeX Live installer downloading the most esoteric packages I would never need.


One issue with TinyTeX is that it (by default) does not include documentation, to reduce the download size. (The motivation is that most latex users google for help. Which, indeed; but pkg docs are then not available when you have no internet connection).
As a result, the "View documentation" link that LaTeX-Workshop provides when hovering over a package's name in \usepackage{pkgname} does not work. (I instead use the CTAN link that is also provided in the popup).

@jlelong
Copy link
Owner

jlelong commented Nov 11, 2022

Based on the new information, I am fine with citing tinytex as an alternative latex distribution. Could you modify your PR to make clear that no documentation is contained in tinytex?

@tfiers
Copy link
Contributor Author

tfiers commented Nov 13, 2022

Preview of what it looks like: https://github.com/tfiers/LaTeX-Workshop-wiki/blob/patch-1/Install.md

I put the extra info in a collapsed <details> block, so that it does not add too much "wall of text".

@jlelong jlelong merged commit f182464 into jlelong:master Nov 14, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants