simtex 0.2.0a0

Convert your mardown or text lectures into LaTeX/pdf with one command.

simtex

simtex (simplified LaTeX) allows you to convert your markdown or text lectures into LaTeX file with one command, configured with simple .json file.

Note: This program does not exist to replace the LaTeX system, this do exist to simplify the process of turning your already existing markdown/text file into PDF with LaTeX.

Program Options

usage: simtex [OPTIONS]

Generate a LaTeX file from your notes with few commands!

options:
  -h, --help            show this help message and exit
  -c, --convert         Convert the input to LaTeX.
  -b, --build           Build the generated LaTeX file.
  -B, --buildnview      Build the generated LaTeX file and view the output.
  -i INPUT, --input INPUT
                        File to be converted into LaTeX.
  -T TITLE, --title TITLE
                        Set the title of the document.
  -f FILENAME, --filename FILENAME
                        Use different name for the output file.
  -of OUTPUTFOLDER, --outputfolder OUTPUTFOLDER
                        Change the output folder for the output file.
  -a AUTHOR, --author AUTHOR
                        Set the author name of the document.
  -d DATE, --date DATE  Set the date of the document.
  -F FONT, --font FONT  Use different font package.
  -s FONTSIZE, --fontsize FONTSIZE
                        Use different font size.
  -p PAPERSIZE, --papersize PAPERSIZE
                        Use different paper size.
  -I INDENT, --indent INDENT
                        Indent size to be used.
  -m MARGIN, --margin MARGIN
                        Margin size to be used.

Features

The program allows the user to convert simple file such as markdown or text file of its assignment/lecture into PDF using LaTeX. This program does not intend to compete with pandoc, which essential does the same, but on a higher level, however, produces a very complex transcription of the input, another reason why this program is created, to create a simple LaTeX transcript of the input. Currently, the program has features that can satisfy conversion of basic inputs:

1. Supports the most basic commands, such as bold, italics, emphasize, inline code.
2. Environments, the program supports a multiline math environment using align, single line math equation using equation environment, as well as code blocks using lstlisting with syntax highlighting.
3. Graphics and figures, as well as links with captions.
4. Sections, subsections and paragraphs.
5. Basic document metadata and properties that can be provided in a configuration file for default value, this includes, author, date, font, among others, view the short documentation for full list.
6. Simple config file using JSON, which defines the rules that should be followed on how the program should parse the input, as well as how to format the document.

Examples

You can view the output of the program here using the command":

simtex -c -i="./examples/1/hello.md" -T="Hello Simtex!" -of="./examples/1" -f="hello.tex" -a="iaacornus" -d="August 15, 2552"

View ./examples/1/hello.md

View output: .examples/1/hello.pdf

To convert a LaTeX file, and rename the default author defined in $CONF_PATH/simtex.json, add -a="iaacornus (or your name), and with the date, -d="August 15, 2552. See the documentation of arguments and configuration file.

Installation

See INSTALL.md for details.

Roadmap

1. Include support for quote blocks.
2. Support for enumerate/lists.
3. Support for other LaTeX compilers such as XeTex.