Show HN: Ntirho wo fometa HTML wa GFM+GF-MathJax/Latex

"Ku humelela ka riendzo leri ro fometa a hi ntsena eka vuhumelerisi bya HTML lebyi tengeke; i ku herisiwa ka xihinga xa vutivi eka vatumbuluxi va hina. A va ha boheki ku hlawula exikarhi ka ntokoto wo olova wo tsala na ku pakanisa ka tinhlayo. Lowu i nsinya wa nawu lowu hi wu tirhisaka eka pulatifomo hinkwayo ya Mewayz—ku susa swihinga leswaku swipano swi ta kota ku kongomisa eka leswi swi swi endlaka kahle."

Xiseketelo xa Timodyuli ta Vumundzuku

Purojeke leyi a yi tlula ku lulamisiwa ka nkarhi wun'we; yi veke masungulo ya xisekelo xa vulawuri bya nhundzu leyi tiyeke. Hi ku tlhantlha xiphiqo xa GFM+MathJax, hi tumbuluxile modyuli leyi tirhisiwaka nakambe yo hundzuluxela swilo leswi endliweke hi vatirhisi, matsalwa ya xithekiniki, na swiviko leswi cinca-cincaka. Lexi i xisekelo xa Mewayz bindzu OS: ku aka swibokisana leswi tirhisanaka leswi khomaka mintlhontlho yo karhi hi ndlela yo saseka. Kungava modyuli ya vufambisi bya phurojeke leyi lavaka tinhlamuselo ta ntirho leti nga erivaleni kumbe modyuli ya vuxopaxopi bya datha leyi lavaka nkombiso wa xiringaniso lowu kongomeke, njhini leyi ya ku fometa yi nyika masungulo lama nga cincekiki, lama tshembekaka. Adventure yi tiyisisile leswaku hi maendlelo lamanene, hambi ku ri mintlhontlho ya xithekiniki yo nonoka swinene yi nga hundzuriwa eka mintokoto ya vatirhisi leyi nga na swiphiqo.

Swivutiso Leswi Vutisiwaka Nkarhi Na Nkarhi

Kombisa HN: Ntirho wo Fometa HTML wa GFM+GF-MathJax/Latex

U tshame u ringeta ku aka ndhawu ya xidijitali laha matsalwa yo basa, ya xithekiniki ya hanyaka swin’we hi ndlela yo pfumala swiphiqo na notation ya tinhlayo leyi rharhanganeke? I ntlhontlho lowu talaka ku katsa ku lwa na tisisiteme to tala to fometa, hi ku tshemba leswaku a ti tshovi layout ya wena kumbe moya wa wena. That’s precisely adventure leyi hi yi sunguleke sweswinyana. Hi lave ku tumbuluxa phayiphi ya nhundzu leyi hlanganeke leyi nga teka GitHub Flavored Markdown (GFM) ku kuma xivumbeko na ku hlayeka, naswona handle ko endla matshalatshala hi yi hlanganisa na matimba yo ka ya nga swekiwanga ya LaTeX hi ku tirhisa MathJax ku hundzuluxela swiringaniso swo saseka. Xikongomelo a xi olovile: xihlovo xin’we xa ntiyiso lexi humesaka HTML leyi nga onhakiki, leyi lunghekeleke webu.

Xivono: Ku Hlanganisa Ku Hlayeka na ku Tika

Exikarhi ka phurojeke leyi a ku ri na ripfumelo ra nkoka: matsalwa ya fanele ku olova ku ma tsala ku fana na README.md ya xihatla, kambe ya matimba yo hlamusela tialgorithm leti rharhanganeke kumbe miehleketo ya sayense handle ko pfumelelana. GFM yi hi nyika ya khale—xivumbeko xo olova xa tinhloko-mhaka, minxaxamelo, swibokisana swa khodi ni swihlanganisi. Kambe eka mani na mani eka sayense ya data, vunjhiniyara kumbe dyondzo, vuswikoti byo kombisa tinhlayo a byi vulavurisaniwi. Ku nghenisa swiphemu swa LaTeX hi ku kongoma endzeni ka markdown, na ku va swi hundzuluxela tanihi swiringaniso leswi hetisekeke, a ku ri norho. Vumbiwa lebyi i bya nkoka eka tipulatifomo leti tirhelaka swipano swa xithekiniki, hi yona mhaka leyi byi fambisanaka hi ku hetiseka na filosofi ya modula ya Mewayz, laha "timodyuli" to hambana ta mabindzu ti lavaka ku hlanganisa miehleketo yo rharhangana kahle.

Swiphiqo swa Xithekiniki: Ku Balekela Swimunhuhatwa na ku Lawula ku Titshega

Adventure yi sungurile hakunene eka ku tirhisiwa. Xihinga xo sungula a ku ri ku baleka ka vumunhu. Markdown yi tirhisa swikombiso swo fana na swikoweto swa le hansi na tinyeleti eka ku fometa, leswi na swona swi nga swa nkoka eka xivumbeko xa marito xa LaTeX. Hi boheke ku tiyisisa leswaku phayiphi ya hina yo lulamisa yi hambanile kahle exikarhi ka markdown italic na subscript ya LaTeX. Kutani ku fike ku hlanganisiwa ka MathJax. Hi lave setup laha Markdown yi nga parsed ku sungula, ivi MathJax yi skena HTML leyi humeleleke, yi kuma swihlawulekisi swa LaTeX leswi hlawuriweke (hinkwaswo inline `$...$` na display `$$...$$`) na ku thayipa tinhlayo hi ndlela yo saseka. Ku lawula minkarhi yo layicha na ku tiyisisa leswaku tsalwa ra MathJax ri tlanga kahle na nhundzu ya hina yin’wana ya le mahlweni a ku ri ncino wo olova.

Nhlawulo: Ku Hlanganisiwa loku nga na Swirhalanganyi ka ku Avelana Vutivi

Mbuyelo wa kona i sisiteme ya nhundzu leyi titwaka yi ri ekusuhi na masalamusi. Vatsari va nga dzikisa mianakanyo ya vona eka rungula ra vona, ku nga ri eka ku fungha. Va nga tsala ndzimana leyi hlamuselaka modele wa tinhlayo, va hoxa fomula ya nkoka yo fana na `$\nabla \cdot \mathbf{E} = \frac{\rho}{\epsilon_0}$` handle ko tshovela goza, naswona va tshemba leswaku mbuyelo lowu kandziyisiweke wu ta va wa xiphurofexinali na lowu kongomeke. Vuswikoti lebyi byi hundzula eka tiwiki ta le ndzeni, matsalwa ya swikumiwa, na swiletelo swa xithekiniki leswi langutaneke na tiklayenti. Swi nyika matimba eka swipano ku avelana vutivi hi ndlela leyinene, ku hunguta ku holova loku talaka ku ta na ku tsala ntirho lowu rharhanganeke.

Xiseketelo xa Timodyuli ta Nkarhi lowu taka

Purojeke leyi a yi tlula ku lulamisiwa ka nkarhi wun'we; yi veke masungulo ya xisekelo xa vulawuri bya nhundzu leyi tiyeke. Hi ku tlhantlha xiphiqo xa GFM+MathJax, hi tumbuluxile modyuli leyi tirhisiwaka nakambe yo hundzuluxela swilo leswi endliweke hi vatirhisi, matsalwa ya xithekiniki, na swiviko leswi cinca-cincaka. Lexi i xisekelo xa OS ya bindzu ra Mewayz: ku aka swibokisana leswi tirhisanaka leswi khomaka mintlhontlho yo karhi hi ndlela yo saseka. Kungava modyuli ya vufambisi bya phurojeke leyi lavaka tinhlamuselo ta ntirho leti nga erivaleni kumbe modyuli ya vuxopaxopi bya datha leyi lavaka nkombiso wa xiringaniso lowu kongomeke, njhini leyi ya ku fometa yi nyika masungulo lama nga cincekiki, lama tshembekaka. Adventure yi tiyisisile leswaku hi maendlelo lamanene, hambi ku ri mintlhontlho ya xithekiniki yo nonoka swinene yi nga hundzuriwa eka mintokoto ya vatirhisi leyi nga na swiphiqo.