# Differences

This shows you the differences between two versions of the page.

 — syntaxtest [2016/05/23 23:10] (current) Line 1: Line 1: + ====== This is the main tile of the document ====== + ===== It also has a subtitle ===== + + I have narrowed down the most basic requirements to this: + + * Mathematical input (equation environments,​ inline math, etc.) and equation referencing. This must be able to parse MathJax, which is just basically latex. + * Bolded and italicized text; section headings + * A way to parse any block of text using latex'​s lstlisting (verbatim) environment. ​ + * A way to ignore any block of text + * A way to include images. For simplicity, all images can be included with a standard size (0.5\textwidth,​ say). + + Along with this, there is one smaller (but still often used) capability + * Links: dokuwiki links can either be internal (within the wiki) or external (just a plain html link). It would be good if the generated pdf file would include hyperlinks. This should be easier for the external kind than the internal. ​ + * Finally, there is one capability that comes for free if we use the doku2html and pandoc method: tables. However, tables are not used very often, and I can avoid them if necessary. + + ===== Essential components ==== + + ==== Mathjax ​ ==== + + Here is a test for an in-line equation $x^2 + y^2 = z^2$, and also a displayed equation ​ + \label{myeq} + f(x) = \sum_{n=0}^\infty \frac{f^{(n)}(0)}{n!} x^n. + + + I can then reference the equation via \eqref{myeq}. I can also do standalone mathematics like + $+ a^2 + b^2 = c^2. +$ + + ==== Text input ==== + + I'll needed **bolded** and //​italicized//​ text. I'd also like to **//​combine//​** them. I'd also like for the chance to \\ force a new line. Footnotes are occasionally used((This is a footnote)) by using double parentheses. + + ==== Sectioning ==== + + Headlines should be included. + + ==== Lists ==== + + * This is a list + * The second item + * You may have different levels + * Another item + + - The same list but ordered + - Another item + - Just use indention for deeper levels + - That's it + + ===== Verbatim text and no formatting ===== + + There are two environments I need. The first would deal with when I need text to be verbatim. For instance, I may have some things I //know// won't be rendered well, like a table, if the table functionality is not implemented,​ or code. In that case, I would still like the text to be displayed, but it must be verbatim and use the \begin{list listing}…\end{lstlisting} environments. For instance, can we specify a <​verbtex>​ command that would be parsed and substituted into a lstlistings environment?​ + + The second capability I would need is a tag that specifies that the following text should not be displayed at all. If possible, this should take in one input, which is a paragraph input. For instance, I would like to have a <​notex="​Image not displayed">​ tag that would remove whatever is between the tags, and replace the latex with: + + \begin{center} ​ + Image not displayed. ​ + \end{center} + + ==== Images ==== + + {{ :​oxford:​maths:​fourier:​12_week4_roda.png?​ |Image description}} + + ===== Non-essential components ===== + + ==== Tables ==== + + It would be nice to have capabilities to do tables. But this should be placed //last// on the list. For instance: + + ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ + | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | + | Row 2 Col 1    | some colspan (note the double pipe) || + | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        | + + You can have rowspans (vertically connected cells) by adding '':::''​ into the cells below the one to which they should connect. + + ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ + | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | + | Row 2 Col 1    | :::                        | Row 2 Col 3        | + | Row 3 Col 1    | :::                        | Row 2 Col 3        | + + Apart from the rowspan syntax those cells should not contain anything else. You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. + + ^           Table with alignment ​          ^^^ + |         ​right| ​   center ​   |left          | + |left          |         ​right| ​   center ​   | + | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | + + ==== Links ==== + + There are two types of links I'd like to handle: external links and internal links. Here is an external link: http://​www.google.com. You can set the link text as well: [[http://​www.google.com|This Link points to google]]. Email addresses like this one: <​andi@splitbrain.org>​ are recognized, too. Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. You can use [[some:​namespaces]] by using a colon in the pagename. + +