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

KaTeX and SsKaTeX: Usage notes and comparison #493

Merged
merged 1 commit into from Feb 4, 2018

Conversation

Projects
None yet
3 participants
@ccorn
Contributor

ccorn commented Feb 4, 2018

As promised, some usage notes and guidelines on where and whether to use KaTeX or SsKaTeX.

@gettalong gettalong merged commit 4121c3c into gettalong:master Feb 4, 2018

1 check passed

continuous-integration/travis-ci/pr The Travis CI build passed
Details

@gettalong gettalong self-assigned this Feb 4, 2018

@gettalong

This comment has been minimized.

Owner

gettalong commented Feb 4, 2018

Thanks - I have merged your changes!

@ccorn ccorn deleted the ccorn:katex-xdoc branch Feb 4, 2018

Requirements for running kramdown with math engine KaTeX:
- Ruby gem [`katex`][katex-gem],
- Ruby gem [`execjs`][ExecJS],

This comment has been minimized.

@glebm

glebm Feb 5, 2018

Contributor

This is a runtime_dependency of the gem so there is no need to install it separately:
https://github.com/glebm/katex-ruby/blob/e432853a5ae1122e8dc8ce96147bded41494baef/katex.gemspec#L25

This comment has been minimized.

@ccorn

ccorn Feb 5, 2018

Contributor

That's just saying that the requirement usually gets fulfilled by dependency resolvers, but it's still a requirement. And it informs about what will (have to) be found in a functioning installation.

- Ruby gem [`katex`][katex-gem],
- Ruby gem [`execjs`][ExecJS],
- A Javascript engine supported by ExecJS, e.g. via one of
- Ruby gem [`therubyracer`][therubyracer],

This comment has been minimized.

@glebm

glebm Feb 5, 2018

Contributor

therubyracer is not a good choice for a runtime, mini_racer is better in every way.

This comment has been minimized.

@ccorn

ccorn Feb 5, 2018

Contributor

Those are just examples of what is supported by ExecJS. I have chosen therubyracer mostly because of the naming similarity to therubyrhino which is suitable for Jruby.

This comment has been minimized.

@ccorn

ccorn Feb 5, 2018

Contributor

Besides, ExecJS has a different view. Its autodetection prefers RubyRacer over MiniRacer, trying RubyRhino and Duktape in between. I do not suppose that that is an argument by itself; my actual point is that one should not interpret too much into that list of examples, because there is no way to satisfy all tastes anyway.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment