MarTeX-Cpp

MarTeX-Cpp is a flexable, extendable and fast TeX-to-HTML converter by fully tokenizing-lexing-parsing-interpreting the TeX source. It can be compiled to serve as a module for different languages, like PHP or JavaScript. It's goal is to provide a way to allow users to write TeX they are familiar with to produce nice looking pages like this one, but without allowing code injection.

Styling

• Headings
  • \title{Title}

    Make a big fancy title.

  • \chapter{Title}

    Make a chapter title.

  • \section{Title}

    Make a section title.

  • \subsection{Title}

    Make a subsection title.

  • \subsubsection{Title}

    Make a subsubsection title.

• Markup
  • \textbf{Text} or \bold{Text}

    Render Text in bold.

  • \textit{Text} or \italic{Text}

    Render Text in italics.

  • \textul{Text} or \underline{Text}

    Render Text underlined.

  • \textsc{Text} or \smallcaps{Text}

    Render Text smallcaps.

  • \textms{Text} or \mono{Text}

    Render Text monospaced.

  • \sizew{Text}

    Change the width of a rendered element.

  • \sizeh{Text}

    Change the height of a rendered element.

  • \sup{Text}

    Write superscript text.

  • \sub{Text}

    Write subscript text.

• Elements
  • \hline

    Make a horizontal line.

  • \newline

    Line break, equivalent to a double backslash.

  • \ref{label}

    Reference a label (from an image, for example). Works with both forward and backwards declaration (The label can be both above and below the ref command). Outputs a question mark when the label is undefined.

  • \define{Variable}{Value}

    Set the global Variable to Value. Often used to change module behaviour.

  • \href{URL}{Text}

    Make a hyperlink to URL with text Text

  • \url{URL}

    Make a hyperlink to URL with text URL (so is like invoking \href{URL}{URL})

  • \colo(u)r{hexcode}{text}

    Change the colour of a piece of text. \colour{ff00ff}{text}

  • \bkgcolo(u)r{hexcode}

    Change the background colour.

• Fontsize
  • \fontsize{size}

    Change the fontsize .

  • \tiny

    Make the font tiny sized.

  • \small

    Make the font small sized.

  • \normal

    Make the font normal sized.

  • \big

    Make the font big sized.

  • \huge

    Make the font huge sized.

Special Characters

Just throw any old unicode into martex and it will work. You can also use these escape codes:

Images

Images are pretty. Normally the images try to fill the page width, you can control this behaviour with the provided sizing options. If you add a caption to an image it will put "Figure 1: caption" under it. You can change "Figure" to , for example, "Picture" by setting the header with a \define{header}{Picture }.

• \includegraphics{url}

  Use to display an image.

• \caption{caption text}

  Use to display text under your image.

• \label{label text}

  Use to give your image a label, so you can use \ref{label} to reference it.

• \width{Width}

  Set the width of your image. Width can have the following formats: 10 (this is a percentage), 10px, 10cm, 10em.

• \height{Height}

  Set the height of your image. Height can have the following formats: 10 (this is a percentage), 10px, 10cm, 10em.

• \alttext{alt text}

  Set the alt text, also called hovertext, of your image.

\begin{figure}
    \includegraphics{test.png}
    \caption{This is a test image}
    \label{testimage}
    \width{120px}
    \height{30}
    \alttext{A mouse!}
\end{figure}

Lists

Note that there are two different list environments: enumerate and itemize with a different default markers, respectively numbers and bullets.

• \item

  Mark the start of the next item in the list.

• \setmarker{type}

  Set the marker type. Valid types are: square, bullet, circle, none, numbers, letters, LETTERS, roman, ROMAN.

Example

\begin{itemize}
    \item{Akcie}
    \item{Ambicie}
    \item{Batavieren}
    \item{Boson}
\end{itemize}
\begin{itemize}
    \setmarker{square}
    \item Brouwcommissie
    \item Colloquiumcommissie
    \item Excurcie
\end{itemize}
\begin{enumerate}
    \item{Impuls}
    \item{Lustrumcie}
    \item{Münchencie}
\end{enumerate}
\begin{enumerate}
    \setmarker{letters}
    \item{Ouderdagcie}
    \item{Particie}
    \item{PR-cie}
    \item{Reunistencie}
\end{enumerate}
\begin{enumerate}
    \setmarker{ROMAN}
    \item Sponsorcommissie
    \item Symposiumcie
    \item Vakancie
    \item Weekendcommissie
    \item WWW-cie
    \item Coördinatiecommissie
\end{enumerate}

Tables

Tables are a good way to represent content in a neat way. In MarTeX they behave pretty similar to the LaTeX tabulars. The tabular format accepts '|' for vertical lines, 'l' for left aligned column, 'c' for a centered column and 'r' for a right aligned column.

• \hline

  Add a horizontal line at this position in the table. Maximum of two lines per row.

• \multicolumn{N}{format}{text}

  Make a cell span over N columns. You can add special formatting to this cell (so just like your table formatting).

• \multirow{N}{text}

  Make a cell span over N rows

\begin{tabular}[|| l | c | r ||]
    \hline \hline
    1 & 2 & 3 \\\hline
    4 & 5 & 6 \\\hline
    7 & 8 & 9 \\\hline
    \multicolumn{3}{| c |}{0} \\
    \hline
\end{tabular}

Textual

Paragraphs

\begin{paragraph}
    Paragraph text
\end{paragraph}

Paragraph text

Center

You can center text:

\begin{center}
    Center text
\end{center}

Details

Hide and show text using details.

\begin{details}[Summary]
    Details text
\end{details}

Marie-Curie Specific functionality

• \baseuri{url}

• \user{username}

• \person{username}

• \publicperson{username}

• \document{document reference}

• \photo{photo id}

• \album{album reference}

• \email{address}

• \double_oker_header

• \double_oker_footer

• \single_oker_header

• \single_oker_footer

Contributing

Please feel free to submit anything! The only thing I ask is that you include at least one test that verifies the behaviour of your change.

Bug Bounty Program

If you find a way insert arbitrary html tags and/or get javascript execution from a certain input string then first I'd like to congratualate you on a job well done! Please contact me privately with said input and we'll work on pushing out a fix as quickly as possible.

links

• Live MarTeX interpreter
• Development Guide

Authors

• Thijs Miedema - Initial work - thijsmie

Acknowledgments

Thanks to my committee for their endless patience and enthusiasm while listening to me whining on about this.
Thanks to Diego Perini for writing a nifty regex-based URL validator.

License

This project is licensed under the MIT License - see the LICENCE.md file for details