jekyll-t4j 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 373ef8ace0a1a10dc58cbc1bcb3eb0441cf66894ad27b3a30c87dc2fef6f669d
-  data.tar.gz: a3397303ce58f5b728608e65a2c28ca9eca192d73a6bb9a0dffe243bc8ea2862
+  metadata.gz: 4f7546786489dba969477bac00c45f4e89d15fefe3f875e2567b725d86c81673
+  data.tar.gz: 8145c980e01d7bae20bf611957a61073602789c07f070248c9c85465b241ddaa
 SHA512:
-  metadata.gz: 802513ceba69d9729273fa2928b70c7011bf8bd5f9f0756ba89b0d10bb43f8266c27152a3ed1d926f29af41c42e55fbeae6dffdc1bc4c47f33ff10dde08b3a01
-  data.tar.gz: e3fd8c11ed01a7f25e68d323ac86e4d698e2c2de598c89e8b999d3f8889be0ed9c37b3620f64cd28a9eee926fd37f97daede90b906bf42d807118fa57949b3bf
+  metadata.gz: 363df4ceb85c4e053571d6593b87009c1c79a404cb109d16f85a3f2b1325e3155bb86c0eb18f0b4780741d390994069b6608fc326fd73915c8fc58c4c84b3821
+  data.tar.gz: be623b5331e9e492f6484db617290c8c0f05416040613fb90da3e6dd7794dcf8b75d948a480809fa56da7b31888c4f13eaa286ea6a6a1dc17476b47962a09a5f

data/README.md

@@ -1,12 +1,18 @@
 # Jekyll::T4J
 
-jekyll-t4j is a plugin integrating Jekyll with your local TeX distribution. It enables Jekyll to cope with LaTeX code in your site. If you find MathJax or KaTeX can not cover your needs to write complex articles(i.e. LaTeX using chemfig), this plugin may help you a lot.
+jekyll-t4j is a Jekyll plugin providing (nearly) full support of LaTeX.
+
+- **Comprehensive**: support almost all packages, including tikz, chemfig, etc.
+- **Fast**: employ KaTeX to boost speed. Use cache, bulk rendering.
+- **Server side rendering**: all stuffs are done in server.
+
+T4J integrates Jekyll with your local TeX distribution, so you need to have either [MikTeX](https://miktex.org/) or [Tex Live](https://tug.org/texlive/) installed.
 
 Feel free to write any LaTeX! 🎉
 
-## Usage
+## Getting Started
 
-We start by a simple instance, write a post `2023-02-04-hello-latex.md` and fill it with:
+Let's start by a simple instance, write a post `2023-02-04-hello-latex.md` and fill it with:
 
 ```
 ---
@@ -15,14 +21,16 @@ title:  Hello LaTeX
 date:   2023-02-04 14:53:32 +0800
 ---
 
-This is an inline math $$r=\sqrt{x^2+y^2}$$.
+This is an inline math $r=\sqrt{x^2+y^2}$.
 
 $$\chemfig{*6((--[::-60]HO)-=(-O-[:30])-(-OH)=-=)}$$
 
 And this is vanillyl alcohol.
 ```
 
-Then, open your `_config.yml` file and write:
+As you can see, its usage is the same as KaTeX or MathJax, but we only allow delimiters `$...$`, `$$...$$`, `\(...\)`, `\[...\]`.
+
+Because we use the chemfig package, so open your `_config.yml` file and write:
 
 ```yaml
 t4j:
@@ -32,23 +40,13 @@ t4j:
 
 Finally, build your site, complete!
 
-### Configuire
-
-As shown above, you can configuire jekyll-t4j via `_config.yml`. Here is the template:
-
-```yaml
-t4j:
-  packages:
-    - pkgA
-    - pkgB[xxx] # 'xxx' is the option passed to 'pkgB'
-    - pkgC
-```
+You can learn more about T4J [here](https://github.com/crow02531/jekyll-t4j/wiki).
 
 ## Installation
 
 First of all, you need to have a TeX distribution. Just download and install [MikTeX](https://miktex.org/) or [Tex Live](https://tug.org/texlive/).
 
-Then, install jekyll-t4j just as other Jekyll plugins. Add this line to your application's Gemfile:
+Then, install jekyll-t4j like other Jekyll plugins. Add this line to your application's Gemfile:
 
 ```ruby
 gem 'jekyll-t4j'

data/lib/jekyll-t4j/engine/dvisvgm.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "tmpdir"
+require "open3"
+
+module Jekyll::T4J
+    module Engine
+        @@_dvisvgm_tex_ = File.join(__dir__, "dvisvgm.tex")
+
+        def self.dvisvgm_raw(snippet)
+            dvisvgm_raw_bulk([snippet])[0]
+        end
+
+        def self.dvisvgm_raw_bulk(snippets)
+            # setup: create 'content.tex'
+            pwd = Dir.mktmpdir
+            File.write "#{pwd}/content.tex", <<~HEREDOC
+                \\documentclass{article}
+                #{Jekyll::T4J.cfg_pkgs}
+                \\input{#{@@_dvisvgm_tex_}}
+                \\begin{document}
+                \\pagenumbering{gobble}
+                \\begingroup#{snippets.join("\\endgroup\\newpage\\begingroup")}\\endgroup
+                \\end{document}
+            HEREDOC
+
+            shell = ->(cmd) {
+                log, s = Open3.capture2e(cmd, :chdir => pwd)
+                raise log if not s.success?
+            }
+
+            # call 'latex' to compile: tex->dvi
+            shell.("latex -halt-on-error -quiet content")
+            shell.("latex -halt-on-error -quiet content")
+            # call 'dvisvgm' to convert dvi to svg(s)
+            shell.("dvisvgm -n -e -p 1- -v 3 content")
+
+            # fetch results
+            results = []
+            if snippets.size == 1 then
+                results << File.read("#{pwd}/content.svg")
+            else
+                for i in 1..snippets.size
+                    results << File.read("#{pwd}/content-#{i.to_s}.svg")
+                end
+            end
+
+            # return
+            results
+        ensure
+            FileUtils.remove_entry pwd if pwd
+        end
+    end
+end

data/lib/jekyll-t4j/engine/dvisvgm.tex

@@ -0,0 +1,8 @@
+\usepackage{amsmath}
+\usepackage{amssymb}
+
+\let\OLDLATEX\LaTeX
+\let\OLDTEX\TeX
+\renewcommand{\LaTeX}{\text{\OLDLATEX}}
+\renewcommand{\TeX}{\text{\OLDTEX}}
+% TODO: elimiate the difference between katex and latex.