Matemātikas formulas

Matemātikas formulas

Īss apraksts, kā pievienot XWiki pluginu priekš LaTeX izteiksmēm (uz Ante.lv tas jau ir izdarīts):

1. Instalēt XWiki? un Texvc?.
2. Izčekot kodu http://java-eim.googlecode.com/svn/trunk/java-eim-demo-xwiki-plugin un sakompilēt to par JAR failu. Uz Linux (kur darbojas pats XWiki) to var izdarīt ar "ant jar", savukārt uz Windows darbstacijas - "mvn package". Uz Windows turklāt ir vajadzīgs arī "xwiki-core.jar", jo kodam no tā ir kompilācijas-laika atkarība. Ja nav vēlēšanās šo xwiki-core.jar kompilēt no izejas tekstiem, tad var nokopēt no /usr/share/tomcat5/webapps/xwiki/WEB-INF/lib.
3. Pēc JAR koda sakompilēšanas pārsauc "java-eim-demo-xwiki-plugin.jar" par "ante.jar" (pagaidām šis ir vienīgais paplašinājums) un uzkopē zem /usr/share/tomcat5/webapps/xwiki/WEB-INF/lib.
4. Galvenā klase šajā aplikācijā ir "LatexPluginApi", kura darbina komandrindas "texvc". Šo pluginu reģistrē /usr/share/tomcat5/webapps/xwiki/WEB-INF/xwiki.cfg:

   xwiki.plugins=\
                   com.xpn.xwiki.monitor.api.MonitorPlugin,\
                   ...
                   com.xpn.xwiki.plugin.diff.DiffPlugin,\
                   demo.LatexPlugin

5. Faila /usr/share/tomcat5/webapps/xwiki/skins/albatross/macros.vm pieraksta šādu Velocity macro definīciju:

   #macro(mm $expr)
   #set($ee = $expr.replaceAll("@","\\"))
   $xwiki.latex_plugin.image($ee)
   #end

   (Šī manipulācija aizstāj "@" ar ačgārnajām daļsvītrām un arī ļauj rakstīt drusku īsāk:

   $xwiki.latex_plugin.image("...LaTeX...")
   vietā var rakstīt 
   #mm("...LaTeX...")

6. Pārstartē Tomcat serveri:

   /etc/init.d/tomcat5 restart

7. Kādā XWiki dokumentā ieraksta LaTeX izteiksmi, piemēram

   #mm("x_{1,2}=@frac{-b@pm@sqrt{b^2-4ac}}{2a}")

   . Saglabā dokumentu. Būtu jāparādās šādam attēlam: $xwiki.latex_plugin.image($ee)
8. Vairāk informācijas par spraudņu veidošanu uz XWiki var atrast XWiki spraudņu pamācībā

Kas strādā

1. Var ievietot visos dokumentos dažādas matemātiskas formulas un tās sakrājas direktorijā /var/www/latex/. No klasiskā LaTeX ir divas būtiskas atšķirības - netiek izmantotas ačgārnās daļsvītras, jo tās Velocity kontekstā ļoti slikti uzvedas. Visur, kur vajadzētu būt simbolam "backslash" jeb 0x5C (\), tai vietā jāraksta "@".
2. Ja formula nav pareizi sakompilējusies, tad PNG bilde uz servera nerodas un tiek attēlots vien ALT atribūts - pašas formulas izejas teksts. Nākotnē varētu būt doma par sintakses kļūdu rādīšanu un "broken-image" attēlu, bet nav izpētīts, vai "texvc" mēdz izdot arī kļūdu paziņojumus (vismaz pie noklusētajiem parametriem šī komandrindas utilītprogramma to nedara).
3. Var arī meklēt. Teiksim, ar Ante.lv Velocity meklētāju var ierakstīt "y^2" un atradīsies visi tie dokumenti, kur LaTeX izteiksmē atrodams y².

Problēmas

Teorētiski "texvc" vajadzētu strādāt kā aprakstīts Vikipēdijas dokumentācijā, bet ir dažas nepilnības.

• Ačgārnās daļsvītras nenostrādā pareizi un LaTeX ir pilns ar tādām. Šī iemesla dēļ backslash ir aizstāts ar "@". T.i. mēs rakstām:

  $xwiki.latex_plugin.image($ee)

  bet būtu krietni sakarīgāk šādi:

  {mm}\sqrt{2}{mm}

• Apskatoties attēlu datumus izskatās, ka PNG bildes tiek pārģenerētas ikreiz no jauna. Varbūt arī ka "ls -al" parāda, kad fails pēdējo reizi ir ticis pieprasīts, nevis uzradīts?
• Formulas tiek slikti izlīdzinātas pret teksta rindu - FireFox vispār ignorē "span(vertical-align:middle)" atribūtu, savukārt MS Explorer to ievēro, toties neņem vērā, kur ir formulas "smaguma centrs". (Sal. ABS92_76_3 izskatu abās pārlūkprogrammās. Vienā no tām daļas ir virs teksta, otrā - pakāpju izteiksmes ir "zem" teksta, jo izlīdzināšana neņem vērā kvadrātu. Vajadzētu eksperimentēt un salīdzināt ar Vikipēdijas stiliem.
• Overbrace un Underbrace nerāda atkārtojumu skaitu figūriekavas vidū, bet gan sānos. Sk. ABS92_76_13. Tam varētu būt sakars ar to, ka "texvc" pēc noklusēšanas atbalsta t.s. kompakto (inline) stilu, nevis pilno (displaymath) stilu. LaTeX definē abus divus stilus - jānoskaidro vai arī "texvc".
• Formulās nav izdevies ieviest glītuma atstarpes, kas ir parasti LaTeX - teiksim

  \, \; (precīzāk, @, un @; )

  nedarbojas
• Nestrādā trigonometrijas apzīmējums "tg". Tai vietā ir jālieto "tan". Sk. ABS92_76_17
• Vajadzētu aplūkot formulu veidošanu kā Web servisu - citādi XWiki instanci nevar darbināt uz Windows datoriem vai arī tur, kur nav uzlikts "texvc". Var jau būt, ka "lock-in" ir fīča nevis trūkums.

Formulu vertikālā izlīdzināšana

Kvadrātvienādojuma atrisinājumi dažreiz eksistē un dažreiz nē.