Cara menampilkan persamaan matematika secara umum dari penurunan github (bukan blog github)

151

Setelah menyelidiki, saya menemukan mathjax dapat melakukan ini. Tetapi ketika saya menulis beberapa contoh di file penurunan harga saya, itu tidak menunjukkan persamaan yang benar:

Saya telah menambahkan ini di kepala file penurunan harga:

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

Dan ketikkan pernyataan mathjax:

(E = mc ^ 2) , $$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$

Tapi github tidak menunjukkan apa pun untuk simbol matematika! Tolong bantu saya, terima kasih! Katakan padaku cara menampilkan simbol matematika di halaman penurunan harga github.

alexunder
sumber
2
Itu tidak memecahkan masalah bagi pengguna umum, tetapi jawaban ini menyarankan skrip peramban yang setidaknya dapat membuat Anda melihat persamaan: stackoverflow.com/q/11255900/180892
Jeromy Anglim
gitlab menggunakan KaTeX
Foad

Jawaban:

144

Tapi github tidak menunjukkan simbol matematika! tolong bantu saya, terima kasih!

Parsing GitHub dilakukan oleh pustaka SunDown (ex libUpSkirt).

Moto pustaka adalah " Pustaka pemrosesan markdown yang sesuai standar, cepat, aman di C" . Kata yang penting adalah "aman" di sana, mempertimbangkan pertanyaan Anda :).

Memang, memungkinkan javascript untuk dieksekusi akan sedikit dari standar teks-ke-HTML MarkDown.

Terlebih lagi, segala sesuatu yang tampak seperti tag HTML bisa diloloskan atau dilucuti.

Katakan padaku bagaimana menampilkan simbol matematika pada penurunan harga github secara umum.

Taruhan terbaik Anda adalah menemukan situs web yang mirip dengan yuml.me yang dapat menghasilkan gambar on-the-fly dari dengan mem-parsing querystring URL yang disediakan.

Memperbarui

Saya telah menemukan beberapa situs yang menyediakan layanan seperti ini kepada pengguna: codedogs.com ( tampaknya tidak lagi mendukung penyematan ) atau iTex2Img . Anda mungkin ingin mencobanya. Tentu saja, yang lain mungkin ada dan beberapa Google-fu akan membantu Anda menemukannya.

diberikan sintaks penurunan harga berikut

![equation](http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

itu akan menampilkan gambar berikut

persamaan http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

Catatan : Agar gambar ditampilkan dengan benar, Anda harus memastikan bagian permintaan dari url dikodekan persen . Anda dapat dengan mudah menemukan alat online untuk membantu Anda dengan tugas itu, seperti www.url-encode-decode.com

nulltoken
sumber
6
@nultoken, terima kasih atas jawaban bermanfaat Anda. Saya menggunakan situs web iTex2Img yang Anda referensikan di atas dan saya menambahkan dua rumus pada dokumentasi saya. Saya mempunyai masalah bahwa ketika saya membuka halaman dokumentasi di GitHub, kedua formula ditampilkan sama sementara sebenarnya berbeda. Apakah Anda tahu mengapa itu terjadi?
Sam
3
mathurl.com juga merupakan situs web yang patut diperhatikan jika Anda harus menghasilkan gambar.
Martin Thoma
2
Ini sepertinya tidak bekerja pada github. Gambar tidak ditampilkan. Adakah yang tahu kenapa?
OganM
1
@ OganM Sintaksnya telah berubah. Tautan tersebut telah diperbaiki dan diuji di GitHub juga
nulltoken
1
Situs iTex2Img sepertinya tidak konsisten bekerja untuk saya. Gambar sepertinya tidak ditampilkan di Github.
timbram
91

Penurunan harga mendukung inline HTML. HTML sebaris dapat digunakan untuk persamaan inline cepat dan sederhana dan, dengan alat eksternal, rendering yang lebih kompleks.

Inline Cepat dan Sederhana

Untuk item inline cepat dan sederhana, gunakan HTML ampersand kode entitas . Contoh yang menggabungkan ide ini dengan teks subskrip dalam penurunan harga adalah: h θ (x) = θ o x + θ 1 x, kode yang diikuti.

    h<sub>&theta;</sub>(x) = &theta;<sub>o</sub> x + &theta;<sub>1</sub>x

Kode ampersand entitas HTML untuk simbol matematika umum dapat ditemukan di sini . Kode untuk huruf Yunani di sini .

Meskipun pendekatan ini memiliki keterbatasan, ia bekerja di hampir semua penurunan harga dan tidak memerlukan perpustakaan eksternal.

Rendering Inline Terukur Kompleks dengan LaTeX dan Codecogs

Jika kebutuhan Anda lebih besar, gunakan renderer LaTeX eksternal seperti CodeCogs. Buat persamaan dengan editor CodeCogs . Pilih svg untuk rendering dan HTML untuk kode embed. Svg ditampilkan dengan baik pada ukuran. HTML memungkinkan LaTeX mudah dibaca ketika Anda melihat sumbernya. Salin kode semat dari bagian bawah halaman dan rekatkan ke markdown Anda.

<img src="https://latex.codecogs.com/svg.latex?\Large&space;x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" title="\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" />

Ini menggabungkan jawaban ini dan jawaban ini .

Dukungan GitHub hanya kadang-kadang bekerja menggunakan sintaks html mentah di atas untuk LaTeX yang dapat dibaca untuk saya. Jika hal di atas tidak bekerja untuk Anda, pilihan lain adalah memilih rendering URL yang di-encode dan menggunakan output itu untuk secara manual membuat tautan seperti:

\ Besar x = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2a}

![\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}](https://latex.codecogs.com/svg.latex?x%3D%5Cfrac%7B-b%5Cpm%5Csqrt%7Bb%5E2-4ac%7D%7D%7B2a%7D)

Ini secara manual menggabungkan LaTex dalam teks gambar alt dan menggunakan URL yang disandikan untuk rendering di GitHub.

Rendering Multi-line

Jika Anda membutuhkan rendering multi-baris, periksa jawaban ini .

SpeedCoder5
sumber
1
ini bekerja dengan baik. Saya harus mengonversi notebook jupyter (.ipynb) ke .mddan persamaan dasarnya adalah kode lateks multiline.
Marc Maxmeister
12

Jika hanya ingin menunjukkan matematika di peramban untuk Anda sendiri, Anda dapat mencoba ekstensi Chrome GitHub dengan MathJax . Cukup nyaman.

nn0p
sumber
1
ada kesalahan dengan icon16.png ketika saya mencoba menginstal
Homero Esmeraldo
10

Satu solusi lain adalah menggunakan notebook jupyter dan menggunakan mode penurunan harga dalam sel untuk membuat persamaan.

Hal-hal dasar tampaknya bekerja dengan sempurna, seperti persamaan terpusat

\begin{equation}
...
\end{equation}

atau persamaan sebaris

$ \sum_{\forall i}{x_i^{2}} $

Meskipun, salah satu fungsi yang saya benar-benar inginkan tidak memberikan sama sekali di github adalah \mbox{}, yang mengecewakan. Namun, semuanya ini telah menjadi cara paling sukses untuk memberikan persamaan pada github.

chahuja
sumber
3
Terima kasih atas jawaban ini, tetapi ada masalah ini: Saya berhasil menggunakan notebook jupyter dalam mode penurunan harga dan persamaan muncul OK. Namun, sekarang bagaimana Anda dapat mentransfer jupyter ini ke readme.mdGitHub?
DavidC.
1
Persamaan tidak membuat langsung pada file penurunan harga. Persamaan harus cukup banyak gambar untuk berada di readme.md. Namun, Anda selalu bisa memakai file.ipynbgithub dan github merendernya dengan baik.
hexicle
8

Sekarang tahun 2020, izinkan saya merangkum kemajuan formula matematika yang memberikan dukungan dari host repositori kode sumber.

GitHub & Bitbucket

GitHub dan Bitbucket masih tidak mendukung rendering rumus matematika, apakah itu pembatas default atau lainnya.

Bitbucket Cloud / BCLOUD-11192 - Tambahkan Dukungan LaTeX di Dokumen MarkDown (BB-12552)

GitHub / markup - Render persamaan matematika

GitHub / markup - Mendukung lateks

GitHub Community Forum - [PERMINTAAN FITUR] LaTeX Math in Markdown

talk.commonmark.org - Dapatkah rumus matematika ditambahkan ke penurunan harga

GitHub hampir tidak membuat kemajuan berarti dalam beberapa tahun terakhir.

GitLab

GitLab sudah didukung, tetapi bukan cara yang paling umum. Ini menggunakan pembatas sendiri.

This math is inline $`a^2+b^2=c^2`$.

This is on a separate line

```math
a^2+b^2=c^2
```

GitLab Flavour Markdown - Math

Siapa yang mendukung pembatas universal?

Pengurai penurunan harga yang digunakan oleh Hugo

Cara lain untuk membuat

xuesongye
sumber
6

Meskipun GitHub tidak akan menafsirkan rumus MathJax, Anda dapat secara otomatis membuat dokumen penurunan harga dengan rumus diganti dengan gambar.

Saya sarankan Anda melihat aplikasi GitHub, TeXify :

Aplikasi GitHub yang terlihat dalam dorongan Anda untuk file dengan ekstensi * .tex.md dan menjadikannya ekspresi TeX sebagai gambar SVG

Cara kerjanya (dari repositori sumber ):

Setiap kali Anda menekan TeXify akan berjalan dan mencari file * .tex.md di komit terakhir Anda. Untuk masing-masing dari mereka itu akan menjalankan readme2tex yang akan membawa ekspresi LaTeX terlampir di antara tanda-tanda dolar, mengubahnya menjadi gambar SVG biasa, dan kemudian menyimpan output menjadi file ekstensi .md (Itu berarti bahwa file bernama README.tex.md akan diproses dan hasilnya akan disimpan sebagai README.md). Setelah itu, file output dan gambar SVG baru kemudian dikomit dan didorong kembali ke repo Anda.

Tom Hale
sumber
2

Ada solusi yang bagus untuk masalah Anda - gunakan plugin TeXify github (disebutkan oleh Tom Hale answer - tapi saya mengembangkan jawabannya di tautan yang diberikan di bawah ini) - lebih detail tentang plugin github ini dan penjelasan mengapa ini adalah pendekatan yang baik yang dapat Anda temukan dalam jawaban itu .

Kamil Kiełczewski
sumber
2

Saya menggunakan proses yang disebutkan di bawah ini untuk mengubah persamaan menjadi penurunan harga. Ini bekerja sangat baik untuk saya. Sangat sederhana !!

Katakanlah, saya ingin merepresentasikan persamaan perkalian matriks

Langkah 1:

Dapatkan skrip untuk formula Anda dari sini - https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/

Contoh saya: Saya ingin mewakili Z(i,j)=X(i,k) * Y(k, j); k=1 to nformula penjumlahan. Merujuk situs web, skrip yang diperlukan adalah =>

masukkan deskripsi gambar di sini

Z_i_j=\sum_{k=1}^{10} X_i_k * Y_k_j

Langkah 2:

Gunakan URL encoder - https://www.urlencoder.org/ untuk mengonversi skrip ke url yang valid

Contoh saya:

masukkan deskripsi gambar di sini

Langkah 3:

Gunakan situs web ini untuk menghasilkan gambar dengan menyalin-menempelkan output dari Langkah 2 di parameter permintaan "eq" - http://www.sciweavers.org/tex2img.php?eq=<b><i>paste-output-here</i></b>&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

- Contoh saya:
http://www.sciweavers.org/tex2img.php?eq=Z_i_j=\sum_{k = 1} ^ {10}% 20X_i_k% 20 *% 20Y_k_j & bc = Putih & fc = Hitam & im = jpg & fs = 12 & ff = arev & edit =

masukkan deskripsi gambar di sini

Langkah 4:

Referensi gambar menggunakan sintaks markdown - ![alt text](enter url here)

- Salin ini di markdown Anda dan Anda siap untuk:

![Z(i,j)=X(i,k) * Y(k, j); k=1 to n](http://www.sciweavers.org/tex2img.php?eq=Z_i_j%3D%5Csum_%7Bi%3D1%7D%5E%7B10%7D%20X_i_k%20%2A%20Y_k_j&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

Gambar di bawah ini adalah output dari penurunan harga. Hore!!


masukkan deskripsi gambar di sini

Dexter
sumber
siapa pun yang membaca ini, "Typora" adalah aplikasi penurunan harga favorit baru saya .. hanya mengatakan
Dexter
0

Mengenai tex → konversi gambar, alat LaTeXiT menghasilkan output kualitas yang jauh lebih tinggi. Saya percaya ini adalah standar di sebagian besar distribusi TeX tetapi Anda pasti dapat menemukannya secara online jika Anda belum memilikinya. Yang perlu Anda lakukan adalah meletakkannya di TeX, seret gambar ke desktop Anda, lalu seret dari desktop Anda ke situs hosting gambar (saya menggunakan imgur).

fredcallaway
sumber
Perlu dicatat bahwa LaTeXiT tampaknya hanya berfungsi di bawah MacOS (meskipun itu tidak dinyatakan secara eksplisit di situs web).
ƒacu.-
0

Saya menggunakan berikut ini di kepala file mark down

<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js? 
config=TeX-MML-AM_CHTML"
</script>

Kemudian ketikkan pernyataan mathjax berikut
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
Ini berhasil untuk saya

Swetha Tanamala
sumber