jektex
jektex 0.1.1
매크로를 지원하는 유해한 서버 측 캐시 라텍스 렌더링을위한 Jekyll 플러그인. 부풀어 오른 JavaScript로 사이트를 어수선하지 않고 라텍스와 마크 다운의 편안함을 즐기십시오. 이 프로젝트는 katex.org에 의해 승인됩니다.
Jektex는 내장 Kramdown 수학 표기법과 새로운 라텍스 전용 수학 표기법을 모두 지원합니다.
인라인 공식
단락 내에서 두 쌍의 달러 표시 ( $$ ) 사이에 공식을 넣으십시오.
Lorem ipsum dolor sit amet, consectetur $$ e^{i theta }= cos ( theta )+i sin ( theta ) $$
adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 디스플레이 공식
두 쌍의 달러 표시 ( $$ ) 사이에 공식을두고 두 개의 빈 줄로 둘러싸여 있습니다.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
$$ left [ frac {- hbar ^2}{2 mu } nabla ^ 2 + V( mathbf {r},t) right ] Psi ( mathbf {r},t) $$
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Jektex $$ 인라인 공식에 기존 단일 $ 사용하지 않는 이유는 무엇입니까?
이것이 Kramdown (Jekyll 's Markdown Parser)이 작동하는 방식 이므로이 컨벤션을 존중하기로 결정했습니다. 이 플러그인을보다 일관되고 보편적으로 만듭니다. 자세한 내용은이 문제를 참조하십시오.
인라인 공식
탈출 한 두 개의 괄호 ( ) 사이에 공식을 넣으십시오. 텍스트의 입장은 중요하지 않습니다.
Lorem ipsum dolor sit amet, consectetur ( e^{i theta }= cos ( theta )+i sin ( theta ) )
adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 디스플레이 공식
두 개의 탈출 된 정사각형 괄호 [ ] 사이에 공식을 넣으십시오. 텍스트의 입장은 중요하지 않습니다.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
[ left [ frac {- hbar ^2}{2 mu } nabla ^2 + V( mathbf {r},t) right ] Psi ( mathbf {r},t) ]
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Jektex 로고를위한 매크로 빌드가 있습니다. jektex 로 사용할 수 있습니다.
_config.yml 파일을 통해 jektex si가 매우 구성 가능합니다.
캐시 비활성화
_config.yml 에서 disable_disk_cache = true 로 캐싱을 비활성화 할 수 있습니다. 캐싱은 기본적으로 활성화됩니다. Jekyll의 공식 웹 사이트에서 자세한 정보를 찾을 수 있습니다.
캐시 위치 설정
기본적으로 JekTex 캐시는 .jekyll-cache 디렉토리에 저장됩니다. 이로 인해 jekyll clean 이라고 부르면 삭제됩니다. 캐시 삭제를 방지하거나 캐시 위치를 변경하려면 _config.yml 에서 cache_dir 지정할 수 있습니다.
jektex :
cache_dir : " .jektex-cache " 파일을 무시합니다
기본적으로 Jektex는 Jekyll이 렌더링 한 모든 파일에서 라텍스를 렌더링하려고합니다. 예를 들어 RSS 피드를 라텍스를 포함하는 발췌문으로 렌더링 할 때 때때로 바람직하지 않을 수 있습니다. Jektex는 ignore 옵션을 사용하여이를 해결합니다.
jektex :
ignore : ["*.xml", "README.md", "_drafts/*" ] * 사용하여 기존의 와일드 카드를 사용할 수 있습니다. 이 예제 구성은 모든 .xml 파일, README.md 및 _drafts 디렉토리의 모든 파일을 무시합니다.
특정 게시물을 무시하는 또 다른 방법은 jektex 속성을 Front Matter에서 false 로 설정하는 것입니다.
---
title : " How Jektex works "
category : " Development "
jektex : false
layout : post
--- jektex 태그를 true 또는 설정으로 설정하면 Jektex가 해당 게시물에서 라텍스 표현식을 렌더링하게됩니다.
매크로 사용
글로벌 매크로를 정의 할 수 있습니다.
jektex :
macros :
- ["\Q", "\mathbb{Q}"]
- ["\C", "\mathbb{C}"] 그리고 네, 또 다른 반발로 반발 ( )을 피해야합니다. 이는 YAML 사양 때문입니다.
매개 변수로 매크로를 정의 할 수 있습니다.
jektex :
macros :
- ["\vec", "\mathbf{#1}"]
- ["\addBar", "\bar{#1}"] 이것은 라텍스 newcommand 의 동작을 시뮬레이션합니다.
사일렌 징 Jektex 출력
Jektex는 주기적으로 사용자에게 렌더링/캐시 된 방정식에 대해 알려줍니다. 이것이 필요하지 않은 경우, silent 옵션을 설정할 수 있습니다 (기본적으로 false ).
jektex :
silent : true 완전한 예
권장 구성 :
jektex :
cache_dir : " .jektex-cache "
ignore : ["*.xml"]
silent : false
macros :
- ["\Q", "\mathbb{Q}"]
- ["\C", "\mathbb{C}"]구성이없는 것은 다음과 같습니다.
jektex :
cache_dir : " .jekyll-cache "
ignore : []
silent : false
macros : [] 이 플러그인은 Rubygem으로 제공됩니다.
Bundler 사용
Gemfile 에 Jektex를 추가하십시오.
group :jekyll_plugins do
gem "jektex"
end bundle install 실행하십시오
번들없이
gem install jektex 실행하십시오
설치 후
_config.yml 파일의 플러그인 목록에 jektex 추가
plugins :
- jektex 그리고 katex.min.css 당신에게 html 헤드에 추가하는 것을 잊지 마십시오.
< link rel =" stylesheet " href =" https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css " integrity =" sha384-MlJdn/WNKDGXveldHDdyRP1R4CTHr3FeuDNfhsLPYrq2t0UBkUdK2jyTnXPEK1NQ " crossorigin =" anonymous " >CSS 파일을 다운로드하여 서버에서 직접 자산으로로드하는 것이 훨씬 더 좋습니다. Katex 웹 사이트에서 자세한 정보를 찾을 수 있습니다.
공식 저장소의 문제에 버그를보고하거나 기능 요청을 자유롭게보고하십시오. 풀 요청도 열었습니다.
