Show HN: ናይ GFM+GF-MathJax/Latex HTML ቅርጺ ምግባር ጀብሃ

<ዓንቀጽ>

HN: GFM+GF-MathJax/Latex HTML ፎርማት ምግባር ኣድቨንትሪ ኣርእዩ

ጽሩይን ቴክኒካዊን ሰነዳት ብዘይ ገለ ጸገም ምስ ዝተሓላለኸ ናይ ሒሳብ ምልክት ብሓባር ዝነብሩሉ ዲጂታላዊ ቦታ ክትሃንጽ ፈቲንካ ትፈልጥ? መብዛሕትኡ ግዜ ምስ ብዙሓት ስርዓታት ቅርጺ ምቅላስ ዘጠቓልል ብድሆ’ዩ፣ ንኣቀማምጣኻ ወይ መንፈስካ ከይሰብሩ ተስፋ ብምግባር። ልክዕ ከምኡ’ዩ ኣብ’ዚ ቀረባ እዋን ዝጀመርናዮ ጀብሃ። ንኣቃውማን ተነባብነትን GitHub Flavored Markdown (GFM) ክወስድ ዝኽእል ውሁድ ትሕዝቶ ሻምብቆ ክንፈጥር ደሊና፣ ብዘይ ጻዕሪ ድማ ምስ ጥረ ሓይሊ LaTeX ብመንገዲ MathJax ንጽቡቕ መመዓራረይቲ ንምቕራብ ክንሕውሶ ደሊና። እቲ ዕላማ ቀሊል እዩ ነይሩ: ንጽሩይን ንመርበብ ሓበሬታ ድሉው ዝኾነ ኤችቲኤምኤል ዘውጽእ ሓደ ምንጪ ሓቂ።

እቲ ራእይ፡ ምውህሃድ ተነባብነትን ጽንዓትን

ኣብ ሕመረት ናይዚ ፕሮጀክት ሓደ ቀንዲ እምነት እዩ ነይሩ፡ ሰነዳት ከም ቅልጡፍ README.md ንምጽሓፍ ቀሊል ክኸውን ኣለዎ፡ ግን ከኣ ንዝተሓላለኹ ኣልጎሪዝም ወይ ሳይንሳዊ ኣምር ብዘይ ምድምማጽ ንምግላጽ ዝኣክል ሓያል ክኸውን ኣለዎ። GFM እቲ ቀዳማይ ይህበና- ቀሊል ስነ-ቓል ንርእስታት፡ ዝርዝር፡ ኮድ ብሎክን መላግቦታትን። ንዝኾነ ኣብ ዳታ ሳይንስ፡ ምህንድስና ወይ ኣካዳሚያ ዘሎ ሰብ ግን፡ ሒሳብ ናይ ምግላጽ ክእለት ዘይደራደር እዩ። ቁንጣሮ ቁንጣሮ ላቴክስ ብቐጥታ ኣብ ውሽጢ ማርክዳውን ምእታው፡ ከምኡ’ውን ከም ፍጹማት መመዓራረይቲ ምቕራብ ምግባር፡ እቲ ሕልሚ’ዩ ነይሩ። እዚ ክልተኣውነት ንቴክኒካዊ ጋንታታት ዘገልግሉ መድረኻት ወሳኒ እዩ፣ በዚ ምኽንያት ድማ እዩ ምስቲ ሞዱላዊ ፍልስፍና መዋይዝ ፍጹም ዝሰማማዕ፣ ኣብኡ ዝተፈላለዩ ናይ ንግዲ "ሞዱላት" ዝተሓላለኹ ሓሳባት ብንጹር ከረድኡ የድልዮም።

ቴክኒካዊ መሰናኽላት፡ ምህዳም ገጸ ባህርያትን ምምሕዳር ጽግዕተኛታትን

እቲ ጀብሃ ብሓቂ ኣብ ኣተገባብራ እዩ ጀሚሩ። እቲ ቀዳማይ ዕንቅፋት ባህሪ ምህዳም እዩ ነይሩ። ማርክዳውን ንቅርጺ ከም ትሕቲ መስመርን ኮኾብን ዝኣመሰሉ ምልክታት ይጥቀም፣ እዚኦም እውን ንላቴክስ ስነ-ቓል መሰረታዊ እዮም። ናይ መስርሕ ሻምብቆና ኣብ መንጎ ማርክዳውን ሰያፍን ላቴክስ ሳብስክሪፕትን ብትኽክል ከም ዝፍለ ከነረጋግጽ ነይሩና። ብድሕሪኡ ውህደት ማትጃክስ መጺኡ። መጀመርታ ማርክዳውን ዝትንትንየሉ ኣወዳድባ የድልየና ነይሩ፣ ድሕሪኡ ማትጃክስ ነቲ ዝረኸብናዮ ኤችቲኤምኤል ስካን ብምግባር፣ ነቶም ዝተመደቡ ናይ ላቴክስ ዲሊሚተራት (ክልቲኦም ኣብ መስመር `$...$`ን ዲስፕለይ `$$...$$`ን) ረኺቡን ነቲ ሒሳብ ብጽቡቕ ታይፕ ኣሰናድኦን። ናይ ጽዕነት ግዜ ምምሕዳርን ናይ MathJax ስክሪፕት ምስ ካልኦት ናይ ቅድሚት ንብረትና ጽቡቕ ጌሩ ከም ዝጻወት ምርግጋጽን ረቂቕ ሳዕስዒት እዩ ነይሩ።

ኣብ መስመር ሻምብቆና ዝነበሩ ቁልፊ ስጉምትታት፡

ዝብሉ እዮም።

ዝብል ጽሑፍ ኣሎ።
• ምትንታን፡ ነቲ ጥረ ጽሑፍ ብጂኤፍኤም ፓርሰር ምምስራሕ ናይ መጀመርታ ኤችቲኤምኤል ንምፍጣር።
• ጽሬት፡ ኣብ መንጎ ማርክዳውንን ላቴክስን ስነ-ቓል ግርጭታት ንኸይፍጠር ካብ ትሕዝቶ ብጥንቃቐ ምህዳም።
• ምቕራጽ: ንቤተ-መጻሕፍቲ MathJax ምውጋእን ነቲ ፍሉይ ውጽኢት ኤችቲኤምኤል ንምስራሕ ምውቃርን።
• ቅዲ ምግባር፡ እቶም ዝተቐረጹ መመዓራረይቲ ምስቲ ኣብ ከባቢኡ ዘሎ ጽሑፍ ፍጹም ዝተሰለፉን ብዓይኒ ዝሰማማዕን ምዃኖም ንምርግጋጽ CSS ምትግባር።

ዝብል ጽሑፍ ኣሎ።

እቲ ፍረ: ስሉጥ ውህደት ንፍልጠት ምክፋል

ውጽኢቱ ዳርጋ ስሕበት ዝመስል ስርዓተ ትሕዝቶ እዩ። ጸሓፍቲ ኣብቲ ማርካፕ ዘይኮነስ ኣብ መልእኽቶም ከድህቡ ይኽእሉ። ንሓደ ስታቲስቲካዊ ሞዴል ዝገልጽ ሕጡበ-ጽሑፍ ክነድፉ ይኽእሉ፣ ስጉምቲ ከይሰበሩ ከም `$\nabla \cdot \mathbf{E} = \frac{\rho}{\epsilon_0}$` ዝኣመሰለ ወሳኒ ቀመር ከውድቑ ይኽእሉ፣ እቲ ዝተሓትመ ውጽኢት ድማ ሞያውን ልክዕን ከም ዝኸውን ክኣምኑ ይኽእሉ። እዚ ዓቕሚ ንውሽጣዊ ዊኪ፣ ንፍርያት ሰነዳትን ንዓሚል ዝገጥሙ ቴክኒካዊ መምርሕታትን ለውጢ ዘምጽእ እዩ። ጋንታታት ፍልጠት ብዝያዳ ውጽኢታዊ መንገዲ ንኽካፈላ ሓይሊ ይህቦም፣ እዚ ድማ ነቲ መብዛሕትኡ ግዜ ምስ ምስናድ ዝተሓላለኸ ስራሕ ዝመጽእ ምትፍናን ይንክዮ።

<ብሎክኮት> ዝብል ጽሑፍ ኣሎ። | ዝብል ጽሑፍ ኣሎ።

መሰረት ንመጻኢ ሞዱላት

እዚ ፕሮጀክት ካብ ናይ ሓደ ግዜ ምእራም ንላዕሊ እዩ ነይሩ፤ ንጽኑዕ ትሕዝቶ ምሕደራ ሕመረት መሰረት ኣንቢሩ። ንGFM+MathJax ዝብል ሕንቅልሕንቅሊተይ ብምፍታሕ፡ ብተጠቃሚ ዝፍጠር ትሕዝቶ፡ ቴክኒካዊ ሰነዳትን ዳይናሚክ ጸብጻባትን ንምቕራብ ዳግማይ ክጥቀመሉ ዝኽእል ሞዱል ፈጢርና ኣለና። እዚ ሕመረት ናይቲ መዋይዝ ቢዝነስ ኦኤስ እዩ: ንፍሉያት ብድሆታት ብውቁብ መንገዲ ዝሕዙ ንሓድሕዶም ዝሰርሑ ብሎኮታት ምህናጽ። ንጹር መግለጺ ዕማም ዘድልዮ ናይ ፕሮጀክት ምሕደራ ሞዱል ይኹን ወይ ድማ ልክዕ ናይ መመዓራረዪ ምርኢት ዘድልዮ ናይ ዳታ ትንተና ሞዱል ይኹን፡ እዚ ናይ ቅርጺ ሞተር ቅኑዕን ዘተኣማምንን መሰረት ይህብ። እቲ ጀብሃ ብቕኑዕ ኣገባብ፡ ዋላ እቶም ኣዝዮም ትሪ ቴክኒካዊ ብድሆታት ናብ ስሉጥ ተመኩሮታት ተጠቀምቲ ክቕየሩ ከም ዝኽእሉ ኣረጋጊጹ።

ዝብል ጽሑፍ ኣሎ።

ብተደጋጋሚ ዝሕተቱ ሕቶታት

HN: GFM+GF-MathJax/Latex HTML ፎርማት ምግባር ኣድቨንትሪ ኣርእዩ

ጽሩይን ቴክኒካዊን ሰነዳት ብዘይ ገለ ጸገም ምስ ዝተሓላለኸ ናይ ሒሳብ ምልክት ብሓባር ዝነብሩሉ ዲጂታላዊ ቦታ ክትሃንጽ ፈቲንካ ትፈልጥ? መብዛሕትኡ ግዜ ምስ ብዙሓት ስርዓታት ቅርጺ ምቅላስ ዘጠቓልል ብድሆ’ዩ፣ ንኣቀማምጣኻ ወይ መንፈስካ ከይሰብሩ ተስፋ ብምግባር። ልክዕ ከምኡ’ዩ ኣብ’ዚ ቀረባ እዋን ዝጀመርናዮ ጀብሃ። ንኣቃውማን ተነባብነትን GitHub Flavored Markdown (GFM) ክወስድ ዝኽእል ውሁድ ትሕዝቶ ሻምብቆ ክንፈጥር ደሊና፣ ብዘይ ጻዕሪ ድማ ምስ ጥረ ሓይሊ LaTeX ብመንገዲ MathJax ንጽቡቕ መመዓራረይቲ ንምቕራብ ክንሕውሶ ደሊና። እቲ ዕላማ ቀሊል እዩ ነይሩ: ንጽሩይን ንመርበብ ሓበሬታ ድሉው ዝኾነ ኤችቲኤምኤል ዘውጽእ ሓደ ምንጪ ሓቂ።

እቲ ራእይ፡ ምውህሃድ ተነባብነትን ጽንዓትን

ኣብ ሕመረት ናይዚ ፕሮጀክት ሓደ ቀንዲ እምነት እዩ ነይሩ፡ ሰነዳት ከም ቅልጡፍ README.md ንምጽሓፍ ቀሊል ክኸውን ኣለዎ፡ ግን ከኣ ንዝተሓላለኹ ኣልጎሪዝም ወይ ሳይንሳዊ ኣምር ብዘይ ምድምማጽ ንምግላጽ ዝኣክል ሓያል ክኸውን ኣለዎ። GFM እቲ ቀዳማይ ይህበና- ቀሊል ስነ-ቓል ንርእስታት፡ ዝርዝር፡ ኮድ ብሎክን መላግቦታትን። ንዝኾነ ኣብ ዳታ ሳይንስ፡ ምህንድስና ወይ ኣካዳሚያ ዘሎ ሰብ ግን፡ ሒሳብ ናይ ምግላጽ ክእለት ዘይደራደር እዩ። ቁንጣሮ ቁንጣሮ ላቴክስ ብቐጥታ ኣብ ውሽጢ ማርክዳውን ምእታው፡ ከምኡ’ውን ከም ፍጹማት መመዓራረይቲ ምቕራብ ምግባር፡ እቲ ሕልሚ’ዩ ነይሩ። እዚ ክልተኣዊነት ንቴክኒካዊ ጋንታታት ዘገልግሉ መድረኻት ወሳኒ እዩ፣ በዚ ምኽንያት ድማ እዩ ምስቲ ዝተፈላለዩ ናይ ንግዲ "ሞዱላት" ዝተሓላለኹ ሓሳባት ብንጹር ከመሓላልፉ ዘድልዮም ሞዱላዊ ፍልስፍና መዋይዝ ፍጹም ዝሰማማዕ።

ቴክኒካዊ መሰናኽላት፡ ምህዳም ገጸ ባህርያትን ምምሕዳር ጽግዕተኛታትን

እቲ ጀብሃ ብሓቂ ኣብ ኣተገባብራ እዩ ጀሚሩ። እቲ ቀዳማይ ዕንቅፋት ባህሪ ምህዳም እዩ ነይሩ። ማርክዳውን ንቅርጺ ከም ትሕቲ መስመርን ኮኾብን ዝኣመሰሉ ምልክታት ይጥቀም፣ እዚኦም እውን ንላቴክስ ስነ-ቓል መሰረታዊ እዮም። ናይ መስርሕ ሻምብቆና ኣብ መንጎ ማርክዳውን ሰያፍን ላቴክስ ሳብስክሪፕትን ብትኽክል ከም ዝፍለ ከነረጋግጽ ነይሩና። ብድሕሪኡ ውህደት ማትጃክስ መጺኡ። መጀመርታ ማርክዳውን ዝትንትንየሉ ኣወዳድባ የድልየና ነይሩ፣ ድሕሪኡ ማትጃክስ ነቲ ዝረኸብናዮ ኤችቲኤምኤል ስካን ብምግባር፣ ነቶም ዝተመደቡ ናይ ላቴክስ ዲሊሚተራት (ክልቲኦም ኣብ መስመር `$...$`ን ዲስፕለይ `$$...$$`ን) ረኺቡን ነቲ ሒሳብ ብጽቡቕ ታይፕ ኣሰናድኦን። ናይ ጽዕነት ግዜ ምምሕዳርን ናይ MathJax ስክሪፕት ምስ ካልኦት ናይ ቅድሚት ንብረትና ጽቡቕ ጌሩ ከም ዝጻወት ምርግጋጽን ረቂቕ ሳዕስዒት እዩ ነይሩ።

እቲ ፍረ፡ ንፍልጠት ምክፋል ስሉጥ ውህደት

ውጽኢቱ ዳርጋ ስሕበት ዝመስል ስርዓተ ትሕዝቶ እዩ። ጸሓፍቲ ኣብቲ ማርካፕ ዘይኮነስ ኣብ መልእኽቶም ከድህቡ ይኽእሉ። ንሓደ ስታቲስቲካዊ ሞዴል ዝገልጽ ሕጡበ-ጽሑፍ ክነድፉ ይኽእሉ፣ ስጉምቲ ከይሰበሩ ከም `$\nabla \cdot \mathbf{E} = \frac{\rho}{\epsilon_0}$` ዝኣመሰለ ወሳኒ ቀመር ከውድቑ ይኽእሉ፣ እቲ ዝተሓትመ ውጽኢት ድማ ሞያውን ልክዕን ከም ዝኸውን ክኣምኑ ይኽእሉ። እዚ ዓቕሚ ንውሽጣዊ ዊኪ፣ ንፍርያት ሰነዳትን ንዓሚል ዝገጥሙ ቴክኒካዊ መምርሕታትን ለውጢ ዘምጽእ እዩ። ጋንታታት ፍልጠት ብዝያዳ ውጽኢታዊ መንገዲ ንኽካፈላ ሓይሊ ይህቦም፣ እዚ ድማ ነቲ መብዛሕትኡ ግዜ ምስ ምስናድ ዝተሓላለኸ ስራሕ ዝመጽእ ምትፍናን ይንክዮ።

መሰረት ንመጻኢ ሞዱላት

እዚ ፕሮጀክት ካብ ናይ ሓደ ግዜ ምእራም ንላዕሊ እዩ ነይሩ፤ ንጽኑዕ ትሕዝቶ ምሕደራ ሕመረት መሰረት ኣንቢሩ። ንGFM+MathJax ዝብል ሕንቅልሕንቅሊተይ ብምፍታሕ፡ ብተጠቃሚ ዝፍጠር ትሕዝቶ፡ ቴክኒካዊ ሰነዳትን ዳይናሚክ ጸብጻባትን ንምቕራብ ዳግማይ ክጥቀመሉ ዝኽእል ሞዱል ፈጢርና ኣለና። እዚ ሕመረት ናይቲ መዋይዝ ቢዝነስ ኦኤስ እዩ: ንፍሉያት ብድሆታት ብውቁብ መንገዲ ዝሕዙ ንሓድሕዶም ዝሰርሑ ብሎኮታት ምህናጽ። ንጹር መግለጺ ዕማም ዘድልዮ ናይ ፕሮጀክት ምሕደራ ሞዱል ይኹን ወይ ድማ ልክዕ ናይ መመዓራረዪ ምርኢት ዘድልዮ ናይ ዳታ ትንተና ሞዱል ይኹን፡ እዚ ናይ ቅርጺ ሞተር ቅኑዕን ዘተኣማምንን መሰረት ይህብ። እቲ ጀብሃ ብቕኑዕ ኣገባብ፡ ዋላ እቶም ኣዝዮም ትሪ ቴክኒካዊ ብድሆታት ናብ ስሉጥ ተመኩሮታት ተጠቀምቲ ክቕየሩ ከም ዝኽእሉ ኣረጋጊጹ።

ዝብል ጽሑፍ ኣሎ።