summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/plugins/tex.mdwn25
-rw-r--r--doc/plugins/teximg.mdwn25
-rw-r--r--doc/todo/latex.mdwn5
3 files changed, 29 insertions, 26 deletions
diff --git a/doc/plugins/tex.mdwn b/doc/plugins/tex.mdwn
deleted file mode 100644
index 52f90f6ab..000000000
--- a/doc/plugins/tex.mdwn
+++ /dev/null
@@ -1,25 +0,0 @@
-[[template id=plugin name=tex author="[[PatrickWinnertz]]"]]
-[[tag type/chrome type/slow]]
-
-This plugin renders LaTeX formulas into images, which are rendered automatically when you save this site.
-
-Scaling of this images is of course also possible, possible heights are:
-
- 8,9,10,11,12,14,17,20
-
-But is also work if you pic e.g. another height. The best fitting height is then used to generate the image.
-
-#Here are some examples how to use this plugin:
-
- [[tex code="\ce{[Cu(NH3)3]^{2+}}"]]
- [[tex code="\frac{1}{2}"]]
- [[tex code="E = - \frac{Z^2 \cdot \mu \cdot e^4}{32\pi^2 \epsilon_0^2 \hbar^2 n^2}" ]]
-
-in order to scale this images use height=x:
-
- [[tex code="\ce{[Cu(NH3)3]^{2+}}" height="17"]]
- [[tex code="\ce{[Cu(NH3)3]^{2+}}" height="8"]]
-
-If no height is choosen the default height 12 is used.
-
-See [this site](http://www.der-winnie.de/opensource/gsoc2007) for rendered images. \ No newline at end of file
diff --git a/doc/plugins/teximg.mdwn b/doc/plugins/teximg.mdwn
new file mode 100644
index 000000000..5c35aa2e8
--- /dev/null
+++ b/doc/plugins/teximg.mdwn
@@ -0,0 +1,25 @@
+[[template id=plugin name=teximg author="[[PatrickWinnertz]]"]]
+[[tag type/chrome type/slow]]
+
+This plugin renders LaTeX formulas into images.
+
+## examples
+
+ \[[teximg code="\ce{[Cu(NH3)3]^{2+}}"]]
+ \[[teximg code="\frac{1}{2}"]]
+ \[[teximg code="E = - \frac{Z^2 \cdot \mu \cdot e^4}{32\pi^2 \epsilon_0^2 \hbar^2 n^2}" ]]
+
+To scale the image, use height=x:
+
+ \[[teximg code="\ce{[Cu(NH3)3]^{2+}}" height="17"]]
+ \[[teximg code="\ce{[Cu(NH3)3]^{2+}}" height="8"]]
+
+If no height is choosen the default height 12 is used. Valid heights are: 8, 9,
+10, 11, 12, 14, 17, 20. If another height is entered, the closest available
+height is used.
+
+To add an alt text to the image, use alt="text":
+
+ \[[teximg code="\frac{1}{2}" alt="1/2"]]
+
+See [this site](http://www.der-winnie.de/opensource/gsoc2007) for rendered images.
diff --git a/doc/todo/latex.mdwn b/doc/todo/latex.mdwn
index cedf7cbd5..8822bd30b 100644
--- a/doc/todo/latex.mdwn
+++ b/doc/todo/latex.mdwn
@@ -167,13 +167,16 @@ Okay, the last version of the tex plugin for ikiwiki can be downloaded [here](ht
> fixed a bug (the first time it was run, it tried to write the png file
> before the teximages/ directory existed) and checked the result in.
>
-> Can you please flesh out [[plugins/tex]] with
+> Can you please flesh out [[plugins/teximg]] with
> whatever documentation people who know tex will expect to see?
Okay, I'll fill this up today I think with information about the plugin
Done. Is that docu fine with you?
+>> Perhaps add some documentation about the kind of tex code that can be
+>> used, or a link to some documentation so people who don't know latex
+>> well can figure this out?
> Also, please review my changes. In particular, I changed the @badthings
> array to use qr//, which is much clearer, but it needs to be tested that